NoFocusStyle


	NoFocusStyle	Softel vdm, Inc.

Defines the display style of selected items when the tree control does not have the input focus.

int WINAPI SftTree_GetNoFocusStyle(HWND hwndCtl);
void WINAPI SftTree_SetNoFocusStyle(HWND hwndCtl, int NoFocusStyle);
int WINAPI SftTreeSplit_GetNoFocusStyle(HWND hwndCtl);
void WINAPI SftTreeSplit_SetNoFocusStyle(HWND hwndCtl, int NoFocusStyle);

C++

int CSftTree::GetNoFocusStyle() const;
void CSftTree::SetNoFocusStyle(int type);
int CSftTreeSplit::GetNoFocusStyle() const;
void CSftTreeSplit::SetNoFocusStyle(int type);

Parameters

hwndCtl

The window handle of the tree control.

NoFocusStyle

A value describing the display style of selected items when the tree control does not have the input focus:

SFTTREE_NOFOCUS_KEEPSEL

The selected items are drawn the same way as for a tree control that has the input focus. If a rounded selection outline rectangle is used (see SFTTREE_SELECTION_OUTLINE), the colors used are defined using the nofocusOutlineBorder, nofocusInnerBorder, nofocusInnerFill1 and nofocusInnerFill2 members of the SFTTREE_COLORS structure. Otherwise, the colorSelBgNoFocus and colorSelFgNoFocus members are used. If these colors are identical to the colors selectionOutlineBorder, selectionInnerBorder, selectionInnerFill1, selectionInnerFill2 or colorSelBg and colorSelBgNoFocus, the user cannot distinguish between selected items in an active tree control and an inactive control.

SFTTREE_NOFOCUS_FRAME

The selected items are drawn as items that are not selected, but are framed by a rectangle drawn using the color specified by the colorSelBg member of the SFTTREE_COLORS structure. If a rounded selection outline rectangle is used (see SFTTREE_SELECTION_OUTLINE), SFTTREE_NOFOCUS_FRAME is identical to SFTTREE_NOFOCUS_KEEPSEL.

SFTTREE_NOFOCUS_NOTHING

The selected items are drawn as items that are not selected. The user cannot distinguish between selected items and items that are not selected in an inactive tree control.

Returns

GetNoFocusStyle returns a value describing the display style of selected items when the tree control does not have the input focus.

Comments

The GetNoFocusStyle and SetNoFocusStyle functions define the display style of selected items when the tree control does not have the input focus.

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

SFTTREE_NOFOCUS_KEEPSEL	The selected items are drawn the same way as for a tree control that has the input focus. If a rounded selection outline rectangle is used (see SFTTREE_SELECTION_OUTLINE), the colors used are defined using the nofocusOutlineBorder, nofocusInnerBorder, nofocusInnerFill1 and nofocusInnerFill2 members of the SFTTREE_COLORS structure. Otherwise, the colorSelBgNoFocus and colorSelFgNoFocus members are used. If these colors are identical to the colors selectionOutlineBorder, selectionInnerBorder, selectionInnerFill1, selectionInnerFill2 or colorSelBg and colorSelBgNoFocus, the user cannot distinguish between selected items in an active tree control and an inactive control.
SFTTREE_NOFOCUS_FRAME	The selected items are drawn as items that are not selected, but are framed by a rectangle drawn using the color specified by the colorSelBg member of the SFTTREE_COLORS structure. If a rounded selection outline rectangle is used (see SFTTREE_SELECTION_OUTLINE), SFTTREE_NOFOCUS_FRAME is identical to SFTTREE_NOFOCUS_KEEPSEL.
SFTTREE_NOFOCUS_NOTHING	The selected items are drawn as items that are not selected. The user cannot distinguish between selected items and items that are not selected in an inactive tree control.