Microsoft Windows CE 3.0  

MEASUREITEMSTRUCT

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This structure informs Windows CE of the dimensions of an owner-drawn control or menu item. This allows Windows CE to process user interaction with the control correctly.

typedef struct tagMEASUREITEMSTRUCT {
UINT
CtlType
;
UINT
CtlID
;
UINT
itemID
;
UINT
itemWidth
;
UINT
itemHeight
;
DWORD
itemData
;
} MEASUREITEMSTRUCT;

Members

CtlType
Specifies the control type. It can be one of the following values:
Value Description
ODT_BUTTON Owner-drawn button
ODT_LISTVIEW Owner-draw list view control
ODT_MENU Owner-drawn menu
CtlID
Identifier of the combo box, list box, or button. This member is not used for a menu.
itemID
Identifier for a menu item or the position of a list box or combo box item. This value is specified for a list box only if it has the LBS_OWNERDRAWVARIABLE style; this value is specified for a combo box only if it has the CBS_OWNERDRAWVARIABLE style.
itemWidth
Specifies the width, in pixels, of a menu item. Before returning from the message, the owner of the owner-drawn menu item must fill this member.
itemHeight
Specifies the height, in pixels, of an individual item in a list box or a menu. Before returning from the message, the owner of the owner-drawn combo box, list box, or menu item must fill out this member.
itemData
Specifies the application-defined 32-bit value associated with the menu item. For a control, this member specifies the value last assigned to the list box or combo box by the LB_SETITEMDATAor CB_SETITEMDATAmessage. If the list box or combo box has the LB_HASSTRINGS or CB_HASSTRINGS style, this value is initially zero. Otherwise, this value is initially the value passed to the list box or combo box in the lParamparameter of one of the following messages:
  • CB_ADDSTRING
  • CB_INSERTSTRING
  • LB_ADDSTRING
  • LB_INSERTSTRING

    Remarks

    Windows CE does not support owner-drawn combo boxes and list boxes.

    The owner window of an owner-drawn control receives a pointer to the MEASUREITEMSTRUCTstructure as the lParamparameter of a WM_MEASUREITEM message. The owner-drawn control sends this message to its owner window when the control is created. The owner then fills in the appropriate members in the structure for the control and returns. This structure is common to all owner-drawn controls.

    If an application does not fill the appropriate members of MEASUREITEMSTRUCT, the control or menu item may not be drawn properly.

    Requirements

    Runs On Versions Defined in Include Link to
    Windows CE OS 1.0 and later Winuser.h    
    Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

    See Also

    CB_ADDSTRING, CB_INSERTSTRING, CB_SETITEMDATA, LB_ADDSTRING, LB_INSERTSTRING, LB_SETITEMDATA, WM_MEASUREITEM