LoadKeyboardLayout

Funksjonen LoadKeyboardLayout laster inn en ny tastaturoppsett i systemet. Flere tastaturoppsett, kan lastes om gangen, men bare én per prosess er aktiv om gangen. Laster inn flere tastaturoppsett gjør det mulig å raskt bytte mellom oppsett.

() HKL LoadKeyboardLayout LPCTSTR  pwszKLID, / / navn på oppsett for å laste innUINTFlagg / / tastatur oppsett flagg);
 

Parametere

pwszKLID
Pekeren til bufferen som angir navnet på tastaturoppsettet til å laste inn. Dette navnet er en streng som består av den heksadesimale verdien av den språkidentifikator (lav word) og en enhet identifikator (høy word). For eksempel har amerikansk engelsk en språk-ID for 0x0409, slik at den viktigste U.S. English layouten heter "00000409". Varianter av U.S. English oppsett (for eksempel Dvorak-oppsett) er kalt "00010409", "00020409" og så videre.
Flagg
Angir hvordan tastaturoppsettet er lastes inn. Denne parameteren kan være en av følgende verdier.
Verdi Betydning
KLF_ACTIVATE Hvis det angitte oppsettet ikke er allerede lastet, funksjonen laster og aktiverer oppsettet for gjeldende tråd.
KLF_NOTELLSHELL Forhindrer at en ShellProc Bindingsprosedyren motta en HSHELL_LANGUAGE krok koden når det nye oppsettet er lastet. Denne verdien brukes vanligvis når et program laster inn flere layouts etter hverandre. Å bruke denne verdien til alle men siste oppsettet forsinker grensesnittets behandling til alle oppsett har blitt lagt til.
KLF_REORDER Flytter det angitte oppsettet til leder av tastatur oppsett-listen, gjør at oppsettet aktive oppsettet for gjeldende tråd. Denne verdien omorganiserer tastatur oppsett-listen, selv om KLF_ACTIVATE ikke er angitt.
KLF_REPLACELANG Windows NT 4.0, Windows 95 og senere:Hvis det nye oppsettet har samme språkidentifikatoren som et gjeldende oppsett, erstatter den gjeldende som oppsettet for dette språket i det nye oppsettet. Hvis denne verdien ikke er angitt, og oppsettene har samme språk-IDer, erstattes ikke det gjeldende oppsettet, og funksjonen returnerer NULL.
KLF_SUBSTITUTE_OK Erstatter angitte tastaturoppsettet med et annet oppsett som er foretrukket av brukeren. Systemet starter med dette flagget satt, og det anbefales at programmet alltid skal bruke dette flagget. Substitusjon oppstår bare hvis registernøkkelen HKEY_CURRENT_USER\Keyboard Layout\Substitutes eksplisitt definerer et oppsett for ressurserstatting. For eksempel Hvis nøkkelen inneholder verdinavnet "00000409" med verdien "00010409", forårsaker lasting amerikansk-engelsk oppsett ("00000409") Dvorak U.S. English oppsettet ("00010409") som skal lastes inn i stedet. Systemet bruker KLF_SUBSTITUTE_OK når du starter opp, og det anbefales at alle programmer bruker denne verdien ved innlasting av oppsett slik at det er merket av for brukerens preferanser.
KLF_SETFORPROCESS Windows NT 5.0 og senere:: Dette flagget er bare gyldig for KLF_ACTIVATE. Aktiverer det angitte tastaturoppsettet for hele prosessen, og sender den WM_INPUTLANGCHANGE til alle tråder i den gjeldende prosessen. Vanligvis aktiverer LoadKeyboardLayout et oppsett bare for gjeldende tråd.
KLF_UNLOADPREVIOUS Støttes ikke i Windows NT 5.0, Windows 95 og Windows 98:Dette flagget er bare gyldig med KLF_ACTIVATE. Laster ut forrige oppsettet bare hvis lasting og aktivere det angitte oppsettet er vellykket. Det anbefales at programmet bruker funksjonen UnloadKeyboardLayout i stedet.

Returverdier

Hvis funksjonen er vellykket, er returverdien tastatur oppsett håndtaket i oppsettet som passet med det ønskede navnet. Hvis ingen samsvarende tastaturoppsett er tilgjengelig, er verdien som returneres NULL. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Et program kan og laste vanligvis standardoppsettet eller IME for et språk og kan gjøre dette ved å angi bare en strengversjon av språkidentifikatoren. Hvis et program ønsker å laste inn et bestemt oppsett eller IME, skal det stå i registret for å bestemme bestemt oppsett-identifikatoren til å sende til LoadKeyboardLayout. I dette tilfellet vil en forespørsel om å aktivere den standard tastatur oppsett referansen for en nasjonal innstilling aktivere den første samsvarende. En bestemt IME bør aktiveres ved hjelp av et tastatur som eksplisitt oppsett håndtak som returneres fra GetKeyboardLayout, GetKeyboardLayoutListeller LoadKeyboardLayout.

Windows 95 og Windows 98: Hvis et oppsett er blir lastet med samme språk som et tidlegare lagra oppsett og KLF_REPLACELANG flagget er ikke sett, kallet mislykkes. Bare ett lastet oppsett kan være forbundet med et bestemt språk. (Det er akseptabelt for flere IME-programmer lastes med tilknytninger til samme språk.)

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.
Unicode:Implementert som Unicode- og ANSI-versjoner på Windows NT.

Se også

Tastatur Input oversikt, inndata fra tastaturet fungerer, ActivateKeyboardLayout, GetKeyboardLayoutName, MAKELANGID,UnloadKeyboardLayout

Index