Udostępnij przez


komunikat WM_SETHOTKEY

Wysłane do okna w celu skojarzenia klucza gorącego z oknem. Gdy użytkownik naciśnie Hot, system aktywuje okno.

#define WM_SETHOTKEY                    0x0032

Parametry

wParam

Niski bajt słowa o niskiej kolejności określa kod klucza wirtualnego do skojarzenia z oknem.

Wysoki bajt słowa o niskiej kolejności może być co najmniej jedną z następujących wartości z commCtrl.h.

Wartość Znaczenie
HOTKEYF_ALT
0x04
ALT
HOTKEYF_CONTROL
0x02
CTRL
HOTKEYF_EXT
0x08
Klucz rozszerzony
HOTKEYF_SHIFT
0x01
SHIFT

Słowo wParam o wysokiej kolejności jest ignorowane.

Ustawienie parametru wParam na wartość NULL powoduje usunięcie klucza gorącego skojarzonego z oknem.

lParam

Ten parametr nie jest używany.

Wartość zwracana

Zwracana wartość jest jedną z następujących wartości.

Wartość zwracana Opis
-1
Funkcja nie powiodła się; klucz gorący jest nieprawidłowy.
0
Funkcja nie powiodła się; okno jest nieprawidłowe.
1
Funkcja zakończyła się pomyślnie, a żadne inne okno nie ma tego samego klucza gorącego.
2
Funkcja zakończyła się pomyślnie, ale inne okno ma już ten sam klucz dostępu.

Uwagi

Nie można skojarzyć klucza gorącego z oknem podrzędnym.

VK_ESCAPE, VK_SPACE, VK_TAB i VK_PACKET są nieprawidłowymi kluczami dostępu.

Gdy użytkownik naciśnie Hot, system generuje komunikat WM_SYSCOMMAND z parametrem wParamrównym SC_HOTKEY i lParam równy uchwytowi okna. Jeśli ten komunikat zostanie przekazany do aplikacji DefWindowProc, system wyświetli ostatnie aktywne okno podręczne (jeśli istnieje) lub samo okno (jeśli nie ma okna podręcznego) na pierwszym planie.

Okno może mieć tylko jeden gorący klucz. Jeśli okno ma już skojarzony klucz gorący, nowy klucz hot zastępuje stary. Jeśli więcej niż jedno okno ma ten sam klucz dostępu, okno aktywowane przez klucz gorący jest losowe.

Te klucze dostępu nie są powiązane z kluczami dostępu ustawionymi przez wartość RegisterHotKey.

Wymagania

Wymaganie Wartość
Minimalny obsługiwany klient
Windows 2000 Professional [tylko aplikacje klasyczne]
Minimalny obsługiwany serwer
Windows 2000 Server [tylko aplikacje klasyczne]
Nagłówek
Winuser.h (uwzględnij windows.h)

Zobacz także

Referencja

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

Pojęciowe

wprowadzanie danych z klawiatury