Condividi tramite

Classe CToolBarCtrl

  • Articolo

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

Sintassi

class CToolBarCtrl : public CWnd

Membri

Costruttori pubblici

Nome Descrizione
CToolBarCtrl::CToolBarCtrl Costruisce un oggetto CToolBarCtrl.

Metodi pubblici

Nome Descrizione
CToolBarCtrl::AddBitmap Aggiunge una o più immagini del pulsante bitmap all'elenco di immagini dei pulsanti disponibili per un controllo barra degli strumenti.
CToolBarCtrl::AddButtons Aggiunge uno o più pulsanti a un controllo barra degli strumenti.
CToolBarCtrl::AddString Aggiunge una nuova stringa, passata come ID risorsa, all'elenco interno delle stringhe della barra degli strumenti.
CToolBarCtrl::AddStrings Aggiunge una nuova stringa o stringhe, passata come puntatore a un buffer di NULLstringhe separate dalla barra degli strumenti, all'elenco interno di stringhe della barra degli strumenti.
CToolBarCtrl::AutoSize Ridimensiona un controllo barra degli strumenti.
CToolBarCtrl::ChangeBitmap Modifica la bitmap per un pulsante nel controllo barra degli strumenti corrente.
CToolBarCtrl::CheckButton Controlla o cancella un determinato pulsante in un controllo barra degli strumenti.
CToolBarCtrl::CommandToIndex Recupera l'indice in base zero per il pulsante associato all'identificatore di comando specificato.
CToolBarCtrl::Create Crea un controllo barra degli strumenti e lo collega a un CToolBarCtrl oggetto .
CToolBarCtrl::CreateEx Crea un controllo barra degli strumenti con gli stili estesi di Windows specificati e lo associa a un CToolBarCtrl oggetto .
CToolBarCtrl::Customize Visualizza la finestra di dialogo Personalizza barra degli strumenti.
CToolBarCtrl::DeleteButton Elimina un pulsante dal controllo barra degli strumenti.
CToolBarCtrl::EnableButton Abilita o disabilita il pulsante specificato in un controllo barra degli strumenti.
CToolBarCtrl::GetAnchorHighlight Recupera l'impostazione di evidenziazione dell'ancoraggio per 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 informazioni sul pulsante specificato in un controllo barra degli strumenti.
CToolBarCtrl::GetButtonCount Recupera un conteggio dei pulsanti attualmente presenti nel controllo barra degli strumenti.
CToolBarCtrl::GetButtonInfo Recupera le informazioni relative a 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 del controllo della barra degli strumenti corrente.
CToolBarCtrl::GetDisabledImageList Recupera l'elenco di immagini utilizzato da un controllo barra degli strumenti per visualizzare i pulsanti disabilitati.
CToolBarCtrl::GetDropTarget Recupera l'interfaccia IDropTarget per un controllo barra degli strumenti.
CToolBarCtrl::GetExtendedStyle Recupera gli stili estesi per un controllo barra degli strumenti.
CToolBarCtrl::GetHotImageList Recupera l'elenco di immagini utilizzato da un controllo barra degli strumenti per visualizzare i pulsanti "ad accesso frequente". Quando il puntatore del mouse è al di sopra di esso viene visualizzato un pulsante attivo.
CToolBarCtrl::GetHotItem Recupera l'indice dell'elemento attivo in una barra degli strumenti.
CToolBarCtrl::GetImageList Recupera l'elenco di immagini utilizzato da un controllo barra degli strumenti per visualizzare i pulsanti nello stato predefinito.
CToolBarCtrl::GetInsertMark Recupera il segno di inserimento corrente per la 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 barra degli strumenti.
CToolBarCtrl::GetMaxSize Recupera le dimensioni totali di tutti i pulsanti e i separatori visibili nella barra degli strumenti.
CToolBarCtrl::GetMaxTextRows Recupera il numero massimo di righe di testo visualizzate su un pulsante della barra degli strumenti.
CToolBarCtrl::GetMetrics Recupera le metriche di un controllo barra degli strumenti.
CToolBarCtrl::GetPadding Recupera la spaziatura interna orizzontale e verticale del controllo della barra degli strumenti corrente.
CToolBarCtrl::GetPressedImageList Recupera l'elenco di immagini utilizzato dal controllo della barra degli strumenti corrente per rappresentare i pulsanti nello stato premuto.
CToolBarCtrl::GetRect Recupera il rettangolo di delimitazione per un pulsante della barra degli strumenti specificato.
CToolBarCtrl::GetRows Recupera il numero di righe di pulsanti attualmente visualizzati nella barra degli strumenti.
CToolBarCtrl::GetState Recupera informazioni sullo stato del pulsante specificato in un controllo della barra degli strumenti, ad esempio se è abilitato, premuto o selezionato.
CToolBarCtrl::GetString Recupera una stringa della barra degli strumenti.
CToolBarCtrl::GetStyle Recupera gli stili attualmente in uso per un controllo barra degli strumenti.
CToolBarCtrl::GetToolTips Recupera l'handle del controllo della descrizione comando, se presente, associato al controllo barra degli strumenti.
CToolBarCtrl::HideButton Nasconde o mostra il pulsante specificato in un controllo barra degli strumenti.
CToolBarCtrl::HitTest Determina dove si trova un punto in un controllo barra degli strumenti.
CToolBarCtrl::Indeterminate Imposta o cancella lo stato indeterminato (grigio) del pulsante specificato in un controllo barra degli strumenti.
CToolBarCtrl::InsertButton Inserisce un pulsante in un controllo barra degli strumenti.
CToolBarCtrl::InsertMarkHitTest Recupera le informazioni sul contrassegno di inserimento per un punto in una barra degli strumenti.
CToolBarCtrl::IsButtonChecked Indica se il pulsante specificato in un controllo barra degli strumenti è selezionato.
CToolBarCtrl::IsButtonEnabled Indica se il pulsante specificato in un controllo barra degli strumenti è abilitato.
CToolBarCtrl::IsButtonHidden Indica se il pulsante specificato in un controllo barra degli strumenti è 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 barra degli strumenti è indeterminato (grigio).
CToolBarCtrl::IsButtonPressed Indica se viene premuto il pulsante specificato in un controllo barra degli strumenti.
CToolBarCtrl::LoadImages Carica le bitmap nell'elenco di immagini di un controllo della barra degli strumenti.
CToolBarCtrl::MapAccelerator Esegue il mapping di un carattere di scelta rapida a un pulsante della barra degli strumenti.
CToolBarCtrl::MarkButton Imposta lo stato di evidenziazione di un determinato pulsante in un controllo barra degli strumenti.
CToolBarCtrl::MoveButton Sposta un pulsante da un indice a un altro.
CToolBarCtrl::PressButton Preme o rilascia il pulsante specificato in un controllo barra degli strumenti.
CToolBarCtrl::ReplaceBitmap Sostituisce la bitmap esistente nel controllo della barra degli strumenti corrente con una nuova bitmap.
CToolBarCtrl::RestoreState Ripristina lo stato del controllo barra degli strumenti.
CToolBarCtrl::SaveState Salva lo stato del controllo barra degli strumenti.
CToolBarCtrl::SetAnchorHighlight Imposta l'impostazione di evidenziazione dell'ancoraggio per una barra degli strumenti.
CToolBarCtrl::SetBitmapSize Imposta le dimensioni delle immagini bitmap da aggiungere a un controllo barra degli strumenti.
CToolBarCtrl::SetButtonInfo Imposta le informazioni per un pulsante esistente in una barra degli strumenti.
CToolBarCtrl::SetButtonSize Imposta le dimensioni dei pulsanti da aggiungere a un controllo barra degli strumenti.
CToolBarCtrl::SetButtonStructSize Specifica le dimensioni della TBBUTTON struttura.
CToolBarCtrl::SetButtonWidth Imposta la larghezza minima e massima dei pulsanti nel controllo barra degli strumenti.
CToolBarCtrl::SetCmdID Imposta l'identificatore del comando da inviare alla finestra del proprietario quando viene premuto il pulsante specificato.
CToolBarCtrl::SetColorScheme Imposta la combinazione di colori del controllo della barra degli strumenti corrente.
CToolBarCtrl::SetDisabledImageList Imposta l'elenco di immagini che verrà utilizzato dal controllo barra degli strumenti per visualizzare i pulsanti disabilitati.
CToolBarCtrl::SetDrawTextFlags Imposta i flag nella funzione DrawTextWin32 , che viene usato per disegnare il testo nel rettangolo specificato, formattato in base alla modalità di impostazione dei flag.
CToolBarCtrl::SetExtendedStyle Imposta gli stili estesi per un controllo barra degli strumenti.
CToolBarCtrl::SetHotImageList Imposta l'elenco di immagini che verrà utilizzato dal controllo barra degli strumenti per visualizzare i pulsanti "ad accesso frequente".
CToolBarCtrl::SetHotItem Imposta l'elemento attivo in una barra degli strumenti.
CToolBarCtrl::SetImageList Imposta l'elenco di immagini che verrà utilizzato dalla barra degli strumenti per visualizzare i pulsanti nello stato predefinito.
CToolBarCtrl::SetIndent Imposta il rientro per il primo pulsante in un controllo barra degli strumenti.
CToolBarCtrl::SetInsertMark Imposta il segno di inserimento corrente per la 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 visualizzate su un pulsante della barra degli strumenti.
CToolBarCtrl::SetMetrics Imposta le metriche di un controllo barra degli strumenti.
CToolBarCtrl::SetOwner Imposta la finestra per ricevere messaggi di notifica dal controllo barra degli strumenti.
CToolBarCtrl::SetPadding Imposta la spaziatura interna orizzontale e verticale del controllo barra degli strumenti corrente.
CToolBarCtrl::SetPressedImageList Imposta l'elenco di immagini utilizzato dal controllo della barra degli strumenti corrente per rappresentare i pulsanti nello stato premuto.
CToolBarCtrl::SetRows Imposta il numero di righe di pulsanti visualizzati nella barra degli strumenti.
CToolBarCtrl::SetState Imposta lo stato per il pulsante specificato in un controllo barra degli strumenti.
CToolBarCtrl::SetStyle Imposta gli stili per un controllo barra degli strumenti.
CToolBarCtrl::SetToolTips Associa un controllo descrizione comando al controllo barra degli strumenti.
CToolBarCtrl::SetWindowTheme Imposta lo stile di visualizzazione di un controllo barra degli strumenti.

Osservazioni:

Questo controllo (e quindi la CToolBarCtrl classe ) è disponibile solo per i programmi in esecuzione in Windows 95/98 e Windows NT versione 3.51 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 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 corrispondono agli elementi nel menu dell'applicazione; forniscono un modo più diretto per consentire all'utente di accedere ai comandi di un'applicazione.

CToolBarCtrl gli oggetti contengono diverse strutture di dati interne importanti: un elenco di bitmap di immagine del pulsante o un elenco di immagini, un elenco di stringhe di etichetta del pulsante e un elenco di TBBUTTON strutture che associano un'immagine e/o una stringa alla posizione, stile, stato e ID comando del pulsante. Ognuno degli elementi di queste strutture di dati viene definito da un indice in base zero. Prima di poter usare un CToolBarCtrl oggetto, è necessario configurare queste strutture di dati. L'elenco di stringhe può essere usato solo per le etichette dei pulsanti; non è possibile recuperare stringhe dalla barra degli strumenti.

Per usare un CToolBarCtrl oggetto, in genere si seguiranno questi passaggi:

  1. Costruire l'oggetto CToolBarCtrl.

  2. Chiamare Create per creare il controllo comune della barra degli strumenti di Windows e collegarlo all'oggetto CToolBarCtrl . Indicare lo stile della barra degli strumenti utilizzando stili, ad esempio TBSTYLE_TRANSPARENT per una barra degli strumenti trasparente o TBSTYLE_DROPDOWN per una barra degli strumenti che supporta pulsanti di stile a discesa.

  3. Identificare la modalità di visualizzazione dei pulsanti sulla barra degli strumenti:

    • Per usare immagini bitmap per i pulsanti, aggiungere le bitmap del pulsante alla barra degli strumenti chiamando AddBitmap.

    • Per usare le immagini visualizzate da un elenco di immagini per i pulsanti, specificare l'elenco di immagini chiamando SetImageList, SetHotImageListo SetDisabledImageList.

    • Per usare le etichette di stringa per i pulsanti, aggiungere le stringhe alla barra degli strumenti chiamando AddString e/o AddStrings.

  4. Aggiungere strutture dei pulsanti alla barra degli strumenti chiamando AddButtons.

  5. Se vuoi suggerimenti per gli strumenti per un pulsante della barra degli strumenti in una finestra proprietaria che non è un CFrameWnd, devi gestire i TTN_NEEDTEXT messaggi nella finestra proprietaria della barra degli strumenti, come descritto in Gestione delle notifiche della descrizione comando. Se la finestra padre della barra degli strumenti è derivata da CFrameWnd, i suggerimenti per gli strumenti vengono visualizzati senza alcun sforzo aggiuntivo perché CFrameWnd fornisce un gestore predefinito.

  6. Se si vuole che l'utente sia in grado di personalizzare la barra degli strumenti, gestire i messaggi di notifica di personalizzazione nella finestra proprietario, come descritto in Gestione delle notifiche di personalizzazione.

È possibile utilizzare SaveState per salvare lo stato corrente di un controllo della barra degli strumenti nel Registro di sistema e RestoreState ripristinare lo stato in base alle informazioni archiviate in precedenza nel Registro di sistema. Oltre a salvare lo stato della barra degli strumenti tra gli usi dell'applicazione, le applicazioni in genere archiviano lo stato prima che l'utente inizi a personalizzare la barra degli strumenti nel caso in cui l'utente voglia ripristinare lo stato originale della barra degli strumenti in un secondo momento.

Supporto per Internet Explorer versione 4.0 e successive

Per supportare le funzionalità introdotte in Internet Explorer, versione 4.0 e successive, MFC fornisce supporto per l'elenco di immagini e stili trasparenti e flat per i controlli della barra degli strumenti.

Una barra degli strumenti trasparente consente al client sotto la barra degli strumenti di visualizzare. Per creare una barra degli strumenti trasparente, usare entrambi TBSTYLE_FLAT gli stili e TBSTYLE_TRANSPARENT . Le barre degli strumenti trasparenti presentano il rilevamento rapido; ovvero, quando il puntatore del mouse si sposta su un pulsante attivo sulla barra degli strumenti, l'aspetto del pulsante cambia. Le barre degli strumenti create con solo lo TBSTYLE_FLAT stile conterranno pulsanti che non sono trasparenti.

Il supporto per l'elenco di immagini consente una maggiore flessibilità di controllo per il comportamento predefinito, le immagini ad accesso frequente e le immagini disabilitate. Usare GetImageList, GetHotImageListe GetDisabledImageList con la barra degli strumenti trasparente per modificare l'immagine in base al relativo stato:

Per altre informazioni sull'uso CToolBarCtrldi , vedere Controlli e uso di CToolBarCtrl.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CToolBarCtrl

Requisiti

Intestazione: afxcmn.h

CToolBarCtrl::AddBitmap

Aggiunge una o più immagini pulsante all'elenco di immagini pulsante archiviate nel controllo barra degli strumenti.

int AddBitmap(
    int nNumButtons,
    UINT nBitmapID);

int AddBitmap(
    int nNumButtons,
    CBitmap* pBitmap);

Parametri

nNumButtons
Numero di immagini pulsante nella bitmap.

nBitmapID
Identificatore della risorsa della bitmap che contiene l'immagine o le immagini del pulsante da aggiungere.

pBitmap
Puntatore all'oggetto CBitmap che contiene l'immagine o le immagini del pulsante da aggiungere.

Valore restituito

Indice in base zero della prima nuova immagine in caso di esito positivo; in caso contrario - 1.

Osservazioni:

È possibile usare l'API CreateMappedBitmap Windows per eseguire il mapping dei colori prima di aggiungere la bitmap alla barra degli strumenti. Se passi un puntatore a un CBitMap oggetto, devi assicurarti che la bitmap non venga eliminata definitivamente finché la barra degli strumenti non viene eliminata definitivamente.

CToolBarCtrl::AddButtons

Aggiunge uno o più pulsanti a un controllo barra degli strumenti.

BOOL AddButtons(
    int nNumButtons,
    LPTBBUTTON lpButtons);

Parametri

nNumButtons
Numero di pulsanti da aggiungere.

lpButtons
Indirizzo di una matrice di TBBUTTON strutture che contiene informazioni sui pulsanti da aggiungere. Nella matrice deve essere presente lo stesso numero di elementi specificati da nNumButtons.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Il lpButtons puntatore punta a una matrice di TBBUTTON strutture. Ogni TBBUTTON struttura associa il pulsante da aggiungere allo stile, all'immagine e/o alla stringa del pulsante, all'ID comando, allo stato e ai dati definiti dall'utente:

typedef struct _TBBUTTON {
    int iBitmap;    // zero-based index of button image
    int idCommand;  // command to be sent when button pressed
    BYTE fsState;   // button state--see below
    BYTE fsStyle;   // button style--see below
    DWORD dwData;   // application-defined value
    int iString;    // zero-based index of button label string
} TBBUTTON;

I membri sono i seguenti:

  • iBitmap

    Indice in base zero dell'immagine del pulsante, -1 se non è presente alcuna immagine per questo pulsante.

  • idCommand

    Identificatore del comando associato al pulsante. Questo identificatore viene inviato in un WM_COMMAND messaggio quando si seleziona il pulsante. Se il fsStyle membro ha il TBSTYLE_SEP valore , questo membro deve essere zero.

  • fsState

    Flag di stato del pulsante. Può essere una combinazione dei valori elencati di seguito:

    • TBSTATE_CHECKED Il pulsante ha lo TBSTYLE_CHECKED stile e viene premuto.

    • TBSTATE_ENABLED Il pulsante accetta l'input dell'utente. Un pulsante che non ha questo stato non accetta l'input dell'utente e è disattivato.

    • TBSTATE_HIDDEN Il pulsante non è visibile e non può ricevere l'input dell'utente.

    • TBSTATE_INDETERMINATE Il pulsante è disattivato.

    • TBSTATE_PRESSED Il pulsante viene premuto.

    • TBSTATE_WRAP Un'interruzione di riga segue il pulsante. Il pulsante deve avere anche lo TBSTATE_ENABLED stato .

  • fsStyle

    Stile pulsante. Può essere una combinazione dei valori elencati di seguito:

    • TBSTYLE_BUTTON Crea un pulsante di pressione standard.

    • TBSTYLE_CHECK Crea un pulsante che alterna gli stati premuti e non compressi ogni volta che l'utente lo fa clic. Il pulsante ha un colore di sfondo diverso quando si trova nello stato premuto.

    • TBSTYLE_CHECKGROUP Crea un pulsante di controllo che rimane premuto finché non viene premuto un altro pulsante nel gruppo.

    • TBSTYLE_GROUP Crea un pulsante che rimane premuto finché non viene premuto un altro pulsante nel gruppo.

    • TBSTYLE_SEP Crea un separatore, fornendo una piccola distanza tra i gruppi di pulsanti. Un pulsante con questo stile non riceve l'input dell'utente.

  • dwData

    Dati definiti dall'utente.

  • iString

    Indice in base zero della stringa da usare come etichetta del pulsante, -1 se non è presente alcuna stringa per questo pulsante.

L'immagine e/o la stringa il cui indice specificato deve essere stato aggiunto in precedenza all'elenco del controllo della barra degli strumenti usando AddBitmap, AddStringe/o AddStrings.

CToolBarCtrl::AddString

Aggiunge una nuova stringa, passata come ID risorsa, all'elenco interno delle stringhe della barra degli strumenti.

int AddString(UINT nStringID);

Parametri

nStringID
Identificatore della risorsa stringa da aggiungere all'elenco di stringhe del controllo barra degli strumenti.

Valore restituito

Indice in base zero della prima nuova stringa aggiunta in caso di esito positivo; in caso contrario -1.

CToolBarCtrl::AddStrings

Aggiunge una nuova stringa o stringhe all'elenco di stringhe disponibili per un controllo barra degli strumenti.

int AddStrings(LPCTSTR lpszStrings);

Parametri

lpszStrings
Indirizzo di un buffer contenente una o più NULLstringhe con terminazione da aggiungere all'elenco di stringhe della barra degli strumenti. L'ultima stringa deve essere terminata con due NULL caratteri.

Valore restituito

Indice in base zero della prima nuova stringa aggiunta in caso di esito positivo; in caso contrario -1.

Osservazioni:

Le stringhe nel buffer devono essere separate da un NULL carattere. È necessario assicurarsi che l'ultima stringa abbia due NULL caratteri di terminazione. Per formattare correttamente una stringa costante, è possibile scriverla come segue:

// one null added automatically
lpszStrings = _T("Only one string to add\0");

oppure:

// adds three strings with one call
lpszStrings = _T("String 1\0String 2\0String 3\0");

Non è consigliabile passare un CString oggetto a questa funzione perché non è possibile avere più di un NULL carattere in un oggetto CString.

CToolBarCtrl::AutoSize

Ridimensiona l'intero controllo della barra degli strumenti.

void AutoSize();

Osservazioni:

È necessario chiamare questa funzione quando le dimensioni della finestra padre cambiano o quando cambiano le dimensioni della barra degli strumenti, ad esempio quando si imposta il pulsante o le dimensioni della bitmap o si aggiungono stringhe.

CToolBarCtrl::ChangeBitmap

Modifica la bitmap per un pulsante nel controllo barra degli strumenti corrente.

BOOL ChangeBitmap(
    int idButton,
    int iBitmap);

Parametri

idButton
[in] Identificatore di comando del pulsante che deve ricevere una nuova bitmap.

iBitmap
[in] Indice in base zero di un'immagine nell'elenco di immagini del controllo della barra degli strumenti corrente.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario, FALSE.

Osservazioni:

Se questo metodo ha esito positivo, il sistema visualizza l'immagine specificata nel pulsante specificato.

Questo metodo invia il TB_CHANGEBITMAP messaggio, descritto in Windows SDK.

Esempio

Nell'esempio di codice seguente la bitmap per il pulsante Salva file viene modificata nella bitmap per il pulsante Informazioni.

{
   // Change the bitmap for the File Save button, whose
   // command ID is ID_FILE_SAVE, to the bitmap for the
   // About button, whose index is 7.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ChangeBitmap(ID_FILE_SAVE, 7);
}

CToolBarCtrl::CheckButton

Controlla o cancella un determinato pulsante in un controllo barra degli strumenti.

BOOL CheckButton(
    int nID,
    BOOL bCheck = TRUE);

Parametri

nID
Identificatore del comando del pulsante da controllare o deselezionare.

bCheck
TRUE per controllare il pulsante, FALSE per cancellarlo.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Quando è stato selezionato un pulsante, sembra che sia stato premuto. Se si desidera modificare più di uno stato del pulsante, prendere in considerazione la chiamata SetState .

CToolBarCtrl::CommandToIndex

Recupera l'indice in base zero per il pulsante associato all'identificatore di comando specificato.

UINT CommandToIndex(UINT nID) const;

Parametri

nID
ID comando di cui si desidera trovare l'indice del pulsante.

Valore restituito

Indice in base zero per il pulsante associato all'ID comando.

Osservazioni:

CToolBarCtrl::Create

Crea un controllo barra degli strumenti e lo collega a un CToolBarCtrl oggetto .

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametri

dwStyle
Specifica lo stile del controllo della barra degli strumenti. Le barre degli strumenti devono avere sempre lo WS_CHILD stile. Inoltre, è possibile specificare qualsiasi combinazione di stili della barra degli strumenti e stili di finestra, come descritto in Osservazioni.

rect
Facoltativamente, specifica le dimensioni e la posizione del controllo della barra degli strumenti. Può essere un CRect oggetto o una RECT struttura.

pParentWnd
Specifica la finestra padre del controllo barra degli strumenti. Non deve essere NULL.

nID
Specifica l'ID del controllo della barra degli strumenti.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Si costruisce un oggetto CToolBarCtrl in due passaggi. Chiamare innanzitutto il costruttore e quindi chiamare Create, che crea il controllo della barra degli strumenti e lo collega all'oggetto CToolBarCtrl . Applicare gli stili di finestra seguenti a un controllo barra degli strumenti.

  • WS_CHILD Sempre

  • WS_VISIBLE Solitamente

  • WS_DISABLED Raramente

Per una descrizione degli stili delle finestre, vedere CreateWindow in Windows SDK.

Facoltativamente, applicare una combinazione di stili di controllo comuni, come descritto in Windows SDK.

Applicare una combinazione di stili della barra degli strumenti al controllo o ai pulsanti stessi. Gli stili sono descritti nell'argomento Controllo barra degli strumenti e Stili pulsante in Windows SDK.

Per usare gli stili della barra degli strumenti estesi, chiamare dopo aver chiamato SetExtendedStyle Create. Per creare una barra degli strumenti con stili di Createfinestra estesi, chiamare CToolBarCtrl::CreateEx anziché .

Il controllo barra degli strumenti imposta automaticamente le dimensioni e la posizione della finestra della barra degli strumenti. L'altezza si basa sull'altezza dei pulsanti nella barra degli strumenti. La larghezza corrisponde alla larghezza dell'area client della finestra padre. Gli CCS_TOP stili e CCS_BOTTOM determinano se la barra degli strumenti è posizionata lungo la parte superiore o inferiore dell'area client. Per impostazione predefinita, una barra degli strumenti ha lo CCS_TOP stile .

CToolBarCtrl::CreateEx

Crea un controllo (una finestra figlio) e lo associa all'oggetto CToolBarCtrl .

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametri

dwExStyle
Specifica lo stile esteso del controllo da creare. Per un elenco degli stili di Windows estesi, vedi il dwExStyle parametro per CreateWindowEx in Windows SDK.

dwStyle
Specifica lo stile del controllo della barra degli strumenti. Le barre degli strumenti devono avere sempre lo WS_CHILD stile. Inoltre, è possibile specificare qualsiasi combinazione di stili della barra degli strumenti e stili di finestra, come descritto nella sezione Osservazioni di Create.

rect
Riferimento a una RECT struttura che descrive le dimensioni e la posizione della finestra da creare, nelle coordinate client di pParentWnd.

pParentWnd
Puntatore alla finestra padre del controllo.

nID
ID finestra figlio del controllo.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Usare CreateEx invece di Create applicare stili di Windows estesi, specificati dalla prefazione WS_EX_dello stile esteso di Windows. CreateEx crea il controllo con gli stili di Windows estesi specificati da dwExStyle. Impostare stili estesi specifici di un controllo usando SetExtendedStyle. Ad esempio, usare CreateEx per impostare stili come WS_EX_CONTEXTHELP, ma usare SetExtendedStyle per impostare tali stili, ad TBSTYLE_EX_DRAWDDARROWSesempio . Per altre informazioni, vedere gli stili descritti in Stili estesi della barra degli strumenti in Windows SDK.

CToolBarCtrl::CToolBarCtrl

Costruisce un oggetto CToolBarCtrl.

CToolBarCtrl();

Osservazioni:

È necessario chiamare Create per rendere utilizzabile la barra degli strumenti.

CToolBarCtrl::Customize

Visualizza la finestra di dialogo Personalizza barra degli strumenti.

void Customize();

Osservazioni:

Questa finestra di dialogo consente all'utente di personalizzare la barra degli strumenti aggiungendo ed eliminando pulsanti. Per supportare la personalizzazione, la finestra padre della barra degli strumenti deve gestire i messaggi di notifica di personalizzazione come descritto in Gestione delle notifiche di personalizzazione. La barra degli strumenti deve essere stata creata anche con lo CCS_ADJUSTABLE stile , come descritto in CToolBarCtrl::Create.

CToolBarCtrl::DeleteButton

Elimina un pulsante dal controllo barra degli strumenti.

BOOL DeleteButton(int nIndex);

Parametri

nIndex
Indice in base zero del pulsante da eliminare.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

CToolBarCtrl::EnableButton

Abilita o disabilita il pulsante specificato in un controllo barra degli strumenti.

BOOL EnableButton(
    int nID,
    BOOL bEnable = TRUE);

Parametri

nID
Identificatore del comando del pulsante per abilitare o disabilitare.

bEnable
TRUE per abilitare il pulsante, FALSE per disabilitarlo.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Quando un pulsante è stato abilitato, può essere premuto e selezionato. Se si desidera modificare più di uno stato del pulsante, prendere in considerazione la chiamata SetState .

CToolBarCtrl::GetAnchorHighlight

Recupera l'impostazione di evidenziazione dell'ancoraggio per una barra degli strumenti.

BOOL GetAnchorHighlight() const;

Valore restituito

Se diverso da zero, l'evidenziazione dell'ancoraggio è abilitata. Se zero, l'evidenziazione dell'ancoraggio è disabilitata.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_GETANCHORHIGHLIGHTWin32 , come descritto in Windows SDK.

CToolBarCtrl::GetBitmap

Recupera l'indice della bitmap associata a un pulsante in una barra degli strumenti.

int GetBitmap(int nID) const;

Parametri

nID
Identificatore di comando del pulsante il cui indice bitmap deve essere recuperato.

Valore restituito

Restituisce l'indice della bitmap se ha esito positivo o zero in caso contrario.

Osservazioni:

Implementa la funzionalità di TB_GETBITMAP in Windows SDK.

CToolBarCtrl::GetBitmapFlags

Recupera i flag bitmap dalla barra degli strumenti.

UINT GetBitmapFlags() const;

Valore restituito

Oggetto UINT con il TBBF_LARGE flag impostato se la visualizzazione può supportare bitmap della barra degli strumenti di grandi dimensioni, deselezionare in caso contrario.

Osservazioni:

È necessario chiamarlo dopo aver creato la barra degli strumenti, ma prima di aggiungere bitmap alla barra degli strumenti. Il valore restituito indica se la visualizzazione supporta o meno bitmap di grandi dimensioni. Se lo schermo supporta bitmap di grandi dimensioni e se si sceglie di usarle, chiamare SetBitmapSize e SetButtonSize prima di aggiungere la bitmap di grandi dimensioni usando AddBitmap.

CToolBarCtrl::GetButton

Recupera informazioni sul pulsante specificato in un controllo barra degli strumenti.

BOOL GetButton(
    int nIndex,
    LPTBBUTTON lpButton) const;

Parametri

nIndex
Indice in base zero del pulsante per il quale recuperare informazioni.

lpButton
Indirizzo della TBBUTTON struttura che deve ricevere una copia delle informazioni sul pulsante. Vedere CToolBarCtrl::AddButtons per informazioni sulla TBBUTTON struttura.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

CToolBarCtrl::GetButtonCount

Recupera un conteggio dei pulsanti attualmente presenti nel controllo barra degli strumenti.

int GetButtonCount() const;

Valore restituito

Conteggio dei pulsanti.

CToolBarCtrl::GetButtonInfo

Recupera le informazioni relative a un pulsante in una barra degli strumenti.

int GetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi) const;

Parametri

nID
Identificatore del pulsante.

ptbbi
Puntatore a una TBBUTTONINFO struttura che riceve le informazioni sul pulsante.

Valore restituito

Indice in base zero del pulsante, se riuscito; in caso contrario -1.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_GETBUTTONINFOWin32 , come descritto in Windows SDK.

CToolBarCtrl::GetButtonSize

Ottiene le dimensioni di un pulsante della barra degli strumenti.

DWORD GetButtonSize() const;

Valore restituito

Valore DWORD che contiene rispettivamente i valori di larghezza e altezza in LOWORD e HIWORD.

CToolBarCtrl::GetButtonText

Recupera il testo visualizzato di un pulsante specificato nel controllo della barra degli strumenti corrente.

CString GetButtonText(int idButton) const;

Parametri

idButton
[in] Identificatore del pulsante il cui testo visualizzato viene recuperato.

Valore restituito

Oggetto CString contenente il testo visualizzato del pulsante specificato.

Osservazioni:

Questo metodo invia il TB_GETBUTTONTEXT messaggio, descritto in Windows SDK.

CToolBarCtrl::GetColorScheme

Recupera la combinazione di colori del controllo della barra degli strumenti corrente.

BOOL GetColorScheme(COLORSCHEME* lpColorScheme) const;

Parametri

lpColorScheme
[out] Puntatore a una COLORSCHEME struttura che riceve le informazioni sulla combinazione di colori. Quando termina, la struttura descrive il colore di evidenziazione e il colore ombreggiatura del controllo barra degli strumenti.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario, FALSE.

Osservazioni:

Questo metodo invia il TB_GETCOLORSCHEME messaggio, descritto in Windows SDK.

CToolBarCtrl::GetDisabledImageList

Recupera l'elenco di immagini utilizzato da un controllo barra degli strumenti per visualizzare i pulsanti disabilitati.

CImageList* GetDisabledImageList() const;

Valore restituito

Puntatore a un CImageList oggetto o NULL se non è impostato alcun elenco di immagini disabilitato.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_GETDISABLEDIMAGELISTWin32 , come descritto in Windows SDK. L'implementazione MFC di GetDisabledImageList usa un CImageList oggetto contenente le immagini del pulsante del controllo della barra degli strumenti, anziché un handle per un elenco di immagini.

CToolBarCtrl::GetDropTarget

Recupera l'interfaccia IDropTarget per un controllo barra degli strumenti.

HRESULT GetDropTarget(IDropTarget** ppDropTarget) const;

Parametri

ppDropTarget
Puntatore a un puntatore a un'interfaccia IDropTarget . Se si verifica un errore, viene inserito un NULL puntatore in questo indirizzo.

Valore restituito

Restituisce un HRESULT valore che indica l'esito positivo o negativo dell'operazione.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_GETOBJECTWin32 , come descritto in Windows SDK.

CToolBarCtrl::GetExtendedStyle

Recupera gli stili estesi per un controllo barra degli strumenti.

DWORD GetExtendedStyle() const;

Valore restituito

Oggetto DWORD che rappresenta gli stili estesi attualmente in uso per il controllo barra degli strumenti. Per un elenco degli stili, vedi Stili estesi della barra degli strumenti in Windows SDK.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_GETEXTENDEDSTYLEWin32 , come descritto in Windows SDK.

CToolBarCtrl::GetHotImageList

Recupera l'elenco di immagini utilizzato da un controllo barra degli strumenti per visualizzare i pulsanti "ad accesso frequente". Quando il puntatore del mouse è al di sopra di esso viene visualizzato un pulsante attivo.

CImageList* GetHotImageList() const;

Valore restituito

Puntatore a un CImageList oggetto o NULL se non è impostato alcun elenco di immagini disabilitato.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_GETHOTIMAGELISTWin32 , come descritto in Windows SDK. Quando il puntatore del mouse è al di sopra di esso viene visualizzato un pulsante attivo.

CToolBarCtrl::GetHotItem

Recupera l'indice dell'elemento attivo in una barra degli strumenti.

int GetHotItem() const;

Valore restituito

Indice in base zero dell'elemento attivo in una barra degli strumenti.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_GETHOTITEMWin32 , come descritto in Windows SDK.

CToolBarCtrl::GetImageList

Recupera l'elenco di immagini utilizzato da un controllo barra degli strumenti per visualizzare i pulsanti nello stato predefinito.

CImageList* GetImageList() const;

Valore restituito

Puntatore a un CImageList oggetto o NULL se non è impostato alcun elenco di immagini.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_GETIMAGELISTWin32 , come descritto in Windows SDK.

CToolBarCtrl::GetInsertMark

Recupera il segno di inserimento corrente per la barra degli strumenti.

void GetInsertMark(TBINSERTMARK* ptbim) const;

Parametri

ptbim
Puntatore a una TBINSERTMARK struttura che riceve il segno di inserimento.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_GETINSERTMARKWin32 , come descritto in Windows SDK.

CToolBarCtrl::GetInsertMarkColor

Recupera il colore utilizzato per disegnare il segno di inserimento per la barra degli strumenti.

COLORREF GetInsertMarkColor() const;

Valore restituito

Valore COLORREF contenente il colore del segno di inserimento corrente.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_GETINSERTMARKCOLORWin32 , come descritto in Windows SDK.

CToolBarCtrl::GetItemRect

Recupera il rettangolo di delimitazione di un pulsante in un controllo barra degli strumenti.

BOOL GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parametri

nIndex
Indice in base zero del pulsante per il quale recuperare informazioni.

lpRect
Indirizzo di una RECT struttura o di un CRect oggetto che riceve le coordinate del rettangolo di delimitazione.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Questa funzione non recupera il rettangolo di delimitazione per i pulsanti il cui stato è impostato su TBSTATE_HIDDEN.

CToolBarCtrl::GetMaxSize

Recupera le dimensioni totali di tutti i pulsanti e i separatori visibili nella barra degli strumenti.

BOOL GetMaxSize(LPSIZE pSize) const;

Parametri

pSize
Puntatore a una SIZE struttura che riceve le dimensioni degli elementi.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_GETMAXSIZEWin32 , come descritto in Windows SDK.

CToolBarCtrl::GetMaxTextRows

Recupera il numero massimo di righe di testo visualizzate su un pulsante della barra degli strumenti.

int GetMaxTextRows() const;

Valore restituito

Numero massimo di righe di testo visualizzate su un pulsante della barra degli strumenti.

CToolBarCtrl::GetMetrics

Recupera le metriche dell'oggetto CToolBarCtrl .

void GetMetrics(LPTBMETRICS ptbm) const;

Parametri

ptbm
Puntatore alla TBMETRICS struttura dell'oggetto CToolBarCtrl .

Osservazioni:

Questa funzione membro emula la funzionalità del TB_GETMETRICS messaggio, come descritto in Windows SDK.

CToolBarCtrl::GetPadding

Recupera la spaziatura interna orizzontale e verticale del controllo della barra degli strumenti corrente.

BOOL GetPadding(
    int* pnHorzPadding,
    int* pnVertPadding) const;

Parametri

pnHorzPadding
[out] Intero che riceve la spaziatura interna orizzontale del controllo barra degli strumenti, in pixel.

pnVertPadding
[out] Intero che riceve la spaziatura interna verticale del controllo barra degli strumenti, in pixel.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario, FALSE.

Osservazioni:

Questo metodo invia il TB_GETPADDING messaggio, descritto in Windows SDK.

CToolBarCtrl::GetPressedImageList

Recupera l'elenco di immagini utilizzato dal controllo della barra degli strumenti corrente per rappresentare i pulsanti nello stato premuto.

CImageList* GetPressedImageList();

Valore restituito

Puntatore a un CImageList oggetto che contiene l'elenco di immagini per il controllo corrente o NULL se non è impostato alcun elenco di immagini di questo tipo.

Osservazioni:

Questo metodo invia il TB_GETPRESSEDIMAGELIST messaggio, descritto in Windows SDK.

CToolBarCtrl::GetRect

Recupera il rettangolo di delimitazione per un pulsante della barra degli strumenti specificato.

BOOL GetRect(
    int nID,
    LPRECT lpRect) const;

Parametri

nID
Identificatore del pulsante.

lpRect
Puntatore a una RECT struttura per ricevere le informazioni sul rettangolo di delimitazione.

Valore restituito

TRUE se l'esito è positivo; in caso contrario, FALSE.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_GETRECTWin32 , come descritto in Windows SDK.

CToolBarCtrl::GetRows

Recupera il numero di righe di pulsanti attualmente visualizzati dal controllo barra degli strumenti.

int GetRows() const;

Valore restituito

Numero di righe di pulsanti attualmente visualizzate sulla barra degli strumenti.

Osservazioni:

Si noti che il numero di righe sarà sempre uno a meno che la barra degli strumenti non sia stata creata con lo TBSTYLE_WRAPABLE stile .

CToolBarCtrl::GetState

Recupera informazioni sullo stato del pulsante specificato in un controllo della barra degli strumenti, ad esempio se è abilitato, premuto o selezionato.

int GetState(int nID) const;

Parametri

nID
Identificatore del comando del pulsante per il quale recuperare informazioni.

Valore restituito

Le informazioni sullo stato del pulsante se hanno esito positivo o -1 in caso contrario. Le informazioni sullo stato del pulsante possono essere una combinazione dei valori elencati in CToolBarCtrl::AddButtons.

Osservazioni:

Questa funzione è particolarmente utile se si desidera recuperare più di uno degli stati del pulsante. Per recuperare solo uno stato, usare una delle funzioni membro seguenti: IsButtonEnabled, IsButtonChecked, IsButtonPressedIsButtonHidden, o IsButtonIndeterminate. Tuttavia, la GetState funzione membro è l'unico modo per rilevare lo stato del TBSTATE_WRAP pulsante.

CToolBarCtrl::GetString

Recupera una stringa della barra degli strumenti.

int GetString(
    int nString,
    LPTSTR lpstrString,
    int cchMaxLen) const;

int GetString(
    int nString,
    CString& str) const;

Parametri

nString
Indice della stringa.

lpstrString
Puntatore a un buffer usato per restituire la stringa.

cchMaxLen
Lunghezza del buffer in byte.

str
Stringa.

Valore restituito

Lunghezza della stringa se ha esito positivo, -1 in caso contrario.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_GETSTRINGWin32 , come descritto in Windows SDK.

CToolBarCtrl::GetStyle

Ottiene gli stili attualmente applicati a un controllo barra degli strumenti.

DWORD GetStyle() const;

Valore restituito

Oggetto DWORD contenente una combinazione di stili di controllo della barra degli strumenti, come descritto in Windows SDK.

CToolBarCtrl::GetToolTips

Recupera l'handle del controllo della descrizione comando, se presente, associato al controllo barra degli strumenti.

CToolTipCtrl* GetToolTips() const;

Valore restituito

Puntatore all'oggetto CToolTipCtrl associato a questa barra degli strumenti o NULL se la barra degli strumenti non dispone di alcun controllo della descrizione comando associato.

Osservazioni:

Poiché il controllo barra degli strumenti crea e mantiene il proprio controllo descrizione comando, la maggior parte dei programmi non deve chiamare questa funzione.

CToolBarCtrl::HitTest

Determina dove si trova un punto in un controllo barra degli strumenti.

int HitTest(LPPOINT ppt) const;

Parametri

ppt
Puntatore a una POINT struttura che contiene la coordinata x dell'hit test nel x membro e la coordinata y dell'hit test nel y membro. Le coordinate sono relative all'area client della barra degli strumenti.

Valore restituito

Valore intero che indica la posizione di un punto su una barra degli strumenti. Se il valore è zero o un valore positivo, questo valore restituito è l'indice in base zero dell'elemento nonparator in cui si trova il punto.

Se il valore restituito è negativo, il punto non si trova all'interno di un pulsante. Il valore assoluto del valore restituito è l'indice di un elemento separatore o dell'elemento nonparator più vicino.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_HITTESTWin32 , come descritto in Windows SDK.

CToolBarCtrl::HideButton

Nasconde o mostra il pulsante specificato in un controllo barra degli strumenti.

BOOL HideButton(
    int nID,
    BOOL bHide = TRUE);

Parametri

nID
Identificatore del comando del pulsante da nascondere o visualizzare.

bHide
TRUE per nascondere il pulsante, FALSE per visualizzarlo.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Se si desidera modificare più di uno stato del pulsante, prendere in considerazione la chiamata SetState .

CToolBarCtrl::Indeterminate

Imposta o cancella lo stato indeterminato del pulsante specificato in un controllo barra degli strumenti.

BOOL Indeterminate(
    int nID,
    BOOL bIndeterminate = TRUE);

Parametri

nID
Identificatore del comando del pulsante il cui stato indeterminato deve essere impostato o cancellato.

bIndeterminate
TRUE per impostare lo stato indeterminato per il pulsante specificato, FALSE per cancellarlo.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

I pulsanti indeterminato vengono visualizzati in grigio, ad esempio il modo in cui il pulsante in grassetto sulla barra degli strumenti di un elaboratore di testo apparirebbe quando il testo selezionato contiene caratteri sia grassetto che normale. Se si desidera modificare più di uno stato del pulsante, prendere in considerazione la chiamata SetState .

CToolBarCtrl::InsertButton

Inserisce un pulsante in un controllo barra degli strumenti.

BOOL InsertButton(
    int nIndex,
    LPTBBUTTON lpButton);

Parametri

nIndex
Indice in base zero di un pulsante. Questa funzione inserisce il nuovo pulsante a sinistra di questo pulsante.

lpButton
Indirizzo di una TBBUTTON struttura contenente informazioni sul pulsante da inserire. Vedere CToolBarCtrl::AddButtons per una descrizione della TBBUTTON struttura.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

L'immagine e/o la stringa il cui indice specificato deve essere stato aggiunto in precedenza all'elenco del controllo della barra degli strumenti usando AddBitmap, AddStringe/o AddStrings.

CToolBarCtrl::InsertMarkHitTest

Recupera le informazioni sul contrassegno di inserimento per un punto in una barra degli strumenti.

BOOL InsertMarkHitTest(
    LPPOINT ppt,
    LPTBINSERTMARK ptbim) const;

Parametri

ppt
Puntatore a una POINT struttura che contiene le coordinate di hit test rispetto all'area client della barra degli strumenti.

ptbim
Puntatore a una TBINSERTMARK struttura che riceve le informazioni sul contrassegno di inserimento.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_INSERTMARKHITTESTWin32 , come descritto in Windows SDK.

CToolBarCtrl::IsButtonChecked

Determina se il pulsante specificato in un controllo barra degli strumenti è selezionato.

BOOL IsButtonChecked(int nID) const;

Parametri

nID
Identificatore del comando del pulsante sulla barra degli strumenti.

Valore restituito

Diverso da zero se il pulsante è selezionato; in caso contrario, zero.

Osservazioni:

Valutare la possibilità di chiamare GetState se si desidera recuperare più di uno stato del pulsante.

CToolBarCtrl::IsButtonEnabled

Determina se il pulsante specificato in un controllo barra degli strumenti è abilitato.

BOOL IsButtonEnabled(int nID) const;

Parametri

nID
Identificatore del comando del pulsante sulla barra degli strumenti.

Valore restituito

Diverso da zero se il pulsante è abilitato; in caso contrario, zero.

Osservazioni:

Valutare la possibilità di chiamare GetState se si desidera recuperare più di uno stato del pulsante.

CToolBarCtrl::IsButtonHidden

Determina se il pulsante specificato in un controllo barra degli strumenti è nascosto.

BOOL IsButtonHidden(int nID) const;

Parametri

nID
Identificatore del comando del pulsante sulla barra degli strumenti.

Valore restituito

Diverso da zero se il pulsante è nascosto; in caso contrario, zero.

Osservazioni:

Valutare la possibilità di chiamare GetState se si desidera recuperare più di uno stato del pulsante.

CToolBarCtrl::IsButtonHighlighted

Controlla lo stato di evidenziazione di un pulsante della barra degli strumenti.

BOOL IsButtonHighlighted(int nID) const;

Parametri

nID
[in] ID comando per il pulsante della barra degli strumenti.

Valore restituito

Numero intero positivo se il pulsante è evidenziato, 0 se il pulsante non è evidenziato o -1 se si verifica un errore.

CToolBarCtrl::IsButtonIndeterminate

Determina se il pulsante specificato in un controllo barra degli strumenti è indeterminato.

BOOL IsButtonIndeterminate(int nID) const;

Parametri

nID
[in] Identificatore del comando del pulsante sulla barra degli strumenti.

Valore restituito

Numero intero positivo se il pulsante è indeterminato, zero se il pulsante non è indeterminato o -1 se si verifica un errore.

Osservazioni:

I pulsanti indeterminato vengono visualizzati in grigio, ad esempio il modo in cui il pulsante grassetto sulla barra degli strumenti di un elaboratore di testo sembra quando il testo selezionato contiene caratteri sia in grassetto che normale. Valutare la possibilità di chiamare GetState se si desidera recuperare più di uno stato del pulsante.

CToolBarCtrl::IsButtonPressed

Determina se viene premuto il pulsante specificato in un controllo barra degli strumenti.

BOOL IsButtonPressed(int nID) const;

Parametri

nID
Identificatore del comando del pulsante sulla barra degli strumenti.

Valore restituito

Diverso da zero se viene premuto il pulsante; in caso contrario, zero.

Osservazioni:

Valutare la possibilità di chiamare GetState se si desidera recuperare più di uno stato del pulsante.

CToolBarCtrl::LoadImages

Carica le bitmap nell'elenco di immagini di un controllo della barra degli strumenti.

void LoadImages(
    int iBitmapID,
    HINSTANCE hinst);

Parametri

iBitmapID
ID di una bitmap che contiene le immagini da caricare. Per specificare la propria risorsa bitmap, impostare questo parametro sull'ID di una risorsa bitmap e impostare su hInst NULL. La risorsa bitmap verrà aggiunta all'elenco di immagini come singola immagine. È possibile aggiungere bitmap standard definite dal sistema impostando hinst HINST_COMMCTRL e impostando questo parametro su uno degli ID seguenti:

Bitmap ID Descrizione
IDB_HIST_LARGE_COLOR Bitmap di Esplora risorse in dimensioni elevate
IDB_HIST_SMALL_COLOR Bitmap di Explorer in dimensioni ridotte
IDB_STD_LARGE_COLOR Bitmap standard con dimensioni elevate
IDB_STD_SMALL_COLOR Bitmap standard con dimensioni ridotte
IDB_VIEW_LARGE_COLOR Visualizzare bitmap di grandi dimensioni
IDB_VIEW_SMALL_COLOR Visualizzare le bitmap in dimensioni ridotte

hinst
Handle dell'istanza del programma per l'applicazione chiamante. Questo parametro può essere HINST_COMMCTRL quello di caricare un elenco di immagini standard.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_LOADIMAGESWin32 , come descritto in Windows SDK.

CToolBarCtrl::MapAccelerator

Esegue il mapping di un carattere di scelta rapida a un pulsante della barra degli strumenti.

BOOL MapAccelerator(
    TCHAR chAccel,
    UINT* pIDBtn);

Parametri

chAccel
Carattere di acceleratore di cui eseguire il mapping. Questo carattere è lo stesso carattere sottolineato nel testo del pulsante.

pIDBtn
Puntatore a un oggetto UINT che riceve l'identificatore del comando del pulsante che corrisponde all'acceleratore specificato in chAccel.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_MAPACCELERATORWin32 , come descritto in Windows SDK.

CToolBarCtrl::MarkButton

Imposta lo stato di evidenziazione di un determinato pulsante in un controllo barra degli strumenti.

BOOL MarkButton(
    int nID,
    BOOL fHighlight = TRUE);

Parametri

nID
Identificatore del pulsante.

fHighlight
Specifica lo stato di evidenziazione da impostare. Per impostazione predefinita, TRUE. Se impostato su FALSE, il pulsante viene impostato sullo stato predefinito.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_MARKBUTTONWin32 , come descritto in Windows SDK.

CToolBarCtrl::MoveButton

Sposta un pulsante da un indice a un altro.

BOOL MoveButton(
    UINT nOldPos,
    UINT nNewPos);

Parametri

nOldPos
Indice in base zero del pulsante da spostare.

nNewPos
Indice in base zero della destinazione del pulsante.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_MOVEBUTTONWin32 , come descritto in Windows SDK.

CToolBarCtrl::PressButton

Preme o rilascia il pulsante specificato in un controllo barra degli strumenti.

BOOL PressButton(int nID, BOOL bPress = TRUE);

Parametri

nID
[in] Identificatore del comando del pulsante da premere o rilasciare.

bPress
[in] TRUE per premere il pulsante specificato; FALSE per rilasciare il pulsante specificato. Il valore predefinito è TRUE.

Valore restituito

TRUE se il metodo riesce; in caso contrario, FALSE.

Osservazioni:

Se si desidera modificare più di uno stato del pulsante, prendere in considerazione la chiamata SetState .

Questo metodo invia il TB_PRESSBUTTON messaggio, descritto in Windows SDK.

CToolBarCtrl::ReplaceBitmap

Sostituisce la bitmap esistente nel controllo della barra degli strumenti corrente con una nuova bitmap.

BOOL ReplaceBitmap(LPTBREPLACEBITMAP pReplaceBitmap);

Parametri

pReplaceBitmap
[in] Puntatore a una TBREPLACEBITMAP struttura che descrive la bitmap da sostituire e la nuova bitmap.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario, FALSE.

Osservazioni:

Questo metodo invia il TB_REPLACEBITMAP messaggio, descritto in Windows SDK.

Esempio

L'esempio di codice seguente sostituisce la bitmap per la barra degli strumenti standard con una bitmap diversa.

{
   // Replace one toolbar bitmap with another.
   TBREPLACEBITMAP tbrb;
   tbrb.hInstOld = ::AfxGetInstanceHandle();
   tbrb.nIDOld = IDR_MAINFRAME;
   tbrb.hInstNew = ::AfxGetInstanceHandle();
   tbrb.nIDNew = IDR_MAINFRAME1;
   tbrb.nButtons = 8;
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ReplaceBitmap(&tbrb);
}

CToolBarCtrl::RestoreState

Ripristina lo stato del controllo della barra degli strumenti dal percorso nel Registro di sistema specificato dai parametri.

void RestoreState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Parametri

hKeyRoot
Identifica una chiave attualmente aperta nel Registro di sistema o uno dei valori di handle riservati predefiniti seguenti:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

lpszSubKey
Punta a una NULLstringa con terminazione contenente il nome della sottochiave a cui è associato un valore. Questo parametro può essere NULL o un puntatore a una stringa vuota. Se il parametro è NULL, il valore verrà aggiunto alla chiave identificata dal hKeyRoot parametro .

lpszValueName
Punta a una stringa contenente il nome del valore da recuperare. Se un valore con questo nome non è già presente nella chiave, la funzione lo aggiunge alla chiave.

CToolBarCtrl::SaveState

Salva lo stato del controllo barra degli strumenti nel percorso nel Registro di sistema specificato dai parametri.

void SaveState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Parametri

hKeyRoot
Identifica una chiave attualmente aperta nel Registro di sistema o uno dei valori di handle riservati predefiniti seguenti:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

lpszSubKey
Punta a una NULLstringa con terminazione contenente il nome della sottochiave a cui è associato un valore. Questo parametro può essere NULL o un puntatore a una stringa vuota. Se il parametro è NULL, il valore verrà aggiunto alla chiave identificata dal hKeyRoot parametro .

lpszValueName
Punta a una stringa contenente il nome del valore da impostare. Se un valore con questo nome non è già presente nella chiave, la funzione lo aggiunge alla chiave.

CToolBarCtrl::SetAnchorHighlight

Imposta l'impostazione di evidenziazione dell'ancoraggio per una barra degli strumenti.

BOOL SetAnchorHighlight(BOOL fAnchor = TRUE);

Parametri

fAnchor
[in] Specifica se l'evidenziazione dell'ancoraggio è abilitata o disabilitata. Se questo valore è diverso da zero, l'evidenziazione dell'ancoraggio verrà abilitata. Se questo valore è zero, l'evidenziazione dell'ancoraggio verrà disabilitata

Valore restituito

Impostazione di ancoraggio precedente. Se l'evidenziazione è stata abilitata, questo valore è diverso da zero. Se l'evidenziazione non è stata abilitata, questo valore è zero.

Osservazioni:

Questo metodo implementa il comportamento del messaggio TB_SETANCHORHIGHLIGHTWin32 , come descritto in Windows SDK.

CToolBarCtrl::SetBitmapSize

Imposta le dimensioni delle immagini bitmap effettive da aggiungere a un controllo barra degli strumenti.

BOOL SetBitmapSize(CSize size);

Parametri

size
Larghezza e altezza, in pixel, delle immagini bitmap.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Questa funzione deve essere chiamata solo prima di aggiungere bitmap alla barra degli strumenti. Se l'applicazione non imposta in modo esplicito le dimensioni della bitmap, per impostazione predefinita viene impostata su 16 per 15 pixel.

CToolBarCtrl::SetButtonInfo

Imposta le informazioni per un pulsante esistente in una barra degli strumenti.

BOOL SetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi);

Parametri

nID
Identificatore del pulsante.

ptbbi
Puntatore a una TBBUTTONINFO struttura che riceve le informazioni sul pulsante.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

La funzione membro implementa il comportamento del messaggio TB_SETBUTTONINFOWin32 , come descritto in Windows SDK.

CToolBarCtrl::SetButtonSize

Imposta le dimensioni dei pulsanti nel controllo barra degli strumenti.

BOOL SetButtonSize(CSize size);

Parametri

size
Larghezza e altezza, in pixel, dei pulsanti.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Le dimensioni del pulsante devono essere sempre pari almeno a quanto le dimensioni della bitmap che racchiudono. Questa funzione deve essere chiamata solo prima di aggiungere bitmap alla barra degli strumenti. Se l'applicazione non imposta in modo esplicito le dimensioni del pulsante, il valore predefinito è 24 per 22 pixel.

Esempio

Vedere l'esempio per CToolBar::GetToolBarCtrl.

CToolBarCtrl::SetButtonStructSize

Specifica le dimensioni della TBBUTTON struttura.

void SetButtonStructSize(int nSize);

Parametri

nSize
Dimensione, in byte, della TBBUTTON struttura.

Osservazioni:

Se si desidera archiviare dati aggiuntivi nella TBBUTTON struttura, è possibile derivare una nuova struttura da TBBUTTON, aggiungere i membri necessari oppure creare una nuova struttura contenente una TBBUTTON struttura come primo membro. È quindi necessario chiamare questa funzione per indicare alla barra degli strumenti di controllare le dimensioni della nuova struttura.

Per altre informazioni sulla TBBUTTON struttura, vedere CToolBarCtrl::AddButtons .

CToolBarCtrl::SetButtonWidth

Imposta la larghezza minima e massima dei pulsanti nel controllo barra degli strumenti.

BOOL SetButtonWidth(
    int cxMin,
    int cxMax);

Parametri

cxMin
Larghezza minima del pulsante, in pixel. I pulsanti della barra degli strumenti non saranno mai più stretti di questo valore.

cxMax
Larghezza massima del pulsante, in pixel. Se il testo del pulsante è troppo largo, il controllo lo visualizza con puntini di sospensione.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_SETBUTTONWIDTHWin32 , come descritto in Windows SDK.

CToolBarCtrl::SetCmdID

Imposta l'identificatore del comando che verrà inviato alla finestra del proprietario quando viene premuto il pulsante specificato.

BOOL SetCmdID(
    int nIndex,
    UINT nID);

Parametri

nIndex
Indice in base zero del pulsante il cui ID comando deve essere impostato.

nID
ID comando su cui impostare il pulsante selezionato.

Valore restituito

Restituisce un valore diverso da zero se ha esito positivo; in caso contrario, zero.

CToolBarCtrl::SetColorScheme

Imposta la combinazione di colori del controllo della barra degli strumenti corrente.

void SetColorScheme(const COLORSCHEME* lpColorScheme);

Parametri

lpColorScheme
[in] Puntatore a una COLORSCHEME struttura che descrive il colore di evidenziazione e il colore dell'ombreggiatura del controllo barra degli strumenti.

Osservazioni:

Questo metodo non ha alcun effetto se è impostato un tema visivo di Windows Vista.

Questo metodo invia il TB_SETCOLORSCHEME messaggio, descritto in Windows SDK.

Esempio

Nell'esempio di codice seguente viene impostata la combinazione di colori per il controllo della barra degli strumenti corrente. L'esempio di codice rende i bordi sinistro e superiore di ogni pulsante dello strumento rosso e i bordi destro e inferiore blu. Quando l'utente preme il pulsante, i bordi rossi del pulsante diventano blu e i bordi blu diventano rossi.

//Set color scheme for the current toolbar control.
//Make the left and top edges of the tool button red,
//and the right and bottom edges blue. The colors
//reverse when a button is pressed.
//This method has no effect if the Vista visual theme
//is set.
{
   COLORSCHEME cs;
   cs.dwSize = sizeof(COLORSCHEME);
   cs.clrBtnHighlight = RGB(255, 0, 0);
   cs.clrBtnShadow = RGB(0, 0, 255);
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetColorScheme(&cs);
}

CToolBarCtrl::SetDisabledImageList

Imposta l'elenco di immagini che verrà utilizzato dal controllo barra degli strumenti per visualizzare i pulsanti disabilitati.

CImageList* SetDisabledImageList(CImageList* pImageList);

Parametri

pImageList
Puntatore a un CImageList oggetto contenente le immagini da utilizzare dal controllo barra degli strumenti per visualizzare immagini dei pulsanti disabilitate.

Valore restituito

Puntatore a un CImageList oggetto utilizzato in precedenza dal controllo barra degli strumenti per visualizzare immagini dei pulsanti disabilitate.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_SETDISABLEDIMAGELISTWin32 , come descritto in Windows SDK. L'implementazione MFC di SetDisabledImageList usa un CImageList oggetto contenente le immagini del pulsante disabilitate del controllo barra degli strumenti, anziché un handle per un elenco di immagini.

CToolBarCtrl::SetDrawTextFlags

Imposta i flag nella funzione DrawTextWin32 , che viene usato per disegnare il testo nel rettangolo specificato, formattato in base alla modalità di impostazione dei flag.

DWORD SetDrawTextFlags(
    DWORD dwMask,
    DWORD dwDTFlags);

Parametri

dwMask
Combinazione di uno o più DT_ flag, specificati nella funzione DrawTextWin32 , che indica i bit in dwDTFlags che verranno usati durante il disegno del testo.

dwDTFlags
Combinazione di uno o più DT_ flag, specificati nella funzione DrawTextWin32 , che indicano come verrà disegnato il testo del pulsante. Questo valore viene passato a DrawText quando viene disegnato il testo del pulsante.

Valore restituito

Oggetto DWORD contenente i flag di disegno di testo precedenti.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_SETDRAWTEXTFLAGSWin32 , come descritto in Windows SDK. Questa funzione membro imposta i flag nella funzione DrawTextWin32 , che disegna testo nel rettangolo specificato, formattato in base alla modalità di impostazione dei flag.

CToolBarCtrl::SetExtendedStyle

Imposta gli stili estesi per un controllo barra degli strumenti.

DWORD SetExtendedStyle(DWORD dwExStyle);

Parametri

dwExStyle
Valore che specifica i nuovi stili estesi. Questo parametro può essere una combinazione degli stili estesi della barra degli strumenti.

Valore restituito

Oggetto DWORD che rappresenta gli stili estesi precedenti. Per un elenco degli stili, vedi Stili estesi della barra degli strumenti in Windows SDK.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_SETEXTENDEDSTYLEWin32 , come descritto in Windows SDK.

CToolBarCtrl::SetHotImageList

Imposta l'elenco di immagini che verrà utilizzato dal controllo barra degli strumenti per visualizzare i pulsanti "ad accesso frequente".

CImageList* SetHotImageList(CImageList* pImageList);

Parametri

pImageList
Puntatore a un CImageList oggetto contenente le immagini da utilizzare dal controllo barra degli strumenti per visualizzare immagini di pulsanti di scelta rapida.

Valore restituito

Puntatore a un CImageList oggetto utilizzato in precedenza dal controllo barra degli strumenti per visualizzare le immagini dei pulsanti di scelta rapida.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_SETHOTIMAGELISTWin32 , come descritto in Windows SDK.

L'implementazione MFC di SetHotImageList usa un CImageList oggetto contenente le immagini dei pulsanti di scelta rapida del controllo della barra degli strumenti, anziché un handle per un elenco di immagini. Quando il puntatore è al di sopra di esso, viene visualizzato un pulsante attivo evidenziato.

CToolBarCtrl::SetHotItem

Imposta l'elemento attivo in una barra degli strumenti.

int SetHotItem(int nHot);

Parametri

nHot
Numero di indice in base zero dell'elemento che verrà reso attivo. Se questo valore è -1, nessuno degli elementi sarà attivo.

Valore restituito

Indice dell'elemento attivo precedente oppure -1 se non è presente alcun elemento attivo.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_SETHOTITEMWin32 , come descritto in Windows SDK.

CToolBarCtrl::SetImageList

Imposta l'elenco di immagini che verrà utilizzato dalla barra degli strumenti per visualizzare i pulsanti nello stato predefinito.

CImageList* SetImageList(CImageList* pImageList);

Parametri

pImageList
Puntatore a un CImageList oggetto contenente le immagini da utilizzare dal controllo barra degli strumenti per visualizzare le immagini dei pulsanti nello stato predefinito.

Valore restituito

Puntatore a un CImageList oggetto utilizzato in precedenza dal controllo barra degli strumenti per visualizzare le immagini dei pulsanti nello stato predefinito.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_SETIMAGELISTWin32 , come descritto in Windows SDK.

L'implementazione MFC di SetImageList usa un CImageList oggetto contenente le immagini del pulsante del controllo della barra degli strumenti, anziché un handle per un elenco di immagini.

CToolBarCtrl::SetIndent

Imposta il rientro per il primo pulsante in un controllo barra degli strumenti.

BOOL SetIndent(int iIndent);

Parametri

iIndent
Valore che specifica il rientro, in pixel.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

CToolBarCtrl::SetInsertMark

Imposta il segno di inserimento corrente per la barra degli strumenti.

void SetInsertMark(TBINSERTMARK* ptbim);

Parametri

ptbim
Puntatore alla TBINSERTMARK struttura che contiene il segno di inserimento.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_SETINSERTMARKWin32 , come descritto in Windows SDK.

CToolBarCtrl::SetInsertMarkColor

Imposta il colore utilizzato per disegnare il segno di inserimento per la barra degli strumenti.

COLORREF SetInsertMarkColor(COLORREF clrNew);

Parametri

clrNew
Valore COLORREF che contiene il nuovo colore del segno di inserimento.

Valore restituito

Valore COLORREF contenente il colore del segno di inserimento precedente.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TB_SETINSERTMARKCOLORWin32 , come descritto in Windows SDK.

CToolBarCtrl::SetMaxTextRows

Imposta il numero massimo di righe di testo visualizzate su un pulsante della barra degli strumenti.

BOOL SetMaxTextRows(int iMaxRows);

Parametri

iMaxRows
Numero massimo di righe da impostare.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

CToolBarCtrl::SetMetrics

Imposta le metriche dell'oggetto CToolBarCtrl .

void SetMetrics(LPTBMETRICS ptbm);

Parametri

ptbm
Puntatore alla TBMETRICS struttura dell'oggetto CToolBarCtrl .

Osservazioni:

Questa funzione membro emula la funzionalità del TB_SETMETRICS messaggio, come descritto in Windows SDK.

CToolBarCtrl::SetOwner

Imposta la finestra proprietario per il controllo barra degli strumenti.

void SetOwner(CWnd* pWnd);

Parametri

pWnd
Puntatore all'oggetto CWnd derivato da o CWndche sarà la nuova finestra di proprietario per il controllo barra degli strumenti.

Osservazioni:

La finestra del proprietario è la finestra che riceve le notifiche dalla barra degli strumenti.

CToolBarCtrl::SetPadding

Imposta la spaziatura interna orizzontale e verticale del controllo barra degli strumenti corrente.

DWORD SetPadding(
    int nHorzPadding,
    int nVertPadding);

Parametri

nHorzPadding
[in] Specifica la spaziatura interna orizzontale del controllo barra degli strumenti, in pixel.

nVertPadding
[in] Specifica la spaziatura interna verticale del controllo barra degli strumenti, in pixel.

Valore restituito

Oggetto DWORD la cui parola bassa contiene il valore di spaziatura interna orizzontale precedente e la cui parola alta contiene il valore di spaziatura interna verticale precedente. I valori di spaziatura interna vengono misurati in pixel.

Osservazioni:

Questo metodo invia il TB_SETPADDING messaggio, descritto in Windows SDK.

Esempio

Nell'esempio di codice seguente la spaziatura interna orizzontale e verticale del controllo della barra degli strumenti corrente viene impostata su 20 pixel.

{
   // Set the horizontal and vertical padding of the current
   // toolbar control.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetPadding(50, 50);
}

CToolBarCtrl::SetPressedImageList

Imposta l'elenco di immagini utilizzato dal controllo della barra degli strumenti corrente per rappresentare i pulsanti nello stato premuto.

CImagelist* SetPressedImageList(
    int iImageID,
    CImageList* pImageList);

Parametri

iImageID
[in] Indice in base zero dell'elenco di immagini. Impostare questo parametro su zero se si usa un solo elenco di immagini.

pImageList
[in] Puntatore a un CImageList oggetto contenente il nuovo elenco di immagini.

Valore restituito

Puntatore a un CImageList oggetto contenente l'elenco di immagini precedente per il controllo corrente o NULL se non è stato impostato alcun elenco di immagini di questo tipo.

Osservazioni:

Questo metodo invia il TB_SETPRESSEDIMAGELIST messaggio, descritto in Windows SDK.

Esempio

L'esempio di codice seguente imposta l'elenco di immagini premuto come uguale all'elenco di immagini predefinito.

{
   // SetPressedImageList
   // Set the pressed image list to be the same as the
   // normal image list.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   CImageList *pNormalCil = m_toolBarCtrl.GetImageList();
   CImageList *pPressedCil = m_toolBarCtrl.GetPressedImageList();
   m_toolBarCtrl.SetPressedImageList(0, pNormalCil);
}

CToolBarCtrl::SetRows

Chiede al controllo della barra degli strumenti di ridimensionarsi al numero di righe richiesto.

void SetRows(
    int nRows,
    BOOL bLarger,
    LPRECT lpRect);

Parametri

nRows
Numero di righe richiesto.

bLarger
Indica se usare più righe o meno righe se la barra degli strumenti non può essere ridimensionata in base al numero di righe richiesto.

lpRect
Punta all'oggetto CRect o RECT alla struttura che riceverà il nuovo rettangolo di delimitazione della barra degli strumenti.

Osservazioni:

Se la barra degli strumenti non può ridimensionarsi al numero o alle righe richieste, verrà ridimensionata in base alle dimensioni successive maggiori o successive più piccole, a seconda del valore di bLarger. Se bLarger è TRUE, il nuovo numero di righe sarà maggiore del numero richiesto. Se bLarger è FALSE, il nuovo numero di righe sarà inferiore al numero richiesto.

Un determinato numero di righe è valido per la barra degli strumenti se i pulsanti possono essere disposti in modo che tutte le righe abbiano lo stesso numero di pulsanti (tranne forse l'ultima riga). Ad esempio, una barra degli strumenti contenente quattro pulsanti non può essere ridimensionata a tre righe perché le ultime due righe devono essere più brevi. Se si è tentato di ridimensionarlo in tre righe, si otterrebbero quattro righe se bLarger fosse TRUE e due righe se bLarger fosse FALSE.

Se sono presenti separatori nella barra degli strumenti, le regole per quando un determinato numero di righe è valido sono più complesse. Il layout viene calcolato in modo che i gruppi di pulsanti (pulsanti con un separatore prima del primo e dell'ultimo pulsante nel gruppo) non vengano mai suddivisi in più righe, a meno che il gruppo non sia in grado di adattarsi a una riga.

Se un gruppo non rientra in una riga, il gruppo successivo inizierà sulla riga successiva anche se si adatta alla riga in cui è terminato il gruppo di grandi dimensioni. Lo scopo di questa regola è rendere più evidente la separazione tra gruppi di grandi dimensioni. I separatori verticali risultanti vengono conteggiati come righe.

Si noti anche che la SetRows funzione membro sceglierà sempre il layout con le dimensioni più piccole della barra degli strumenti. La creazione di una barra degli strumenti con lo TBSTYLE_WRAPABLE stile e quindi il ridimensionamento del controllo applicherà semplicemente il metodo descritto sopra in base alla larghezza del controllo.

Questa funzione può essere chiamata solo per le barre degli strumenti create con lo TBSTYLE_WRAPABLE stile .

CToolBarCtrl::SetState

Imposta lo stato per il pulsante specificato in un controllo barra degli strumenti.

BOOL SetState(
    int nID,
    UINT nState);

Parametri

nID
Identificatore del comando del pulsante.

nState
Flag di stato. Può essere una combinazione dei valori elencati per gli stati del pulsante in CToolBarCtrl::AddButtons.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Questa funzione è particolarmente utile se si desidera impostare più di uno degli stati del pulsante. Per impostare solo uno stato, usare una delle funzioni membro seguenti: EnableButton, CheckButton, HideButtonIndeterminate, o PressButton.

CToolBarCtrl::SetStyle

Imposta gli stili per un controllo barra degli strumenti.

void SetStyle(DWORD dwStyle);

Parametri

dwStyle
Oggetto DWORD contenente una combinazione di stili di controllo della barra degli strumenti, come descritto in Windows SDK.

CToolBarCtrl::SetToolTips

Associa un controllo descrizione comando a un controllo barra degli strumenti.

void SetToolTips(CToolTipCtrl* pTip);

Parametri

pTip
Puntatore all'oggetto CToolTipCtrl .

CToolBarCtrl::SetWindowTheme

Imposta lo stile di visualizzazione dell'oggetto CToolBarCtrl .

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parametri

pszSubAppName
Puntatore a una stringa Unicode contenente lo stile di visualizzazione della barra degli strumenti da impostare.

Valore restituito

Il valore restituito non viene usato.

Osservazioni:

Questa funzione membro emula la funzionalità del TB_SETWINDOWTHEME messaggio, come descritto in Windows SDK.

Vedi anche

Esempio MFC CMNCTRL1
Esempio MFC MFCIE
CWnd Classe
Grafico della gerarchia
CToolBar Classe