WM_APPCOMMAND iletisi

Örneğin, fareyi kullanarak bir uygulama komut düğmesine tıklayarak veya klavyede bir uygulama komut tuşu yazarak kullanıcının bir uygulama komut olayı oluşturduğunu bir pencereye bildirir.

#define WM_APPCOMMAND                   0x0319

Parametre

wParam

Kullanıcının düğmeye tıkladığı veya tuşa bastığı pencerenin tutamacı. Bu, iletiyi alan pencerenin alt penceresi olabilir. Bu iletiyi işleme hakkında daha fazla bilgi için Açıklamalar bölümüne bakın.

lParam

lParam parametresinde yer alan bilgileri almak için aşağıdaki kodu kullanın.

cmd  = GET_APPCOMMAND_LPARAM(lParam);

uDevice = GET_DEVICE_LPARAM(lParam);

dwKeys = GET_KEYSTATE_LPARAM(lParam);

Uygulama komutu, aşağıdaki değerlerden biri olabilecek cmd.

Değer	Anlam
APPCOMMAND_BASS_BOOST 20	Bas yükseltmesini açıp kapatın.
APPCOMMAND_BASS_DOWN 19	Bası azaltın.
APPCOMMAND_BASS_UP 21	Bası artırın.
APPCOMMAND_BROWSER_BACKWARD 1	Geriye doğru gidin.
APPCOMMAND_BROWSER_FAVORITES 6	Sık kullanılanları açın.
APPCOMMAND_BROWSER_FORWARD 2	İleriye gidin.
APPCOMMAND_BROWSER_HOME 7	Giriş sayfasına gidin.
APPCOMMAND_BROWSER_REFRESH 3	Sayfayı yenile'yi seçin.
APPCOMMAND_BROWSER_SEARCH 5	Aramayı açın.
APPCOMMAND_BROWSER_STOP 4	İndirmeyi durdurun.
APPCOMMAND_CLOSE 31	Pencereyi kapatın (uygulamayı değil).
APPCOMMAND_COPY 36	Seçimi kopyalayın.
APPCOMMAND_CORRECTION_LIST 45	Konuşma girişi sırasında bir sözcük yanlış tanımlandığında düzeltme listesini getirir.
APPCOMMAND_CUT 37	Seçimi kesin.
APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE 43	İki konuşma girişi modu arasında geçiş yapar: dikte ve komut/denetim (bir uygulamaya komut verme veya menülere erişme).
APPCOMMAND_FIND 28	Bul iletişim kutusunu açın.
APPCOMMAND_FORWARD_MAIL 40	Posta iletisini iletme.
APPCOMMAND_HELP 27	Yardım iletişim kutusunu açın.
APPCOMMAND_LAUNCH_APP1 17	Uygulama1'i başlatın.
APPCOMMAND_LAUNCH_APP2 18	Uygulama2'ye başlayın.
APPCOMMAND_LAUNCH_MAIL 15	Postayı açın.
APPCOMMAND_LAUNCH_MEDIA_SELECT 16	Medya Seçme moduna gidin.
APPCOMMAND_MEDIA_CHANNEL_DOWN 52	Kanal değerini (örneğin, bir TV veya radyo tarayıcısı) azaltma.
APPCOMMAND_MEDIA_CHANNEL_UP 51	Tv veya radyo tarayıcısı gibi kanal değerini artırma.
APPCOMMAND_MEDIA_FAST_FORWARD 49	Akış kayıttan yürütme hızını artırın. Bu, sabit bir hız kullanarak veya artan bir dizi hız arasında geçiş yapmak gibi birçok yolla uygulanabilir.
APPCOMMAND_MEDIA_NEXTTRACK 11	Sonraki parçaya gidin.
APPCOMMAND_MEDIA_PAUSE 47	Duraklat. Zaten duraklatıldıysa başka bir işlem yapmanıza gerek yoktur. Bu, durumu olmayan doğrudan bir PAUSE komutudur. Ayrı Yürüt ve Duraklat düğmeleri varsa, uygulamalar hem bu komut üzerinde hem de APPCOMMAND_MEDIA_PLAY_PAUSEüzerinde işlem yapmalıdır.
APPCOMMAND_MEDIA_PLAY 46	Geçerli konumda oynamaya başlayın. Zaten duraklatıldıysa devam eder. Bu, durumu olmayan bir doğrudan PLAY komutudur. Ayrı Yürütme ve Duraklat düğmeleri varsa, uygulamalar hem bu komut üzerinde hem de APPCOMMAND_MEDIA_PLAY_PAUSEüzerinde işlem yapmalıdır.
APPCOMMAND_MEDIA_PLAY_PAUSE 14	Kayıttan yürütmeyi yürüt veya duraklat. Ayrı Yürütme ve Duraklat düğmeleri varsa, uygulamalar hem bu komut üzerinde hem de APPCOMMAND_MEDIA_PLAY ve APPCOMMAND_MEDIA_PAUSEüzerinde işlem yapmalıdır.
APPCOMMAND_MEDIA_PREVIOUSTRACK 12	Önceki parçaya gidin.
APPCOMMAND_MEDIA_RECORD 48	Geçerli akışı kaydetmeye başlayın.
APPCOMMAND_MEDIA_REWIND 50	Daha yüksek hızda bir akışta geriye doğru gidin. Bu, sabit bir hız kullanarak veya artan bir dizi hız arasında geçiş yapmak gibi birçok yolla uygulanabilir.
APPCOMMAND_MEDIA_STOP 13	Kayıttan yürütmeyi durdurun.
APPCOMMAND_MIC_ON_OFF_TOGGLE 44	Mikrofonu açın.
APPCOMMAND_MICROPHONE_VOLUME_DOWN 25	Mikrofon ses düzeyini azaltın.
APPCOMMAND_MICROPHONE_VOLUME_MUTE 24	Mikrofonun sesini kapatma.
APPCOMMAND_MICROPHONE_VOLUME_UP 26	Mikrofon ses düzeyini artırın.
APPCOMMAND_NEW 29	Yeni bir pencere oluşturun.
APPCOMMAND_OPEN 30	Bir pencere açın.
APPCOMMAND_PASTE 38	Yapıştırmak
APPCOMMAND_PRINT 33	Geçerli belgeyi yazdırın.
APPCOMMAND_REDO 35	Son eylemi yineleyin.
APPCOMMAND_REPLY_TO_MAIL 39	Posta iletisini yanıtlama.
APPCOMMAND_SAVE 32	Geçerli belgeyi kaydedin.
APPCOMMAND_SEND_MAIL 41	Posta iletisi gönderin.
APPCOMMAND_SPELL_CHECK 42	Yazım denetimi başlatın.
APPCOMMAND_TREBLE_DOWN 22	Titremeyi azalt.
APPCOMMAND_TREBLE_UP 23	Tizi artırın.
APPCOMMAND_UNDO 34	Son eylemi geri al.
APPCOMMAND_VOLUME_DOWN 9	Ses düzeyini azaltın.
APPCOMMAND_VOLUME_MUTE 8	Birimin sesini kapatma.
APPCOMMAND_VOLUME_UP 10	Birimi yükseltin.

uDevice bileşeni, giriş olayını oluşturan giriş cihazını gösterir ve aşağıdaki değerlerden biri olabilir.

Değer	Anlam
FAPPCOMMAND_KEY 0	Kullanıcı bir tuşa bastı.
FAPPCOMMAND_MOUSE 0x8000	Kullanıcı bir fare düğmesine tıkladı.
FAPPCOMMAND_OEM 0x1000	Olayı tanımlanamayan bir donanım kaynağı oluşturdu. Bu bir fare veya klavye olayı olabilir.

dwKeys bileşeni, çeşitli sanal anahtarların devre dışı olup olmadığını ve aşağıdaki değerlerden biri veya daha fazlası olabileceğini gösterir.

Değer	Anlam
MK_CONTROL 0x0008	CTRL tuşu çalışmıyor.
MK_LBUTTON 0x0001	Sol fare düğmesi çalışmıyor.
MK_MBUTTON 0x0010	Ortadaki fare düğmesi çalışmıyor.
MK_RBUTTON 0x0002	Sağ fare düğmesi çalışmıyor.
MK_SHIFT 0x0004	SHIFT tuşu çalışmıyor.
MK_XBUTTON1 0x0020	XBUTTON1 çalışmıyor.
MK_XBUTTON2 0x0040	XBUTTON2 çalışmıyor.

Dönüş değeri

Bir uygulama bu iletiyi işlerse truedöndürmelidir. Dönüş değerini işleme hakkında daha fazla bilgi için Açıklamalar bölümüne bakın.

Açıklamalar

DefWindowProc, WM_XBUTTONUP veya WM_NCXBUTTONUP iletisini işlerken ya da kullanıcı bir uygulama komut anahtarı yazdığınızda WM_APPCOMMAND iletisini oluşturur.

Alt pencere bu iletiyi işlemez ve bunun yerine DefWindowProcçağırırsa DefWindowProc iletiyi üst penceresine gönderir. Üst düzey bir pencere bu iletiyi işlemezse ve bunun yerine DefWindowProcçağırırsa DefWindowProcHSHELL_APPCOMMANDeşit kanca koduna sahip bir kabuk kancası çağırır.

İleti fare tıklaması ile oluşturulduysa imlecin koordinatlarını almak için, uygulama getMessagePosçağırabilir. Bir uygulama, lParamFAPPCOMMAND_MOUSEiçerip içermediğini denetleyerek iletinin fare tarafından oluşturulup oluşturulmadığını test edebilir.

Diğer windows iletilerinden farklı olarak, bir uygulama bu iletiyi işlerse bu iletiden TRUE döndürmelidir. Bunun yapılması, Windows 2000'den önceki Windows sistemlerinde bu iletinin benzetimini yapan yazılımların, pencere yordamının iletiyi işleyip işlemediğini veya DefWindowProc olarak adlandırıldığını belirlemesine olanak tanır.

Gereksinim -leri

Ayrıca bkz.

Başvuru

DefWindowProc

GET_APPCOMMAND_LPARAM

GET_DEVICE_LPARAM

GET_KEYSTATE_LPARAM

ShellProc

WM_XBUTTONUP

WM_NCXBUTTONUP

kavramsal

fare girişi