BeginUpdate Method

Description

The BeginUpdate method will "lock" the property grid. This should be called when adding, deleting, or modifying a large number of items.

Syntax

Public Function BeginUpdate() As [PropertyGridUpdateContext](XtremePropertyGrid~PropertyGridUpdateContext.md)

Return Type

Pointer to the currently used PropertyGridUpdateContext. The EndUpdate method will use this PropertyGridUpdateContext to end the update.

Remarks

Each time you add a new item or category to the grid, the state of the grid is updated and the grid is redrawn. If you want to delete all items in the grid and then add a lot of new items, it will be quite slow. To do this, you would call BeginUpdate, then delete all the items. The property grid will be locked until you call EndUpdate.

It might be a good idea to implement a "busy" mouse cursor until the EndUpdate method is called.

Example

Locking the Property Grid Before a Large Update.