IMEMENUITEMINFOW-Struktur (imm.h)
Enthält Informationen zu IME-Menüelementen.
Syntax
typedef struct tagIMEMENUITEMINFOW {
UINT cbSize;
UINT fType;
UINT fState;
UINT wID;
HBITMAP hbmpChecked;
HBITMAP hbmpUnchecked;
DWORD dwItemData;
WCHAR szString[IMEMENUITEM_STRING_SIZE];
HBITMAP hbmpItem;
} IMEMENUITEMINFOW, *PIMEMENUITEMINFOW, *NPIMEMENUITEMINFOW, *LPIMEMENUITEMINFOW;
Members
cbSize
Größe der Struktur in Bytes.
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 hbmpChecked-ElementNULL 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 mindestens einen 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ü darf 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 deaktivierten 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 mit der Bitmap, die neben dem Element angezeigt werden soll, wenn es aktiviert ist. Wenn dieses Element NULL ist, wird eine Standard-Bitmap verwendet. Wenn der Wert IMFT_RADIOCHECK Typs angegeben wird, ist die Standardbitte ein Aufzählungszeichen. Andernfalls ist es ein Häkchen.
hbmpUnchecked
Behandeln Sie die Bitmap, die neben dem Element angezeigt werden soll, wenn sie nicht aktiviert ist. Wenn dieses Element 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-beendete Zeichenfolge.
hbmpItem
Handle mit einer anzuzeigenden 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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
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) |