ImmAssociateContextEx-Funktion (imm.h)

  • Artikel

Ändert die Zuordnung zwischen dem Eingabemethodenkontext und dem angegebenen Fenster oder den untergeordneten Elementen.

Syntax

BOOL ImmAssociateContextEx(
  [in] HWND  unnamedParam1,
  [in] HIMC  unnamedParam2,
  [in] DWORD unnamedParam3
);

Parameter

[in] unnamedParam1

Handle mit dem Fenster, das dem Eingabekontext zugeordnet werden soll.

[in] unnamedParam2

Handle mit dem Kontext der Eingabemethode.

[in] unnamedParam3

Flags, die den Typ der Zuordnung zwischen dem Fenster und dem Kontext der Eingabemethode angeben. Dieser Parameter kann einen der folgenden Werte aufweisen.

Wert Bedeutung
IACE_CHILDREN
 Ordnen Sie den Kontext der Eingabemethode nur den untergeordneten Fenstern des angegebenen Fensters zu.
IACE_DEFAULT
 Stellen Sie den Standardeingabemethodekontext des Fensters wieder her.
IACE_IGNORENOCONTEXT
 Ordnen Sie den Kontext der Eingabemethode nicht Fenstern zu, die keinem Eingabemethodenkontext zugeordnet sind.

Rückgabewert

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE .

Hinweise

Wenn die Anwendung diese Funktion mit IACE_CHILDREN aufruft, ordnet das Betriebssystem den angegebenen Eingabemethodenkontext untergeordneten Fenstern des von hWnd angegebenen Fensters zu. Der Kontext der Eingabemethode wird nur untergeordneten Fenstern des Threads zugeordnet, der hWnd erstellt. Alle untergeordneten Fenster, die nach dem Aufruf dieser Funktion erstellt werden, sind nicht betroffen. Stattdessen wird ihr der Standardeingabemethodenkontext zugeordnet.

Wenn die Anwendung diese Funktion mit IACE_DEFAULT aufruft, stellt das Betriebssystem den Standardeingabemethodenkontext für das Fenster wieder her. In diesem Fall wird der hIMC-Parameter ignoriert.

Anforderungen

   
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 imm.h (include Immdev.h, Windows.h)
Bibliothek Imm32.lib
DLL Imm32.dll

Weitere Informationen

Eingabemethoden-Manager

Funktionen des Eingabemethoden-Managers