CHotKeyCtrl osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Biztosítja a Gyakori windowsos gyorsbillentyű-vezérlő funkcióit.

Szemantika

class CHotKeyCtrl : public CWnd

Tagok

Nyilvános konstruktorok

Név	Description
CHotKeyCtrl::CHotKeyCtrl	Egy CHotKeyCtrl objektumot hoz létre.

Nyilvános metódusok

Név	Description
CHotKeyCtrl::Létrehozás	Létrehoz egy gyorsbillentyű-vezérlőt, és csatolja egy CHotKeyCtrl objektumhoz.
CHotKeyCtrl::CreateEx	Létrehoz egy gyorsbillentyű-vezérlőt a windowsos bővített stílusokkal, és csatolja egy CHotKeyCtrl objektumhoz.
CHotKeyCtrl::GetHotKey	Lekéri egy gyorsbillentyű-vezérlő virtuális kulcskódját és módosító jelzőit.
CHotKeyCtrl::GetHotKeyName	Lekéri a kulcs nevét a helyi karakterkészletben, amely egy gyakori kulcshoz van rendelve.
CHotKeyCtrl::GetKeyName	Lekéri a megadott virtuáliskulcs-kódhoz rendelt kulcsnevet a helyi karakterkészletben.
CHotKeyCtrl::SetHotKey	A gyorsbillentyű-vezérlő gyorsbillentyű-kombinációját állítja be.
CHotKeyCtrl::SetRules	Meghatározza a gyorsbillentyű-vezérlő érvénytelen kombinációit és alapértelmezett módosító kombinációit.

Megjegyzések

A "gyorsbillentyű-vezérlő" egy ablak, amely lehetővé teszi a felhasználó számára, hogy gyorsbillentyűt hozzon létre. A "gyorsbillentyűk" olyan billentyűkombinációk, amelyeket a felhasználó lenyomva gyorsan végrehajthat egy műveletet. (A felhasználók létrehozhatnak például egy gyorsbillentyűt, amely aktivál egy adott ablakot, és a Z rendelés elejére viszi.) A gyorsbillentyű-vezérlő megjeleníti a felhasználó választási lehetőségeit, és biztosítja, hogy a felhasználó érvényes kulcskombinációt válasszon.

Ez a vezérlő (és így az CHotKeyCtrl osztály) csak a Windows 95/98 és a Windows NT 3.51-es és újabb verzióiban futó programokhoz érhető el.

Amikor a felhasználó kiválasztott egy kulcskombinációt, az alkalmazás lekérheti a megadott kulcskombinációt a vezérlőből, és a WM_SETHOTKEY üzenettel beállíthatja a gyorsbillentyűt a rendszerben. Amikor a felhasználó ezután lenyomja a gyorsbillentyűt, a rendszer bármely részéből a WM_SETHOTKEY üzenetben megadott ablak egy WM_SYSCOMMAND üzenetet kap, amely megadja a SC_HOTKEY. Ez az üzenet aktiválja az azt fogadó ablakot. A gyorsbillentyű mindaddig érvényes marad, amíg a WM_SETHOTKEY nevű alkalmazás nem lép ki.

Ez a mechanizmus eltér a WM_HOTKEY üzenettől, valamint a Windows RegisterHotKey és a UnregisterHotKey függvénytől függő gyorsbillentyű-támogatástól.

A használatról CHotKeyCtrltovábbi információt a Vezérlők és a CHotKeyCtrl használata című témakörben talál.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CHotKeyCtrl

Requirements

Fejléc: afxcmn.h

CHotKeyCtrl::CHotKeyCtrl

Egy CHotKeyCtrl objektumot hoz létre.

CHotKeyCtrl();

CHotKeyCtrl::Létrehozás

Létrehoz egy gyorsbillentyű-vezérlőt, és csatolja egy CHotKeyCtrl objektumhoz.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Paraméterek

dwStyle
Megadja a gyorsbillentyű-vezérlő stílusát. A vezérlőstílusok bármilyen kombinációját alkalmazhatja. További információt a Windows SDK gyakori vezérlőstílusai című témakörben talál.

téglalap
Megadja a gyorsbillentyű-vezérlő méretét és pozícióját. Lehet CRect objektum vagy RECT-struktúra.

pParentWnd
Megadja a gyorsbillentyű-vezérlő szülőablakát, általában egy CDialogot. Nem lehet NULL.

nID
Megadja a gyorsbillentyű-vezérlő azonosítóját.

Visszaadott érték

Nonzero, ha az inicializálás sikeres volt; egyéb esetben 0.

Megjegyzések

Egy objektumot CHotKeyCtrl két lépésben hozhat létre. Először hívja meg a konstruktort, majd hívja meg Create, amely létrehozza a gyorsbillentyű-vezérlőt, és csatolja az CHotKeyCtrl objektumhoz.

Ha a vezérlővel bővített ablakstílusokat szeretne használni, ahelyett hívja meg a CreateCreateExet.

CHotKeyCtrl::CreateEx

A függvény meghívásával hozzon létre egy vezérlőt (egy gyermekablakot), és társítsa azt az CHotKeyCtrl objektummal.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Paraméterek

dwExStyle
A létrehozott vezérlőelem kiterjesztett stílusát adja meg. A bővített Windows-stílusok listáját a CreateWindowExdwExStyle paraméterében találja a Windows SDK-ban.

dwStyle
Megadja a gyorsbillentyű-vezérlő stílusát. A vezérlőstílusok bármilyen kombinációját alkalmazhatja. További információ: Gyakori vezérlőstílusok a Windows SDK-ban.

téglalap
Hivatkozás a létrehozandó ablak méretét és pozícióját leíró RECT-struktúrára a pParentWnd ügyfélkoordinátáiban.

pParentWnd
A vezérlő szülőablakára mutató mutató.

nID
A vezérlő gyermekablak-azonosítója.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A CreateExLétrehozás helyett kiterjesztett Windows-stílusokat alkalmazhat, amelyeket a Windows bővített stílus előszavában WS_EX_.

CHotKeyCtrl::GetHotKey

Lekéri a billentyűparancsok virtuális kulcskódját és módosító jelzőit egy gyorsbillentyű-vezérlőből.

DWORD GetHotKey() const;

void GetHotKey(
    WORD& wVirtualKeyCode,
    WORD& wModifiers) const;

Paraméterek

wVirtualKeyCode
[kifelé] A billentyűparancs virtuális kulcskódja. A standard virtuális kulcskódok listájáért lásd: Winuser.h.

wModifiers
[kifelé] A billentyűparancs módosító kulcsait jelző jelzők (VAGY) bitenkénti kombinációja.

A módosító jelzők a következők:

Flag	Megfelelő kulcs
HOTKEYF_ALT	ALT billentyű
HOTKEYF_CONTROL	CTRL billentyű
HOTKEYF_EXT	Bővített kulcs
HOTKEYF_SHIFT	SHIFT billentyű

Visszaadott érték

Az első túlterhelt metódusban egy DWORD, amely tartalmazza a virtuális kulcs kódját és módosító jelzőit. Az alacsonyrendű szó kis sorrendű bájtja tartalmazza a virtuális kulcskódot, az alacsony sorrendű szó nagy sorrendű bájtja pedig a módosító jelzőket, a magasrendű szó pedig nulla.

Megjegyzések

A virtuális kulcs kódja és a módosító billentyűk együttesen határozzák meg a billentyűparancsot.

CHotKeyCtrl::GetHotKeyName

Hívja meg ezt a tagfüggvényt a gyorsbillentyű honosított nevének lekéréséhez.

CString GetHotKeyName() const;

Visszaadott érték

Az aktuálisan kijelölt gyorsbillentyű honosított neve. Ha nincs kijelölt gyorsbillentyű, GetHotKeyName üres sztringet ad vissza.

Megjegyzések

A tagfüggvény által visszaadott név a billentyűzetillesztőből származik. Nem honosított billentyűzetillesztőt telepíthet a Windows honosított verziójában, és fordítva.

CHotKeyCtrl::GetKeyName

Hívja meg ezt a tagfüggvényt a megadott virtuális kulcskódhoz rendelt kulcs honosított nevének lekéréséhez.

static CString GetKeyName(
    UINT vk,
    BOOL fExtended);

Paraméterek

vk
A virtuális kulcs kódja.

fExtended
Ha a virtuális kulcs kódja kiterjesztett kulcs, igaz; egyéb esetben HAMIS.

Visszaadott érték

A vk paraméter által megadott kulcs honosított neve. Ha a kulcsnak nincs leképezett neve, GetKeyName egy üres sztringet ad vissza.

Megjegyzések

A függvény által visszaadott kulcsnév a billentyűzetillesztőből származik, így nem honosított billentyűzetillesztőt telepíthet a Windows honosított verziójában, és fordítva.

Example

CString str;
str = CHotKeyCtrl::GetKeyName(VK_CONTROL, FALSE);
// str is now "Ctrl", or the localized equivalent.

CHotKeyCtrl::SetHotKey

A gyorsbillentyű-vezérlő billentyűparancsának beállítása.

void SetHotKey(
    WORD wVirtualKeyCode,
    WORD wModifiers);

Paraméterek

wVirtualKeyCode
[in] A billentyűparancs virtuális kulcskódja. A standard virtuális kulcskódok listájáért lásd: Winuser.h.

wModifiers
[in] A billentyűparancs módosító kulcsait jelző jelzők (VAGY) bitenkénti kombinációja.

A módosító jelzők a következők:

Flag	Megfelelő kulcs
HOTKEYF_ALT	ALT billentyű
HOTKEYF_CONTROL	CTRL billentyű
HOTKEYF_EXT	Bővített kulcs
HOTKEYF_SHIFT	SHIFT billentyű

Megjegyzések

A virtuális kulcs kódja és a módosító billentyűk együttesen határozzák meg a billentyűparancsot.

CHotKeyCtrl::SetRules

Hívja meg ezt a függvényt az érvénytelen kombinációk és a gyorsbillentyű-vezérlő alapértelmezett módosító kombinációinak meghatározásához.

void SetRules(
    WORD wInvalidComb,
    WORD wModifiers);

Paraméterek

wInvalidComb
Érvénytelen kulcskombinációkat meghatározó jelzők tömbje. A következő értékek kombinációja lehet:

• HKCOMB_A ALT

• HKCOMB_C CTRL

• HKCOMB_CA CTRL+ALT

• HKCOMB_NONE nem módosított kulcsok

• HKCOMB_S SHIFT

• HKCOMB_SA SHIFT+ALT

• HKCOMB_SC SHIFT+CTRL

• HKCOMB_SCA SHIFT+CTRL+ALT

wModifiers
A jelölők tömbje, amelyek a felhasználó érvénytelen kombináció beírásakor használandó kulcskombinációt határozzák meg. A módosító jelzőkkel kapcsolatos további információkért lásd: GetHotKey.

Megjegyzések

Ha egy felhasználó érvénytelen kulcskombinációt ad meg a wInvalidCombban megadott jelölők szerint, a rendszer az OR operátorral egyesíti a felhasználó által megadott kulcsokat a wModifiersben megadott jelzőkkel. Az eredményül kapott billentyűkombináció sztringgé alakul, majd megjelenik a gyorsbillentyű-vezérlőben.

Lásd még

CWnd osztály
hierarchiadiagram