Diverso da zero in caso di successo; altrimenti zero.
Parametri
dwStyle
Specifica lo stile del controllo toolbar. Le barre degli strumenti deve avere sempre lo stile WS_CHILD . Inoltre, è possibile specificare qualsiasi combinazione di stili della barra degli strumenti e stili di finestra come descritto sotto osservazioni.
rect
Facoltativamente, specificare dimensioni e la posizione del controllo toolbar. Può essere sia un oggetto CRect o un struttura RECT.
pParentWnd
Specifica la finestra padre del controllo toolbar. Non deve essere NULL.
nID
Specifica l'ID del controllo toolbar.
Osservazioni
Si costruisce un CToolBarCtrl in due fasi. Innanzitutto chiamare il costruttore, quindi chiamare Create, che crea il controllo toolbar e viene associato all'oggetto CToolBarCtrl.
Controllo toolbar imposta automaticamente la dimensione e la posizione della finestra della barra degli strumenti. L'altezza si basa sull'altezza dei pulsanti della barra degli strumenti. La larghezza è lo stesso come la larghezza dell'area client della finestra padre. Gli stili CCS_TOP e CCS_BOTTOM per determinare se la barra degli strumenti è posizionato lungo la parte superiore o inferiore dell'area client. Per impostazione predefinita, una barra degli strumenti ha lo stile CCS_TOP.
Si applicano i seguenti stili finestra a un controllo toolbar.
WS_CHILD Sempre
WS_VISIBLE Di solito
WS_DISABLED Raramente
Successivamente, si consiglia di applicare uno o più degli stili di controllo comuni:
CCS_ADJUSTABLE Permette le barre degli strumenti essere personalizzati dall'utente. Se viene utilizzato questo stile, finestra proprietaria della barra degli strumenti deve gestire i messaggi di notifica di personalizzazione inviati da barra degli strumenti, come descritto in CToolBarCtrl: gestione delle notifiche di personalizzazione.
CCS_BOTTOM Fa sì che il controllo a posizionarsi nella parte inferiore dell'area client della finestra padre e imposta la larghezza di essere lo stesso del padre larghezza della finestra.
CCS_&NODIVIDERnbsp; Impedisce a evidenziare due pixel viene disegnato nella parte superiore del controllo.
CCS_&NOHILITEnbsp; Impedisce a evidenziare un pixel viene disegnato nella parte superiore del controllo.
CCS_&NOMOVEYnbsp; Fa sì che il controllo ridimensionare e muoversi in senso orizzontale, ma non verticalmente, in risposta a un messaggio WM_SIZE . Se viene utilizzato lo stile CCS_NORESIZE , questo stile non si applica.
CCS_&NOPARENTALIGNnbsp; Impedisce il controllo di trasferirsi automaticamente nella parte superiore o inferiore della finestra padre. Invece, il controllo mantiene la relativa posizione all'interno della finestra padre, nonostante le modifiche alla dimensione della finestra padre. Se viene anche utilizzato lo stile CCS_TOP o CCS_BOTTOM , il valore predefinito è regolato in altezza, ma la posizione e la larghezza rimangono invariati.
CCS_&NORESIZEnbsp; Il controllo impedisce di utilizzare la larghezza predefinita e l'altezza quando si imposta la dimensione iniziale o una nuova dimensione. Invece, il controllo utilizza la larghezza e l'altezza specificate nella richiesta per la creazione o il dimensionamento.
CCS_TOP Provoca il controllo a posizionarsi nella parte superiore dell'area client della finestra padre e imposta la larghezza di essere lo stesso del padre larghezza della finestra. Le barre degli strumenti avere questo stile di default.
Infine, si applica una combinazione di stili della barra degli strumenti per il controllo o i pulsanti di se stessi. Gli stili sono descritte nell'argomento barra degli strumenti di controllo e pulsante stili in Platform SDK.