ImmGetImeMenuItemsW-Funktion (immdev.h)

Artikel
08/24/2023

Ruft die Menüelemente ab, die im IME-Menü eines angegebenen Eingabekontexts registriert sind.

Syntax

DWORD ImmGetImeMenuItemsW(
  [in]            HIMC               unnamedParam1,
  [in]            DWORD              unnamedParam2,
  [in]            DWORD              unnamedParam3,
  [out, optional] LPIMEMENUITEMINFOW lpImeParentMenu,
  [out, optional] LPIMEMENUITEMINFOW lpImeMenu,
  [in]            DWORD              dwSize
);

Parameter

[in] unnamedParam1

Handle mit dem Eingabekontext für die angegebenen Menüelemente.

[in] unnamedParam2

Flag, das Menüinformationsoptionen angibt. Der folgende Wert wird definiert.

Wert	Bedeutung
IGIMIF_RIGHTMENU	Rufen Sie die Menüelemente für das Kontextmenü ab, die mit der rechten Maustaste abgerufen werden.

[in] unnamedParam3

Typ des abzurufenden Menüs. Dieser Parameter kann mindestens einen der folgenden Werte aufweisen.

Wert	Bedeutung
IGIMII_CMODE	Rufen Sie die Menüelemente ab, die den Konvertierungsmodus steuern.
IGIMII_SMODE	Rufen Sie die Menüelemente ab, die den Satzmodus steuern.
IGIMII_CONFIGURE	Rufen Sie die Menüelemente ab, die sich auf die IME-Konfiguration beziehen.
IGIMII_TOOLS	Rufen Sie die Menüelemente ab, die sich auf IME-Tools beziehen.
IGIMII_HELP	Rufen Sie die Menüelemente ab, die die IME-Hilfe steuern.
IGIMII_OTHER	Rufen Sie die Menüelemente ab, die andere IME-Funktionen steuern.
IGIMII_INPUTTOOLS	Rufen Sie die Menüelemente ab, die Menüelemente im Zusammenhang mit IME-Eingabetools steuern und eine erweiterte Möglichkeit zum Eingeben von Zeichen bieten.

[out, optional] lpImeParentMenu

Zeiger auf eine IMEMENUITEMINFO-Struktur , in der die Funktion Informationen zum übergeordneten Menü abruft. Um Informationen zu den Untermenüelementen dieses übergeordneten Menüs abzurufen, legt die Anwendung das fType-Element auf MFT_SUBMENU fest. Dieser Parameter enthält NULL , wenn die Funktion nur Menüelemente der obersten Ebene abruft.

[out, optional] lpImeMenu

Zeiger auf ein Array von IMEMENUITEMINFO-Strukturen , in dem die Funktion Informationen zu den Menüelementen abruft. Dieser Parameter enthält NULL , wenn die Funktion die Anzahl der registrierten Menüelemente abruft.

[in] dwSize

Größe des Puffers, um die IMEMENUITEMINFO-Struktur zu empfangen.

Rückgabewert

Gibt die Anzahl der in lpImeMenu kopierten Menüelemente zurück. Wenn lpImeMenuNULL angibt, gibt die Funktion die Anzahl der registrierten Menüelemente im angegebenen Eingabekontext zurück.

Hinweise

Hinweis

Der immdev.h-Header definiert ImmGetImeMenuItems als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps],Ostasiatische Sprachunterstützung installiert.
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	immdev.h (einschließen immdev.h, Windows.h)
Bibliothek	Imm32.lib
DLL	Imm32.dll

Weitere Informationen

IMEMENUITEMINFO

Eingabemethoden-Manager

Funktionen des Eingabemethoden-Managers

Share via