BeginUpdate Method (RasterImageList)

Prevents the control from drawing until the EndUpdate method is called.

Syntax

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++

public void BeginUpdate()

'Declaration
 
Public Sub BeginUpdate()

'Usage
 
Dim instance As RasterImageList
 
instance.BeginUpdate()

public void BeginUpdate()

 function Leadtools.WinForms.RasterImageList.BeginUpdate()

public:
void BeginUpdate();

Remarks

The preferred way to add multiple items to a RasterImageList is to use the AddRange method of the RasterImageListItemCollection (accessed through the Items property of the RasterImageList). This enables you to add an array of items to the list in a single operation. However, if you want to add items one at a time using the Add method of the RasterImageListItemCollection class, you can use the BeginUpdate method to prevent the control from repainting the RasterImageList each time an item is added. Once you have completed the task of adding items to the control, call the EndUpdate method to enable the RasterImageList to repaint. This way of adding items can prevent flickered drawing of the RasterImageList when a large number of items are being added to the control.

Example

For an example, refer to Image.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

RasterImageList Class
RasterImageList Members