HDITEM Structure ()

HDITEM Structure

HDITEM Structure

Contains information about an item in a header control. This structure supersedes the HD_ITEM structure.

Syntax

typedef struct _HDITEM {
    UINT    mask; 
    int     cxy; 
    LPTSTR  pszText; 
    HBITMAP hbm; 
    int     cchTextMax; 
    int     fmt; 
    LPARAM  lParam; 
#if (_WIN32_IE >= 0x0300)
    int     iImage;
    int     iOrder;
#endif
#if (_WIN32_IE >= 0x0500)
    UINT    type;
    void    *pvFilter;
#endif
#if _WIN32_WINNT >= 0x0600
    UINT   state;
#endif
} HDITEM,  *LPHDITEM;

Members

mask
Flags indicating which other structure members contain valid data or must be filled in. This member can be a combination of the following values:
HDI_BITMAP
The hbm member is valid.
HDI_DI_SETITEM
Version 4.70. While handling the message HDM_GETITEM, the header control may not have all the values needed to complete the request. In this case, the control must call the application back for the values via the HDN_GETDISPINFO notification. If HDI_DI_SETITEM has been passed in the HDM_GETITEM message, the control will cache any values returned from HDN_GETDISPINFO (otherwise the values remain unset.)
HDI_FORMAT
The fmt member is valid.
HDI_FILTER
Version 5.80. The type and pvFilter members are valid. This is used to filter out the values specified in the type member.
HDI_HEIGHT
The same as HDI_WIDTH.
HDI_IMAGE
Version 4.70. The iImage member is valid and specifies the image to be displayed with the item.
HDI_LPARAM
The lParam member is valid.
HDI_ORDER
Version 4.70. The iOrder member is valid and specifies the item's order value.
HDI_STATE
Version 6.00 and Windows Vista. The state member is valid.
HDI_TEXT
The pszText and cchTextMax members are valid.
HDI_WIDTH
The cxy member is valid and specifies the item's width.
cxy
The width or height of the item.
pszText
A pointer to an item string. If the text is being retrieved from the control, this member must be initialized to point to a character buffer. If this member is set to LPSTR_TEXTCALLBACK, the control will request text information for this item by sending an HDN_GETDISPINFO notification message. Note that although the header control allows a string of any length to be stored as item text, only the first 260 TCHARs are displayed.
hbm
A handle to the item bitmap.
cchTextMax
The length of the item string, in TCHARs. If the text is being retrieved from the control, this member must contain the number of TCHARs at the address specified by pszText.
fmt
Flags that specify the item's format.
Text Justification:
Set one of the following flags to specify text justification:
HDF_CENTER
The item's contents are centered.
HDF_LEFT
The item's contents are left-aligned.
HDF_RIGHT
The item's contents are right-aligned.
Display:
Set one of the following flags to control the display:
HDF_BITMAP
The item displays a bitmap.
HDF_BITMAP_ON_RIGHT
Version 4.70. The bitmap appears to the right of text.
HDF_OWNERDRAW
The header control's owner draws the item.
HDF_STRING
The item displays a string.
Combining Flags:
The preceding value can be combined with:
HDF_IMAGE
Version 4.70. Display an image from an image list. Specify the image list by sending an HDM_SETIMAGELIST message. Specify the index of the image in the iImage member of this structure.
HDF_JUSTIFYMASK
Isolate the bits corresponding to the three justification flags listed in the preceding table.
HDF_RTLREADING
Typically, windows displays text left-to-right (LTR). Microsoft Windows can be mirrored to display languages such as Hebrew or Arabic that read right-to-left (RTL). Usually, header text is read in the same direction as the text in its parent window. If HDF_RTLREADING is set, header text will read in the opposite direction from the text in the parent window.
HDF_SORTDOWN
Version 6.00. Draws a down-arrow on this item. This is typically used to indicate that information in the current window is sorted on this column in descending order. This flag cannot be combined with HDF_IMAGE or HDF_BITMAP.
HDF_SORTUP
Version 6.00. Draws an up-arrow on this item. This is typically used to indicate that information in the current window is sorted on this column in ascending order. This flag cannot be combined with HDF_IMAGE or HDF_BITMAP.
HDF_CHECKBOX
Microsoft Windows Vista and Version 6.00. The item displays a checkbox. The flag is only valid when the HDS_CHECKBOXES style is first set on the header control.
HDF_CHECKED
Microsoft Windows Vista and Version 6.00. The item displays a checked checkbox. The flag is only valid when HDF_CHECKBOX is also set.
HDF_FIXEDWIDTH
Microsoft Windows Vista and Version 6.00.The width of the item cannot be modified by a user action to resize it.
HDF_FOCUSED
Microsoft Windows Vista and Version 6.00. The item has keyboard focus.
HDF_SPLITBUTTON
Microsoft Windows Vista and Version 6.00. The item displays a split button. The HDN_DROPDOWN notification is sent when the split button is clicked.
lParam
Application-defined item data.
iImage
Version 4.70. The zero-based index of an image within the image list. The specified image will be displayed in the header item in addition to any image specified in the hbm field. If iImage is set to I_IMAGECALLBACK, the control requests text information for this item by using an HDN_GETDISPINFO notification message. To clear the image, set this value to I_IMAGENONE.
iOrder
Version 4.70. The order in which the item appears within the header control, from left to right. That is, the value for the far left item is 0. The value for the next item to the right is 1, and so on.
type
Version 5.80. The type of filter specified by pvFilter. The possible types include:
HDFT_ISSTRING
String data.
HDFT_ISNUMBER
Numerical data.
HDFT_HASNOVALUE
Ignore pvFilter.
HDFT_ISDATE
SYSTEMTIME.
pvFilter
Version 5.80. The address of an application-defined data item. The data filter type is determined by setting the flag value of the member. Use the HDFT_ISSTRING flag to indicate a string and HDFT_ISNUMBER to indicate an integer. When the HDFT_ISSTRING flag is used pvFilter is a pointer to a HDTEXTFILTER structure.
state
The state. The only valid, supported value for this member is the following:
HDIS_FOCUSED
The item has keyboard focus.

Remarks

Note Comctl32.dll version 6 is not redistributable but it is included in Windows XP and later. To use Comctl32.dll version 6, specify it in a manifest. For more information on manifests, see Enabling Visual Styles.

Structure Information

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

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