CToolBarCtrl::AddButtons
Aggiunge uno o più pulsanti a un controllo toolbar.
BOOL AddButtons(
int nNumButtons,
LPTBBUTTON lpButtons
);
Parametri
nNumButtons
Numero di pulsanti da aggiungere.lpButtons
Indirizzo di una matrice di strutture TBBUTTON contenente le informazioni sui pulsanti per aggiungere. Deve essere lo stesso numero di elementi nella matrice come pulsanti specificati da nNumButtons.
Valore restituito
Diverso da zero se ha esito positivo; in caso contrario zero.
Note
I punti del puntatore lpButtons in una matrice di strutture TBBUTTON. Ogni struttura TBBUTTON associa il pulsante aggiunto con lo stile del pulsante, l'immagine e/o la stringa, l'id di comando, lo stato e i dati definiti dall'utente:
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;
I membri sono:
iBitmap
Indice a base zero di un'immagine del pulsante, -1 se nessuna un'immagine per il pulsante.idCommand
Identificatore di comando associato al pulsante. Questo identificatore viene inviato un messaggio WM_COMMAND quando il pulsante viene scelto. Se il membro fsStyle del valore TBSTYLE_SEP, questo membro deve essere zero.fsState
Flag dello stato del pulsante. Può essere una combinazione dei valori riportati di seguito:TBSTATE_CHECKED il pulsante presenta lo stile TBSTYLE_CHECKED e in premendo.
TBSTATE_ENABLED il pulsante accetta input. Un pulsante che presenta questo stato non accetta input e viene ingrigito.
TBSTATE_HIDDEN il pulsante non è visibile e non può ricevere l'input dell'utente.
TBSTATE_INDETERMINATE il pulsante è ingrigito.
TBSTATE_PRESSED il pulsante nella.
l'interruzione di riga diTBSTATE_WRAP A seconda del pulsante. Il controllo pulsante deve disporre dello stato TBSTATE_ENABLED.
fsStyle
Stile del pulsante. Può essere una combinazione dei valori riportati di seguito:TBSTYLE_BUTTON crea un pulsante di comando standard.
TBSTYLE_CHECK creato un pulsante che passa tra premuto e gli stati inattivi quando l'utente fa clic su. Il pulsante è un colore di sfondo diverso quando viene premuto.
TBSTYLE_CHECKGROUP crea un pulsante di controllo che resta raggiunti fino a un altro pulsante nel gruppo viene premuto.
TBSTYLE_GROUP creato un pulsante che rimane premuto fino a raggiungere un altro pulsante nel gruppo.
TBSTYLE_SEP crea un separatore, fornendo una piccola divario tra gruppi di pulsanti. Un pulsante con questo stile non riceve l'input.
dwData
Dati definiti dall'utente.iString
Indice a base zero della stringa da utilizzare come etichetta del pulsante, -1 se non c'è nessuna stringa per il pulsante.
L'immagine e/o la stringa il cui indice che si immette deve essere aggiunto in precedenza all'elenco di controllo toolbar utilizzando AddBitmap, AddStringe/o AddStrings.
Requisiti
Header: afxcmn.h