RegisterHotKey

De RegisterHotKey functie definieert een hele systeem sneltoets drukt.

BOOL RegisterHotKey ()  HWND  hWnd, / / venster sneltoets meldingen ontvangenint id, / / id van hete sleutelUINTfsModifiers, / / sleutel-modificator vlaggenUINTVK / / virtuele-key code);
 

Parameters

hWnd
Ingang naar het venster dat zal WM_HOTKEY berichten die worden gegenereerd door de hete sleutel ontvangen. Als deze parameter NULL is, WM_HOTKEY berichten zijn gepost naar de berichtenwachtrij van de aanroepende wol en moeten worden verwerkt in de lus bericht.
id
Hiermee geeft u de id van de sneltoets. Geen andere hete sleutel in de aanroepende draad moet dezelfde id hebben. Een toepassing moet een waarde opgeven in het bereik 0x0000 via 0xBFFF. Een gedeelde dynamic-link library (DLL) moet een waarde opgeven in het bereik 0xC000 tot 0xFFFF (het bereik geretourneerd door de GlobalAddAtom functie). Om conflicten te voorkomen met hot-key id's gedefinieerd door andere gedeelde DLL's, moet een dll-bestand de GlobalAddAtom functie gebruiken om de sneltoets-identificatie.
fsModifiers
Hiermee geeft u sleutels die moeten worden ingedrukt in combinatie met de sleutel opgegeven door de parameter nVirtKey om het WM_HOTKEY bericht genereren. De fsModifiers -parameter kan bestaan uit een combinatie van de volgende waarden.
Waarde Betekenis
MOD_ALT Beide alt-toets moet worden ingedrukt.
MOD_CONTROL Beide ctrl-toets moet worden ingedrukt.
MOD_SHIFT Beide shift-toets moet worden ingedrukt.
MOD_WIN Beide WINDOWS toets werd ingedrukt. Deze toetsen worden aangeduid met het Microsoft Windows-logo.

vk
Hiermee geeft u de code van de virtuele-sleutel van de hete sleutel.

Retourwaarden

Als de functie slaagt, is de retourwaarde aan nul.

Als de functie mislukt, is de retourwaarde nul. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

Wanneer een toets wordt ingedrukt, zoekt het systeem naar een wedstrijd tegen alle hete sleutels. Op een match te vinden, berichten het systeem het bericht WM_HOTKEY naar de berichtenwachtrij van de thread die de hete sleutel geregistreerd. Dit bericht is gepost naar het begin van de wachtrij, dus het is verwijderd door de volgende iteratie van de lus bericht.

Deze functie kan niet een hete sleutel associŽren met een venster dat is gemaakt door een andere thread.

RegisterHotKey mislukt als de toetsaanslagen die zijn opgegeven voor de sneltoets al is geregistreerd door een andere sneltoets.

Als het venster geÔdentificeerd door de parameter hWnd al een hete sleutel met dezelfde id als die opgegeven door de parameter id wordt geregistreerd, vervangt de nieuwe waarden voor de parameters fsModifiers en vk de eerder opgegeven waarden voor deze parameters.

Windows CE: Windows CE versie 2.0 en hoger ondersteunen een extra vlag, genaamd MOD_KEYUP, voor de parameter fsModifiers . Als u de vlag MOD_KEYUP instellen, het venster ontvangt een WM_HOTKEY-bericht op een sleutel tot gebeurtenis, alsmede op een toets ingedrukt houdt gebeurtenis.

RegisterHotKey kan worden gebruikt voor het registreren van hete sleutels over draden.

Syntaxisinfo

nbsp;†Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Niet-ondersteunde.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.

Zie ook

Toetsenbord Input overzicht, toetsenbord Input functies, GlobalAddAtom, UnregisterHotKey, WM_HOTKEY

Index