Defines whether a focus rectangle is drawn around the current item when the tree control has the input focus.

C

BOOL WINAPI SftTree_GetShowFocus(HWND hwndCtl);
void WINAPI SftTree_SetShowFocus(HWND hwndCtl, BOOL fSet);
BOOL WINAPI SftTreeSplit_GetShowFocus(HWND hwndCtl);
void WINAPI SftTreeSplit_SetShowFocus(HWND hwndCtl, BOOL fSet);

C++

BOOL CSftTree::GetShowFocus() const;
void CSftTree::SetShowFocus(BOOL fSet = TRUE);
BOOL CSftTreeSplit::GetShowFocus() const;
void CSftTreeSplit::SetShowFocus(BOOL fSet = TRUE);

Parameters

hwndCtl

The window handle of the tree control.

fSet

Set to TRUE to display the focus rectangle, otherwise set to FALSE.

Returns

GetShowFocus returns a value indicating whether a focus rectangle is drawn around the current item when the tree control has the input focus.  TRUE is returned if the focus rectangle is drawn, otherwise FALSE is returned.

Comments

The GetShowFocus and SetShowFocus functions define whether a focus rectangle is drawn around the current item when the tree control has the input focus.

The focus rectangle is used to indicate to the user which item is the current item (see GetCaretIndex).  An application could turn off the focus rectangle to change the display style of the current item by using cell foreground and background colors instead. 

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