TabCtrl_SetCurFocusTabCtrl_SetCurFocus*
*Contents  *Index  *Topic Contents
*Previous Topic: TabCtrl_RemoveImage
*Next Topic: TabCtrl_SetCurSel

TabCtrl_SetCurFocus


VOID TabCtrl_SetCurFocus(
    HWND hwnd,
    int  iItem
);

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

hwnd
Handle to the tab control.
iItem
Zero-based index of the tab that gets the focus.

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 messages to its parent window.

See also TabCtrl_GetCurFocus, TCM_GETCURFOCUS

Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.