GetKeyNameText

Funkcja GetKeyNameText pobiera ciąg, który reprezentuje nazwę klucza.

int GetKeyNameText ( LONG  fikcyjnymi, / / drugi parametr komunikatu klawiaturyLPTSTRlpString, / / wskaźnik do buforu dla nazwy kluczaintnSize / / maksymalna długość nazwa klucza ciąg znaków długości);
 

Parametry

fikcyjnymi

Określa drugi parametr wiadomości klawiatury (np. WM_KEYDOWN), mają zostać przetworzone. Funkcja interpretuje następujące fragmenty fikcyjnymi.

Bity	Znaczenie
16-23	Skanowanie kodu.
24	Flaga klucz rozszerzony. Rozróżnia niektóre klawisze na klawiaturę rozszerzoną.
25	"Don't care" bitów. Aplikacja wywołaniu tej funkcji ustawia ten bit wskazuje, że funkcja powinna nie rozróżnia lewy i prawy ctrl i klawisze shift, na przykład.

lpString

Wskaźnik do buforu, który będzie odbierał nazwa klucza.

nSize

Określa maksymalną długość, liter, nazwy klucza, włączając kończącego znaku null. (Ten parametr powinna być równa rozmiarowi buforu wskazywanego przez parametr lpString ).

Zwraca wartości

Jeśli funkcja, ciąg zakończony znakiem null jest kopiowana do buforu, a wartość zwracany jest długość ciągów znaków, nie licząc kończącego znaku null.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Format ciągu nazwa klucza zależy od bieżący układ klawiatury. Sterownik klawiatury utrzymuje listę nazw w postaci ciągów znaków dla kluczy z nazwy dłuższe niż pojedynczy znak. Nazwa klucza jest tłumaczony zgodnie z układem klawiatury aktualnie zainstalowany. Nazwa klucza znak jest sam znak. Nazwy kluczy martwych etykietkami są w pełni.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Należy użyć user32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Przegląd danych wejściowych klawiatura, funkcji wprowadzania klawiatury

Index