VkKeyScanEx

[funkcja] Tłumaczy podany znak na odpowiadający mu kod wirtualnego klawisza używając podanych ustawień lokalnych.

Składnia

#include <windows.h>

SHORT WINAPI VkKeyScanEx(
TCHAR ch,
HKL dwhkl
);

Argumenty

Argument	Opis
ch	Znak, który zostanie przetłumaczony na odpowiadający mu kod wirtualnego klawisza.
dwhkl	Lokalny identyfikator wejścia używany do przetłumaczenia danego znaku. Użyj funkcji _{» WinAPI ♦}LoadKeyboardLayout, aby go uzyskać.

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 VkKeyScanEx tłumaczy podany znak na odpowiadający mu kod wirtualnego klawisza.

Identyfikator wejścia jest pojęciem szerszym niż układ klawiatury, ponieważ może on obejmować również konwerter speech-to-text, edytor IME, lub inne formy wejścia.

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.

VkKeyScanEx 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 zastąpiła funkcję _{» WinAPI ♦}VkKeyScan.

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	VkKeyScanExW (Unicode) i VkKeyScanExA (ANSI)

Przykład

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

SHORT result = VkKeyScanEx( 'A', LoadKeyboardLayout( "00000415", KLF_ACTIVATE ) ); //00000415 to identyfikator j. polskiego

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

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

Zagadnienia powiązane

VkKeyScan	Tłumaczy podany znak na odpowiadający mu kod wirtualnego klawisza. (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)
LoadKeyboardLayout	Ładuje nowy lokalny identyfikator układu wejścia do systemu. (funkcja)

Linki zewnętrzne

http://msdn.microsoft.com/en-us/library/windows/desktop/ms646332(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.