Share via


CTabCtrl::SetItemState

Sets the state of the tab control item identified by nItem.

BOOL SetItemState( 
  int nItem, 
  DWORD dwMask, 
  DWORD dwState  
);

Parameters

  • nItem
    The zero-based index number of the item for which to set state information.

  • dwMask
    Mask specifying which of the item's state flags to set. For a list of values, see the mask member of the TCITEM structure, as described in the Windows SDK.

  • dwState
    A reference to a DWORD value containing the state information. Can be one of the following values:

    Value

    Description

    TCIS_BUTTONPRESSED

    The tab control item is selected.

    TCIS_HIGHLIGHTED

    The tab control item is highlighted, and the tab and text are drawn using the current highlight color. When using highlight color, this will be a true interpolation, not a dithered color.

Return Value

Nonzero if successful; otherwise 0.

Requirements

Header: afxcmn.h

See Also

Reference

CTabCtrl Class

Hierarchy Chart

CTabCtrl::GetItemState