Gli oggetti della classe CToolBar sono le barre di controllo che dispongono di una fila di pulsanti bitmap e separatori opzionale. I pulsanti possono agire come pulsanti, casella di controllo pulsanti o pulsanti di opzione. CToolBar oggetti sono membri di solito incorporati di finestra cornice oggetti derivati dalla classe CFrameWnd o CMDIFrameWnd.
CToolBar:: GetToolBarCtrl, una funzione membro di nuova a MFC 4.0, consente di sfruttare il supporto del controllo comuni di Windows per la personalizzazione della barra degli strumenti e funzionalità aggiuntive. Funzioni membro CToolBar darvi la maggior parte delle funzionalità di Windows common controls; Tuttavia, quando si chiama GetToolBarCtrl, è possibile assegnare le barre degli strumenti ancora di più le caratteristiche delle barre degli strumenti di Windows 95. Quando si chiama GetToolBarCtrl, restituirà un riferimento a un oggetto CToolBarCtrl . Per ulteriori informazioni sulla progettazione di barre degli strumenti mediante controlli comuni di Windows, vedere CToolBarCtrl . Per informazioni più generali sui controlli comuni, vedere Common Controls in Windows 95 SDK Programmer di riferimento.
Visual C++ fornisce due metodi per creare una barra degli strumenti. Per creare una barra degli strumenti risorsa utilizzando l'Editor di risorse, attenersi alla seguente procedura:
In caso contrario, attenersi alla seguente procedura:
Tutte le immagini di pulsante della barra degli strumenti sono presi da una bitmap, che deve contenere una sola immagine per ciascun pulsante. Tutte le immagini devono avere le stesse dimensioni; il valore predefinito è di 16 pixel di larghezza e 15 pixel di altezza. Le immagini devono essere fianco a fianco della bitmap.
La funzione SetButtons accetta un puntatore a una matrice di ID controllo e un valore integer 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 ciascun pulsante un indice dell'immagine, che specifica la posizione dell'immagine del pulsante della bitmap. Se un elemento di matrice ha il valore ID_SEPARATOR, non viene assegnato alcun indice dell'immagine.
L'ordine delle immagini bitmap è in genere l'ordine in cui essi vengono disegnate sullo schermo, ma è possibile utilizzare la funzione SetButtonInfo per modificare il rapporto tra immagine ordine e disegno.
Tutti i pulsanti di una barra degli strumenti sono le stesse dimensioni. Il valore predefinito è 24 x 22 pixel, conformemente Agli orientamenti di interfaccia di Windows per la progettazione del Software. Qualsiasi ulteriore spazio tra le dimensioni dell'immagine e il pulsante viene utilizzato per formare un bordo intorno all'immagine.
Ogni pulsante ha un'unica immagine. I vari pulsante Stati e stili (pressato, su, giù, disabili, disabili giù e indeterminato) sono generati da tale un'immagine. Anche se le bitmap possono essere qualsiasi colore, si possono ottenere i migliori risultati con immagini in bianco e sfumature di grigio.
Barra di navigazione imitazione i pulsanti per impostazione predefinita. Tuttavia, barra di navigazione può imitare casella pulsanti o pulsanti di opzione. Casella di controllo pulsanti hanno tre stati: checked, cancellato e indeterminato. I pulsanti radio hanno solo due stati: controllato e liquidati.
Per impostare un pulsante individuale o separatore stile senza che punta a una matrice, chiamare GetButtonStyle per recuperare lo stile e quindi chiamare SetButtonStyle invece di SetButtons. SetButtonStyle è particolarmente utile quando si desidera cambiare lo stile di un pulsante in fase di esecuzione.
Per assegnare il testo venga visualizzato su un pulsante, chiamare GetButtonText per recuperare il testo ad apparire sul pulsante e quindi chiamare SetButtonText per impostare il testo.
Per creare un pulsante casella, assegnarlo lo stile TBBS_CHECKBOX o utilizzare la funzione di membro di un oggetto CCmdUI SetCheck in un gestore ON_UPDATE_COMMAND_UI . Chiamata SetCheck , un pulsante si trasforma in un pulsante casella di controllo. Invia SetCheck un argomento 0 per incontrollato, 1 per selezionata o 2 per indeterminata.
Per creare un pulsante di opzione, chiamare la funzione di membro di un oggetto CCmdUI SetRadio da un gestore ON_UPDATE_COMMAND_UI . Passare un argomento di 0 SetRadio per diverso da zero per selezionata o deselezionata. Al fine di fornire un comportamento reciprocamente esclusivi di un gruppo di radio, devono avere gestori ON_UPDATE_COMMAND_UI per tutti i pulsanti del gruppo.
Per ulteriori informazioni sull'utilizzo di CToolBar, vedere l'articolo barre degli strumenti nel manuale del programmatore di Visual C++ e tecnica nota 31, barre di controllo.
# include lt;afxext.h>
Membri della classe | Classe base | Gerarchia Chart
Campio&ninbsp; Esempio MFC CTRLBARS | MFC campione DLGCBR32 | Esempio MFC DOCKTOOL
Vedere a&nchenbsp;CToolBarCtrl, CControlBar, CToolBar, CToolBar::LoadBitmap, CToolBar::SetButtons, CCmdUI::SetCheck, CCmdUI::SetRadio