CToolBarCtrl::AddButtons

Makale
02/26/2013

Bir veya daha fazla düğmeleri bir araç çubuğu denetimi ekler.

BOOL AddButtons(
   int nNumButtons,
   LPTBBUTTON lpButtons 
);

Parametreler

nNumButtons
Düğmeleri eklemek için sayısı.
lpButtons
Bir dizi adresini TBBUTTON ekleyecek düğmeleri hakkında bilgiler içeren yapıları.Aynı Dizideki öğelerin sayısı tarafından belirtilen düğmeleri olarak olması gereken nNumButtons.

Dönüş Değeri

Başarılı olursa sıfırdan farklı; Aksi takdirde sıfır.

Notlar

lpButtons İşaretçi işaret eden bir dizi için TBBUTTON yapılar.Her TBBUTTON yapısı düğmesinin stili, görüntü ve/veya komut kimliği dizesi durumunu ve kullanıcı tanımlı veri ile eklenen düğmesini ilişkilendirir:

typedef struct _TBBUTTON {

int iBitmap;// zero-based index of button image

int idCommand; // command to be sent when button pressed

BYTE fsState; // button state--see below

BYTE fsStyle; // button style--see below

DWORD dwData; // application-defined value

int iString;// zero-based index of button label string

} TBBUTTON;

Üyeleri aşağıdaki gibidir:

iBitmap
Düğme resmi, resim yok, bu düğme için -1 sıfır tabanlı dizini.
idCommand
Düğmeyle ilişkili komut tanımlayıcısı.Bu tanımlayıcı gönderilen bir wm_command iletisi düğme seçilir.FsStyle üyenin TBSTYLE_SEP değeri, bu üye sıfır olması gerekir.
fsState
Düğme durumu bayrakları.Aşağıda listelenen değerleri birleşimi olabilir:
- TBSTATE_CHECKEDDüğmenin bulunduğu tbstyle_checked stil ve basılı olduğundan.
- TBSTATE_ENABLEDDüğme, kullanıcı girişini kabul eder.Bu duruma sahip olmayan bir düğme, kullanıcı girişini kabul etmez ve renkte.
- TBSTATE_HIDDENDüğme görünür değildir ve kullanıcı girdisi alamaz.
- TBSTATE_INDETERMINATEDüğmesi gri.
- TBSTATE_PRESSEDDüğme basılı.
- TBSTATE_WRAPDüğmeyi bir satır sonu izler.Düğmeyi de olmalıdır TBSTATE_ENABLED durumu.
fsStyle
Düğme stili.Aşağıda listelenen değerleri birleşimi olabilir:
- TBSTYLE_BUTTONStandart bir düğme oluşturur.
- TBSTYLE_CHECKBasılan ve basılmamış durumlar arasında kullanýcý her zaman geçer bir düğme oluşturur.Düğmeyi basılı durumdayken farklı arka plan rengi vardır.
- TBSTYLE_CHECKGROUPGrubu başka bir düğmesine basılıncaya kadar basılı kalır bir onay düğmesi oluşturur.
- TBSTYLE_GROUPGrubu başka bir düğmesine basılıncaya kadar basılı kalır bir düğme oluşturur.
- TBSTYLE_SEPDüğme grupları arasında küçük bir boşluk sağlayan bir ayırıcı oluşturur.Bu stilde bir düğme kullanıcı girdisi almaz.
dwData
Kullanıcı tanımlı veriler.
iString
Bu düğme için hiçbir dize ise -1 inde düğmesi etiketi olarak kullanılmak üzere dize sıfır tabanlı dizini.