ActivateKeyboardLayout

Die Implementierungen der ActivateKeyboardLayout in Windows NT und Windows 95 sind erheblich unterschiedlich. Um diesen Unterschieden Rechnung zu tragen, stellt diese Referenzseite zunächst die Windows NT-Implementierung in ihrer Gesamtheit, gefolgt von der Windows 95-version.

&Nbsp;Windows NT
Die ActivateKeyboardLayout -Funktion ein anderes Tastaturlayout aktiviert und setzt das aktive Tastaturlayout für den aufrufenden Thread, anstatt das gesamte system.

HKL ActivateKeyboardLayout) HKL  Hkl, / / handle für das TastaturlayoutUINTFlags / / Tastatur Layout Flaggen);
 

Parameter

hkl
Handle für das Tastaturlayout aktiviert werden. Das Layout muss von einem vorherigen Aufruf der Funktion LoadKeyboardLayout geladen wurden. Dieser Parameter muss entweder das Handle für ein Tastatur-Layout oder einer der folgenden Werte sein.
Wert Bedeutung
HKL_NEXT Wählt das nächste Layout in der kreisförmigen Liste der geladenen Layouts vom System verwaltet.
HKL_PREV Wählt das vorherige Layout in der kreisförmigen Liste der geladenen Layouts vom System verwaltet.

Flaggen
Gibt an, wie das Layout das Tastatur aktiviert werden. Dieser Parameter kann eine der folgenden Werte sein:.
Wert Bedeutung
KLF_REORDER Wenn dieses Bit gesetzt ist, wird das System kreisförmige Liste der Tastaturlayouts geladen nachbestellt. Wenn dieses Bit nicht festgelegt ist, wird die Liste ohne eine Änderung der Reihenfolge gedreht. Beispielsweise, wenn ein Benutzer eine aktive englische Layout hatte, als auch Französisch, Deutsch und Spanisch-Layouts geladen (in dieser Reihenfolge), dann aktivieren das deutsche Layout mit der KLF_REORDER-Bit gesetzt würde produzieren die folgende Reihenfolge: Deutsch, Englisch, Französisch, Spanisch. Aktivierung des deutschen Layouts ohne die KLF_REORDER-Bit gesetzt würde produzieren den folgenden Reihenfolge: Deutsch, Spanisch, Englisch, Französisch.

Wenn weniger als drei Tastaturlayouts geladen sind, ist der Wert dieses Flags irrelevant.

KLF_SETFORPROCESS Windows NT 5.0 und höher: Aktiviert das angegebene Tastaturlayout für den gesamten Prozess und sendet die WM_INPUTLANGCHANGE-Nachricht an alle Threads im aktuellen Prozess.
KLF_UNLOADPREVIOUS Das zuvor aktive Layout wird entladen.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das vorherige Tastatur-Layout-Handle. Andernfalls ist er NULL. Verwenden Sie Fehlerinformationen verlängert zu bekommen, die GetLastError -Funktion.

Bemerkungen

Mehrere Tastaturlayouts können jederzeit geladen werden, aber nur zu einem Zeitpunkt aktiv ist. Laden mehrere Tastaturlayouts macht es möglich, schnell zwischen den Layouts wechseln.

&Nbsp;Windows 95
Die Funktion ActivateKeyboardLayout setzt die Eingabesprache für den aktuellen Thread. Diese Funktion akzeptiert einen Tastatur-Layout-Handle, der ein Gebietsschema sowie das physische Layout der Tastatur identifiziert.

HKL ActivateKeyboardLayout) HKL  Hkl, / / handle für das TastaturlayoutUINTFlags / / Tastatur Layout Flaggen);
 

Parameter

jk.
Handle für ein Tastatur-Layout oder ein NULL-extended Sprachbezeichner. Dieser Parameter kann jeder gültige Tastatur Layout Handle mithilfe der LoadKeyboardLayout oder GetKeyboardLayoutList -Funktion oder einer der folgenden Werte sein.
Wert Bedeutung
HKL_NEXT Wählt das nächste Layout in der Tastatur-Layouts-Liste vom System verwaltet.
HKL_PREV Wählt das vorherige Layout in der keyboard-Layout-Liste vom System verwaltet.

Flaggen
Gibt die Tastatur-Layout-Flags. Der Wert dieses Parameters kann sein:
Wert Bedeutung
KLF_REORDER Ordnet neu an die Tastatur-Layouts-Liste von bestimmten Tastatur-Layout-Handle auf den Kopf der Liste zu verschieben. Wenn dieser Wert nicht angegeben ist, wird die Liste ohne eine Änderung der Reihenfolge gedreht. Beispielsweise, wenn ein Benutzer eine aktive englische Layout hatte, als auch Französisch, Deutsch und Spanisch-Layouts geladen (in dieser Reihenfolge), dann aktivieren das deutsche Layout mit der KLF_REORDER-Bit gesetzt würde produzieren die folgende Reihenfolge: Deutsch, Englisch, Französisch, Spanisch. Aktivieren das deutsche Layout ohne die KLF_REORDER festgelegte Wert ergibt die folgende Reihenfolge: Deutsch, Spanisch, Englisch, Französisch.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das vorherige Tastatur-Layout-Handle. Andernfalls ist er NULL. Verwenden Sie Fehlerinformationen verlängert zu bekommen, die GetLastError -Funktion.

Bemerkungen

Mehrere Tastaturlayouts können jederzeit geladen werden, aber nur zu einem Zeitpunkt aktiv ist. Laden mehrere Tastaturlayouts macht es möglich, schnell zwischen den Layouts wechseln.

Eine Anwendung kann einen gültige Tastatur-Layout-Handle erstellen, indem Sie das hohe Word auf 0 (null) und das niedrige Word ein Gebietsschemabezeichner. Mithilfe solcher Tastatur Layout Griffe Änderungen der Eingabesprache ohne Auswirkungen auf das physische layout.

Wenn mehrere Eingabemethoden-Editoren (IMEs) für jedes Gebietsschema zulässig sind, aktiviert übergeben ein Tastatur-Layout-Handle in dem das hohe Word (Das Gerätehandle) 0 (null) ist den ersten IME in der Liste "gehören" das Gebietsschema.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.

Siehe auch

Übersicht über die Tastatur-Eingabe, Keyboard Input Funktionen, LoadKeyboardLayout, GetKeyboardLayoutName, UnloadKeyboardLayout

Index