VkKeyScan

[funkcja] Tłumaczy podany znak na odpowiadający mu kod wirtualnego klawisza.

Składnia

#include <windows.h>

SHORT WINAPI VkKeyScan(
TCHAR ch
);

Argumenty

Argument	Opis
ch	Znak, który zostanie przetłumaczony na odpowiadający mu kod wirtualnego klawisza.

Zwracana wartość

Jeśli wywołanie funkcji powiedzie się, niższy bajt zwróconej wartości będzie zawierał wirtualny kod danego klawisza, a wyższy bajt dodatkowe informacje, które mogą być kombinacją następujących wartości:

Zwrócona wartość	Opis
1	Klawisz Shift jest wciśnięty.
2	Klawisz Ctrl jest wciśnięty.
4	Klawisz Alt jest wciśnięty.
8	Klawisz Hankaku jest wciśnięty.
16	Zarezerwowane.
32	Zarezerwowane.

Jeśli funkcja nie znajdzie kodu odpowiadającego danemu klawiszowi, zarówno niższy jak i wyższy bajt są ustawiane na -1.

Opis szczegółowy

Funkcja VkKeyScan tłumaczy podany znak na odpowiadający mu kod wirtualnego klawisza.

Dla układów klawiatury, które używają prawego klawisza Alt jako klawisza Shift (np. dla francuskiego układu klawiatury), stan wciśnięcia tego klawisza jest reprezentowany przez wartość 6, ponieważ jest on konwertowany wewnętrznie jako Ctrl+Alt.

Funkcja nie konwertuje znaków z klawiatury numerycznej (wirtualne klawisze od VK_NUMPAD0 do VK_DIVIDE). Jej celem jest konwertowanie znaków z głównej części klawiatury, dlatego znak '7' zostanie przetłumaczony na VK_7, a nie VK_NUMPAD7.

VkKeyScan jest używana przez aplikacje, które używają komunikatów WM_KEYUP i WM_KEYDOWN do zasygnalizowania wciśnięcia lub puszczenia klawisza.

Dodatkowe informacje

Ta funkcja została zastąpiona przez funkcję _{» WinAPI ♦}VkKeyScanEx. Można jej jednak nadal używać, jeśli nie jest potrzebne określenie układu klawiatury.

Wymagania

Minimalny obsługiwany klient	Windows 2000 Professional
Minimalny obsługiwany serwer	Windows 2000 Server
Nagłówek	Winuser.h (wewnątrz Windows.h)
Biblioteka	User32.lib
DLL	User32.dll
Nazwy Unicode i ANSI	VkKeyScanW (Unicode) i VkKeyScanA (ANSI)

Przykład

#include <windows.h>
#include <cstdio>

char wynik[ 512 ];
strcpy( wynik, "" );

SHORT result = VkKeyScan( 'A' );

sprintf( wynik, "%x", LOBYTE( result ) );
MessageBox( 0, wynik, 0, 0 );

sprintf( wynik, "%x", HIBYTE( result ) );
MessageBox( 0, wynik, 0, 0 );

Zagadnienia powiązane

VkKeyScanEx	Tłumaczy podany znak na odpowiadający mu kod wirtualnego klawisza używając podanych ustawień lokalnych. (funkcja)
GetKeyboardState	Kopiuje stan 256 wirtualnych klawiszy do podanego bufora. (funkcja)
SetKeyboardState	Kopiuje tablicę stanów poszczególnych klawiszy do odpowiedniej tablicy wywołującego wątku. (funkcja)

Linki zewnętrzne

http://msdn.microsoft.com/en-us/library/windows/desktop/ms646329(v=vs.85).aspx

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.