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.