WM_SETHOTKEY bericht

Verzonden naar een venster om een sneltoets aan het venster te koppelen. Wanneer de gebruiker op de sneltoets drukt, activeert het systeem het venster.

#define WM_SETHOTKEY                    0x0032

Parameterwaarden

wParam-

De lage byte van het woord met lage volgorde geeft de code van de virtuele sleutel op die moet worden gekoppeld aan het venster.

De hoge byte van het woord met lage volgorde kan een of meer van de volgende waarden van CommCtrl.h zijn.

Waarde	Betekenis
HOTKEYF_ALT 0x04	Alt-toets
HOTKEYF_CONTROL 0x02	Ctrl-toets
HOTKEYF_EXT 0x08	Uitgebreide sleutel
HOTKEYF_SHIFT 0x01	SHIFT-toets

Het woord in hoge volgorde van wParam wordt genegeerd.

Als u wParam instelt op NULL , wordt de sneltoets verwijderd die aan een venster is gekoppeld.

lParam-

Deze parameter wordt niet gebruikt.

Retourwaarde

De retourwaarde is een van de volgende opties.

Retourwaarde	Beschrijving
-1	De functie is mislukt; de sneltoets is ongeldig.
0	De functie is mislukt; het venster is ongeldig.
1	De functie is geslaagd en er is geen ander venster met dezelfde sneltoets.
2	De functie is geslaagd, maar een ander venster heeft al dezelfde sneltoets.

Opmerkingen

Een sneltoets kan niet worden gekoppeld aan een onderliggend venster.

VK_ESCAPE, VK_SPACE, VK_TAB en VK_PACKET zijn ongeldige sneltoetsen.

Wanneer de gebruiker op de sneltoets drukt, genereert het systeem een WM_SYSCOMMAND bericht met wParam gelijk aan SC_HOTKEY en lParam gelijk aan de ingang van het venster. Als dit bericht wordt doorgegeven aan DefWindowProc, brengt het systeem de laatste actieve pop-up van het venster (indien aanwezig) of het venster zelf (als er geen pop-upvenster is) naar de voorgrond.

Een venster kan slechts één sneltoets hebben. Als er al een sneltoets aan het venster is gekoppeld, vervangt de nieuwe sneltoets de oude. Als meer dan één venster dezelfde sneltoets heeft, is het venster dat wordt geactiveerd door de sneltoets willekeurig.

Deze sneltoetsen zijn niet gerelateerd aan de sneltoetsen die zijn ingesteld door RegisterHotKey.

Behoeften

Voorwaarde	Waarde
Minimaal ondersteunde client	Windows 2000 Professional [alleen desktop-apps]
Minimaal ondersteunde server	Windows 2000 Server [alleen desktop-apps]
Koptekst	Winuser.h (inclusief Windows.h)

Zie ook

Verwijzing

RegisterHotKey-

WM_GETHOTKEY

WM_SYSCOMMAND

Conceptuele

toetsenbordinvoer