Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This macro sets the focus to a specified tab in a tab control. You can use this macro or send the TCM_SETCURFOCUSmessage explicitly.

Syntax 

VOID TabCtrl_SetCurFocus( 
  HWND 
hwnd,
  int 
iItem 
);

Parameters

hwnd

Handle to the tab control.

iItem

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

Return Value

None.

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_SetCurFocusmacro 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_SELCHANGINGand TCN_SELCHANGEmessages to its parent window.

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also