CToolBarCtrl

La classe CToolBarCtrl fornisce la funzionalità del controllo Windows toolbar comune. Questo controllo (e quindi la classe CToolBarCtrl ) è disponibile solo per i programmi in esecuzione sotto Windows 95 e Windows NT versione 3.51 e versioni successive.

Un controllo comune barra degli strumenti di Windows è una finestra rettangolare figlio che contiene uno o più pulsanti. Questi pulsanti possono visualizzare un'immagine bitmap, una stringa o entrambi. Quando l'utente sceglie un pulsante, Invia un messaggio di comando alla finestra proprietaria della barra degli strumenti. In genere, i pulsanti di una barra degli strumenti corrispondano agli elementi nel menu dell'applicazione; Essi forniscono un modo più diretto per l'utente accedere ai comandi di un'applicazione.

CToolBarCtrl oggetti contengono diverse strutture di dati interne importanti: un elenco di pulsante immagine bitmap o un elenco immagini, un elenco delle punture di etichetta del pulsante e un elenco di strutture TBBUTTON che associare un'immagine e/o stringa con la posizione, di stile, di stato e ID del pulsante di comando. Ciascuno degli elementi di queste strutture di dati viene definito da un indice in base zero. Prima di poter utilizzare un oggetto CToolBarCtrl , è necessario impostare queste strutture di dati. L'elenco di stringhe può essere utilizzato solo per le etichette dei pulsanti; Lei non può recuperare le stringhe dalla barra degli strumenti.

Per utilizzare un oggetto CToolBarCtrl , vi seguirà in genere questi passaggi:

1. Costruire l'oggetto CToolBarCtrl.
   
   
2. Chiamare Create per creare il controllo comune di barra degli strumenti di Windows e allegarlo all'oggetto CToolBarCtrl . Indicare lo stile della barra degli strumenti utilizzando stili, come ad esempio TBSTYLE_TRANSPARENT per una barra degli strumenti trasparente o TBSTYLE_DROPDOWN per una barra degli strumenti che supporta pulsanti a discesa.
   
   
3. Identificare come si desidera che i pulsanti della barra degli strumenti visualizzato:
   • Per utilizzare immagini bitmap per i pulsanti, aggiungere le bitmap pulsante alla barra degli strumenti chiamando AddBitmap.
     
     
   • Per utilizzare immagini visualizzate da un elenco di immagini per i pulsanti, specificare l'elenco immagini chiamando SetImageList, SetHotImageListo SetDisabledImageList.
     
     
   • Per utilizzare le etichette di stringa per pulsanti, aggiungere le stringhe alla barra degli strumenti chiamando AddString () e/o AddStrings.
4. Aggiungere strutture pulsante della barra degli strumenti chiamando AddButtons.
   
   
5. Se si desidera che i suggerimenti per un pulsante della barra degli strumenti nella finestra di un proprietario che non è un CFrameWnd, è necessario gestire i messaggi TTN_NEEDTEXT nella finestra proprietaria della barra degli strumenti, come descritto in CToolBarCtrl: gestione delle notifiche. Se la finestra padre della barra degli strumenti è derivata da CFrameWnd, i suggerimenti sono visualizzati senza alcun sforzo supplementare da voi perché CFrameWnd fornisce un gestore predefinito.
   
   
6. Se si desidera che l'utente sia in grado di personalizzare la barra degli strumenti, gestire i messaggi di notifica di personalizzazione nella finestra del proprietario come descritto in CToolBarCtrl: gestione delle notifiche di personalizzazione.

È possibile utilizzare SaveState per salvare lo stato corrente di un controllo toolbar nel Registro di sistema e RestoreState per ripristinare lo stato sulla base di informazioni precedentemente memorizzate nel Registro di sistema. Oltre a salvare lo stato di toolbar tra usi dell'applicazione, applicazioni di memorizzano in genere lo stato prima che l'utente inizia a personalizzare la barra degli strumenti nel caso in cui l'utente più tardi vuole ripristinare la barra degli strumenti al suo stato originale.

Supporto per Internet Explorer versione 4.0 e successive

Per supportare la funzionalità introdotta in Internet Explorer versione 4.0 e successive, MFC fornisce supporto elenco immagini e stili trasparenti e piatti per controlli toolbar.

Una barra degli strumenti trasparente consente al client sotto la barra degli strumenti di mostrare attraverso. Per creare una barra degli strumenti trasparente, utilizzare gli stili sia TBSTYLE_FLAT e TBSTYLE_TRANSPARENT . Le barre degli strumenti trasparenti dispongono di caldo di rilevamento; cioè, se il puntatore del mouse si sposta su un caldo pulsante sulla barra degli strumenti, cambia l'aspetto del pulsante. Le barre degli strumenti, creati con solo lo stile TBSTYLE_FLAT conterrà pulsanti che non sono trasparenti.

Supporto per immagini elenco permette una flessibilità maggiore controllo per comportamento predefinito, immagini calde e immagini disabili. Utilizzare GetImageList, GetHotImageListe GetDisabledImageList con la barra degli strumenti trasparente per modificare l'immagine secondo al suo stato:

Per ulteriori informazioni sull'utilizzo di CToolBarCtrl, vedere Argomenti di controllo e CToolBarCtrl usando il manuale del programmatore di Visual C++.

# include lt;afxcmn.h>

Membri della classe |  Classe base | Gerarchia Chart

Campioninbsp; MFC campione CMNCTRL1 | Esempio MFC MFCIE

Vedere a&nchenbsp;CToolBar