CTabCtrl::GetItemState

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

DWORD GetItemState( 
   int nItem, 
   DWORD dwMask  
) const;

Parameters

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

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

Return Value

A reference to a DWORD value receiving 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.

Remarks

An item's state is specified by the dwState member of the TCITEM structure.

Requirements

Header: afxcmn.h

See Also

Reference

CTabCtrl Class

Hierarchy Chart

CTabCtrl::SetItemState

Other Resources

CTabCtrl Members