RegisterHotKey

Funksjonen RegisterHotKey definerer en systemomfattende varm nøkkelen.

BOOL RegisterHotKey) HWND  hWnd, / / vindu til å motta varsler for hurtigtastInt id, / / identifikator for hurtigtastUINTfsModifiers, / / nøkkel-modifikator flagsUINTVK / / virtual-key kode);
 

Parametere

hWnd

Håndtere til vinduet som skal motta WM_HOTKEY meldinger som genereres av hurtigtasten. Hvis denne parameteren er NULL, WM_HOTKEY meldinger posteres til meldingskøen kallende trådens og må behandles i meldingsløkke.

id

Angir identifikatoren til hurtigtasten. Ingen andre hurtigtasten i kallende tråden bør ha samme identifikator. Et program må angi en verdi i området 0x0000 gjennom 0xBFFF. Et delt bibliotek for dynamiske koblinger (DLL) må angi en verdi i området 0xC000 gjennom 0xFFFF (området som returneres av den GlobalAddAtom funksjonen). For å unngå konflikter med hurtigtast-identifikatorer som er definert av andre delte DLL-filer, skal en DLL-fil bruke funksjonen GlobalAddAtom for å få identifikatoren hurtigtast.

fsModifiers

Angir nøkler må være trykket i kombinasjon med nøkkelen som er angitt av parameteren nVirtKey for å generere WM_HOTKEY-meldingen. FsModifiers -parameteren kan være en kombinasjon av følgende verdier.

Verdi	Betydning
MOD_ALT	Enten alt-tasten må holdes nede.
MOD_CONTROL	Enten ctrl-tast må holdes.
MOD_SHIFT	Enten Skift-tast må holdes.
MOD_WIN	Enten WINDOWS-nøkkel ble holdt. Disse nøklene er merket med Microsoft Windows-logoen.

vk

Angir virtual-key koden for varm nøkkelen.

Returverdier

Hvis funksjonen lykkes, er returverdien ikke-null.

Hvis funksjonen mislykkes, er verdien som returneres Null. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Når du trykker på en tast, søker systemet etter en kamp mot alle hurtigtaster. Ved å finne en match, posterer systemet WM_HOTKEY meldingen til meldingskøen av tråden som registrert på hurtigtasten én. Denne meldingen er lagt inn til begynnelsen av køen slik at det er fjernet ved neste gjentakelse av løkken melding.

Denne funksjonen kan ikke knytte en hurtigtast til et vindu som er opprettet av en annen tråd.

RegisterHotKey mislykkes hvis tastetrykk som er angitt for hurtigtasten som allerede er registrert av en annen varm tast.

Hvis vinduet identifisert av parameteren hWnd allerede registrert en varm nøkkelen med den samme identifikatoren som som angitt av parameteren id , erstatte de nye verdiene for parameterne fsModifiers og vk de tidligere angitte verdiene for disse parameterne.

Windows CE: Windows CE versjon 2.0 og senere støtter en ekstra flagg, kalt MOD_KEYUP, for fsModifiers -parameteren. Hvis du angir MOD_KEYUP-flagg, vil vinduet bli sendt en melding i WM_HOTKEY på en nøkkel opp hendelsen, så vel som på en nøkkel-eventen.

RegisterHotKey kan brukes til å registrere het keys over tråder.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.

Se også

Tastatur Input oversikt, tastatur Input funksjoner, GlobalAddAtom, UnregisterHotKey, WM_HOTKEY

Index