Aracılığıyla paylaş

Düğme (Windows Denetimleri)

  • Makale

Bu bölüm, düğme denetimleriyle kullanılan programlama öğeleri hakkında bilgi içerir. düğmesi, kullanıcının uygulamaya giriş sağlamak için tıklayabileceği bir denetimdir.

Genel bakış

Konu Içeriği
Düğme İletileri Bu konu başlığında düğmelerle kullanılan iletiler açıklanmaktadır.
Düğme Durumları Bu bölümde, düğme seçme işleminin durumunu nasıl değiştirip uygulamanın nasıl yanıt vermesi gerektiği açıklanır.
Düğme Türleri Bu konuda farklı düğme türleri açıklanmaktadır.
Düğmeleri kullanarak Bu bölümde, düğmelerle ilişkili bazı görevlerin nasıl gerçekleştirilecekleri açıklanmaktadır.

Işlev

Konu Içeriği
CheckDlgButton Düğme denetiminin denetim durumunu değiştirir.
CheckRadioButton Bir gruptaki belirtilen radyo düğmesine onay işareti ekler (denetler) ve gruptaki diğer tüm radyo düğmelerinden onay işaretini kaldırır (temizler).
IsDlgButtonChecked IsDlgButtonChecked işlevi, düğme denetiminin işaretli olup olmadığını veya üç durumlu düğme denetiminin işaretli mi, işaretsiz mi yoksa belirsiz mi olduğunu belirler.

Makro

Konu Içeriği
Button_Enable Düğmeyi etkinleştirir veya devre dışı bırakır.
Button_GetCheck Radyo düğmesinin veya onay kutusunun onay durumunu alır. Bu makroyu kullanabilir veya BM_GETCHECK iletisini açıkça gönderebilirsiniz.
Button_GetIdealSize Resim listesi varsa, metin ve görüntüye en uygun düğmenin boyutunu alır. Bu makroyu kullanabilir veya BCM_GETIDEALSIZE iletisini açıkça gönderebilirsiniz.
Button_GetImageList Düğme denetimi için ayarlanan görüntü listesini açıklayan BUTTON_IMAGELIST yapısını alır. Bu makroyu kullanabilir veya BCM_GETIMAGELIST iletisini açıkça gönderebilirsiniz.
Button_GetNote Komut bağlantısı düğmesiyle ilişkili not metnini alır. Bu makroyu kullanabilir veya BCM_GETNOTE iletisini açıkça gönderebilirsiniz.
Button_GetNoteLength Komut bağlantısının açıklamasında görüntülenebilen not metninin uzunluğunu alır. Bu makroyu kullanın veya BCM_GETNOTELENGTH iletisini açıkça gönderin.
Button_GetSplitInfo Belirtilen bölünmüş düğme denetimiyle ilgili bilgileri alır. Bu makroyu kullanın veya BCM_GETSPLITINFO iletisini açıkça gönderin.
Button_GetState Radyo düğmesinin veya onay kutusunun onay durumunu alır. Bu makroyu kullanabilir veya BM_GETSTATE iletisini açıkça gönderebilirsiniz.
Button_GetText Düğme metnini alır.
Button_GetTextLength Düğme metnindeki karakter sayısını alır.
Button_GetTextMargin Düğme denetiminde metin çizmek için kullanılan kenar boşluklarını alır. Bu makroyu kullanabilir veya BCM_GETTEXTMARGIN iletisini açıkça gönderebilirsiniz.
Button_SetCheck Radyo düğmesinin veya onay kutusunun onay durumunu ayarlar. Bu makroyu kullanabilir veya BM_SETCHECK iletisini açıkça gönderebilirsiniz.
Button_SetDropDownState BS_SPLITBUTTONstiline sahip belirtilen düğme için açılan menü durumunu ayarlar. Bu makroyu kullanın veya BCM_SETDROPDOWNSTATE iletisini açıkça gönderin.
Button_SetElevationRequiredState Yükseltilmiş bir simgeyi görüntülemek için belirtilen düğme veya komut bağlantısı için gereken yükseltme durumunu ayarlar. Bu makroyu kullanın veya BCM_SETSHIELD iletisini açıkça gönderin.
Button_SetImageList Düğme denetimine resim listesi atar. Bu makroyu kullanabilir veya BCM_SETIMAGELIST iletisini açıkça gönderebilirsiniz.
Button_SetNote Belirtilen komut bağlantısı düğmesiyle ilişkili not metnini ayarlar. Bu makroyu kullanabilir veya BCM_SETNOTE iletisini açıkça gönderebilirsiniz.
Button_SetSplitInfo Belirtilen bölünmüş düğme denetimi için bilgileri ayarlar. Bu makroyu kullanın veya BCM_SETSPLITINFO iletisini açıkça gönderin.
Button_SetState Düğmenin vurgu durumunu ayarlar. Vurgu durumu, düğmenin kullanıcı tarafından gönderilmiş gibi vurgulanıp vurgulanmamış olduğunu gösterir. Bu makroyu kullanabilir veya BM_SETSTATE iletisini açıkça gönderebilirsiniz.
Button_SetStyle Düğmenin stilini ayarlar. Bu makroyu kullanabilir veya BM_SETSTYLE iletisini açıkça gönderebilirsiniz.
Button_SetText Düğmenin metnini ayarlar.
Button_SetTextMargin Düğme denetiminde metin çizmek için kenar boşluklarını ayarlar. Bu makroyu kullanabilir veya BCM_SETTEXTMARGIN iletisini açıkça gönderebilirsiniz.

Ileti

Konu Içeriği
BCM_GETIDEALSIZE Resim listesi varsa, düğmenin metnine ve resmine en uygun boyutunu alır. Bu iletiyi açıkça gönderebilir veya Button_GetIdealSize makroyu kullanabilirsiniz.
BCM_GETIMAGELIST Düğme denetimine atanan görüntü listesini açıklayan BUTTON_IMAGELIST yapısını alır. Bu iletiyi açıkça gönderebilir veya Button_GetImageList makroyu kullanabilirsiniz.
BCM_GETNOTE Komut bağlantısı düğmesiyle ilişkili not metnini alır. Bu iletiyi açıkça gönderebilir veya Button_GetNote makroyu kullanabilirsiniz.
BCM_GETNOTELENGTH Komut bağlantısı düğmesinin açıklamasında görüntülenebilen not metninin uzunluğunu alır. Bu iletiyi açıkça veya Button_GetNoteLength makroyu kullanarak gönderin.
BCM_GETSPLITINFO Bölünmüş düğme denetimiyle ilgili bilgileri alır. Bu iletiyi açıkça veya Button_GetSplitInfo makroyu kullanarak gönderin.
BCM_GETTEXTMARGIN Düğme denetiminde metin çizmek için kullanılan kenar boşluklarını alır. Bu iletiyi açıkça gönderebilir veya Button_GetTextMargin makroyu kullanabilirsiniz.
BCM_SETDROPDOWNSTATE TBSTYLE_DROPDOWNstiline sahip bir düğmenin açılan durumunu ayarlar. Bu iletiyi açıkça veya Button_SetDropDownState makro kullanarak gönderin.
BCM_SETIMAGELIST Düğme denetimine resim listesi atar. Bu iletiyi açıkça gönderebilir veya Button_SetImageList makroyu kullanabilirsiniz.
BCM_SETNOTE Komut bağlantısı düğmesiyle ilişkili not metnini ayarlar. Bu iletiyi açıkça gönderebilir veya Button_SetNote makroyu kullanabilirsiniz.
BCM_SETSHIELD Yükseltilmiş bir simgeyi görüntülemek için belirtilen düğme veya komut bağlantısı için gereken yükseltme durumunu ayarlar. Bu iletiyi açıkça veya Button_SetElevationRequiredState makro kullanarak gönderin.
BCM_SETSPLITINFO Bölünmüş düğme denetimi için bilgileri ayarlar. Bu iletiyi açıkça veya Button_SetSplitInfo makroyu kullanarak gönderin.
BCM_SETTEXTMARGIN BCM_SETTEXTMARGIN iletisi, düğme denetiminde metin çizmek için kenar boşluklarını ayarlar.
BM_CLICK Bir düğmeye tıklayan kullanıcının benzetimini oluşturur. Bu ileti, düğmenin WM_LBUTTONDOWN ve WM_LBUTTONUP iletilerini almasına ve düğmenin üst penceresinin BN_CLICKED bildirim kodu almasına neden olur.
BM_GETCHECK Radyo düğmesinin veya onay kutusunun onay durumunu alır. Bu iletiyi açıkça gönderebilir veya Button_GetCheck makroyu kullanabilirsiniz.
BM_GETIMAGE Düğmeyle ilişkilendirilmiş görüntünün (simge veya bit eşlem) tutamacını alır.
BM_GETSTATE Düğmenin veya onay kutusunun durumunu alır. Bu iletiyi açıkça gönderebilir veya Button_GetState makroyu kullanabilirsiniz.
BM_SETCHECK Radyo düğmesinin veya onay kutusunun onay durumunu ayarlar. Bu iletiyi açıkça veya Button_SetCheck makroyu kullanarak gönderebilirsiniz.
BM_SETDONTCLICK Düğme odağı aldığında BN_CLICKED iletilerinin oluşturulmasını denetleen bir radyo düğmesinde bir bayrak ayarlar.
BM_SETIMAGE Yeni bir görüntüyü (simge veya bit eşlem) düğmeyle ilişkilendirir.
BM_SETSTATE Düğmenin vurgu durumunu ayarlar. Vurgu durumu, düğmenin kullanıcı tarafından gönderilmiş gibi vurgulanıp vurgulanmamış olduğunu gösterir. Bu iletiyi açıkça gönderebilir veya Button_SetState makroyu kullanabilirsiniz.
BM_SETSTYLE Düğmenin stilini ayarlar. Bu iletiyi açıkça gönderebilir veya Button_SetStyle makroyu kullanabilirsiniz.

Bildirim

Konu Içeriği
BCN_DROPDOWN Kullanıcı bir düğmedeki açılan oka tıkladığında gönderilir. Denetimin üst penceresi bu bildirim kodunu bir WM_NOTIFY iletisi biçiminde alır.
BCN_HOTITEMCHANGE Düğme denetimi sahibine farenin düğme denetiminin istemci alanına girdiğini veya ayrıldığını bildirir. Düğme denetimi bu bildirim kodunu bir WM_NOTIFY iletisi biçiminde gönderir.
BN_CLICKED Kullanıcı bir düğmeye tıkladığında gönderilir.
Düğmenin üst penceresi, WM_COMMAND iletisi aracılığıyla BN_CLICKED bildirim kodunu alır.
BN_DBLCLK Kullanıcı bir düğmeye çift tıkladığında gönderilir. Bu bildirim kodu, BS_USERBUTTON, BS_RADIOBUTTONve BS_OWNERDRAW düğmeleri için otomatik olarak gönderilir. Diğer düğme türleri yalnızca BS_NOTIFY stiline sahipse BN_DBLCLK gönderir.
Düğmenin üst penceresi WM_COMMAND iletisi aracılığıyla BN_DBLCLK bildirim kodunu alır.
BN_DISABLE Bir düğme devre dışı bırakıldığında gönderilir. Not: Bu bildirim kodu yalnızca 3.0 sürümünden önceki Windows'un 16 bit sürümleriyle uyumluluk için sağlanır. Uygulamalar bu görev için BS_OWNERDRAW düğme stilini ve DRAWITEMSTRUCTyapısınıkullanmalıdır.
Düğmenin üst penceresi WM_COMMAND iletisi aracılığıyla BN_DISABLE bildirim kodunu alır.
BN_DOUBLECLICKED Kullanıcı bir düğmeye çift tıkladığında gönderilir. Bu bildirim kodu, BS_USERBUTTON, BS_RADIOBUTTONve BS_OWNERDRAW düğmeleri için otomatik olarak gönderilir. Diğer düğme türleri yalnızca BS_NOTIFY stiline sahipse BN_DOUBLECLICKED gönderir.
Düğmenin üst penceresi WM_COMMAND iletisi aracılığıyla BN_DOUBLECLICKED bildirim kodunu alır.
BN_HILITE Kullanıcı bir düğme seçtiğinde gönderilir. Not: Bu bildirim kodu yalnızca 3.0 sürümünden önceki Windows'un 16 bit sürümleriyle uyumluluk için sağlanır. Uygulamalar bu görev için BS_OWNERDRAW düğme stilini ve DRAWITEMSTRUCTyapısınıkullanmalıdır.
Düğmenin üst penceresi WM_COMMAND iletisi aracılığıyla BN_HILITE bildirim kodunu alır.
BN_KILLFOCUS Bir düğme klavye odağını kaybettiğinde gönderilir. Düğme, bu bildirim kodunu göndermek için BS_NOTIFY stiline sahip olmalıdır.
Düğmenin üst penceresi WM_COMMAND iletisi aracılığıyla BN_KILLFOCUS bildirim kodunu alır.
BN_PAINT Bir düğmenin boyanması gerektiğinde gönderilir. Not: Bu bildirim kodu yalnızca 3.0 sürümünden önceki Windows'un 16 bit sürümleriyle uyumluluk için sağlanır. Uygulamalar bu görev için BS_OWNERDRAW düğme stilini ve DRAWITEMSTRUCTyapısınıkullanmalıdır.
Düğmenin üst penceresi, WM_COMMAND iletisi aracılığıyla BN_PAINT bildirim kodunu alır.
BN_PUSHED Bir düğmenin gönderme durumu gönderilmek üzere ayarlandığında gönderilir. Not: Bu bildirim kodu yalnızca 3.0 sürümünden önceki Windows'un 16 bit sürümleriyle uyumluluk için sağlanır. Uygulamalar bu görev için BS_OWNERDRAW düğme stilini ve DRAWITEMSTRUCTyapısınıkullanmalıdır.
Düğmenin üst penceresi WM_COMMAND iletisi aracılığıyla BN_PUSHED bildirim kodunu alır.
BN_SETFOCUS Bir düğme klavye odağını aldığında gönderilir. Düğme, bu bildirim kodunu göndermek için BS_NOTIFY stiline sahip olmalıdır.
Düğmenin üst penceresi WM_COMMAND iletisi aracılığıyla BN_SETFOCUS bildirim kodunu alır.
BN_UNHILITE Vurgu bir düğmeden kaldırıldığında gönderilir. Not: Bu bildirim kodu yalnızca 3.0 sürümünden önceki Windows'un 16 bit sürümleriyle uyumluluk için sağlanır. Uygulamalar bu görev için BS_OWNERDRAW düğme stilini ve DRAWITEMSTRUCTyapısınıkullanmalıdır.
Düğmenin üst penceresi, WM_COMMAND iletisi aracılığıyla BN_UNHILITE bildirim kodunu alır.
BN_UNPUSHED Bir düğmenin anında iletme durumu pusuya düşürülmüş olarak ayarlandığında gönderilir. Not: Bu bildirim kodu yalnızca 3.0 sürümünden önceki Windows'un 16 bit sürümleriyle uyumluluk için sağlanır. Uygulamalar bu görev için BS_OWNERDRAW düğme stilini ve DRAWITEMSTRUCTyapısınıkullanmalıdır.
Düğmenin üst penceresi WM_COMMAND iletisi aracılığıyla BN_UNPUSHED bildirim kodunu alır.
NM_CUSTOMDRAW (düğme) Düğme denetiminin üst penceresine düğmedeki özel çizim işlemleri hakkında bilgi sağlar.
Düğme denetimi bu bildirim kodunu bir WM_NOTIFY iletisi biçiminde gönderir.
WM_CTLCOLORBTN WM_CTLCOLORBTN iletisi, düğmeyi çizmeden önce düğmenin üst penceresine gönderilir. Üst pencere, düğmenin metin ve arka plan renklerini değiştirebilir. Ancak, yalnızca sahip tarafından çizilmiş düğmeler bu iletiyi işleyen üst pencereye yanıt verir.

Yapı

Konu Içeriği
BUTTON_IMAGELIST Düğme denetimiyle kullanılan bir resim listesi hakkında bilgi içerir.
BUTTON_SPLITINFO Bölünmüş düğmeyi (BS_SPLITBUTTON ve BS_DEFSPLITBUTTON stilleri) tanımlayan bilgileri içerir. BCM_GETSPLITINFO ve BCM_SETSPLITINFO iletileriyle kullanılır.
NMBCDROPDOWN BCN_DROPDOWN bildirimi hakkında bilgi içerir.
NMBCHOTITEM Farenin bir düğme denetimi üzerindeki hareketi hakkında bilgi içerir.

Sabit

Konu Içeriği
düğme stillerini Düğme stillerinin bir bileşimini belirtir. CreateWindowveya CreateWindowExişleviBUTTON sınıfını kullanarak bir düğme oluşturursanız, aşağıda listelenen düğme stillerinden herhangi birini belirtebilirsiniz.