MEASUREITEMSTRUCT

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

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_SETITEMDATA or CB_SETITEMDATA message. 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 lParam parameter of one of the following messages:

  • CB_ADDSTRING
  • CB_INSERTSTRING
  • LB_ADDSTRING
  • LB_INSERTSTRING

Remarks

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

The owner window of an owner-drawn control receives a pointer to the MEASUREITEMSTRUCT structure as the lParam parameter 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

See Also

Reference

Combo Boxes Structures
CB_ADDSTRING
CB_INSERTSTRING
CB_SETITEMDATA
LB_ADDSTRING
LB_INSERTSTRING
LB_SETITEMDATA
WM_MEASUREITEM