IMEMENUITEMINFOA-Struktur (imm.h)

Enthält Informationen zu IME-Menüelementen.

Syntax

typedef struct tagIMEMENUITEMINFOA {
  UINT    cbSize;
  UINT    fType;
  UINT    fState;
  UINT    wID;
  HBITMAP hbmpChecked;
  HBITMAP hbmpUnchecked;
  DWORD   dwItemData;
  CHAR    szString[IMEMENUITEM_STRING_SIZE];
  HBITMAP hbmpItem;
} IMEMENUITEMINFOA, *PIMEMENUITEMINFOA, *NPIMEMENUITEMINFOA, *LPIMEMENUITEMINFOA;

Member

cbSize

Größe der Struktur in Byte.

fType

Menüelementtyp. Dieser Member kann über einen der folgenden Werte verfügen.

Wert	Bedeutung
IMFT_RADIOCCHECK	Zeigen Sie aktivierte Menüelemente mithilfe eines Optionsfelds anstelle eines Häkchens an, wenn das element hbmpCheckedNULL ist.
IMFT_SEPARATOR	Das Menüelement ist ein Trennzeichen. Ein Menüelementtrennzeichen wird als horizontale Trennlinie angezeigt. Die Member hbmpItem und szString werden in diesem Fall ignoriert.
IMFT_SUBMENU	Das Menüelement ist ein Untermenü.

fState

Menüelementstatus. Dieser Member kann einen oder mehrere der folgenden Werte aufweisen:

Wert	Bedeutung
IMFS_CHECKED	Das Menüelement ist aktiviert. Weitere Informationen finden Sie in der Beschreibung des hbmpChecked-Elements .
IMFS_DEFAULT	Das Menüelement ist die Standardeinstellung. Ein Menü kann nur ein Standardmenüelement enthalten, das fett angezeigt wird.
IMFS_DISABLED	Das Menüelement ist deaktiviert und wird abgeblendet angezeigt, sodass es nicht ausgewählt werden kann. Dies entspricht IMFS_GRAYED.
IMFS_ENABLED	Das Menüelement ist aktiviert. Dies ist die Standardeinstellung.
IMFS_GRAYED	Das Menüelement ist deaktiviert und wird abgeblendet angezeigt, sodass es nicht ausgewählt werden kann. Dies entspricht IMFS_DISABLED.
IMFS_HILITE	Das Menüelement ist hervorgehoben.
IMFS_UNCHECKED	Das Menüelement ist deaktiviert. Weitere Informationen zu nicht aktivierten Menüelementen finden Sie in der Beschreibung des hbmpUnchecked-Elements .
IMFS_UNHILITE	Das Menüelement ist nicht hervorgehoben. Dies ist die Standardeinstellung.

wID

Anwendungsdefinierter 16-Bit-Wert, der das Menüelement identifiziert.

hbmpChecked

Handle für die Bitmap, die neben dem Element angezeigt werden soll, wenn es aktiviert ist. Wenn dieser Member NULL ist, wird eine Standardbit verwendet. Wenn der IMFT_RADIOCHECK Typwert angegeben wird, ist die Standardbitmap ein Aufzählungszeichen. Andernfalls ist es ein Häkchen.

hbmpUnchecked

Handle für die Bitmap, die neben dem Element angezeigt werden soll, wenn es nicht aktiviert ist. Wenn dieser Member NULL ist, wird keine Bitmap verwendet.

dwItemData

Anwendungsdefinierter Wert, der dem Menüelement zugeordnet ist.

szString[IMEMENUITEM_STRING_SIZE]

Inhalt des Menüelements. Dies ist eine NULL-endende Zeichenfolge.

hbmpItem

Handle für eine anzuzeigende Bitmap.

Hinweise

Hinweis

Der imm.h-Header definiert IMEMENUITEMINFO als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	imm.h (include Immdev.h, Windows.h)

Weitere Informationen

ImmGetImeMenuItems

Eingabemethoden-Manager

Strukturen des Eingabemethoden-Managers