TVM_EXPANDTVM_EXPAND*
*Contents  *Index  *Topic Contents
*Previous Topic: TVM_ENSUREVISIBLE
*Next Topic: TVM_GETBKCOLOR

TVM_EXPAND


TVM_EXPAND
    wParam = (WPARAM) (UINT) flag; 
    lParam = (LPARAM) (HTREEITEM) hItem;

Expands or collapses the list of child items associated with the specified parent item, if any. You can send this message explicitly or by using the TreeView_Expand macro.

flag
Action flag. This parameter can be one or more of the following values:
TVE_COLLAPSE Collapses the list.
TVE_COLLAPSERESET Collapses the list and removes the child items. This flag must be used with the TVE_COLLAPSE flag.
TVE_EXPAND Expands the list.
TVE_EXPANDPARTIAL Version 4.70. Partially expands the list. In this state, the child items are visible and the parent item's plus symbol is displayed. This flag must be used in combination with the TVE_EXPAND flag.
TVE_TOGGLE Collapses the list if it is expanded or expands it if it is collapsed.
hItem
Handle to the parent item to expand or collapse.

The TVM_EXPAND message will cause the TVN_ITEMEXPANDING and TVN_ITEMEXPANDED notification messages to be generated if the item being expanded does not have the TVIS_EXPANDEDONCE state bit set. This state gets set when a parent item is expanded for the first time. Using TVE_COLLAPSE and TVE_COLLAPSERESET with TVM_EXPAND will cause the TVIS_EXPANDEDONCE state to be reset.

If the item already has the TVIS_EXPANDEDONCE state set, the TVM_EXPAND message will not cause the TVN_ITEMEXPANDING and TVN_ITEMEXPANDED notification messages to be generated.

Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.