RegisterHotKey

RegisterHotKey işlevi bir sistem genelinde kısayol tuşu tanımlar.

bool RegisterHotKey ()  hwnd  hWnd, / / hot-key bildirim almak için pencereint id, / / sıcak anahtarının tanımlayıcısıUINTfsModifiers, / / anahtar değiştirici flagsUINTVK / / sanal-anahtar kodu);
 

Parametreleri

hWnd

Kısayol tuşu tarafından oluşturulan wm_hotkey iletileri alacak penceresine kolu. Bu parametre null ise, wm_hotkey iletileri arama iş parçacığına ileti kuyruğuna nakledilir ve ileti döngüsü içinde işlenmesi.

id

Kısayol tuşu tanımlayıcısını belirtir. Hayır diğer sıcak anahtar arama iş parçacığında aynı olmalıdır. Uygulama 0x0000 ile 0xBFFF aralığında bir değer belirtmeniz gerekir. Paylaşılan bir dinamik bağlantı kitaplığı (dll) aralığında 0xC000 ile 0xFFFF değeri belirtmeniz gerekir (tarafından döndürülen Aralık GlobalAddAtom işlevi). Diğer paylaşılan DLL'lerin tarafından tanımlanan sıcak anahtar tanımlayıcılara sahip çakışmaları önlemek için bir dll GlobalAddAtom işlevi sıcak anahtar tanımlayıcısı elde etmek için kullanmanız gerekir.

fsModifiers

Tuşları basılan gerekir, wm_hotkey mesaj üretmek için nVirtKey parametresi tarafından belirtilen anahtarla birlikte belirtir. FsModifiers parametresi aşağıdaki değerleri birleşimi olabilir.

Değer	Anlamı
MOD_ALT	Ya da alt tuşu basılıyken gerekir.
MOD_CONTROL	Ya da ctrl tuşu basılıyken gerekir.
MOD_SHIFT	Ya da shift tuşu basılıyken gerekir.
MOD_WIN	Ya da WINDOWS tuşu gerçekleştirildi. Bu tuşlar Microsoft Windows logosu ile etiketlenir.

vk

Kısayol tuşu sanal-anahtar kodunu belirtir.

Dönüş değerleri

İşlev başarılı olursa, dönüş değeri sıfır.

İşlev başarısız olursa, dönüş değeri sıfırdır. Genişletilmiş hata bilgilerini için GetLastError.

Açıklamalar

Bir tuşa basıldığında sistem tüm tuşları karşı bir eşleşme arar. Bir eş bulma üzerine sistem ileti sırası kısayol tuşu kayıtlı iş parçacığının wm_hotkey iletisi gönderir. Böylece ileti döngüsü bir sonraki yineleme tarafından kaldırılır Bu iletiyi sıranın başlangıcına nakledilir.

Bu işlev bir kısayol tuşu ile başka bir iş parçacığı tarafından oluşturulan bir pencere ilişkilendiremezsiniz.

Sıcak anahtar için belirtilen tuş vuruşlarını zaten başka bir kısayol tuşu tarafından tescil edilmiş RegisterHotKey başarısız olur.

Pencerenin hWnd parametresi tarafından tanımlanan zaten aynı tanımlayıcı olarak kimliği parametresi tarafından belirtilen bir kısayol tuşu kayıtlı fsModifiers ve vk parametreleri için yeni değerleri bu parametreleri önceden belirtilen değerleri yerine.

Windows ce: Windows ce 2.0 ve sonraki sürümlerde, mod_keyup, fsModifiers parametre olarak adlandırılan bir başka bayrak destekler. mod_keyup bayrağı ayarlarsanız, pencere wm_hotkey mesaj olay tuşu yanı sıra olay bir anahtarı gönderilecektir.

RegisterHotKey kısayol tuşları arasında ipler kaydetmek için kullanılabilir.

QuickInfo

nbsp; Windows &NT: sürüm 3.1 veya üstü gerektirir.
Windows:Windows 95 veya sonraki sürümleri gerektirir.
Windows ce:Desteklenmeyen.
Header:WINUSER.h ilan etti.
İçe Library:User32.lib kullanma.

Ayrıca bkz:

Klavye girişi genel bakış, klavye girişi işlevleri, GlobalAddAtom, UnregisterHotKey, wm_hotkey

Index