Share via

TabCtrl_SetCurSel

  • Article

This macro selects a tab in a tab control. You can use this macro or send the TCM_SETCURSEL message explicitly.

int TabCtrl_SetCurSel( 
HWND hwnd, 
int iItem );

Parameters

  • hwnd
    Handle to the tab control.
  • iItem
    Index of the tab to select.

Return Values

The index of the previously selected tab indicates success. –1 indicates failure.

Remarks

A tab control does not send a TCN_SELCHANGING or TCN_SELCHANGE notification message when a tab is selected using the TCM_SETCUSEL message.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Commctrl.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

TCM_SETCURSEL, TCN_SELCHANGE, TCN_SELCHANGING

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.