Condividi tramite


CToolBarCtrl::Create

Crea un controllo barra degli strumenti e lo collega a un oggetto CToolBarCtrl.

virtual BOOL Create(
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID 
);

Parametri

  • dwStyle
    Specifica lo stile del controllo della barra degli strumenti.Le barre degli strumenti deve sempre disporre dello stile WS_CHILD.Inoltre, è possibile specificare qualsiasi combinazione di stili della barra degli strumenti e degli stili di finestra come descritto in Note.

  • rect
    Facoltativamente specifica la dimensione e la posizione del controllo barra degli strumenti.Può essere un oggetto CRect o una struttura RECT.

  • pParentWnd
    Specifica la finestra padre del controllo della barra degli strumenti.Non deve essere NULL.

  • nID
    Specifica l'id del controllo toolbar

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario zero.

Note

Costruisce CToolBarCtrl in due passaggi.Innanzitutto, chiamare il costruttore e quindi chiamare Crea, che crea il controllo barra degli strumenti e lo aggiunge all'oggetto CToolBarCtrl.Applicare gli stili la finestra a un controllo toolbar.

  • WS_CHILD sempre

  • WS_VISIBLE in genere

  • WS_DISABLED raramente

Vedere CreateWindow in Windows SDK per una descrizione degli stili della finestra.

Facoltativamente, applicare una combinazione stili di controlli comuni, come descritto in Windows SDK.

Applica una combinazione di stili della barra degli strumenti al controllo o ai pulsanti stessi.Gli stili vengono descritti nell'argomento Controllo della barra degli strumenti e stili del pulsante in Windows SDK.

Per utilizzare gli stili estesi della barra degli strumenti, chiamare SetExtendedStyle dopo avere chiamato Crea.Per creare una barra degli strumenti con gli stili estesi della finestra, chiamare CToolBarCtrl::CreateEx anziché Crea.

Il controllo toolbar imposta automaticamente la dimensione e la posizione della finestra della barra degli strumenti.L'altezza è basata sull'altezza dei pulsanti della barra degli strumenti.La larghezza è uguale alla larghezza dell'area client della finestra padre.Gli stili CCS_BOTTOM e CCS_TOP determinare se la barra degli strumenti è ubicata lungo la parte superiore o inferiore dell'area client.Per impostazione predefinita, una barra degli strumenti con lo stile CCS_TOP.

Requisiti

Header: afxcmn.h

Vedere anche

Riferimenti

Classe di CToolBarCtrl

Grafico della gerarchia

CToolBarCtrl::CToolBarCtrl

CToolBarCtrl::SetButtonStructSize