CToolBarCtrl::AddButtons

BOOL AddButtons ( int nNumButtons, LPTBBUTTON lpButtons );

Valore restituito

Diverso da zero in caso di successo; altrimenti zero.

Parametri

nNumButtons

Numero di pulsanti per aggiungere.

lpButtons

Indirizzo di una matrice di strutture TBBUTTON contenente informazioni sui pulsanti per aggiungere. Ci deve essere lo stesso numero di elementi nella matrice come pulsanti specificato da nNumButtons.

Osservazioni

Chiamare questa funzione per aggiungere uno o più pulsanti a un controllo toolbar.

Il puntatore lpButtons punta a una matrice di strutture TBBUTTON . Ogni struttura TBBUTTON associa il pulsante aggiunto con lo stile del pulsante, immagine e/o stringa, ID di comando, stato e dati definiti dall'utente:

typedef struct {_TBBUTTO&N
int iBitmap; / / in base zero indice dell'immagine del pulsante
int idCommand; nbsp; / / comando per essere inviato quando viene premuto il pulsante
BYTE fsState;   / / tasto dello stato - vedi sotto
BYTE fsStyle;   / / tasto stile - vedi sotto
DWORD dwData;   / / definiti dall'applicazione valore
int iString; / / indice in base zero del pulsante etichetta stringa
} TBBUTTON

I membri sono i seguenti:

iBitmap

Indice in base zero dell'immagine del pulsante. NULL se nessuna immagine per questo pulsante.

idCommand

Comando identificatore associato al pulsante. Questo identificatore viene inviato in un messaggio WM_COMMAND , quando viene scelto il pulsante. Se il membro fsStyle ha il valore TBSTYLE_SEP , questo membro deve essere zero.

fsState

Flag di stato del pulsante. Può essere una combinazione dei valori elencati di seguito:

• TBSTATE_CHECKED   Il pulsante ha lo stile TBSTYLE_CHECKED e si sta preme.
  
  
• TBSTATE_E&NABLEDnbsp;  Il pulsante accetta l'input dell'utente. Un pulsante che non dispone di questo stato non accetta l'input dell'utente e viene visualizzato in grigio.
  
  
• TBSTATE_HIDDE&Nnbsp;  Il pulsante non è visibile e non può ricevere l'input dell'utente.
  
  
• TBSTATE_I&NDETERMINATEnbsp;  Il pulsante viene visualizzato in grigio.
  
  
• TBSTATE_PRESSED   È essere premuto il pulsante.
  
  
• TBSTATE_WRAPnbsp;  Un'interruzione di riga segue il pulsante. Il pulsante deve avere anche lo stato TBSTATE_E&NABLED.

fsStyle

Stile del pulsante. Può essere una combinazione dei valori elencati di seguito:

• TBSTYLE_BUTTO&Nnbsp;  Crea un pulsante standard.
  
  
• TBSTYLE_CHECKnbsp;  Crea un pulsante che attiva o disattiva tra gli stati pressati e rilasciare ogni volta che l'utente fa clic su esso. Il pulsante ha un colore di sfondo diverso quando è nello stato premuto. & nbsp;
  
  
• TBSTYLE_CHECKGROUP   Crea un controllo pulsante che rimane premuto fino a quando non viene premuto un altro pulsante nel gruppo.
  
  
• TBSTYLE_GROUP   Crea un pulsante che rimane premuto fino a quando non viene premuto un altro pulsante nel gruppo.
  
  
• TBSTYLE_SEP   Crea un separatore, fornendo un piccolo divario tra gruppi di pulsante. Un pulsante che ha questo stile non riceve l'input dell'utente.

dwData

Dati definiti dall'utente.

iString

Indice in base zero della stringa da utilizzare come etichetta del pulsante. NULL se non non c'è nessuna stringa per questo pulsante.

L'immagine e/o stringa il cui indice è fornire deve sono stati precedentemente aggiunti all'elenco del controllo toolbar utilizzando AddBitmap, AddString ()o AddStrings ,.

Pa&noramica di CToolBarCtrl |nbsp; Membri della classe | Gerarchia Chart

Vedere a&nchenbsp;CToolBarCtrl::InsertButton, CToolBarCtrl::DeleteButton, CToolBarCtrl::AddBitmap, CToolBarCtrl::AddString, CToolBarCtrl::AddStrings