LoadKeyboardLayout

De functie LoadKeyboardLayout een nieuwe toetsenbordindeling in het systeem geladen. Verschillende toetsenbordindelingen tegelijk kunnen worden geladen, maar slechts één per proces is actief op een moment. Laden van meerdere toetsenbordindelingen maakt het mogelijk om snel schakelen tussen lay-outs.

HKL LoadKeyboardLayout) LPCTSTR  pwszKLID, / / naam van lay-out om te ladenUINTVlaggen / / toetsenbord lay-out vlaggen);
 

Parameters

pwszKLID
Verwijzing naar de buffer die de naam van de toetsenbordindeling aangeeft te laden. Deze naam is een tekenreeks die bestaat uit de hexadecimale waarde van de taal-id (lage "word") en een apparaat-id (hoge "word"). Engels (VS) heeft bijvoorbeeld een taal-id van 0x0409, dus de primaire U.S. English lay-out is "00000409" genoemd. Varianten van U.S. English-indeling (zoals de Dvorak-indeling) zijn met de naam "00010409", "00020409", enzovoort.
Vlaggen
Geeft aan hoe de toetsenbordindeling moet worden geladen. Deze parameter kan een van de volgende waarden worden.
Waarde Betekenis
KLF_ACTIVATE Als de opgegeven lay-out niet al is geladen, de functie ladingen en activeert u de indeling voor de huidige thread.
KLF_NOTELLSHELL Hiermee voorkomt dat een ShellProc haak procedure ontvangen een HSHELL_LANGUAGE haak code wanneer de nieuwe lay-out wordt geladen. Deze waarde wordt meestal gebruikt wanneer een toepassing wordt geladen meerdere lay-outs een na de ander. Toepassing van deze waarde op alle, maar de laatste lay-out vertragingen van de shell verwerkt totdat alle lay-outs zijn toegevoegd.
KLF_REORDER Hiermee verplaatst u de opgegeven lay-out aan het hoofd van de lijst met toetsenbord lay-outs maken die lay-out van de actieve lay-out voor de huidige thread. Deze waarde nabestellingen de lijst van toetsenbord lay-outs zelfs als KLF_ACTIVATE niet is opgegeven.
KLF_REPLACELANG Windows NT 4.0, Windows 95 en later:Als de nieuwe lay-out de dezelfde taal-id als een huidige lay-out heeft, vervangt de nieuwe lay-out het huidige als de lay-out voor die taal. Als deze waarde niet beschikbaar is en de lay-outs de dezelfde taal-id's hebben, de huidige lay-out niet is vervangen en de functie retourneert NULL.
KLF_SUBSTITUTE_OK Hiermee vervangt u de opgegeven toetsenbordindeling met een andere lay-out de voorkeur van de gebruiker. Het systeem begint met deze markering is ingesteld, en het is aanbevolen dat uw toepassing altijd gebruikt deze vlag. De vervanging treedt alleen op als de registersleutel HKEY_CURRENT_USER\Keyboard Layout\Substitutes expliciet een vervanging lay-out definieert. Bijvoorbeeld als de sleutel bevat de naam van de waarde "00000409" met de waarde "00010409", wordt laden de Amerikaans-Engelse lay-out ("00000409") de Dvorak U.S. English indeling ("00010409") moet worden geladen in plaats daarvan. Het systeem maakt gebruik van KLF_SUBSTITUTE_OK bij het opstarten, en het is aanbevolen dat alle toepassingen gebruik deze waarde wanneer u lay-outs om ervoor te zorgen dat de voorkeuren van de gebruiker is geselecteerd.
KLF_SETFORPROCESS Windows NT 5.0 en hoger:: deze vlag is alleen geldig met KLF_ACTIVATE. Hiermee activeert u het opgegeven toetsenbord lay-out voor het hele proces en verzendt het bericht WM_INPUTLANGCHANGE naar alle threads in het huidige proces. Typisch, LoadKeyboardLayout activeert een lay-out alleen voor de huidige thread.
KLF_UNLOADPREVIOUS Niet ondersteund in Windows NT 5.0, Windows 95 en Windows 98:Deze vlag is alleen geldig met KLF_ACTIVATE. De vorige lay-out wordt alleen als laden en activeren de opgegeven indeling slaagt. Het is aanbevolen dat uw toepassing gebruikt de UnloadKeyboardLayout functie in plaats daarvan.

Retourwaarden

Als de functie slaagt, is de geretourneerde waarde de greep toetsenbord lay-out naar de lay-out overeenkomt met de aangevraagde naam. Als geen overeenkomende toetsenbordindeling beschikbaar is, is de retourwaarde NULL. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

Een toepassing kan en zal meestal de standaardindeling of IME voor een taal laden en kan dit doen door te geven alleen een tekenreeksversie van de taal-id. Als een toepassing wil om een bepaalde lay-out of IME te laden, moet het register om te bepalen welke identificatie specifieke lay-out te geven aan de LoadKeyboardLayoutgelezen. In dit geval, zal een verzoek om te activeren het handvat standaard toetsenbord lay-out voor een landinstelling activeren de eerste overeenkomende één. Een specifieke IME moet worden geactiveerd met behulp van een expliciete toetsenbord lay-out handvat terug van GetKeyboardLayout, GetKeyboardLayoutListof LoadKeyboardLayout.

Windows 95 en Windows 98: Als een lay-out is om te worden geladen met dezelfde taal als een eerder geladen lay-out en de KLF_REPLACELANG vlag is niet ingesteld, mislukt de aanroep. Slechts één geladen lay-out kan worden geassocieerd met een bepaalde taal. (Het is aanvaardbaar voor meerdere IME's worden geladen met verenigingen naar dezelfde taal).

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Niet-ondersteunde.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.
Unicode:Geïmplementeerd als Unicode en ANSI-versies van Windows NT.

Zie ook

Toetsenbord Input overzicht, invoer van het toetsenbord functioneert, ActivateKeyboardLayout, GetKeyboardLayoutName, MAKELANGID,UnloadKeyboardLayout

Index