Returns the highest level parent index number for an item.

C

int WINAPI SftTree_GetTopParent(HWND hwndCtl, int index);
int WINAPI SftTreeSplit_GetTopParent(HWND hwndCtl, int index);

C++

int CSftTree::GetTopParent(int index) const;
int CSftTreeSplit::GetTopParent(int index) const;

Parameters

hwndCtl

The window handle of the tree control.

index

The zero-based index of the item for which the top parent item index is to be retrieved.

Returns

The return value is the zero-based index of the top parent item.  -1 is returned if the item requested doesn't have a parent or if an error occurred.

Comments

The GetTopParent function returns the highest level parent index number for an item.

The index returned is a direct or indirect parent, which itself has no parent.  To retrieve an immediate parent, use GetParent instead. 

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