Classe CMFCToolBarButton

Articolo
08/04/2024

Fornisce la funzionalità dei pulsanti alle barre degli strumenti.

Sintassi

class CMFCToolBarButton : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CMFCToolBarButton::CMFCToolBarButton	Costruisce e inizializza un oggetto `CMFCToolBarButton`.
`CMFCToolBarButton::~CMFCToolBarButton`	Distruttore.

Metodi pubblici

Nome	Descrizione
CMFCToolBarButton::CanBeDropped	Specifica se un utente può posizionare un pulsante su una barra degli strumenti o un menu durante la personalizzazione.
CMFCToolBarButton::CanBeStored	Specifica se il pulsante può essere archiviato.
CMFCToolBarButton::CanBeStretched	Specifica se un utente può estendere il pulsante durante la personalizzazione.
CMFCToolBarButton::CompareWith	Confronta questa istanza con l'oggetto fornito `CMFCToolBarButton` .
CMFCToolBarButton::CopyFrom	Copia le proprietà di un altro pulsante della barra degli strumenti nel pulsante corrente.
CMFCToolBarButton::CreateFromOleData	Crea un `CMFCToolBarButton` oggetto dall'oggetto fornito `COleDataObject` .
`CMFCToolBarButton::CreateObject`	Usato dal framework per creare un'istanza dinamica di questo tipo di classe.
CMFCToolBarButton::EnableWindow	Abilita o disabilita l'input da mouse e tastiera.
CMFCToolBarButton::ExportToMenuButton	Copia il testo dal pulsante della barra degli strumenti a un menu.
CMFCToolBarButton::GetClipboardFormat	Recupera il formato globale degli Appunti per l'applicazione.
CMFCToolBarButton::GetHwnd	Recupera l'handle di finestra associato al pulsante della barra degli strumenti.
CMFCToolBarButton::GetImage	Recupera l'indice dell'immagine del pulsante.
CMFCToolBarButton::GetInvalidateRect	Recupera l'area dell'area client del pulsante che deve essere ridisegnata.
CMFCToolBarButton::GetParentWnd	Recupera la finestra padre del pulsante.
CMFCToolBarButton::GetProtectedCommands	Recupera l'elenco di comandi che l'utente non può personalizzare.
CMFCToolBarButton::GetTextSize	Recupera le dimensioni del testo del pulsante.
CMFCToolBarButton::HasFocus	Determina se il pulsante ha lo stato attivo di input corrente.
CMFCToolBarButton::HaveHotBorder	Determina se un bordo del pulsante viene visualizzato quando un utente seleziona il pulsante.
CMFCToolBarButton::IsDrawImage	Determina se un'immagine viene visualizzata sul pulsante.
CMFCToolBarButton::IsDrawText	Determina se sul pulsante viene visualizzata un'etichetta di testo.
CMFCToolBarButton::IsDroppedDown	Determina se il pulsante visualizza un sottomenu.
CMFCToolBarButton::IsEditable	Determina se il pulsante può essere personalizzato.
CMFCToolBarButton::IsExtraSize	Determina se il pulsante può essere visualizzato con un bordo esteso.
CMFCToolBarButton::IsFirstInGroup	Determina se il pulsante si trova nella prima posizione nel relativo gruppo di pulsanti.
CMFCToolBarButton::IsHidden	Determina se il pulsante è nascosto.
CMFCToolBarButton::IsHorizontal	Determina se il pulsante si trova su una barra degli strumenti orizzontale.
CMFCToolBarButton::IsLastInGroup	Specifica se il pulsante si trova nell'ultima posizione nel relativo gruppo di pulsanti.
CMFCToolBarButton::IsLocked	Determina se il pulsante si trova su una barra degli strumenti bloccata (non personalizzabile).
CMFCToolBarButton::IsOwnerOf	Determina se il pulsante è il proprietario dell'handle di finestra specificato.
CMFCToolBarButton::IsVisible	Determina se il pulsante della barra degli strumenti è visibile.
CMFCToolBarButton::IsWindowVisible	Determina se l'handle di finestra sottostante del pulsante è visibile.
CMFCToolBarButton::NotifyCommand	Specifica se il pulsante elabora il messaggio WM_COMMAND .
CMFCToolBarButton::OnAddToCustomizePage	Chiamato dal framework quando il pulsante viene aggiunto a una finestra di dialogo Personalizza .
CMFCToolBarButton::OnBeforeDrag	Specifica se il pulsante può essere trascinato.
CMFCToolBarButton::OnBeforeDrop	Specifica se un utente può rilasciare il pulsante sulla barra degli strumenti di destinazione.
CMFCToolBarButton::OnCalculateSize	Chiamato dal framework per calcolare le dimensioni del pulsante per il contesto di dispositivo e lo stato di ancoraggio specificati.
CMFCToolBarButton::OnCancelMode	Chiamato dal framework per gestire il messaggio di WM_CANCELMODE .
CMFCToolBarButton::OnChangeParentWnd	Chiamato dal framework quando il pulsante viene inserito in una nuova barra degli strumenti.
CMFCToolBarButton::OnClick	Chiamato dal framework quando l'utente fa clic sul pulsante del mouse.
CMFCToolBarButton::OnClickUp	Chiamato dal framework quando l'utente rilascia il pulsante del mouse.
CMFCToolBarButton::OnContextHelp	Chiamato dal framework quando la barra degli strumenti padre gestisce un messaggio di WM_HELPHITTEST.
CMFCToolBarButton::OnCtlColor	Chiamato dal framework quando la barra degli strumenti padre gestisce un messaggio di WM_CTLCOLOR.
CMFCToolBarButton::OnCustomizeMenu	Consente al pulsante di modificare il menu fornito quando l'applicazione visualizza un menu di scelta rapida sulla barra degli strumenti padre.
CMFCToolBarButton::OnDblClk	Chiamato dal framework quando la barra degli strumenti padre gestisce un messaggio WM_LBUTTONDBLCLK .
CMFCToolBarButton::OnDraw	Chiamato dal framework per disegnare il pulsante usando gli stili e le opzioni specificati.
CMFCToolBarButton::OnDrawOnCustomizeList	Chiamato dal framework per disegnare il pulsante nel riquadro Comandi della finestra di dialogo Personalizza .
CMFCToolBarButton::OnGetCustomToolTipText	Chiamato dal framework per recuperare il testo personalizzato della descrizione comando per il pulsante.
CMFCToolBarButton::OnGlobalFontsChanged	Chiamato dal framework quando il tipo di carattere globale è stato modificato.
CMFCToolBarButton::OnMove	Chiamato dal framework quando la barra degli strumenti padre viene spostata.
CMFCToolBarButton::OnShow	Chiamato dal framework quando il pulsante diventa visibile o invisibile.
CMFCToolBarButton::OnSize	Chiamato dal framework quando la barra degli strumenti padre modifica le dimensioni o la posizione e questa modifica richiede che il pulsante modifichi le dimensioni.
CMFCToolBarButton::OnToolHitTest	Chiamato dal framework quando la barra degli strumenti padre deve determinare se un punto si trova nel rettangolo di delimitazione del pulsante.
CMFCToolBarButton::OnUpdateToolTip	Chiamato dal framework quando la barra degli strumenti padre aggiorna il testo della descrizione comando.
CMFCToolBarButton::P repareDrag	Chiamato dal framework quando il pulsante sta per eseguire un'operazione di trascinamento della selezione.
CMFCToolBarButton::Rect	Recupera il rettangolo di delimitazione del pulsante.
CMFCToolBarButton::ResetImageToDefault	Imposta sul valore predefinito l'immagine associata al pulsante.
CMFCToolBarButton::SaveBarState	Salva lo stato del pulsante della barra degli strumenti.
CMFCToolBarButton::Serialize	Legge questo oggetto da un archivio o lo scrive in un archivio. Esegue l'override di CObject::Serialize.
CMFCToolBarButton::SetACCData	Popola l'oggetto fornito `CAccessibilityData` con i dati di accessibilità dal pulsante della barra degli strumenti.
CMFCToolBarButton::SetClipboardFormatName	Rinomina il formato globale degli Appunti.
CMFCToolBarButton::SetImage	Imposta l'indice dell'immagine del pulsante.
CMFCToolBarButton::SetProtectedCommands	Imposta l'elenco dei comandi che l'utente non può personalizzare.
CMFCToolBarButton::SetRadio	Chiamato dal framework quando un pulsante cambia lo stato selezionato.
CMFCToolBarButton::SetRect	Imposta il rettangolo di delimitazione del pulsante.
CMFCToolBarButton::SetStyle	Imposta lo stile del pulsante.
CMFCToolBarButton::SetVisible	Specifica se il pulsante è visibile.
CMFCToolBarButton::Show	Mostra o nasconde il pulsante.

Membri dei dati

Nome	Descrizione
CMFCToolBarButton::m_bImage	Specifica se un'immagine viene visualizzata sul pulsante.
CMFCToolBarButton::m_bText	Specifica se sul pulsante viene visualizzata un'etichetta di testo.
CMFCToolBarButton::m_bTextBelow	Specifica se l'etichetta di testo viene visualizzata sotto l'immagine sul pulsante.
CMFCToolBarButton::m_bUserButton	Specifica se il pulsante ha un'immagine definita dall'utente.
CMFCToolBarButton::m_bWholeText	Specifica se il pulsante visualizza l'etichetta full-text anche se non rientra nel rettangolo di delimitazione.
CMFCToolBarButton::m_bWrap	Specifica se il pulsante accanto a un separatore verrà inserito nella riga successiva.
CMFCToolBarButton::m_bWrapText	Specifica se le etichette di testo a più righe sono abilitate.
CMFCToolBarButton::m_nID	ID del comando del pulsante.
CMFCToolBarButton::m_nStyle	Stile del pulsante.
CMFCToolBarButton::m_strText	Etichetta di testo del pulsante.

Osservazioni:

Un CMFCToolbarButton oggetto è un controllo che si trova su una barra degli strumenti. Il suo comportamento è simile a quello di un pulsante ordinario. È possibile assegnare un'immagine e un'etichetta di testo a questo oggetto. Un pulsante della barra degli strumenti può anche avere un ID comando. Quando l'utente fa clic sul pulsante della barra degli strumenti, il framework esegue il comando specificato da questo ID.

In genere, i pulsanti della barra degli strumenti possono essere personalizzati: l'utente può trascinare i pulsanti da una barra degli strumenti a un'altra e copiare, incollare, eliminare e modificare etichette e immagini di testo. Per impedire all'utente di personalizzare la barra degli strumenti, è possibile bloccare la barra degli strumenti in uno dei due modi seguenti. Impostare il bLocked flag su TRUE quando si chiama CMFCToolBar::LoadToolBar oppure aggiungere l'ID comando di un singolo pulsante all'elenco globale di comandi protetti usando il metodo CMFCToolBarButton::SetProtectedCommands .

CMFCToolBarButton gli oggetti visualizzano immagini dalle raccolte globali di immagini della barra degli strumenti nell'applicazione. Queste raccolte vengono gestite dalla barra degli strumenti padre, classe CMFCToolBar. Per altre informazioni, vedere Classe CMFCToolBarImages.

Quando l'utente fa clic su un pulsante della barra degli strumenti, la barra degli strumenti padre elabora il messaggio del mouse e comunica le azioni appropriate al pulsante. Se il pulsante ha un ID comando valido, la barra degli strumenti padre invia il messaggio WM_COMMAND al frame padre.

La CMFCToolBarButton classe è la classe base per altre classi di pulsanti della barra degli strumenti, ad esempio CMFCToolBarMenuButton Class, CMFCToolBarEditBoxButton Class e CMFCToolBarComboBoxButton Class.

Esempio

Nell'esempio seguente viene illustrato come configurare un CMFCToolBarButton oggetto usando vari metodi nella CMFCToolBarButton classe . Nell'esempio viene illustrato come abilitare l'input del mouse e della tastiera, impostare l'indice dell'immagine del pulsante, impostare il rettangolo di delimitazione del pulsante e rendere visibile il pulsante. Questo frammento di codice fa parte dell'esempio di controllo Struttura a schede.

CMFCToolBarButton *pOffice2007 = NULL;
int nIndex = -1;

for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
{
   // CMFCToolBar m_wndToolBarTheme
   nIndex = m_wndToolBarTheme.CommandToIndex(uiCmd);

   CMFCToolBarButton *pButton = m_wndToolBarTheme.GetButton(nIndex);

   if (pButton != NULL)
   {
      pOffice2007 = pButton;
      break;
   }
}

pOffice2007->EnableWindow();
pOffice2007->SetImage(1);
pOffice2007->SetRect(CRect(1, 1, 1, 1));
pOffice2007->SetVisible();
pOffice2007->Show(true);

Gerarchia di ereditarietà

CObject

CMFCToolBarButton

Requisiti

Intestazione: afxtoolbarbutton.h

CMFCToolBarButton::CanBeDropped

Specifica se un utente può posizionare un pulsante su una barra degli strumenti o un menu durante la personalizzazione.

virtual BOOL CanBeDropped(CMFCToolBar* pToolbar);

Parametri

pToolbar
[in] Inutilizzato.

Valore restituito

Questo metodo restituisce TRUE.

Osservazioni:

Per impostazione predefinita, un pulsante della barra degli strumenti può essere eliminato su ogni barra degli strumenti personalizzabile (ovvero non bloccata).

L'implementazione predefinita di questo metodo restituisce TRUE. Eseguire l'override di questo metodo e restituire FALSE se si desidera impedire all'utente di riposizionare il pulsante.

CMFCToolBarButton::CanBeStored

Determina se il pulsante può essere archiviato.

virtual BOOL CanBeStored() const;

Valore restituito

Questo metodo restituisce TRUE.

Osservazioni:

Il framework usa questo metodo per determinare se il pulsante può partecipare a un'operazione di trascinamento della selezione.

L'implementazione predefinita restituisce TRUE. Eseguire l'override di questo metodo se il pulsante non può essere archiviato come parte di un'operazione di trascinamento della selezione. Per altre informazioni sulle operazioni di trascinamento della selezione, vedere Trascinamento e rilascio OLE.

CMFCToolBarButton::CanBeStretched

Specifica se un utente può estendere il pulsante durante la personalizzazione.

virtual BOOL CanBeStretched() const;

Valore restituito

Questo metodo restituisce FALSE.

Osservazioni:

Questo metodo viene usato dal framework per determinare se il pulsante può essere esteso in modalità di personalizzazione.

L'implementazione predefinita di questo metodo restituisce FALSE. Eseguire l'override di questo metodo per restituire TRUE per un controllo a larghezza variabile, ad esempio una casella combinata o un dispositivo di scorrimento.

Per altre informazioni sulla modalità di personalizzazione, vedere CMFCToolBar::SetCustomizeMode.

CMFCToolBarButton::CMFCToolBarButton

Costruisce e inizializza un oggetto CMFCToolBarButton.

CMFCToolBarButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE,
    BOOL bLocked=FALSE);

Parametri

uiID
[in] ID del comando del pulsante.

iImage
[in] Indice dell'immagine del pulsante nella raccolta di immagini.

lpszText
[in] Etichetta di testo del pulsante. Può essere NULL.

bUserButton
[in] Valore booleano che determina se il pulsante è definito dall'utente. Se questo parametro è TRUE, il pulsante è definito dall'utente. In caso contrario, l'immagine del pulsante viene caricata da una risorsa.

bloccato
[in] Valore booleano che determina se il pulsante può essere personalizzato. Se questo parametro è TRUE, il pulsante non può essere personalizzato. In caso contrario, il pulsante può essere personalizzato.

CMFCToolBarButton::CompareWith

Confronta questa istanza con l'oggetto fornito CMFCToolBarButton .

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Parametri

other
[in] Riferimento all'oggetto da confrontare con questa istanza.

Valore restituito

Diverso da zero se l'oggetto specificato è uguale al valore di questa istanza; in caso contrario, 0.

Osservazioni:

L'implementazione predefinita determina se l'ID comando dell'oggetto specificato è uguale all'ID comando di questa istanza. Eseguire l'override di questo metodo se è necessario eseguire un'elaborazione aggiuntiva per determinare se due CMFCToolBarButton oggetti sono uguali.

CMFCToolBarButton::CopyFrom

Copia le proprietà di un altro pulsante della barra degli strumenti nel pulsante corrente.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parametri

src
[in] Riferimento al pulsante di origine da cui copiare.

Osservazioni:

Chiamare questo metodo per copiare un altro pulsante della barra degli strumenti in questo pulsante della barra degli strumenti.

CMFCToolBarButton::CreateFromOleData

Crea un CMFCToolBarButton oggetto dall'oggetto fornito COleDataObject .

static CMFCToolBarButton* __stdcall CreateFromOleData(COleDataObject* pDataObject);

Parametri

pDataObject
[in] Oggetto dati OLE di origine.

Valore restituito

L'oggetto CMFCToolBarButton creato.

Osservazioni:

Questo metodo viene usato dal framework per eseguire il trasferimento dei dati in vari formati. Ad esempio, il CMFCOutlookBarPane::OnDragOver metodo usa questo metodo per eseguire operazioni di trascinamento della selezione.

CMFCToolBarButton::EnableWindow

Abilita o disabilita l'input da mouse e tastiera.

virtual void EnableWindow(BOOL bEnable = TRUE);

Parametri

bEnable
[in] Impostare questo parametro su TRUE per abilitare l'input o su FALSE per disabilitare l'input.

Osservazioni:

Questo metodo chiama la EnableWindow funzione per abilitare o disabilitare l'input. Per altre informazioni, vedere EnableWindow in Windows SDK.

CMFCToolBarButton::ExportToMenuButton

Copia il testo dal pulsante della barra degli strumenti a un menu.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parametri

menuButton
[in] Riferimento al pulsante del menu di destinazione.

Valore restituito

Questo metodo restituisce TRUE.

Osservazioni:

Il framework chiama questo metodo per copiare il testo da un pulsante della barra degli strumenti a un pulsante di menu. L'implementazione predefinita copia l'etichetta di testo del pulsante. Se l'etichetta di testo è vuota, questo metodo copia il testo della descrizione comando del pulsante.

L'implementazione predefinita di questo metodo restituisce TRUE. Eseguire l'override di questo metodo se si desidera eseguire azioni aggiuntive quando il framework converte un oggetto derivato da CMFCToolbarButton in un pulsante di menu.

CMFCToolBarButton::GetClipboardFormat

Recupera il formato globale degli Appunti per l'applicazione.

static CLIPFORMAT __stdcall GetClipboardFormat();

Valore restituito

Valore CLIPFORMAT globale per l'applicazione.

Osservazioni:

Il framework chiama questo metodo per recuperare il formato degli Appunti per le operazioni di trasferimento dati OLE. Ad esempio, il metodo CMFCToolBarButton::CreateFromOleData usa questo metodo per copiare dati da un oggetto dati OLE di origine.

Questo metodo imposta il valore CLIPFORMAT globale la prima volta che questo metodo viene chiamato. Tutte le chiamate successive a questo metodo restituiscono questo valore.

Per consentire l'esecuzione di operazioni di trascinamento della selezione tra le applicazioni, chiamare il metodo CMFCToolBarButton::SetClipboardFormatName .

Per altre informazioni sugli Appunti in MFC, vedere Appunti.

CMFCToolBarButton::GetHwnd

Recupera l'handle di finestra associato al pulsante della barra degli strumenti.

virtual HWND GetHwnd();

Valore restituito

Handle di finestra associato al pulsante della barra degli strumenti o NULL se il pulsante della barra degli strumenti non dispone di handle di finestra associato.

Osservazioni:

L'implementazione predefinita di questo metodo restituisce NULL. Eseguire l'override di questo metodo per restituire l'handle della finestra del controllo specifico.

CMFCToolBarButton::GetImage

Recupera l'indice dell'immagine del pulsante.

int GetImage() const;

Valore restituito

Indice dell'immagine associata a questo pulsante.

Osservazioni:

Se il pulsante ha un'immagine definita dall'utente, ovvero se bUserButton è true nel costruttore, l'indice restituito specifica un'immagine nella raccolta di immagini definite dall'utente (vedere CMFCToolBar::GetUserImages). In caso contrario, l'indice specifica un'immagine nella raccolta di immagini caricate da un file di risorse (vedere CMFCToolBar::GetImages). Per altre informazioni sui file di risorse, vedere Uso dei file di risorse.

CMFCToolBarButton::GetInvalidateRect

Recupera l'area dell'area client del pulsante che deve essere ridisegnata.

virtual const CRect GetInvalidateRect() const;

Valore restituito

Oggetto CRect che specifica l'area da ridisegnare.

Osservazioni:

L'implementazione predefinita di questo metodo restituisce l'intera area client. Eseguire l'override di questo metodo se si desidera ridisegnare un'area diversa.

CMFCToolBarButton::GetParentWnd

Recupera la finestra padre del pulsante.

CWnd* GetParentWnd() const;

Valore restituito

Finestra padre del pulsante.

CMFCToolBarButton::GetProtectedCommands

Recupera l'elenco di comandi che l'utente non può personalizzare.

static const CList<UINT,UINT>& GetProtectedCommands();

Valore restituito

Elenco di comandi protetti.

Osservazioni:

In modalità di personalizzazione, il framework disabilita i comandi del pulsante della barra degli strumenti protetti. L'utente non può eseguire operazioni di trascinamento della selezione e modifica sui pulsanti della barra degli strumenti disabilitati.

Utilizzare il metodo CMFCToolBarButton::SetProtectedCommands per definire l'elenco di comandi protetti.

CMFCToolBarButton::GetTextSize

Recupera le dimensioni del testo del pulsante.

SIZE GetTextSize() const;

Valore restituito

Oggetto SIZE contenente le dimensioni, in pixel, del testo del pulsante.

CMFCToolBarButton::HasFocus

Determina se il pulsante ha lo stato attivo di input corrente.

virtual BOOL HasFocus() const;

Valore restituito

Diverso da zero se il pulsante ha lo stato attivo per l'input; in caso contrario, 0.

Osservazioni:

L'implementazione predefinita di questo metodo restituisce un valore diverso da zero se il pulsante ha lo stato attivo per l'input o è una finestra figlio o discendente della finestra con lo stato attivo per l'input. È possibile eseguire l'override di questa funzione per personalizzare questo comportamento.

CMFCToolBarButton::HaveHotBorder

Determina se un bordo del pulsante viene visualizzato quando un utente seleziona il pulsante.

virtual BOOL HaveHotBorder() const;

Valore restituito

Questo metodo restituisce TRUE.

Osservazioni:

Il framework chiama questo metodo per determinare se il pulsante della barra degli strumenti deve visualizzare il bordo quando un utente lo seleziona.

L'implementazione predefinita restituisce TRUE. È possibile eseguire l'override di questo metodo per personalizzare questo comportamento.

CMFCToolBarButton::IsDrawImage

Determina se un'immagine viene visualizzata sul pulsante.

BOOL IsDrawImage() const;

Valore restituito

Diverso da zero se sul pulsante viene visualizzata un'immagine; in caso contrario, 0.

Osservazioni:

Questo metodo restituisce FALSE se il pulsante della barra degli strumenti non ha un'immagine associata ( CMFCToolBarButton::GetImage restituisce -1) o se CMFCToolBarButton::m_bImage è impostato su FALSE.

CMFCToolBarButton::IsDrawText

Determina se sul pulsante viene visualizzata un'etichetta di testo.

BOOL IsDrawText() const;

Valore restituito

Diverso da zero se viene visualizzata un'etichetta di testo; in caso contrario, 0.

Osservazioni:

Questo metodo restituisce FALSE se il pulsante della barra degli strumenti non ha un'etichetta di testo associata ( CMFCToolBarButton::m_strText è vuota) o CMFCToolBarButton::m_bText è impostato su FALSE.

CMFCToolBarButton::IsDroppedDown

Determina se il pulsante visualizza un sottomenu.

virtual BOOL IsDroppedDown() const;

Valore restituito

Questo metodo restituisce FALSE.

Osservazioni:

L'implementazione predefinita di questo metodo restituisce FALSE. Eseguire l'override di questo metodo per restituire TRUE se il controllo visualizza un sottomenu.

CMFCToolBarButton::IsEditable

Determina se il pulsante può essere personalizzato.

virtual BOOL IsEditable() const;

Valore restituito

Diverso da zero se un pulsante può essere personalizzato dall'utente; in caso contrario, 0.

Osservazioni:

Il framework chiama questo metodo per determinare se l'utente può personalizzare il pulsante della barra degli strumenti usando operazioni di trascinamento della selezione o modifica.

L'implementazione predefinita restituisce FALSE se l'ID comando del pulsante è un comando standard (è possibile determinarne la chiamata chiamando la IsStandardCommand funzione) o se l'ID comando si trova nell'elenco dei comandi protetti. Per altre informazioni sui comandi protetti, vedere CMFCToolBarButton::GetProtectedCommands e CMFCToolBarButton::SetProtectedCommands.

Eseguire l'override di questo metodo per personalizzarne il comportamento.

CMFCToolBarButton::IsExtraSize

Determina se il pulsante può essere visualizzato con un bordo esteso.

virtual BOOL IsExtraSize() const;

Valore restituito

Diverso da zero se il pulsante della barra degli strumenti può essere visualizzato con un bordo esteso; in caso contrario, 0.

Osservazioni:

Diverse interfacce usano dimensioni aggiuntive per i bordi dei pulsanti della barra degli strumenti (ad esempio pulsanti arrotondati).

Se l'utente sposta questo pulsante da una barra degli strumenti a un'altra, il framework chiama il metodo CMFCToolBarButton::OnChangeParentWnd . Il metodo CMFCToolBarButton::OnChangeParentWnd imposta il flag di dimensioni aggiuntive su quello della nuova barra degli strumenti padre. Per altre informazioni, vedere CMFCToolBar::IsButtonExtraSizeAvailable.

CMFCToolBarButton::IsFirstInGroup

Determina se il pulsante si trova nella prima posizione nel relativo gruppo di pulsanti.

virtual BOOL IsFirstInGroup() const;

Valore restituito

TRUE se il pulsante è il primo pulsante nel gruppo di pulsanti; in caso contrario FALSE.

Osservazioni:

Questo metodo definisce un gruppo di pulsanti come un set di pulsanti adiacente posizionato sulla stessa riga e delimitato da separatori o dal bordo della barra degli strumenti. Questo metodo restituisce FALSE se il pulsante della barra degli strumenti fa riferimento al pulsante Personalizza . Per altre informazioni sul pulsante Personalizza , vedere CMFCToolBar::GetCustomizeButton.

Chiamare il metodo CMFCToolBarButton::IsLastInGroup per determinare se il pulsante si trova nell'ultima posizione nel relativo gruppo di pulsanti.

CMFCToolBarButton::IsHidden

Determina se il pulsante è nascosto.

BOOL IsHidden() const;

Valore restituito

Diverso da zero se il pulsante è nascosto (invisibile); in caso contrario, 0.

Osservazioni:

Il framework chiama questo metodo quando la barra degli strumenti padre viene estesa per determinare se il pulsante della barra degli strumenti è visibile.

Se si imposta il pulsante per essere invisibile tramite il metodo CMFCToolBarButton::SetVisible , usare CMFCToolBarButton::IsVisible per determinare se il pulsante della barra degli strumenti è visibile.

Per impostazione predefinita, tutti i pulsanti della barra degli strumenti sono visibili. Utilizzare il metodo CMFCToolBarButton::Show per nascondere o visualizzare i pulsanti della barra degli strumenti.

CMFCToolBarButton::IsHorizontal

Determina se il pulsante si trova su una barra degli strumenti orizzontale.

BOOL IsHorizontal() const;

Valore restituito

Diverso da zero se un pulsante della barra degli strumenti si trova su una barra degli strumenti orizzontale; in caso contrario, 0.

Osservazioni:

Il framework chiama questo metodo per determinare il layout dei pulsanti della barra degli strumenti.

Questo metodo restituisce il m_bHorz membro dati. Il valore predefinito del m_bHorz membro dati è TRUE. Viene reimpostato su ogni chiamata al metodo CMFCToolBarButton::OnDraw .

CMFCToolBarButton::IsLastInGroup

Specifica se il pulsante si trova nell'ultima posizione nel relativo gruppo di pulsanti.

virtual BOOL IsLastInGroup() const;

Valore restituito

TRUE se il pulsante è l'ultimo pulsante nel relativo gruppo di pulsanti; in caso contrario FALSE.

Osservazioni:

Questo metodo definisce un gruppo di pulsanti come set adiacente di pulsanti posizionati nella stessa riga e delimitati da separatori o dal bordo della barra degli strumenti Questo metodo restituisce FALSE se il pulsante della barra degli strumenti non dispone di una barra degli strumenti padre o il pulsante della barra degli strumenti fa riferimento al pulsante Personalizza . Per altre informazioni sul pulsante Personalizza , vedere CMFCToolBar::GetCustomizeButton.

Chiamare il metodo CMFCToolBarButton::IsFirstInGroup per determinare se il pulsante si trova nella prima posizione nel relativo gruppo di pulsanti.

CMFCToolBarButton::IsLocked

Determina se il pulsante si trova su una barra degli strumenti bloccata (non personalizzabile).

BOOL IsLocked() const;

Valore restituito

Diverso da zero se il pulsante si trova su una barra degli strumenti bloccata; in caso contrario, 0.

Osservazioni:

Il framework chiama questo metodo per determinare se l'utente può personalizzare il pulsante della barra degli strumenti usando operazioni di trascinamento della selezione o modifica. Impostare l'attributo bloccato sulla barra degli strumenti padre usando il metodo CMFCToolBar::LoadToolBar . Il framework passa il valore di questo attributo al costruttore di ogni pulsante della barra degli strumenti ( CMFCToolbarButton) inserito nella barra degli strumenti padre.

CMFCToolBarButton::IsOwnerOf

Determina se il pulsante è il proprietario dell'handle di finestra specificato.

virtual BOOL IsOwnerOf(HWND hwnd);

Parametri

hwnd
[in] Handle di finestra.

Valore restituito

Diverso da zero se il pulsante è il proprietario dell'handle di finestra fornito; in caso contrario, 0.

Osservazioni:

Questo metodo restituisce un valore diverso da zero se hwnd fa riferimento all'handle di finestra diretta o è un elemento figlio dell'handle di finestra associato al pulsante. Questo metodo restituisce 0 se hwnd è NULL.

CMFCToolBarButton::IsVisible

Determina se il pulsante della barra degli strumenti è visibile.

BOOL IsVisible() const;

Valore restituito

Diverso da zero se il pulsante della barra degli strumenti è visibile; in caso contrario, 0.

Osservazioni:

È possibile visualizzare o nascondere il pulsante della barra degli strumenti usando il metodo CMFCToolBarButton::SetVisible . Chiamare il metodo CPane::AdjustSizeImmediate sulla barra degli strumenti padre dopo aver chiamato CMFCToolBarButton::SetVisible per ricalcolare il layout di una barra degli strumenti padre.

CMFCToolBarButton::IsWindowVisible

Determina se l'handle di finestra sottostante del pulsante è visibile.

virtual BOOL IsWindowVisible();

Valore restituito

Diverso da zero se l'handle di finestra sottostante del pulsante è visibile; in caso contrario, 0.

Osservazioni:

Questo metodo restituisce un valore diverso da zero se l'attributo styles dell'handle di finestra sottostante contiene lo stile WS_VISIBLE. Questo metodo restituisce FALSE se l'handle della finestra sottostante del pulsante è NULL.

CMFCToolBarButton::m_bImage

Specifica se un'immagine viene visualizzata sul pulsante.

BOOL m_bImage;

Osservazioni:

Se questo membro dati è impostato su TRUE, il framework visualizza l'immagine associata al pulsante della barra degli strumenti; in caso contrario, il framework non visualizza l'immagine. Questo membro influisce sul valore restituito del metodo CMFCToolBarButton::m_bImage .

CMFCToolBarButton::m_bText

Specifica se sul pulsante viene visualizzata un'etichetta di testo.

BOOL m_bText;

Osservazioni:

Se questo membro dati è impostato su TRUE, il framework visualizza l'etichetta di testo del pulsante della barra degli strumenti; in caso contrario, il framework non visualizza l'etichetta di testo. Questo membro influisce sul valore restituito del metodo CMFCToolBarButton::m_bText .

CMFCToolBarButton::m_bTextBelow

Specifica se l'etichetta di testo viene visualizzata sotto l'immagine sul pulsante.

BOOL m_bTextBelow;

Osservazioni:

Se questa variabile membro è impostata su TRUE, il framework visualizza il testo del pulsante sotto l'immagine. Il valore predefinito di questo membro è FALSE.

CMFCToolBarButton::m_bUserButton

Specifica se il pulsante ha un'immagine definita dall'utente

BOOL m_bUserButton;

Osservazioni:

Questo membro dati è impostato su TRUE quando al pulsante è associata un'immagine definita dall'utente.

CMFCToolBarButton::m_bWholeText

Specifica se il pulsante visualizza l'etichetta full-text anche se non rientra nel rettangolo di delimitazione.

BOOL m_bWholeText;

Osservazioni:

Se questo membro dati è impostato su TRUE, il framework visualizza l'etichetta full-text ampliando il pulsante. In caso contrario, il framework tronca e aggiunge i puntini di sospensione ( ...) all'etichetta di testo.

CMFCToolBarButton::m_bWrap

Specifica se il pulsante accanto a un separatore verrà inserito nella riga successiva.

BOOL m_bWrap;

Osservazioni:

Il framework imposta questo membro dati su TRUE quando il pulsante della barra degli strumenti non si adatta alla riga corrente o quando si specifica un layout , ad esempio un numero specifico di pulsanti della barra degli strumenti per riga.

Il framework posiziona questo pulsante nella riga successiva se questo membro dati è impostato su TRUE e la barra degli strumenti è ancorata orizzontalmente o mobile.

Il valore predefinito di questo membro dati è FALSE.

CMFCToolBarButton::m_bWrapText

Specifica se le etichette di testo a più righe sono abilitate.

AFX_IMPORT_DATA static BOOL m_bWrapText;

Osservazioni:

Se questa variabile membro statica è TRUE, il framework consente a tutte le barre degli strumenti di visualizzare etichette di testo a più righe sui pulsanti della barra degli strumenti.

Il valore predefinito di questo membro dati è FALSE.

CMFCToolBarButton::m_nID

ID del comando del pulsante.

UINT m_nID;

Osservazioni:

L'ID di comando -1 indica che il pulsante è un separatore. Tutti i separatori di pulsante hanno lo stile TBBS_SEPARATOR. Per altre informazioni sugli stili dei pulsanti, vedere CMFCToolBarButton::m_nStyle .

CMFCToolBarButton::m_nStyle

Stile del pulsante.

UINT m_nStyle;

Osservazioni:

Vedi Stili di controllo della barra degli strumenti per l'elenco degli stili dei pulsanti disponibili.

CMFCToolBarButton::m_strText

Etichetta di testo del pulsante.

CString m_strText;

Osservazioni:

Questo membro dati contiene l'etichetta di testo del pulsante. L'etichetta di testo può essere vuota.

CMFCToolBarButton::NotifyCommand

Specifica se il pulsante elabora il messaggio WM_COMMAND .

virtual BOOL NotifyCommand(int iNotifyCode);

Parametri

iNotifyCode
[in] Messaggio di notifica associato al comando.

Valore restituito

Questo metodo restituisce FALSE.

Osservazioni:

Il framework chiama questo metodo quando sta per inviare un messaggio di WM_COMMAND alla finestra padre.

Per impostazione predefinita, questo metodo restituisce FALSE. Eseguire l'override di questo metodo per restituire TRUE se si desidera elaborare il messaggio di WM_COMMAND o FALSE per indicare che la barra degli strumenti padre deve gestire il messaggio.

CMFCToolBarButton::OnAddToCustomizePage

Chiamato dal framework quando il pulsante viene aggiunto a una finestra di dialogo Personalizza .

virtual void OnAddToCustomizePage();

Osservazioni:

L'implementazione predefinita di questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo se si desidera eseguire un'azione quando il pulsante viene aggiunto a una finestra di dialogo Personalizza .

CMFCToolBarButton::OnBeforeDrag

Specifica se il pulsante può essere trascinato.

virtual BOOL OnBeforeDrag() const;

Valore restituito

TRUE se il pulsante può essere trascinato; in caso contrario FALSE.

Osservazioni:

Il framework chiama questo metodo prima che l'utente inizi a trascinare il pulsante.

L'implementazione predefinita di questo metodo restituisce TRUE. Eseguire l'override di questo metodo per restituire FALSE per disabilitare il trascinamento del pulsante.

CMFCToolBarButton::OnBeforeDrop

Specifica se un utente può rilasciare il pulsante sulla barra degli strumenti di destinazione.

virtual BOOL OnBeforeDrop(CMFCToolBar* pTarget);

Parametri

pTarget
[in] Destinazione dell'operazione di trascinamento della selezione.

Valore restituito

TRUE se il pulsante può essere rilasciato sulla barra degli strumenti di destinazione fornita; in caso contrario FALSE.

Osservazioni:

Il framework chiama questo metodo prima che il pulsante venga rilasciato su una barra degli strumenti.

L'implementazione predefinita di questo metodo restituisce TRUE. Eseguire l'override di questo metodo per restituire FALSE per disabilitare l'operazione di rilascio nella destinazione specificata.

CMFCToolBarButton::OnCalculateSize

Chiamato dal framework per calcolare le dimensioni del pulsante per il contesto di dispositivo e lo stato di ancoraggio specificati.

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parametri

pDC
[in] Contesto del dispositivo che visualizza il pulsante.

sizeDefault
[in] Dimensioni predefinite del pulsante.

bHorz
[in] Stato di ancoraggio della barra degli strumenti padre. Questo parametro è TRUE se la barra degli strumenti è ancorata orizzontalmente o mobile oppure FALSE se la barra degli strumenti è ancorata verticalmente.

Valore restituito

Struttura SIZE che contiene le dimensioni del pulsante, in pixel.

Osservazioni:

Il framework chiama questo metodo per determinare le dimensioni del pulsante della barra degli strumenti per il contesto di dispositivo e lo stato di ancoraggio specificati.

L'implementazione predefinita considera le dimensioni del testo e dell'immagine (se visualizzate), il testo e le posizioni dell'immagine (il testo sottostante o a destra dell'immagine) e lo stato di ancoraggio della barra degli strumenti.

Eseguire l'override di questo metodo se si desidera specificare le dimensioni di un pulsante non standard, ad esempio un pulsante di modifica.

CMFCToolBarButton::OnCancelMode

Chiamato dal framework per gestire il messaggio di WM_CANCELMODE .

virtual void OnCancelMode();

Osservazioni:

L'implementazione predefinita di questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo se si desidera gestire il messaggio di WM_CANCELMODE .

CMFCToolBarButton::OnChangeParentWnd

Chiamato dal framework quando il pulsante viene inserito in una nuova barra degli strumenti.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parametri

pWndParent
[in] Nuova finestra padre.

Osservazioni:

Il pulsante viene inserito in una barra degli strumenti, ad esempio quando l'utente lo trascina da una barra degli strumenti a un'altra barra degli strumenti.

L'implementazione predefinita di questo metodo non esegue alcuna operazione.

CMFCToolBarButton::OnClick

Chiamato dal framework quando l'utente fa clic sul pulsante del mouse.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay=TRUE);

Parametri

pWnd
[in] Finestra padre del pulsante della barra degli strumenti.

bDelay
[in] TRUE se il messaggio deve essere gestito con un ritardo.

Valore restituito

Questo metodo restituisce FALSE.

Osservazioni:

Il framework chiama questo metodo quando l'utente fa clic sul pulsante della barra degli strumenti.

L'implementazione predefinita non esegue alcuna operazione e restituisce FALSE. Eseguire l'override di questo metodo per restituire un valore diverso da zero se il pulsante elabora il messaggio di clic.

CMFCToolBarButton::OnClickUp

Chiamato dal framework quando l'utente rilascia il pulsante del mouse.

virtual BOOL OnClickUp();

Valore restituito

Questo metodo restituisce FALSE.

Osservazioni:

Il framework chiama questo metodo quando l'utente rilascia il pulsante della barra degli strumenti.

CMFCToolBarButton::OnContextHelp

Chiamato dal framework quando la barra degli strumenti padre gestisce un messaggio di WM_HELPHITTEST.

virtual BOOL OnContextHelp(CWnd* pWnd);

Parametri

pWnd
[in] Finestra padre del pulsante della barra degli strumenti.

Valore restituito

Questo metodo restituisce FALSE.

Osservazioni:

L'implementazione predefinita di questo metodo non esegue alcuna operazione e restituisce FALSE. Eseguire l'override di questo metodo per restituire un valore diverso da zero se il pulsante elabora il messaggio della Guida.

Per altre informazioni sul messaggio di WM_HELPHITTEST, vedere TN028: Supporto della Guida sensibile al contesto.

CMFCToolBarButton::OnCtlColor

Chiamato dal framework quando la barra degli strumenti padre gestisce un messaggio di WM_CTLCOLOR.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parametri

pDC
[in] Contesto del dispositivo che visualizza il pulsante.

nCtlColor
[in] Notifica del colore specifica.

Valore restituito

Handle per l'oggetto pennello utilizzato dal framework per disegnare lo sfondo del pulsante.

Osservazioni:

Il framework chiama questo metodo quando la barra degli strumenti padre elabora il messaggio WM_CTLCOLOR per un pulsante della barra degli strumenti che contiene un controllo Windows. Il framework non chiama questo metodo se il pulsante della barra degli strumenti è senza finestra.

Il framework chiama questo metodo quando il framework della barra degli strumenti è in modalità di personalizzazione e il pulsante della barra degli strumenti viene sbloccato. Per altre informazioni sulla modalità di personalizzazione, vedere CMFCToolBar::SetCustomizeMode. Per altre informazioni sui pulsanti della barra degli strumenti di blocco, vedere CMFCToolBarButton::IsLocked.

L'implementazione predefinita non esegue alcuna operazione e restituisce NULL.

CMFCToolBarButton::OnCustomizeMenu

Consente al pulsante di modificare il menu fornito quando l'applicazione visualizza un menu di scelta rapida sulla barra degli strumenti padre.

virtual BOOL OnCustomizeMenu(CMenu* pMenu);

Parametri

pMenu
[in] Menu da personalizzare.

Valore restituito

Questo metodo restituisce FALSE.

Osservazioni:

L'implementazione predefinita non esegue alcuna operazione e restituisce FALSE. Eseguire l'override di questo metodo e restituire un valore diverso da zero se si desidera modificare il contenuto del menu specificato.

CMFCToolBarButton::OnDblClk

Chiamato dal framework quando la barra degli strumenti padre gestisce un messaggio WM_LBUTTONDBLCLK .

virtual void OnDblClk(CWnd* pWnd);

Parametri

pWnd
[in] - Finestra padre del pulsante.

Osservazioni:

Questo metodo viene chiamato dal CMFCToolBar::OnLButtonDblClk metodo quando la barra degli strumenti padre gestisce un messaggio di WM_LBUTTONDBLCLK .

L'implementazione predefinita di questo metodo non esegue alcuna operazione.

CMFCToolBarButton::OnDraw

Chiamato dal framework per disegnare il pulsante usando gli stili e le opzioni specificati.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz=TRUE,
    BOOL bCustomizeMode=FALSE,
    BOOL bHighlight=FALSE,
    BOOL bDrawBorder=TRUE,
    BOOL bGrayDisabledButtons=TRUE);

Parametri

pDC
[in] Contesto del dispositivo che visualizza il pulsante.

rect
[in] Rettangolo di delimitazione del pulsante.

pImages
[in] Raccolta di immagini della barra degli strumenti associate al pulsante.

bHorz
[in] Stato di ancoraggio della barra degli strumenti padre. Questo parametro è TRUE quando il pulsante è ancorato orizzontalmente e FALSE quando il pulsante è ancorato verticalmente.

bCustomizeMode
[in] Specifica se la barra degli strumenti è in modalità di personalizzazione. Questo parametro è TRUE quando la barra degli strumenti è in modalità di personalizzazione e FALSE quando la barra degli strumenti non è in modalità di personalizzazione.

bHighlight
[in] Specifica se il pulsante è evidenziato. Questo parametro è TRUE quando il pulsante è evidenziato e FALSE quando il pulsante non è evidenziato.

bDrawBorder
[in] Specifica se il pulsante deve visualizzare il bordo. Questo parametro è TRUE quando il pulsante deve visualizzare il bordo e FALSE quando il pulsante non deve visualizzare il bordo.

bGrayDisabledButtons
[in] Specifica se oscurare i pulsanti disabilitati o utilizzare la raccolta di immagini disabilitate. Questo parametro è TRUE quando i pulsanti disabilitati devono essere ombreggiati e FALSE quando questo metodo deve usare la raccolta di immagini disabilitate.

Osservazioni:

Eseguire l'override di questo metodo per personalizzare il disegno del pulsante della barra degli strumenti.

CMFCToolBarButton::OnDrawOnCustomizeList

Chiamato dal framework per disegnare il pulsante nel riquadro Comandi della finestra di dialogo Personalizza .

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parametri

pDC
[in] Contesto del dispositivo che visualizza il pulsante.

rect
[in] Rettangolo di delimitazione del pulsante.

bSelected
[in] Specifica se il pulsante è selezionato. Se questo parametro è TRUE, viene selezionato il pulsante . Se questo parametro è FALSE, il pulsante non è selezionato.

Valore restituito

Larghezza, in pixel, del pulsante nel contesto di dispositivo specificato.

Osservazioni:

Questo metodo viene chiamato dalla finestra di dialogo di personalizzazione ( scheda Comandi ) quando il pulsante sta per essere visualizzato nella casella di riepilogo di disegno proprietario.

L'implementazione predefinita di questo metodo visualizza l'immagine e l'etichetta di testo del pulsante, se disponibili. Se l'etichetta di testo del pulsante non è disponibile, il metodo visualizza il testo della descrizione comando.

Eseguire l'override di questo metodo per eseguire il disegno personalizzato.

CMFCToolBarButton::OnGetCustomToolTipText

Chiamato dal framework per recuperare il testo personalizzato della descrizione comando per il pulsante.

virtual BOOL OnGetCustomToolTipText(CString& strToolTip);

Parametri

strToolTip
[out] Oggetto CString che riceve il testo della descrizione comando personalizzato.

Valore restituito

Questo metodo restituisce FALSE.

Osservazioni:

Il framework chiama questo metodo quando visualizza la descrizione comando per il pulsante della barra degli strumenti. Se questo metodo restituisce FALSE, il framework usa una descrizione comando predefinita.

L'implementazione predefinita non esegue alcuna operazione e restituisce FALSE. Eseguire l'override di questo metodo e restituire un valore diverso da zero per fornire testo personalizzato della descrizione comando per il pulsante della barra degli strumenti.

CMFCToolBarButton::OnGlobalFontsChanged

Chiamato dal framework quando il tipo di carattere globale è stato modificato.

virtual void OnGlobalFontsChanged();

Osservazioni:

L'implementazione predefinita di questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo per aggiornare il tipo di carattere utilizzato per visualizzare il testo del pulsante.

CMFCToolBarButton::OnMove

Chiamato dal framework quando la barra degli strumenti padre viene spostata.

virtual void OnMove();

Osservazioni:

L'implementazione predefinita di questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo per riposizionare il pulsante quando viene spostata la barra degli strumenti padre.

CMFCToolBarButton::OnShow

Chiamato dal framework quando il pulsante diventa visibile o invisibile.

virtual void OnShow(BOOL bShow);

Parametri

bShow
[in] Specifica se il pulsante è visibile. Se questo parametro è TRUE, il pulsante è visibile. In caso contrario, il pulsante non è visibile.

Osservazioni:

L'implementazione predefinita di questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo per aggiornare la visibilità del pulsante.

CMFCToolBarButton::OnSize

Chiamato dal framework quando la barra degli strumenti padre modifica le dimensioni o la posizione e questa modifica fa sì che il pulsante modifichi le dimensioni.

virtual void OnSize(int iSize);

Parametri

iSize
[in] Nuova larghezza del pulsante.

Osservazioni:

L'implementazione predefinita di questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo per ridimensionare il pulsante quando cambiano le dimensioni o la posizione della barra degli strumenti padre.

CMFCToolBarButton::OnToolHitTest

Chiamato dal framework quando la barra degli strumenti padre deve determinare se un punto si trova nel rettangolo di delimitazione del pulsante.

virtual BOOL OnToolHitTest(
    const CWnd* pWnd,
    TOOLINFO* pTI);

Parametri

pWnd
[in] Finestra padre del pulsante. Può essere NULL.

Pti
[in] Struttura TOOLINFO che contiene informazioni su uno strumento in un controllo descrizione comando.

Valore restituito

Risultato di OnMenuButtonToolHitTest se il pulsante può recuperare un puntatore alla finestra cornice padre; in caso contrario, FALSE.

Osservazioni:

Questo metodo chiama uno dei metodi seguenti se può convertire la finestra padre in un oggetto frame valido:

CMFCToolBarButton::OnUpdateToolTip

Chiamato dal framework quando la barra degli strumenti padre aggiorna il testo della descrizione comando.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

Parametri

pWndParent
[in] Finestra padre.

iButtonIndex
[in] Indice in base zero del pulsante nell'insieme di pulsanti padre.

wndToolTip
[in] Controllo che visualizza il testo della descrizione comando.

str
[out] Oggetto CString che riceve il testo della descrizione comando aggiornato.

Valore restituito

Questo metodo restituisce FALSE.

Osservazioni:

CMFCToolBarButton::P repareDrag

Chiamato dal framework quando il pulsante sta per eseguire un'operazione di trascinamento della selezione.

virtual BOOL PrepareDrag(COleDataSource& srcItem);

Parametri

srcItem
[in] Oggetto COleDataSource che archivia le informazioni sullo stato relative all'operazione di trascinamento della selezione.

Valore restituito

TRUE se l'operazione ha esito positivo; in caso contrario FALSE.

Osservazioni:

Il framework chiama questo metodo per preparare il pulsante della barra degli strumenti per archiviarne lo stato nell'oggetto fornito COleDataSource . Questo metodo archivia lo stato serializzando se stesso in un file condiviso e quindi passando tale file al metodo COleDataSource::CacheGlobalData . Per altre informazioni sulla serializzazione dei pulsanti della barra degli strumenti, vedere CMFCToolBarButton::Serialize.

Questo metodo non esegue alcuna operazione e restituisce TRUE se il pulsante non può essere archiviato (il metodo CMFCToolBarButton::CanBeStored restituisce FALSE). Restituisce FALSE se si verifica un'eccezione durante la serializzazione di oggetti.

Per altre informazioni sulle operazioni di trascinamento della selezione OLE, vedere Trascinamento e rilascio OLE.

CMFCToolBarButton::Rect

Recupera il rettangolo di delimitazione del pulsante.

const CRect& Rect() const;

Valore restituito

Oggetto CRect contenente il rettangolo di delimitazione di un pulsante.

CMFCToolBarButton::ResetImageToDefault

Imposta sul valore predefinito l'immagine associata al pulsante.

virtual void ResetImageToDefault();

Osservazioni:

Questo metodo recupera l'immagine predefinita dalla barra degli strumenti padre usando il metodo CMFCToolBar::GetDefaultImage . Se il pulsante non ha un'immagine predefinita associata, questo metodo imposta l'etichetta di testo del pulsante in base alla risorsa stringa usando il metodo CStringT::LoadString . Per altre informazioni sulle risorse stringa, vedere Uso dei file di risorse.

Questo metodo non esegue alcuna operazione se il pulsante ha un'immagine definita dall'utente.

CMFCToolBarButton::SaveBarState

Salva lo stato del pulsante della barra degli strumenti.

virtual void SaveBarState();

Osservazioni:

Il framework chiama questo metodo quando crea un CMFCToolBarButton oggetto come risultato di un'operazione di trascinamento della selezione.

L'implementazione predefinita di questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo per salvare lo stato del pulsante della barra degli strumenti in un'origine dati esterna.

CMFCToolBarButton::Serialize

Legge questo oggetto da un archivio o lo scrive in un archivio.

virtual void Serialize(CArchive& ar);

Parametri

Ar
[in] Oggetto CArchive da cui o da serializzare.

Osservazioni:

Questo metodo supporta processi di trasferimento dei dati, ad esempio appunti o operazioni di trascinamento della selezione. Legge o scrive le proprietà del pulsante, ad esempio l'ID, l'etichetta di testo e l'ID immagine da o all'oggetto specificato CArchive .

Per esempi di serializzazione, vedere Serializzazione: Serializzazione di un oggetto.

CMFCToolBarButton::SetACCData

Popola l'oggetto fornito CAccessibilityData con i dati di accessibilità dal pulsante della barra degli strumenti.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parametri

pParent
[in] Finestra padre del pulsante della barra degli strumenti.

data
[in] Oggetto CAccessibilityData popolato con i dati di accessibilità del pulsante della barra degli strumenti.

Valore restituito

Questo metodo restituisce TRUE.

Osservazioni:

Eseguire l'override di questo metodo per restituire FALSE se il pulsante della barra degli strumenti non fornisce dati di accessibilità.

CMFCToolBarButton::SetClipboardFormatName

Rinomina il formato globale degli Appunti.

static void __stdcall SetClipboardFormatName(LPCTSTR lpszName);

Parametri

lpszName
[in] Nuovo nome del formato globale degli Appunti. Non può essere NULL.

Osservazioni:

Questo metodo consente di eseguire operazioni di trascinamento della selezione tra più applicazioni. Ogni applicazione deve specificare lo stesso nome di formato degli Appunti.

È necessario chiamare questo metodo prima che il framework chiami CMFCToolBarButton::GetClipboardFormat.

CMFCToolBarButton::SetImage

Imposta l'indice dell'immagine del pulsante.

virtual void SetImage(int iImage);

Parametri

iImage
[in] Indice dell'immagine nell'insieme di immagini della barra degli strumenti.

Osservazioni:

Se il pulsante della barra degli strumenti è un separatore, iImage fa riferimento alla nuova larghezza del pulsante separatore.

Se iImage è minore di zero, questo metodo disabilita il disegno dell'immagine e abilita il disegno dell'etichetta di testo del pulsante.

CMFCToolBarButton::SetProtectedCommands

Imposta l'elenco dei comandi che l'utente non può personalizzare.

static void SetProtectedCommands(const CList<UINT,UINT>& lstCmds);

Parametri

lstCmds
[in] Elenco di comandi protetti.

Osservazioni:

Utilizzare il metodo CMFCToolBarButton::GetProtectedCommands per recuperare l'elenco di comandi protetti.

CMFCToolBarButton::SetRadio

Chiamato dal framework quando un pulsante cambia lo stato selezionato.

virtual void SetRadio();

Osservazioni:

L'implementazione predefinita di questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo per eseguire un'azione personalizzata quando il pulsante modifica lo stato selezionato.

CMFCToolBarButton::SetRect

Imposta il rettangolo di delimitazione del pulsante.

void SetRect(const CRect rect);

Parametri

rect
[in] Nuovo rettangolo di delimitazione del pulsante.

Osservazioni:

Questo metodo chiama il metodo CMFCToolBarButton::OnMove dopo aver impostato il nuovo rettangolo di delimitazione.

CMFCToolBarButton::SetStyle

Imposta lo stile del pulsante.

virtual void SetStyle(UINT nStyle);

Parametri

nStyle
[in] Nuovo stile del pulsante.

Osservazioni:

L'implementazione predefinita imposta il membro dati CMFCToolBarButton::m_nStyle su nStyle. Eseguire l'override di questo metodo se si desidera eseguire un'elaborazione aggiuntiva per gestire la modifica nello stile. Per un elenco di flag di stile validi, vedere ToolBar Control Styles .See ToolBar Control Styles for a list of valid style flags.

CMFCToolBarButton::SetVisible

Specifica se il pulsante è visibile.

void SetVisible(BOOL bShow=TRUE);

Parametri

bShow
[in] Valore booleano che specifica se visualizzare o nascondere il pulsante. Se questo parametro è TRUE, viene visualizzato il pulsante. Se il parametro è FALSE, il pulsante è nascosto.

Osservazioni:

Usare questa funzione per nascondere o visualizzare un particolare pulsante della barra degli strumenti. Chiamare il metodo CPane::AdjustSizeImmediate dopo aver chiamato questo metodo.

CMFCToolBarButton::Show

Mostra o nasconde il pulsante.

void Show(BOOL bShow);

Parametri

bShow
[in] Valore booleano che specifica se visualizzare o nascondere il pulsante. Se questo parametro è TRUE, viene visualizzato il pulsante. Se il parametro è FALSE, il pulsante è nascosto.

Osservazioni:

Il framework chiama questo metodo per aggiornare la visibilità dei pulsanti della barra degli strumenti quando viene ridimensionata la barra degli strumenti padre. Il framework chiama questo metodo con bShow impostato su FALSE quando il pulsante non rientra più nei limiti della barra degli strumenti. Il framework chiama questo metodo con bShow impostato su TRUE quando dopo il ridimensionamento del pulsante rientra nei limiti della barra degli strumenti.

Usare il metodo CMFCToolBarButton::SetVisible per impostare la visibilità generale del pulsante.

Questo metodo chiama il metodo CMFCToolBarButton::OnShow dopo aver aggiornato lo stato di visibilità del pulsante.

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCToolBar
Classe CMFCToolBarImages

Condividi tramite

Classe CMFCToolBarButton

Sintassi

Membri

Costruttori pubblici

Metodi pubblici

Membri dei dati

Osservazioni:

Esempio

Gerarchia di ereditarietà

Requisiti

CMFCToolBarButton::CanBeDropped

Parametri

Valore restituito

Osservazioni:

CMFCToolBarButton::CanBeStored

Valore restituito

Osservazioni:

CMFCToolBarButton::CanBeStretched

Valore restituito

Osservazioni:

CMFCToolBarButton::CMFCToolBarButton

Parametri

CMFCToolBarButton::CompareWith

Parametri

Valore restituito

Osservazioni:

CMFCToolBarButton::CopyFrom

Parametri

Osservazioni:

CMFCToolBarButton::CreateFromOleData

Parametri

Valore restituito

Osservazioni:

CMFCToolBarButton::EnableWindow

Parametri

Osservazioni:

CMFCToolBarButton::ExportToMenuButton

Parametri

Valore restituito

Osservazioni:

CMFCToolBarButton::GetClipboardFormat

Valore restituito

Osservazioni:

CMFCToolBarButton::GetHwnd

Valore restituito

Osservazioni:

CMFCToolBarButton::GetImage

Valore restituito

Osservazioni:

CMFCToolBarButton::GetInvalidateRect

Valore restituito

Osservazioni:

CMFCToolBarButton::GetParentWnd

Valore restituito

CMFCToolBarButton::GetProtectedCommands

Valore restituito

Osservazioni:

CMFCToolBarButton::GetTextSize

Valore restituito

CMFCToolBarButton::HasFocus

Valore restituito

Osservazioni:

CMFCToolBarButton::HaveHotBorder

Valore restituito

Osservazioni:

CMFCToolBarButton::IsDrawImage

Valore restituito

Osservazioni:

CMFCToolBarButton::IsDrawText

Valore restituito

Osservazioni:

CMFCToolBarButton::IsDroppedDown

Valore restituito

Osservazioni:

CMFCToolBarButton::IsEditable

Valore restituito

Osservazioni:

CMFCToolBarButton::IsExtraSize

Valore restituito