CHotKeyCtrl Sınıfı

Windows ortak kısayol tuşu denetiminin işlevselliğini sağlar.

Sözdizimi

class CHotKeyCtrl : public CWnd

Üyeler

Ortak Oluşturucular

Genel Yöntemler

Açıklamalar

"Sık erişimli anahtar denetimi", kullanıcının kısayol tuşu oluşturmasını sağlayan bir penceredir. "Kısayol tuşu", kullanıcının hızlı bir şekilde eylem gerçekleştirmek için basabileceği bir tuş bileşimidir. (Örneğin, kullanıcı belirli bir pencereyi etkinleştiren ve Z sırasının en üstüne getiren bir kısayol tuşu oluşturabilir.) Kısayol tuşu denetimi kullanıcının seçimlerini görüntüler ve kullanıcının geçerli bir tuş bileşimi seçmesini sağlar.

Bu denetim (ve dolayısıyla CHotKeyCtrl sınıfı) yalnızca Windows 95/98 ve Windows NT sürüm 3.51 ve üzeri altında çalışan programlarda kullanılabilir.

Kullanıcı bir tuş bileşimi seçtiğinde, uygulama denetimden belirtilen tuş bileşimini alabilir ve sistemde kısayol tuşunu ayarlamak için WM_SETHOTKEY iletisini kullanabilir. Kullanıcı bundan sonra sistemin herhangi bir bölümünden kısayol tuşuna bastığında, WM_SETHOTKEY iletisinde belirtilen pencere SC_HOTKEY belirten bir WM_SYSCOMMAND iletisi alır. Bu ileti, bu iletiyi alan pencereyi etkinleştirir. Kısayol tuşu, WM_SETHOTKEY çağıran uygulama çıkana kadar geçerli kalır.

Bu mekanizma, WM_HOTKEY iletisine ve Windows RegisterHotKey ve UnregisterHotKey işlevlerine bağlı olan kısayol tuşu desteğinden farklıdır.

kullanma CHotKeyCtrlhakkında daha fazla bilgi için bkz . Denetimler ve CHotKeyCtrl Kullanma.

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CHotKeyCtrl

Gereksinimler

Üst bilgi: afxcmn.h

CHotKeyCtrl::CHotKeyCtrl

Bir CHotKeyCtrl nesne oluşturur.

CHotKeyCtrl();

CHotKeyCtrl::Create

Bir kısayol tuşu denetimi oluşturur ve bunu bir CHotKeyCtrl nesneye ekler.

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

Parametreler

dwStyle
Kısayol tuşu denetiminin stilini belirtir. Denetim stillerinin herhangi bir bileşimini uygulayın. Daha fazla bilgi için bkz . Windows SDK'sında Ortak Denetim Stilleri .

Rect
Kısayol tuşu denetiminin boyutunu ve konumunu belirtir. Bir CRect nesnesi veya RECT yapısı olabilir.

pParentWnd
Sık erişimli anahtar denetiminin üst penceresini ( genellikle bir CDialog) belirtir. NULL olmamalıdır.

Nıd
Kısayol tuşu denetiminin kimliğini belirtir.

Dönüş Değeri

Sıfır olmayan, başlatma başarılı olursa; aksi takdirde 0.

Açıklamalar

İki adımda bir CHotKeyCtrl nesne oluşturursunuz. İlk olarak oluşturucuyu çağırın ve ardından kısayol tuşu denetimini oluşturan ve nesnesine ekleyen öğesini çağırınCreateCHotKeyCtrl.

Denetiminizle genişletilmiş windows stilleri kullanmak istiyorsanız, yerine CreateEx'i çağırın.Create

CHotKeyCtrl::CreateEx

Bir denetim (alt pencere) oluşturmak ve nesneyle ilişkilendirmek için bu işlevi çağırın CHotKeyCtrl .

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

Parametreler

dwExStyle
Oluşturulan denetimin genişletilmiş stilini belirtir. Genişletilmiş Windows stillerinin listesi için Windows SDK'sında CreateWindowEx için dwExStyle parametresine bakın.

dwStyle
Kısayol tuşu denetiminin stilini belirtir. Denetim stillerinin herhangi bir bileşimini uygulayın. Daha fazla bilgi için bkz . Windows SDK'sında Ortak Denetim Stilleri .

Rect
pParentWnd istemci koordinatlarında oluşturulacak pencerenin boyutunu ve konumunu açıklayan rect yapısına başvuru.

pParentWnd
Denetimin üst öğesi olan pencere işaretçisi.

Nıd
Denetimin alt pencere kimliği.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Windows genişletilmiş stil ön biçimi WS_EX_ tarafından belirtilen genişletilmiş Windows stillerini uygulamak için Oluştur yerine kullanınCreateEx.

CHotKeyCtrl::GetHotKey

Kısayol tuşu denetiminden bir klavye kısayolunun sanal anahtar kodunu ve değiştirici bayraklarını alır.

DWORD GetHotKey() const;

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

Parametreler

wVirtualKeyCode
[out] Klavye kısayolunun sanal tuş kodu. Standart sanal anahtar kodlarının listesi için bkz. Winuser.h.

wModifiers
[out] Klavye kısayolundaki değiştirici tuşlarını gösteren bit düzeyinde bir bayrak bileşimi (OR).

Değiştirici bayrakları aşağıdaki gibidir:

Dönüş Değeri

İlk aşırı yüklenmiş yöntemde, sanal anahtar kodunu ve değiştirici bayraklarını içeren bir DWORD. Düşük sıralı sözcüğün düşük sıralı bayt değeri sanal anahtar kodunu, düşük sıralı sözcüğün yüksek sıralı bayt değeri değiştirici bayrakları içerir ve yüksek sıralı sözcük sıfırdır.

Açıklamalar

Sanal anahtar kodu ve değiştirici tuşlar birlikte klavye kısayolunu tanımlar.

CHotKeyCtrl::GetHotKeyName

Sık erişim anahtarının yerelleştirilmiş adını almak için bu üye işlevini çağırın.

CString GetHotKeyName() const;

Dönüş Değeri

Seçili durumdaki kısayol tuşunun yerelleştirilmiş adı. Seçili kısayol tuşu yoksa boş GetHotKeyName bir dize döndürür.

Açıklamalar

Bu üye işlevinin döndürdüğü ad klavye sürücüsünden gelir. Yerelleştirilmemiş bir klavye sürücüsünü Windows'un yerelleştirilmiş bir sürümüne (veya tam tersi) yükleyebilirsiniz.

CHotKeyCtrl::GetKeyName

Belirtilen sanal anahtar koduna atanan anahtarın yerelleştirilmiş adını almak için bu üye işlevini çağırın.

static CString GetKeyName(
    UINT vk,
    BOOL fExtended);

Parametreler

vk
Sanal anahtar kodu.

fExtended
Sanal anahtar kodu genişletilmiş bir anahtarsa TRUE; aksi takdirde YANLIŞ.

Dönüş Değeri

vk parametresi tarafından belirtilen anahtarın yerelleştirilmiş adı. Anahtarın eşlenmiş bir adı yoksa boş GetKeyName bir dize döndürür.

Açıklamalar

Bu işlevin döndürdüğü tuş adı klavye sürücüsünden gelir, böylece yerelleştirilmemiş bir klavye sürücüsünü Windows'un yerelleştirilmiş bir sürümüne yükleyebilirsiniz ve tam tersi de geçerlidir.

Örnek

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

CHotKeyCtrl::SetHotKey

Kısayol tuşu denetimi için klavye kısayolunu ayarlar.

void SetHotKey(
    WORD wVirtualKeyCode,
    WORD wModifiers);

Parametreler

wVirtualKeyCode
[in] Klavye kısayolunun sanal tuş kodu. Standart sanal anahtar kodlarının listesi için bkz. Winuser.h.

wModifiers
[in] Klavye kısayolundaki değiştirici tuşlarını gösteren bit düzeyinde bir bayrak bileşimi (OR).

Değiştirici bayrakları aşağıdaki gibidir:

Açıklamalar

Sanal anahtar kodu ve değiştirici tuşlar birlikte klavye kısayolunu tanımlar.

CHotKeyCtrl::SetRules

Bir kısayol tuşu denetimi için geçersiz birleşimleri ve varsayılan değiştirici bileşimini tanımlamak için bu işlevi çağırın.

void SetRules(
    WORD wInvalidComb,
    WORD wModifiers);

Parametreler

wInvalidComb
Geçersiz tuş bileşimlerini belirten bayrak dizisi. Aşağıdaki değerlerin bir bileşimi olabilir:

• HKCOMB_A ALT

• HKCOMB_C CTRL

• HKCOMB_CA CTRL+ALT

• Değiştirilmemiş anahtarları HKCOMB_NONE

• HKCOMB_S SHIFT

• HKCOMB_SA SHIFT+ALT

• HKCOMB_SC SHIFT+CTRL

• HKCOMB_SCA SHIFT+CTRL+ALT

wModifiers
Kullanıcı geçersiz bir bileşim girdiğinde kullanılacak tuş bileşimini belirten bayrak dizisi. Değiştirici bayrakları hakkında daha fazla bilgi için bkz . GetHotKey.

Açıklamalar

Kullanıcı, wInvalidComb'da belirtilen bayraklarla tanımlandığı gibi geçersiz bir tuş bileşimi girdiğinde sistem, kullanıcı tarafından girilen anahtarları wModifiers'da belirtilen bayraklarla birleştirmek için OR işlecini kullanır. Sonuçta elde edilen tuş bileşimi bir dizeye dönüştürülür ve ardından kısayol tuşu denetiminde görüntülenir.

Ayrıca bkz.

CWnd Sınıfı
Hiyerarşi Grafiği