GetKeyNameText

La funzione GetKeyNameText recupera una stringa che rappresenta il nome di una chiave.

int (GetKeyNameText LONG  lParam, / / secondo parametro del messaggio di tastieraLPTSTRlpString, / / puntatore buffer per nome della chiaveintnSize / lunghezza massima del nome della chiave di lunghezza: String);
 

Parametri

lParam
Specifica il secondo parametro del messaggio (ad esempio WM_KEYDOWN) tastiera da elaborare. La funzione interpreta le seguenti parti di lParam.
Bit Significato
16-23 Analisi codice.
24 Bandiera esteso-chiave. Distingue alcuni tasti su una tastiera avanzata.
25 Po ' "Non interessa". L'applicazione chiamare questa funzione imposta questo bit per indicare che la funzione dovrebbe non distinguere tra destra e sinistra ctrl e MAIUSC, ad esempio.

lpString
Puntatore a un buffer che riceverà il nome della chiave.
nSize
Specifica la lunghezza massima, in caratteri, di nome della chiave, tra cui il carattere di terminazione null. (Questo parametro deve essere uguale alla dimensione del buffer a cui puntata il parametro lpString ).

Valori restituiti

Se la funzione ha esito positivo, una stringa null-terminated viene copiata nel buffer specificato e il valore restituito è la lunghezza della stringa, in caratteri, senza contare il carattere di terminazione null.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

Il formato della stringa nome chiave dipende il layout di tastiera corrente. Il driver della tastiera mantiene un elenco di nomi sotto forma di stringhe di caratteri per i tasti con nomi più lunghi di un singolo carattere. Il nome della chiave è tradotto il layout della tastiera correntemente installato. Il nome di un personaggio chiave è il carattere stesso. I nomi dei tasti morti sono precisati in pieno.

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.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Cenni preliminari sull'Input di tastiera, funzioni di Input di tastiera

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

Index