Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

TabCtrl_SetCurFocus macro

Sets the focus to a specified tab in a tab control. You can use this macro or send the TCM_SETCURFOCUS message explicitly.

Syntax


VOID TabCtrl_SetCurFocus(
   HWND hwnd,
   int  iItem
);

Parameters

hwnd

Type: HWND

Handle to the tab control.

iItem

Type: int

Zero-based index of the tab that gets the focus.

Return value

No return value.

Remarks

If the tab control has the TCS_BUTTONS style (button mode), the tab with the focus may be different from the selected tab. For example, when a tab is selected, the user can press the arrow keys to set the focus to a different tab without changing the selected tab. In button mode, the TabCtrl_SetCurFocus macro sets the input focus to the button associated with the specified tab, but it does not change the selected tab.

If the tab control does not have the TCS_BUTTONS style, changing the focus also changes the selected tab. In this case, the tab control sends the TCN_SELCHANGING and TCN_SELCHANGE notification codes to its parent window.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

See also

Reference
TabCtrl_GetCurFocus
TCM_GETCURFOCUS

 

 

Community Additions

ADD
Show:
© 2015 Microsoft