ImmGetImeMenuItemsA-Funktion (immdev.h)

Artikel
11/20/2024

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

Behandeln sie den Eingabekontext für die angegebenen Menüelemente.

[in] unnamedParam2

Kennzeichnung, die 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 einen oder mehrere 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 mit der IME-Konfiguration zusammenhängen.
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, die eine erweiterte Möglichkeit für Eingabezeichen bieten.

[out, optional] lpImeParentMenu

Zeigen Sie auf eine IMEMENUITEMINFO Struktur, in der die Funktion übergeordnete Menüinformationen abruft. Um Informationen zu den Untermenüelementen dieses übergeordneten Menüs abzurufen, legt die Anwendung den fType Member 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, um die IMEMENUITEMINFO Struktur zu empfangen.

Rückgabewert

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

Bemerkungen

Anmerkung

Der header immdev.h 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

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [Desktop-Apps nur],Ostasiatische Sprachunterstützung installiert.
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	immdev.h (include Immdev.h, Windows.h)
Library	Imm32.lib
DLL-	Imm32.dll

Siehe auch

IMEMENUITEMINFO

Eingabemethoden-Manager

Funktionen des Eingabemethoden-Managers

Freigeben über