windows_programming_notes.nbk: Home | Index | Next Page: TCITEM | Previous Page: TabCtrl_GetCurSel

 TabCtrl_SetCurSel

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

Syntax

    int TabCtrl_SetCurSel(
        HWND hwnd,
        int iItem
    );

Parameters

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

Return Value

Returns the index of the previously selected tab if successful, or -1 otherwise.

Remarks

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

Macro Information

• Header commctrl.h
• Minimum operating systems Windows NT 3.51, Windows 95

windows_programming_notes.nbk: Home | Index | Next Page: TCITEM | Previous Page: TabCtrl_GetCurSel

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time