Classe CToolBar

Articolo
06/10/2015

Barre di controllo che litigano dei pulsanti bitmap e dei separatori facoltativi.

class CToolBar : public CControlBar

Membri

Costruttori pubblici

Nome	Descrizione
CToolBar::CToolBar	Costruisce un oggetto CToolBar.

Metodi pubblici

Nome	Descrizione
CToolBar::CommandToIndex	Restituisce l'indice di un pulsante con un ID di comando
CToolBar::Create	Crea la barra degli strumenti di Windows e allegarlo all'oggetto CToolBar.
CToolBar::CreateEx	Crea un oggetto CToolBar con gli stili aggiuntivi per l'oggetto incorporato CToolBarCtrl.
CToolBar::GetButtonInfo	Recupera l'id, lo stile e il numero di immagine di un pulsante.
CToolBar::GetButtonStyle	Recupera lo stile per un pulsante.
CToolBar::GetButtonText	Recupera il testo che verrà visualizzato su un pulsante.
CToolBar::GetItemID	Restituisce l'id di comando di un pulsante o di un separatore l'indice specificato.
CToolBar::GetItemRect	Recupera il rettangolo di visualizzazione per l'elemento all'indice specificato.
CToolBar::GetToolBarCtrl	Consente l'accesso diretto a controlli comuni sottostante.
CToolBar::LoadBitmap	Carica la bitmap contenente le immagini di bitmap- pulsante.
CToolBar::LoadToolBar	Carica una risorsa della barra degli strumenti creata con l'editor di risorse.
CToolBar::SetBitmap	Imposta un'immagine bitmap a bit.
CToolBar::SetButtonInfo	Impostare l'id, lo stile e il numero di immagine di un pulsante.
CToolBar::SetButtons	Imposta gli stili del pulsante e un indice delle icone dei pulsanti nella bitmap.
CToolBar::SetButtonStyle	Imposta lo stile per un pulsante.
CToolBar::SetButtonText	Imposta il testo che verrà visualizzato su un pulsante.
CToolBar::SetHeight	L'altezza della barra degli strumenti.
CToolBar::SetSizes	Impostare le dimensioni dei pulsanti e le bitmap.

Note

I pulsanti possono agire come pulsanti, pulsanti della casella di controllo, o i pulsanti di opzione. Gli oggetti diCToolBar sono membri generalmente incorporati degli oggetti della finestra cornice derivati dalla classe CFrameWnd o CMDIFrameWnd.

CToolBar::GetToolBarCtrl, una funzione membro nuova a MFC 4,0, consente a approfittiate il supporto dei controlli comuni di Windows per la personalizzazione della barra degli strumenti e funzionalità aggiuntive. Le funzioni membro diCToolBar offrono ulteriori funzionalità dei controlli comuni di Windows, tuttavia, quando si chiama GetToolBarCtrl, è possibile fornire alle barre degli strumenti ancora più delle caratteristiche delle barre degli strumenti di Windows 95/98. Quando si chiama GetToolBarCtrl, restituirà un riferimento a un oggetto CToolBarCtrl. Vedere CToolBarCtrl per ulteriori informazioni sulla progettazione delle barre degli strumenti mediante i controlli comuni di Windows. Per informazioni generali sui controlli, vedere Controlli comuni in Windows SDK.

Visual C++ sono disponibili due metodi per creare una barra degli strumenti. Per creare una risorsa della barra degli strumenti utilizzando l'editor di risorse, seguire questi passaggi:

Creare una risorsa della barra degli strumenti.
Creare l'oggetto CToolBar.
Chiamare la funzione CreateExo Crea ) per creare la barra degli strumenti di Windows e per associarlo all'oggetto CToolBar.
Chiamata LoadToolBar per caricare le risorse della barra degli strumenti.

In caso contrario, attenersi ai passaggi riportati di seguito:

Creare l'oggetto CToolBar.
Chiamare la funzione CreateExo Crea ) per creare la barra degli strumenti di Windows e per associarlo all'oggetto CToolBar.
Chiamare LoadBitmap per caricare la bitmap contenente le icone dei pulsanti della barra degli strumenti.
Chiamare SetButtons per impostare lo stile del pulsante e associare ogni pulsante con un'immagine nella bitmap.

Tutte le immagini del pulsante nella barra degli strumenti tratte da una bitmap, che deve contenere un'immagine per ciascun pulsante. Tutte le immagini devono essere la stessa dimensione, l'impostazione predefinita è 16 pixel di larghezza e 15 pixel di altezza. Le immagini devono essere side-by-side nella bitmap.

La funzione SetButtons accetta un puntatore a una matrice di controllo ID e un intero che specifica il numero di elementi nella matrice. La funzione imposta ID di ciascun pulsante al valore dell'elemento corrispondente della matrice e assegna a ogni pulsante un indice di immagine, che specifica il percorso di un'immagine del pulsante nella bitmap. Se un elemento di matrice contiene il valore ID_SEPARATOR, alcun indice immagine è assegnato.

L'ordine di immagini nella bitmap è in genere l'ordine in cui vengono creati nello schermo, ma è possibile utilizzare la funzione SetButtonInfo per modificare la relazione tra l'ordine di immagine e ordine di disegno.

Tutti i pulsanti di una barra degli strumenti sono la stessa dimensione. L'impostazione predefinita è 24 x 22 pixel, conforme alle linee guida dell'interfaccia Windows per progettazione software. Tutto lo spazio aggiuntivo tra immagine e le dimensioni del pulsante viene utilizzato per formare un bordo intorno all'immagine.

Ogni pulsante ha un'immagine. I diversi stati e stili del pulsante (pressione, verso il basso, in disabilitato su, disattivare il basso e non definito) vengono generati da tale un'immagine. Sebbene le bitmap siano il colore, è possibile ottenere risultati ottimali con immagini in nero e in tonalità di grigi.

Avviso

CToolBar supporta le bitmap con un massimo di 16 colori.Quando si carica un'immagine in un editor della barra degli strumenti, Visual Studio converte automaticamente l'immagine a un colore 16 bitmap se necessario e visualizza un messaggio di avviso se l'immagine è stata convertita.Se si utilizza un'immagine con più di 16 colori (utilizzando un editor esterno per modificare l'immagine), l'applicazione potrebbe presentare comportamenti imprevisti.

I pulsanti della barra degli strumenti imitano i pulsanti per impostazione predefinita. Tuttavia, i pulsanti della barra degli strumenti possono anche imitare i pulsanti o i pulsanti di opzione della casella di controllo. I pulsanti della casella di controllo con tre stati: sì, cancellato e indeterminato. I pulsanti di opzione sono solo due stati: archiviare e cancellato.

Per impostare un singolo stile o il separatore del pulsante senza puntare a una matrice, chiamare GetButtonStyle per recuperare lo stile e quindi chiamare SetButtonStyle anziché SetButtons. SetButtonStyle è molto utile quando si desidera modificare lo stile di un pulsante in fase di esecuzione.

Per assegnare che venga visualizzato il testo su un pulsante, chiamare GetButtonText per recuperare il testo da visualizzare sul pulsante e quindi chiamare SetButtonText per impostare il testo.

Per creare un pulsante della casella di controllo, assegnargli lo stile TBBS_CHECKBOX o utilizzare la funzione membro SetCheck di un oggetto CCmdUI in un gestore ON_UPDATE_COMMAND_UI. Chiamare SetCheck trasforma un pulsante in un pulsante della casella di controllo. Passare a SetCheck un argomento di 0 per non selezionato, 1 per archiviare, o 2 per indeterminato.

Per creare un pulsante di opzione, chiamare la funzione membro SetRadio di un oggetto CCmdUI da un gestore ON_UPDATE_COMMAND_UI. Passare a SetRadio un argomento di 0 per selezionare o diverso da zero per archiviare. Per fornire escludono a un gruppo radiofonico - comportamento esclusivo, è necessario disporre di gestori ON_UPDATE_COMMAND_UI per tutti i pulsanti nel gruppo.

Per ulteriori informazioni su l CToolBar, vedere l'articolo Implementazione della barra degli strumenti MFC e nota tecnica 31: barre di controllo.