Classe CMFCToolBarButton
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à
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] Inutilizzati.
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 FAL edizione Standard 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 FAL edizione Standard.
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 FAL edizione Standard. 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 FAL edizione Standard 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 FAL edizione Standard se il pulsante della barra degli strumenti non dispone di un'immagine associata ( CMFCToolBarButton::GetImage restituisce -1) o se CMFCToolBarButton::m_bImage è impostato su FAL edizione Standard.
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 FAL edizione Standard se il pulsante della barra degli strumenti non ha un'etichetta di testo associata ( CMFCToolBarButton::m_strText è vuota) o CMFCToolBarButton::m_bText è impostato su FAL edizione Standard.
CMFCToolBarButton::IsDroppedDown
Determina se il pulsante visualizza un sottomenu.
virtual BOOL IsDroppedDown() const;
Valore restituito
Questo metodo restituisce FAL edizione Standard.
Osservazioni:
L'implementazione predefinita di questo metodo restituisce FAL edizione Standard. 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 FAL edizione Standard 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; altrimenti FAL edizione Standard.
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 FAL edizione Standard 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; altrimenti FAL edizione Standard.
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 FAL edizione Standard 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 FAL edizione Standard 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 è FAL edizione Standard.
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 è FAL edizione Standard.
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 è FAL edizione Standard.
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_edizione Standard PARATOR. 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 FAL edizione Standard.
Osservazioni:
Il framework chiama questo metodo quando sta per inviare un messaggio di WM_COMMAND alla finestra padre.
Per impostazione predefinita, questo metodo restituisce FAL edizione Standard. Eseguire l'override di questo metodo per restituire TRUE se si desidera elaborare il messaggio di WM_COMMAND o FAL edizione Standard 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; altrimenti FAL edizione Standard.
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 FAL edizione Standard 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; altrimenti FAL edizione Standard.
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 FAL edizione Standard per disabilitare l'operazione di rilascio sulla 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 o FAL edizione Standard 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 FAL edizione Standard.
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 FAL edizione Standard. 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 FAL edizione Standard.
Osservazioni:
Il framework chiama questo metodo quando l'utente rilascia il pulsante della barra degli strumenti.
L'implementazione predefinita non esegue alcuna operazione e restituisce FAL edizione Standard. Eseguire l'override di questo metodo per restituire un valore diverso da zero se il pulsante elabora il messaggio di clic.
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 FAL edizione Standard.
Osservazioni:
L'implementazione predefinita di questo metodo non esegue alcuna operazione e restituisce FAL edizione Standard. 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 FAL edizione Standard.
Osservazioni:
L'implementazione predefinita non esegue alcuna operazione e restituisce FAL edizione Standard. 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 FAL edizione Standard 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 FAL edizione Standard 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 FAL edizione Standard 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 FAL edizione Standard 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 FAL edizione Standard 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 è FAL edizione Standard, 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 FAL edizione Standard.
Osservazioni:
Il framework chiama questo metodo quando visualizza la descrizione comando per il pulsante della barra degli strumenti. Se questo metodo restituisce FAL edizione Standard, il framework usa una descrizione comando predefinita.
L'implementazione predefinita non esegue alcuna operazione e restituisce FAL edizione Standard. 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, FAL edizione Standard.
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 FAL edizione Standard.
Osservazioni:
L'implementazione predefinita di questo metodo non esegue alcuna operazione e restituisce FAL edizione Standard. Eseguire l'override di questo metodo per restituire un valore diverso da zero se si specifica una stringa di testo della descrizione comando.
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; altrimenti FAL edizione Standard.
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 FAL edizione Standard). Restituisce FAL edizione Standard se si verifica un'eccezione durante la serializzazione degli 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 FAL edizione Standard 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:
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::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 è FAL edizione Standard, 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 è FAL edizione Standard, 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 FAL edizione Standard 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
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per