MEASUREITEMSTRUCT-Struktur (winuser.h)

Artikel
08/28/2023

Informiert das System über die Dimensionen eines vom Besitzer gezeichneten Steuerelements oder Menüelements. Dadurch kann das System die Benutzerinteraktionen mit dem Steuerelement ordnungsgemäß verarbeiten.

Syntax

typedef struct tagMEASUREITEMSTRUCT {
  UINT      CtlType;
  UINT      CtlID;
  UINT      itemID;
  UINT      itemWidth;
  UINT      itemHeight;
  ULONG_PTR itemData;
} MEASUREITEMSTRUCT, *PMEASUREITEMSTRUCT, *LPMEASUREITEMSTRUCT;

Member

CtlType

Typ: UINT

Der Steuerelementtyp. Dieser Member kann einer der in der folgenden Tabelle gezeigten Werte sein.

Wert	Bedeutung
ODT_COMBOBOX	Vom Besitzer gezeichnetes Kombinationsfeld
ODT_LISTBOX	Vom Besitzer gezeichnetes Listenfeld
ODT_LISTVIEW	Listenansicht-Steuerelement "Besitzer zeichnen"
ODT_MENU	Vom Besitzer gezeichnetes Menü

CtlID

Typ: UINT

Der Bezeichner des Kombinationsfelds oder Listenfelds. Dieser Member wird nicht für ein Menü verwendet.

itemID

Typ: UINT

Der Bezeichner für ein Menüelement oder die Position eines Listenfeld- oder Kombinationsfeldelements. Dieser Wert wird nur für ein Listenfeld angegeben, wenn es über die LBS_OWNERDRAWVARIABLE Formatvorlage verfügt. Dieser Wert wird nur für ein Kombinationsfeld angegeben, wenn es über das CBS_OWNERDRAWVARIABLE-Format verfügt.

itemWidth

Typ: UINT

Die Breite eines Menüelements in Pixel. Bevor die Nachricht zurückgegeben wird, muss der Besitzer des vom Besitzer gezeichneten Menüelements dieses Element ausfüllen.

itemHeight

Typ: UINT

Die Höhe eines einzelnen Elements in Pixel in einem Listenfeld oder Menü. Vor der Rückkehr von der Nachricht muss der Besitzer des vom Besitzer gezeichneten Kombinationsfelds, des Listenfelds oder des Menüelements dieses Mitglied ausfüllen.

itemData

Typ: ULONG_PTR

Der anwendungsdefinierte Wert, der dem Menüelement zugeordnet ist. Für ein Steuerelement gibt dieses Element den Wert an, der dem Listenfeld oder Kombinationsfeld zuletzt durch die LB_SETITEMDATA - oder CB_SETITEMDATA-Nachricht zugewiesen wurde. Wenn das Listen- oder Kombinationsfeld die LB_HASSTRINGS- oder CB_HASSTRINGS-Format aufweist, ist dieser Wert zunächst 0 (null). Andernfalls ist dieser Wert ursprünglich der Wert, der im lParam-Parameter einer der folgenden Meldungen an das Listenfeld oder Kombinationsfeld übergeben wird:

Hinweise

Das Besitzerfenster eines besitzergezeichneten Steuerelements empfängt einen Zeiger auf die MEASUREITEMSTRUCT-Struktur als lParam-Parameter einer WM_MEASUREITEM-Nachricht . Das vom Besitzer gezeichnete Steuerelement sendet diese Nachricht an das Besitzerfenster, wenn das Steuerelement erstellt wird. Der Besitzer füllt dann die entsprechenden Member in der Struktur für das Steuerelement aus und gibt zurück. Diese Struktur ist für alle vom Besitzer gezeichneten Steuerelemente mit Ausnahme des vom Besitzer gezeichneten Schaltflächensteuerelements gemeinsam, dessen Größe durch sein Fenster vordefiniert wird.

Wenn eine Anwendung die entsprechenden Member von MEASUREITEMSTRUCT nicht ausfüllt, wird das Steuerelement oder Menüelement möglicherweise nicht ordnungsgemäß gezeichnet.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winuser.h (windows.h einschließen)