LoadKeyboardLayout

Funcția LoadKeyboardLayout încarcă un nou aspect tastatură în sistem. Mai multe structuri de tastatură pot fi încărcate la un moment dat, dar numai unul per proces este activă la un moment. Încărcare mai multe structuri de tastatură face posibilă pentru a comuta rapid între layouts.

(HKL LoadKeyboardLayout LPCTSTR  pwszKLID, / / numele de aspect pentru a încărcaUINTSteaguri / / keyboard layout steaguri);
 

Parametrii

pwszKLID
Indicatorul către buffer-ul care specifică numele de structura tastaturii pentru a încărca. Acest nume este un șir format din valoarea hexazecimală identificatorul de limbă (word scăzut) și un identificator de dispozitiv (mare word). De exemplu, engleză s.u.a. are un identificator limbă de 0x0409, astfel încât aspectul Română de U.S. primară este numit "00000409". Variante de U.S. engleză aspect (cum ar fi aspectul Dvorak) sunt denumite "00010409", "00020409", și așa mai departe.
Steaguri
Specifică modul în care structura tastaturii este să fie încărcate. Acest parametru poate fi una dintre următoarele valori.
Valoarea Sensul
KLF_ACTIVATE Dacă aspectul specificat nu este deja încărcat, funcția încarcă și activează aspectul pentru firul de execu?ie curent.
KLF_NOTELLSHELL Împiedică primirea un cod de cârlig HSHELL_LANGUAGE atunci când noul aspect este încărcat o procedură de cârlig ShellProc . Această valoare este de obicei folosit atunci când o cerere mai multe machete una după alta. Aplicând această valoare tuturor aspectul ultima întârzieri de shell prelucrare până când s-au adăugat toate machetele.
KLF_REORDER Se mută aspectul specificate la cap de lista de dispuneri de tastatură, face că aspectul aspectul active pentru firul de execu?ie curent. Această valoare reordonează lista de dispuneri de tastatură, chiar dacă nu este furnizată KLF_ACTIVATE.
KLF_REPLACELANG Windows NT 4.0, Windows 95, și mai târziu:Dacă noul aspect are același Identificator limbă ca un aspect curent, noul aspect înlocuiește cel curent ca aspect pentru acea limbă. Dacă această valoare nu este furnizată și structurile au același identificatorii de limbă, aspectul curent nu este înlocuit și funcția întoarce NULL.
KLF_SUBSTITUTE_OK Înlocuitori de structura tastaturii specificate cu un alt aspect preferat de utilizator. Sistemul începe cu acest set de pavilion și se recomandă că aplicația întotdeauna utilizați acest flag. Înlocuirea apare numai dacă cheia de registry HKEY_CURRENT_USER\Keyboard Layout\Substitutes definește în mod explicit un aspect de înlocuire. De exemplu, dacă cheia include nume de valoare "00000409" cu valoarea "00010409", încărcare engleză s.u.a. aspect ("00000409") determină aspectul engleză Dvorak U.S. ("00010409") să fie încărcate în schimb. Sistemul utilizează KLF_SUBSTITUTE_OK atunci când cizme, și se recomandă că toate aplicații utilizează această valoare atunci când încărcarea machete pentru a asigurați-vă că este selectată preferința utilizatorului.
KLF_SETFORPROCESS Windows NT 5.0 și mai târziu:: acest flag este valabil numai cu KLF_ACTIVATE. Aspectul tastatură specificate pentru întregul proces se activează și trimite mesajul WM_INPUTLANGCHANGE pentru toate subiectele în procesul curent. De obicei, LoadKeyboardLayout activează un aspect numai de firul de execu?ie curent.
KLF_UNLOADPREVIOUS Neacceptate în Windows NT 5.0, Windows 95, Windows 98 și:Acest flag este valabil cu KLF_ACTIVATE. Descarcă aspectul anterior numai dacă reușește de încărcare și activarea aspectul specificate. Se recomandă că aplicația utilizează funcția UnloadKeyboardLayout în schimb.

Valorile întroarse

Dacă funcția reușește, valoarea returnată este ghidajul de aspect tastatură aspect potrivit cu numele solicitate. Dacă nici o potrivire aspect tastatură este disponibil, valoarea returnată este NULL. Pentru a obține extins informa?ii eroare, apel GetLastError.

Observații

Cererea poate și de obicei va încărca aspectul implicit sau IME pentru o limbă și puteți face acest lucru prin specificarea numai o versiune șir de identificatorul de limbă. Dacă o aplicație vrea pentru a încărca un anumit aspect sau IME, acesta ar trebui să citiți registry pentru a determina identificatorul aspect specific să treacă la LoadKeyboardLayout. În acest caz, o cerere pentru a activa ghidajul aspect tastatură implicită pentru a locale va activa o potrivire prima. Un IME specifice ar trebui să fie activat folosind un mâner de aspect tastatură explicită s-a întors la GetKeyboardLayout, GetKeyboardLayoutListsau LoadKeyboardLayout.

Windows 95 și Windows 98: Dacă un aspect este de a fi încărcate cu aceea?i limbă ca un aspect anterior încărcate și KLF_REPLACELANG pavilion este nu set, apelul nu reușește. Doar un singur aspect încărcat pot fi asociate cu o anumită limbă. (Este acceptabil pentru IME multiple să fie încărcate cu asociațiile de același limbaj).

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Neacceptat.
Antet:A declarat în winuser.h.
Import Biblioteca:Utilizarea user32.lib.
Unicode:Pus în aplicare ca Unicode și ANSI versiuni Windows NT.

A se vedea, de asemenea

Tastatură intrare prezentare generală, funcții de Input tastatură, ActivateKeyboardLayout, GetKeyboardLayoutName, MAKELANGID,UnloadKeyboardLayout

Index