Classe di CToolBarCtrl

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

class CToolBarCtrl : public CWnd

Membri

tf5d6ca2.collapse_all(it-it,VS.110).gifCostruttori pubblici

Nome

Descrizione

CToolBarCtrl::CToolBarCtrl

Costruisce un oggetto CToolBarCtrl.

tf5d6ca2.collapse_all(it-it,VS.110).gifMetodi 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:

  1. Creare l'oggetto CToolBarCtrl.

  2. 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.

  3. 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.

  4. Aggiungere le strutture del pulsante sulla barra degli strumenti chiamando AddButtons.

  5. 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.

  6. 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.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CToolBarCtrl

Requisiti

Header: afxcmn.h

Vedere anche

Riferimenti

Classe CWnd

Grafico della gerarchia

Classe di CToolBar

Concetti

MFC campione CMNCTRL1

Esempio MFCIE MFC