ImmGetImeMenuItemsA-Funktion (immdev.h)

Artikel
08/24/2023

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

Syntax

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

Parameter

[in] unnamedParam1

Handle für den Eingabekontext für die angegebenen Menüelemente.

[in] unnamedParam2

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

Wert	Bedeutung
IGIMIF_RIGHTMENU	Rufen Sie die Menüelemente für das Kontextmenü ab, die durch einen Rechtsklick abgerufen werden.

[in] unnamedParam3

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

Wert	Bedeutung
IGIMII_CMODE	Rufen Sie die Menüelemente ab, die den Konvertierungsmodus steuern.
IGIMII_SMODE	Ruft 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, um eine erweiterte Möglichkeit zum Eingeben von Zeichen zu 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 denen 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, der die IMEMENUITEMINFO-Struktur empfangen soll.

Rückgabewert

Gibt die Anzahl der Menüelemente zurück, die in lpImeMenu kopiert wurden. 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 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


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps],Unterstützung für ostasiatische Sprache installiert.
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	immdev.h (einschließen von Immdev.h, Windows.h)
Bibliothek	Imm32.lib
DLL	Imm32.dll

Weitere Informationen

IMEMENUITEMINFO

Eingabemethoden-Manager

Funktionen des Eingabemethoden-Managers

Share via