EnableRedraw

This method is used to allow changes to be redrawn or to prevent them from being redrawn in the Project Tree.

 

JavaScript
EnableRedraw(bEnable)

 

C#
void EnableRedraw(        bool bEnable)

 

C++
HRESULT EnableRedraw(        VARIANT_BOOL bEnable)

Parameters

bEnable 

Indicates whether or not the Project Tree should be redrawn.

Exceptions

HRESULT can return any of the values listed in the HRESULT Return Values list, as well as the following values:

TE_E_INFOTREE_PARENTNOTGROUP	The group ID entered does not represent a valid group in the project tree.
TE_E_INFOTREE_ITEMNOTGROUP	The item entered is not a group and therefore cannot be used as a group.
TE_E_INFOTREE_CANTUSEROOT	Can not use tree root for this operation
TE_E_INFOTREE_ITEMISGROUP	ItemID is a group so an object cannot be retrieved.

Remarks

When adding several groups and objects at once, it is best to call EnableRedraw (FALSE), before starting to add items to the tree, along with EnableRedraw(TRUE), after you have finished adding those items. This prevents a flashing effect and the constant repainting of the tree in the Project Tree. Instead, EnableRedraw repaints the tree once all the items have been added.