This documentation is archived and is not being maintained.


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

DWORD GetItemState( 
   int nItem, 
   DWORD dwMask  
) const;



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


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 Platform SDK.

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

Value Description


The tab control item is selected.


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.

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