Compartir a través de


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:

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

Header winuser.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Combo Boxes Structures
CB_ADDSTRING
CB_INSERTSTRING
CB_SETITEMDATA
LB_ADDSTRING
LB_INSERTSTRING
LB_SETITEMDATA
WM_MEASUREITEM