Dela via


WM_SETHOTKEY meddelande

Skickas till ett fönster för att associera en snabbnyckel med fönstret. När användaren trycker på snabbtangenten aktiverar systemet fönstret.

#define WM_SETHOTKEY                    0x0032

Parameterar

wParam

Det låga bytet av lågordningsordet anger den virtuella nyckelkod som ska associeras med fönstret.

Det höga bytet av lågordningsordet kan vara ett eller flera av följande värden från CommCtrl.h.

Värde Innebörd
HOTKEYF_ALT
0x04
ALT-nyckel
HOTKEYF_CONTROL
0x02
CTRL-tangent
HOTKEYF_EXT
0x08
Utökad nyckel
HOTKEYF_SHIFT
0x01
Skift

Ord med hög ordning i wParam ignoreras.

Om du anger wParam till NULL tar du bort den frekventa nyckel som är associerad med ett fönster.

lParam

Den här parametern används inte.

Returvärde

Returvärdet är något av följande.

Returvärde Beskrivning
-1
Funktionen misslyckas. den aktiva nyckeln är ogiltig.
0
Funktionen misslyckas. fönstret är ogiltigt.
1
Funktionen lyckas och inget annat fönster har samma snabbnyckel.
2
Funktionen lyckas, men ett annat fönster har redan samma snabbnyckel.

Anmärkningar

En snabbnyckel kan inte associeras med ett underordnat fönster.

VK_ESCAPE, VK_SPACE, VK_TAB och VK_PACKET är ogiltiga snabbtangenter.

När användaren trycker på snabbtangenten genererar systemet ett WM_SYSCOMMAND meddelande med wParam lika med SC_HOTKEY och lParam lika med fönstrets handtag. Om det här meddelandet skickas vidare till DefWindowProc kommer systemet att föra fönstrets sista aktiva popup-fönster (om det finns) eller själva fönstret (om det inte finns något popup-fönster) till förgrunden.

Ett fönster kan bara ha en snabbnyckel. Om fönstret redan har en associerad snabbnyckel ersätter den nya snabbnyckeln den gamla. Om fler än ett fönster har samma snabbnyckel är fönstret som aktiveras av den aktiva nyckeln slumpmässigt.

Dessa snabbnycklar är inte relaterade till de snabbnycklar som anges av RegisterHotKey.

Kravspecifikation

Krav Värde
Lägsta klient som stöds
Windows 2000 Professional [endast skrivbordsappar]
Lägsta server som stöds
Windows 2000 Server [endast skrivbordsappar]
Rubrik
Winuser.h (inkludera Windows.h)

Se även

Referens

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

Konceptuellt

Tangentbordsinmatning