CToolBarCtrl::AddButtons
Přidá jedno nebo více tlačítek na panelu nástrojů Ovládací prvek.
BOOL AddButtons(
int nNumButtons,
LPTBBUTTON lpButtons
);
Parametry
nNumButtons
Počet tlačítek Přidat.lpButtons
Pole s adresou TBBUTTON struktury, které obsahuje informace o přidání tlačítek.Musí být stejný počet prvků pole jako tlačítka určené nNumButtons .
Vrácená hodnota
Nenulová hodnota, pokud je úspěšná. jinak nula.
Poznámky
lpButtons Ukazatel odkazuje na pole TBBUTTON struktury.Každý TBBUTTON struktury associates tlačítko Přidat na tlačítko styl, stavu obrazu nebo řetězec ID příkazu a data definovaná uživatelem:
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;
Členové jsou následující:
iBitmap
Z nuly vycházející index obrázku tlačítka, -1, pokud žádný obrázek pro toto tlačítko.idCommand
Příkaz identifikátor přidružený k tlačítku.Tento identifikátor je odeslána v WM_COMMAND zpráva je vybrané tlačítko.Pokud fsStyle člen má TBSTYLE_SEP hodnotu tohoto člena musí být nula.fsState
Příznaky stavu tlačítka.Může být kombinací hodnot uvedených níže:TBSTATE_CHECKEDTlačítko má TBSTYLE_CHECKED stylu a je stisknutí klávesy.
TBSTATE_ENABLEDTlačítko přijme vstup uživatele.Tlačítka, která nemá tento stát nepřijme vstup uživatele a zobrazen šedě.
TBSTATE_HIDDENTlačítka se nezobrazí a nelze přijímat vstup uživatele.
TBSTATE_INDETERMINATETlačítko není šedé.
TBSTATE_PRESSEDStisknutí tlačítka.
TBSTATE_WRAPKonec řádku následující tlačítko.Musí mít také tlačítka TBSTATE_ENABLED státu.
fsStyle
Styl tlačítka.Může být kombinací hodnot uvedených níže:TBSTYLE_BUTTONVytvoří standardní tlačítka.
TBSTYLE_CHECKVytvoří tlačítko přepíná mezi státy pokaždé, když uživatel klepne, jej stisknuté a unpressed.Tlačítko má jinou barvu pozadí při stisknutí státu.
TBSTYLE_CHECKGROUPVytvoří zaškrtávací tlačítko, který zůstává stisknuté, dokud nedojde ke stisknutí jiné tlačítko ve skupině.
TBSTYLE_GROUPVytvoří tlačítko, který zůstává stisknuté, dokud nedojde ke stisknutí jiné tlačítko ve skupině.
TBSTYLE_SEPVytvoří oddělovač poskytuje malou mezeru mezi skupinami tlačítek.Tlačítko, které má tento styl neobdrží vstup uživatele.
dwData
Uživatelská data.iString
Z nuly vycházející index řetězce jako tlačítko pro popisek, -1, pokud není žádný řetězec pro toto tlačítko.
Obrázek nebo řetězec, jehož index poskytnete musí dříve byly přidány do ovládacího panelu nástrojů seznamu pomocí AddBitmap, AddString, nebo AddStrings.
Požadavky
Záhlaví: afxcmn.h