ActivateKeyboardLayout

Le implementazioni di ActivateKeyboardLayout in Windows NT e Windows 95 sono sostanzialmente differenti. Per soddisfare queste differenze, questa pagina di riferimento presenta innanzitutto l'implementazione di Windows NT nella sua interezza, seguita dalla versione di Windows 95.

nbsp;Windows &NT
La funzione ActivateKeyboardLayout attiva un layout di tastiera differente e imposta il layout di tastiera attiva per l'intero sistema, piuttosto che il thread chiamante.

(HKL ActivateKeyboardLayout HKL  hkl, / / handle al layout di tastieraUINTBandiere / / flag layout di tastiera);
 

Parametri

hkl
Handle per il layout di tastiera per essere attivato. Il layout deve caricato da una precedente chiamata alla funzione LoadKeyboardLayout . Questo parametro deve essere l'handle per il layout di tastiera o uno dei seguenti valori.
Valore Significato
HKL_NEXT Seleziona il layout successivo nell'elenco circolare di layout caricato gestite dal sistema di.
HKL_PREV Seleziona il layout precedente nell'elenco circolare di layout caricato gestite dal sistema di.

Bandiere
Specifica come deve essere attivato il layout di tastiera. Questo parametro pu essere uno dei seguenti valori.
Valore Significato
KLF_REORDER Se questo bit impostato, riordinata elenco circolare del sistema di layout di tastiera caricato. Se questo bit non impostato, l'elenco viene ruotata senza un cambiamento dell'ordine. Ad esempio, se un utente avesse un layout inglese attivo, oltre ad avere il francese, tedesco e spagnolo layout caricati (in questo ordine), quindi attivando il layout tedesco con il KLF_REORDER set bit produrrebbe il seguente ordine: tedesco, inglese, francese, spagnolo. Attivando il tedesco layout senza la KLF_REORDER set bit produrrebbe il seguente ordine: tedesco, spagnolo, inglese, francese.

Se sono caricati meno di tre layout di tastiera, il valore di questo flag irrilevante.

KLF_SETFORPROCESS Windows NT 5.0 e versioni successive: Attiva il layout di tastiera specificato per l'intero processo e invia il messaggio WM_INPUTLANGCHANGE a tutti i thread del processo corrente.
KLF_UNLOADPREVIOUS Il layout precedentemente attivo viene scaricato.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito l'handle di layout di tastiera precedente. In caso contrario, esso zero. Per ottenere informazioni di errore estese, utilizzare il funzione GetLastError.

Osservazioni

Diversi layout di tastiera possono essere caricati in qualsiasi momento, ma solo uno attivo in un momento. Caricamento pi layout di tastiera rende possibile passare rapidamente tra layout.

 Windows 95
La funzione ActivateKeyboardLayout imposta la lingua di input per il thread corrente. Questa funzione accetta un handle di layout di tastiera che identifica le impostazioni internazionali, come pure il layout fisico della tastiera.

(HKL ActivateKeyboardLayout HKL  hkl, / / handle al layout di tastieraUINTBandiere / / flag layout di tastiera);
 

Parametri

hkl
Gestire il layout di tastiera o estensione zero identificatore di lingua. Questo parametro pu essere qualsiasi handle di layout tastiera validi ottenuto utilizzando la funzione LoadKeyboardLayout o GetKeyboardLayoutList o uno dei seguenti valori.
Valore Significato
HKL_NEXT Seleziona il layout successivo nell'elenco layout tastiera gestita dal sistema di.
HKL_PREV Seleziona il layout precedente nell'elenco layout tastiere gestita dal sistema di.

Bandiere
Specifica i flag di layout di tastiera. Il valore di questo parametro pu essere:
Valore Significato
KLF_REORDER Riordina l'elenco di layout di tastiera spostando l'handle del layout di tastiera dato alla testa della lista. Se questo valore non fornito, l'elenco viene ruotata senza un cambiamento dell'ordine. Ad esempio, se un utente avesse un layout inglese attivo, oltre ad avere il francese, tedesco e spagnolo layout caricati (in questo ordine), quindi attivando il layout tedesco con il KLF_REORDER set bit produrrebbe il seguente ordine: tedesco, inglese, francese, spagnolo. Attivando il tedesco layout senza il KLF_REORDER valore impostato produrrebbe il seguente ordine: tedesco, spagnolo, inglese, francese.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito l'handle di layout di tastiera precedente. In caso contrario, esso zero. Per ottenere informazioni di errore estese, utilizzare il funzione GetLastError.

Osservazioni

Diversi layout di tastiera possono essere caricati in qualsiasi momento, ma solo uno attivo in un momento. Caricamento pi layout di tastiera rende possibile passare rapidamente tra layout.

Un'applicazione pu creare un handle del layout di tastiera valido impostando il word alto a zero e la parola bassa su un identificatore delle impostazioni internazionali. Utilizzando tali modifiche di maniglie di layout di tastiera la lingua di input senza influire sul layout fisico.

Quando multiple input method editor (IME) sono consentite per ogni locale, il passaggio di un handle di layout di tastiera in cui la parola alta (il handle del dispositivo) zero attiva l'IME prima nell'elenco "appartenenza" per le impostazioni internazionali.

Descrizione

nbsp;Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Cenni preliminari sull'Input di tastiera, funzioni di Input di tastiera, LoadKeyboardLayout, GetKeyboardLayoutName, UnloadKeyboardLayout

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index