EnableRedraw

This method is used to allow or prevent redrawing of changes in the Project Tree.

 

JavaScript

 

EnableRedraw(bEnable)

 

C#

 

void EnableRedraw(

       bool bEnable)

 

C++

 

HRESULT EnableRedraw(

       VARIANT_BOOL bEnable)

Parameters

bEnable 

A Boolean that determines 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

Cannot use Tree root for this operation

TE_E_INFOTREE_ITEMISGROUP

Item ID 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.