Classe di CToolBarCtrl

Articolo
02/19/2013

Fornisce la funzionalità del controllo comune della barra degli strumenti di Windows.

class CToolBarCtrl : public CWnd

Membri

Costruttori pubblici

Nome	Descrizione
CToolBarCtrl::CToolBarCtrl	Costruisce un oggetto CToolBarCtrl.

Metodi pubblici

Nome	Descrizione
CToolBarCtrl::AddBitmap	Aggiunge uno o più icone dei pulsanti bitmap all'elenco di icone dei pulsanti disponibili per un controllo toolbar.
CToolBarCtrl::AddButtons	Aggiunge uno o più pulsanti a un controllo toolbar.
CToolBarCtrl::AddString	Aggiunge una nuova stringa, passata come ID di risorsa, all'interno della barra degli strumenti di stringhe.
CToolBarCtrl::AddStrings	Aggiunge una nuova stringa o stringhe, passate come un puntatore a un buffer di stringhe null separate, all'interno della barra degli strumenti di stringhe.
CToolBarCtrl::AutoSize	Ridimensiona un controllo toolbar.
CToolBarCtrl::ChangeBitmap	Modifica la bitmap per un pulsante nel controllo della barra degli strumenti corrente.
CToolBarCtrl::CheckButton	Controlli o definito un pulsante specificato in un controllo toolbar.
CToolBarCtrl::CommandToIndex	Recupera l'indice in base zero del pulsante associato all'identificatore di comando specificato.
CToolBarCtrl::Create	Crea un controllo barra degli strumenti e lo collega a un oggetto CToolBarCtrl.
CToolBarCtrl::CreateEx	Crea un controllo toolbar con gli stili estesi Windows specificati e lo collega a un oggetto CToolBarCtrl.
CToolBarCtrl::Customize	Visualizzare la finestra di dialogo della barra degli strumenti di personalizzare.
CToolBarCtrl::DeleteButton	Rimuove un pulsante dal controllo della barra degli strumenti.
CToolBarCtrl::EnableButton	Abilita o disabilita il pulsante specificato in un controllo toolbar.
CToolBarCtrl::GetAnchorHighlight	Recupera l'impostazione di evidenziazione di ancoraggio di una barra degli strumenti.
CToolBarCtrl::GetBitmap	Recupera l'indice della bitmap associata a un pulsante in una barra degli strumenti.
CToolBarCtrl::GetBitmapFlags	Ottiene i flag associati alla bitmap della barra degli strumenti.
CToolBarCtrl::GetButton	Recupera le informazioni sul pulsante specificato in un controllo toolbar.
CToolBarCtrl::GetButtonCount	Recupera attualmente un conteggio dei pulsanti nel controllo della barra degli strumenti.
CToolBarCtrl::GetButtonInfo	Recupera le informazioni per un pulsante in una barra degli strumenti.
CToolBarCtrl::GetButtonSize	Recupera la larghezza e l'altezza correnti dei pulsanti della barra degli strumenti, in pixel.
CToolBarCtrl::GetColorScheme	Recupera la combinazione di colori controllo toolbar corrente.
CToolBarCtrl::GetDisabledImageList	Recupera l'elenco di immagini che un controllo toolbar utilizza per visualizzare i pulsanti disabilitati.
CToolBarCtrl::GetDropTarget	Recupera l'interfaccia IDropTarget per un controllo toolbar.
CToolBarCtrl::GetExtendedStyle	Recupera gli stili estesi per un controllo toolbar.
CToolBarCtrl::GetHotImageList	Recupera l'elenco di immagini che un controllo toolbar utilizza per visualizzare i pulsanti "caldi".Un pulsante a caldo appare evidenziato quando il puntatore del mouse è sopra.
CToolBarCtrl::GetHotItem	Recupera l'indice dell'elemento personalizzazione in una barra degli strumenti.
CToolBarCtrl::GetImageList	Recupera l'elenco di immagini che un controllo toolbar utilizza per visualizzare i pulsanti nello stato predefinito.
CToolBarCtrl::GetInsertMark	Recupera il segno di inserimento corrente della barra degli strumenti.
CToolBarCtrl::GetInsertMarkColor	Recupera il colore utilizzato per disegnare il segno di inserimento per la barra degli strumenti.
CToolBarCtrl::GetItemRect	Recupera il rettangolo di delimitazione di un pulsante in un controllo toolbar.
CToolBarCtrl::GetMaxSize	Recupera la dimensione totale di tutti i pulsanti e separatori visibili nella barra degli strumenti.
CToolBarCtrl::GetMaxTextRows	Recupera il numero massimo di righe di testo visualizzato su un pulsante della barra degli strumenti.
CToolBarCtrl::GetMetrics	Recupera la metrica di un controllo toolbar.
CToolBarCtrl::GetPadding	Recupera la spaziatura orizzontale e verticale di controllo toolbar corrente.
CToolBarCtrl::GetPressedImageList	Recupera l'elenco di immagini che il controllo toolbar corrente viene utilizzato per rappresentare i pulsanti premuto.
CToolBarCtrl::GetRect	Recupera il rettangolo di delimitazione di un pulsante della barra degli strumenti specificato.
CToolBarCtrl::GetRows	Recupera il numero di righe di pulsanti attualmente visualizzato nella barra degli strumenti.
CToolBarCtrl::GetState	Recupera le informazioni sullo stato del pulsante specificato in un controllo toolbar, ad esempio se è attivato, premuto, o selezionata.
CToolBarCtrl::GetString	Recupera una stringa della barra degli strumenti.
CToolBarCtrl::GetStyle	Recupera gli stili attualmente in uso per un controllo toolbar.
CToolBarCtrl::GetToolTips	Recupera l'handle del controllo di descrizione comandi, se presente, associato al controllo della barra degli strumenti.
CToolBarCtrl::HideButton	Nascondere o nel pulsante specificato in un controllo toolbar.
CToolBarCtrl::HitTest	Determina se un punto si trova in un controllo toolbar.
CToolBarCtrl::Indeterminate	Imposta o definito lo stato (grigio) indeterminato del pulsante specificato in un controllo toolbar.
CToolBarCtrl::InsertButton	Inserisce un pulsante in un controllo toolbar.
CToolBarCtrl::InsertMarkHitTest	Recupera le informazioni del segno di inserimento per un punto in una barra degli strumenti.
CToolBarCtrl::IsButtonChecked	Indica se il pulsante specificato in un controllo toolbar selezionata.
CToolBarCtrl::IsButtonEnabled	Indica se il pulsante specificato in un controllo toolbar è abilitato.
CToolBarCtrl::IsButtonHidden	Indica se il pulsante specificato in un controllo toolbar è nascosto.
CToolBarCtrl::IsButtonHighlighted	Controlla lo stato di evidenziazione del pulsante della barra degli strumenti.
CToolBarCtrl::IsButtonIndeterminate	Indica se lo stato del pulsante specificato in un controllo toolbar è indeterminato (grigio).
CToolBarCtrl::IsButtonPressed	Indica se il pulsante specificato in un controllo toolbar premuto.
CToolBarCtrl::LoadImages	Bitmap carichi nell'elenco immagini di un controllo toolbar.
CToolBarCtrl::MapAccelerator	Esegue il mapping di un carattere tasto di scelta rapida a un pulsante della barra degli strumenti.
CToolBarCtrl::MarkButton	Imposta lo stato dell'evidenziazione di un pulsante specificato in un controllo toolbar.
CToolBarCtrl::MoveButton	Sposta un pulsante da un indice a un altro.
CToolBarCtrl::PressButton	Stampa o versioni il pulsante specificato in un controllo toolbar.
CToolBarCtrl::ReplaceBitmap	Sostituisce la bitmap esistente nel controllo della barra degli strumenti corrente con una nuova bitmap.
CToolBarCtrl::RestoreState	Ripristina lo stato del controllo della barra degli strumenti.
CToolBarCtrl::SaveState	Salvare lo stato del controllo della barra degli strumenti.
CToolBarCtrl::SetAnchorHighlight	Imposta il valore di evidenziazione di ancoraggio di una barra degli strumenti.
CToolBarCtrl::SetBitmapSize	Imposta la dimensione delle immagini destinate a bit da aggiungere a un controllo toolbar.
CToolBarCtrl::SetButtonInfo	Imposta le informazioni per un pulsante esistente in una barra degli strumenti.
CToolBarCtrl::SetButtonSize	Imposta la dimensione dei pulsanti da aggiungere a un controllo toolbar.
CToolBarCtrl::SetButtonStructSize	Specifica la dimensione della struttura TBBUTTON.
CToolBarCtrl::SetButtonWidth	Imposta il valore minimo e la larghezza massima del pulsante nel controllo della barra degli strumenti.
CToolBarCtrl::SetCmdID	Imposta l'identificatore di comando da inviare alla finestra proprietaria quando il pulsante viene premuto specificato.
CToolBarCtrl::SetColorScheme	Imposta la combinazione di colori controllo toolbar corrente.
CToolBarCtrl::SetDisabledImageList	Imposta l'elenco di immagini che il controllo toolbar utilizzerà per visualizzare i pulsanti disabilitati.
CToolBarCtrl::SetDrawTextFlags	Imposta flag nella funzione Win32 DrawText, utilizzata per disegnare testo nel rettangolo specificato, formattato come ad esempio i flag è impostato.
CToolBarCtrl::SetExtendedStyle	Imposta stili estesi per un controllo toolbar.
CToolBarCtrl::SetHotImageList	Imposta l'elenco di immagini che il controllo toolbar utilizzerà per visualizzare i pulsanti "caldi".
CToolBarCtrl::SetHotItem	Imposta l'elemento personalizzazione in una barra degli strumenti.
CToolBarCtrl::SetImageList	Imposta l'elenco di immagini che la barra degli strumenti verrà utilizzato per visualizzare i pulsanti che si trovano nello stato predefinito.
CToolBarCtrl::SetIndent	Impostare il rientro per il primo pulsante in un controllo toolbar.
CToolBarCtrl::SetInsertMark	Impostare il segno di inserimento corrente della barra degli strumenti.
CToolBarCtrl::SetInsertMarkColor	Imposta il colore utilizzato per disegnare il segno di inserimento per la barra degli strumenti.
CToolBarCtrl::SetMaxTextRows	Imposta il numero massimo di righe di testo visualizzato su un pulsante della barra degli strumenti.
CToolBarCtrl::SetMetrics	Imposta la metrica di un controllo toolbar.
CToolBarCtrl::SetOwner	Imposta la finestra per ricevere i messaggi di notifica dal controllo della barra degli strumenti.
CToolBarCtrl::SetPadding	Impostare la spaziatura orizzontale e verticale di controllo toolbar corrente.
CToolBarCtrl::SetPressedImageList	Imposta l'elenco di immagini che il controllo toolbar corrente viene utilizzato per rappresentare i pulsanti premuto.
CToolBarCtrl::SetRows	Imposta il numero di righe di pulsanti visualizzare nella barra degli strumenti.
CToolBarCtrl::SetState	Imposta lo stato del pulsante specificato in un controllo toolbar.
CToolBarCtrl::SetStyle	Imposta stili per un controllo toolbar.
CToolBarCtrl::SetToolTips	Associa un controllo tooltip al controllo della barra degli strumenti.
CToolBarCtrl::SetWindowTheme	Consente di impostare lo stile di visualizzazione di un controllo toolbar.

Note

Questo controllo e la classe CToolBarCtrl ) è disponibile solo per i programmi in esecuzione in versioni 3,51 di Windows NT e Windows 95/98 e successive.

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

Gli oggetti diCToolBarCtrl contengono diverse strutture dei dati interne importanti: un elenco di immagine bitmap del pulsante o un elenco immagini, un elenco di stringhe del pulsante e un elenco di strutture TBBUTTON che associano un'immagine e/o la stringa con il percorso, stili, dichiara e di ID di comando pulsante.Tutti gli elementi di queste strutture di dati viene fatto riferimento da un indice a base zero.Prima di poter utilizzare un oggetto CToolBarCtrl, è necessario installare queste strutture dei dati.L'elenco di stringhe può essere utilizzato solo per le etichette del pulsante, non è possibile recuperare le stringhe dalla barra degli strumenti.

Per utilizzare un oggetto CToolBarCtrl, in genere verranno effettuate le seguenti operazioni:

Creare l'oggetto CToolBarCtrl.
Chiamare Crea per creare il controllo comune della barra degli strumenti di Windows e per associarlo all'oggetto CToolBarCtrl.Selezionare lo stile della barra degli strumenti utilizzando gli stili, come TBSTYLE_TRANSPARENT di una barra degli strumenti trasparente o TBSTYLE_DROPDOWN di una barra degli strumenti pulsanti a discesa di tale stile di supportare.
Identificare come si desidera utilizzare i pulsanti della barra degli strumenti visualizzazione:
- Per utilizzare immagini bitmap per i pulsanti, aggiungere le bitmap del pulsante sulla barra degli strumenti chiamando AddBitmap.
- Per utilizzare immagini da un elenco immagini per i pulsanti, specificare l'elenco di immagini chiamando SetImageList, SetHotImageList, o SetDisabledImageList.
- Per utilizzare le etichette della stringa per i pulsanti, aggiungere stringhe alla barra degli strumenti chiamando AddString e/o AddStrings.
Aggiungere le strutture del pulsante sulla barra degli strumenti chiamando AddButtons.
Se si desidera che le descrizioni comandi per un pulsante della barra degli strumenti in una finestra proprietaria che non è CFrameWnd, è necessario gestire i messaggi TTN_NEEDTEXT nella finestra proprietaria della barra degli strumenti come descritto in Notifiche di descrizione comandi di gestione.Se la finestra padre della barra degli strumenti è derivata da CFrameWnd, descrizioni comandi visualizzati senza alcuno sforzo aggiuntivo è perché CFrameWnd fornisce un gestore predefinito.
Se si desidera che un utente la possibilità di personalizzare la barra degli strumenti, gestire i messaggi di notifica di personalizzazione nella finestra proprietaria come descritto in notifiche di personalizzazione di gestione.

È possibile utilizzare SaveState per salvare lo stato corrente di un controllo barra degli strumenti nel Registro di sistema e in RestoreState per ripristinare lo stato basato sulle informazioni memorizzate in precedenza nel Registro di sistema.Oltre a salvare lo stato tra gli utilizzi dell'applicazione, le applicazioni in genere archiviano lo stato prima che l'utente inizia personalizzazione della barra degli strumenti nell'utente successivamente desidera ripristinare la barra degli strumenti allo stato originale.

Supporto per le versioni di Internet Explorer 4,0 e successive

Per supportare la funzionalità introdotta in Internet Explorer, la versione 4,0 e successive, MFC fornisce il supporto dell'elenco immagini e stili trasparenti e piani ai controlli della barra degli strumenti.

Una barra degli strumenti trasparente consente al client sotto la barra degli strumenti per mostrare tramite.Per creare una barra degli strumenti trasparente, utilizzare gli stili TBSTYLE_TRANSPARENTTBSTYLE_FLAT.Le barre degli strumenti trasparenti presentano il hot track; ovvero quando il puntatore del mouse viene spostato su un pulsante personalizzazione della barra degli strumenti, le modifiche dell'aspetto del pulsante.Le barre degli strumenti create con uno stile TBSTYLE_FLAT conterranno i pulsanti che non sono transparent.

Il supporto dell'elenco immagini consente a un controllo maggiore flessibilità per il comportamento predefinito, immagini calde e immagini disabilitate.Utilizzare GetImageList, GetHotImageListe GetDisabledImageList con la barra degli strumenti trasparente per modificare l'immagine in base allo stato:

Per ulteriori informazioni su l CToolBarCtrl, vedere Controlli e Utilizzando CToolBarCtrl.