Defines whether items are automatically expanded when the mouse hovers over a collapsed parent item.

C

BOOL WINAPI SftTree_GetAutoExpand(HWND hwndCtl);
void WINAPI SftTree_SetAutoExpand(HWND hwndCtl, BOOL fSet);
BOOL WINAPI SftTreeSplit_GetAutoExpand(HWND hwndCtl);
void WINAPI SftTreeSplit_SetAutoExpand(HWND hwndCtl, BOOL fSet);

C++

BOOL CSftTree::GetAutoExpand() const;
void CSftTree::SetAutoExpand(BOOL fSet = TRUE);
BOOL CSftTreeSplit::GetAutoExpand() const;
void CSftTreeSplit::SetAutoExpand(BOOL fSet = TRUE);

Parameters

hwndCtl

The window handle of the tree control.

fSet

Set to TRUE so the SFTTREEN_AUTOEXPANDING notification is sent to the application when the mouse hovers over a collapsed parent item. Otherwise, set to FALSE.

Returns

GetAutoExpand returns TRUE if the SFTTREEN_AUTOEXPANDING notification is enabled, otherwise FALSE is returned.

Comments

The GetAutoExpand and SetAutoExpand functions define whether items are automatically expanded when the mouse hovers over a collapsed parent item.

The SetControlInfo function can be used to define the delay after which a collapsed parent item is automatically expanded (SFTTREE_CONTROL, autoExpandHoverInterval).

If enabled, the SFTTREEN_AUTOEXPANDING notification is sent to the application when the mouse hovers over a collapsed parent item.  An application must handle the SFTTREEN_AUTOEXPANDING notification and expand the item returned by GetExpandCollapseIndex.

See Also  C/C++ API  |  Categories |  Notifications