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) |