Classe CMFCRibbonBaseElement

Articolo
08/04/2024

La CMFCRibbonBaseElement classe è la classe base per tutti gli elementi che è possibile aggiungere a una barra multifunzione. Esempi di elementi della barra multifunzione sono i pulsanti della barra multifunzione, le caselle di controllo della barra multifunzione e le caselle combinate della barra multifunzione.

Sintassi

class CMFCRibbonBaseElement : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
`CMFCRibbonBaseElement`	Costruisce un oggetto `CMFCRibbonBaseElement`.

Metodi pubblici

Nome	Descrizione
CMFCRibbonBaseElement::AddToKeyList	Aggiunge un suggerimento chiave per l'elemento della barra multifunzione a una matrice di suggerimenti per i tasti di scelta rapida.
CMFCRibbonBaseElement::AddToListBox	Aggiunge un elemento della barra multifunzione alla casella di riepilogo dei comandi della barra multifunzione specificata.
CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar	Indica se l'elemento della barra multifunzione può essere aggiunto alla barra degli strumenti di accesso rapido.
CMFCRibbonBaseElement::CanBeCompacted	Indica se le dimensioni dell'elemento della barra multifunzione possono essere compattate.
CMFCRibbonBaseElement::CanBeStretched	Indica se l'altezza dell'elemento della barra multifunzione può aumentare verticalmente fino all'altezza di una riga della barra multifunzione.
CMFCRibbonBaseElement::CanBeStretchedHorizontally	Indica se la larghezza dell'elemento della barra multifunzione può cambiare.
CMFCRibbonBaseElement::CleanUpSizes	Pulisce le impostazioni della dimensione per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::ClosePopupMenu	Chiude il menu popup per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::CopyFrom	Copia lo stato dell'oggetto specificato `CMFCRibbonBaseElement` nell'oggetto corrente.
CMFCRibbonBaseElement::D estroyCtrl	Elimina definitivamente l'elemento della barra multifunzione.
CMFCRibbonBaseElement::D rawImage	Disegna l'immagine per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::Find	Restituisce il puntatore specificato all'elemento della barra multifunzione se punta all'oggetto corrente.
CMFCRibbonBaseElement::FindByData	Recupera un puntatore all'elemento della barra multifunzione se contiene i dati specificati.
CMFCRibbonBaseElement::FindByID	Recupera un puntatore all'elemento della barra multifunzione se tale elemento è identificato dall'ID comando specificato.
CMFCRibbonBaseElement::FindByOriginal	Recupera un puntatore all'elemento della barra multifunzione se l'elemento della barra multifunzione originale corrisponde all'elemento della barra multifunzione specificato.
CMFCRibbonBaseElement::GetCompactSize	Restituisce la dimensione compatta dell'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetData	Recupera i dati definiti dall'utente associati all'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetDescription	Restituisce la descrizione dell'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetDroppedDown	Recupera un puntatore all'elemento della barra multifunzione se il relativo menu a comparsa viene eliminato.
CMFCRibbonBaseElement::GetElements	Aggiunge l'elemento della barra multifunzione corrente alla matrice specificata.
CMFCRibbonBaseElement::GetElementsByID	Aggiunge l'elemento della barra multifunzione corrente alla matrice specificata se l'elemento della barra multifunzione corrente contiene l'ID comando specificato.
CMFCRibbonBaseElement::GetHighlighted	Recupera un puntatore all'elemento della barra multifunzione, se evidenziato.
CMFCRibbonBaseElement::GetID	Restituisce l'ID comando dell'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetImageSize	Restituisce la dimensione dell'immagine dell'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetIntermediateSize	Restituisce la dimensione dell'elemento della barra multifunzione nello stato intermedio.
CMFCRibbonBaseElement::GetKeys	Restituisce il suggerimento chiave associato all'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetKeyTipRect	Recupera il rettangolo limite del suggerimento tasto per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetKeyTipSize	Recupera le dimensioni del testo della descrizione tasto.
CMFCRibbonBaseElement::GetLocationInGroup	Indica la posizione di visualizzazione dell'elemento della barra multifunzione in un gruppo della barra multifunzione.
CMFCRibbonBaseElement::GetMenuKeys	Restituisce i suggerimenti per i tasti associati a un pulsante.
CMFCRibbonBaseElement::GetNotifyID	Recupera l'ID del comando di notifica per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetOriginal	Recupera l'elemento della barra multifunzione originale.
CMFCRibbonBaseElement::GetParentCategory	Recupera la categoria della barra multifunzione per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetParentPanel	Recupera il pannello della barra multifunzione che contiene l'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetParentRibbonBar	Recupera la barra multifunzione padre per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetParentWnd	Recupera la finestra padre per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetPressed	Recupera un puntatore all'elemento della barra multifunzione se l'utente lo preme attualmente.
CMFCRibbonBaseElement::GetQuickAccessToolBarID	Recupera l'ID comando dell'elemento della barra multifunzione quando si trova nella barra degli strumenti di accesso rapido.
CMFCRibbonBaseElement::GetRect	Restituisce il rettangolo di delimitazione dell'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetRegularSize	Restituisce la dimensione regolare dell'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetSize	Restituisce le dimensioni correnti dell'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetText	Restituisce il testo associato all'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetToolTipText	Restituisce il testo della descrizione comando dell'elemento della barra multifunzione.
CMFCRibbonBaseElement::GetTopLevelRibbonBar	Recupera la barra multifunzione di primo livello per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::HasCompactMode	Specifica se l'elemento della barra multifunzione dispone di una modalità compatta.
CMFCRibbonBaseElement::HasFocus	Indica se l'elemento padre ha lo stato attivo della tastiera.
CMFCRibbonBaseElement::HasIntermediateMode	Specifica se l'elemento della barra multifunzione dispone di una modalità intermedia.
CMFCRibbonBaseElement::HasLargeMode	Specifica se l'elemento della barra multifunzione ha una modalità grande.
CMFCRibbonBaseElement::HasMenu	Indica se l'elemento della barra multifunzione dispone di un menu.
CMFCRibbonBaseElement::HitTest	Recupera un puntatore all'elemento della barra multifunzione se il punto specificato si trova in esso.
CMFCRibbonBaseElement::IsAlignByColumn	Indica se l'elemento della barra multifunzione è allineato verticalmente con altri elementi della barra multifunzione.
CMFCRibbonBaseElement::IsAlwaysLargeImage	Indica se le dimensioni dell'immagine dell'elemento della barra multifunzione sono sempre grandi.
CMFCRibbonBaseElement::IsAutoRepeatMode	Indica se l'elemento della barra multifunzione è in modalità di ripetizione automatica.
CMFCRibbonBaseElement::IsChecked	Specifica se l'elemento della barra multifunzione è selezionato.
CMFCRibbonBaseElement::IsCompactMode	Specifica se l'elemento della barra multifunzione è in modalità compatta.
CMFCRibbonBaseElement::IsDefaultMenuLook
CMFCRibbonBaseElement::IsDisabled	Specifica se l'elemento della barra multifunzione è disabilitato.
CMFCRibbonBaseElement::IsDroppedDown	Determina se l'elemento della barra multifunzione visualizza un menu popup e viene eliminato.
CMFCRibbonBaseElement::IsFocused	Specifica se l'elemento della barra multifunzione ha lo stato attivo.
CMFCRibbonBaseElement::IsGalleryIcon	Indica se l'elemento della barra multifunzione è contenuto in una raccolta della barra multifunzione.
CMFCRibbonBaseElement::IsHighlighted	Specifica se l'elemento della barra multifunzione è evidenziato.
CMFCRibbonBaseElement::IsIntermediateMode	Indica se l'immagine corrente per l'elemento della barra multifunzione è di dimensioni intermedie.
CMFCRibbonBaseElement::IsLargeMode	Indica se l'immagine corrente per l'elemento della barra multifunzione è di grandi dimensioni.
CMFCRibbonBaseElement::IsMenuMode	Indica se l'elemento della barra multifunzione è contenuto in un menu.
CMFCRibbonBaseElement::IsPressed	Indica se l'utente ha fatto clic sull'elemento della barra multifunzione.
CMFCRibbonBaseElement::IsQATMode	Indica se l'elemento della barra multifunzione è contenuto nella barra degli strumenti di accesso rapido.
CMFCRibbonBaseElement::IsSeparator	Indica se l'elemento della barra multifunzione è un separatore di visualizzazione.
CMFCRibbonBaseElement::IsShowGroupBorder	Indica se l'elemento della barra multifunzione è contenuto in un gruppo che visualizza un bordo comune.
CMFCRibbonBaseElement::IsShowTooltipOnBottom	Indica se la descrizione comando viene visualizzata sotto l'elemento della barra multifunzione.
CMFCRibbonBaseElement::IsTabStop	Indica se l'elemento della barra multifunzione può essere selezionato con la tastiera.
CMFCRibbonBaseElement::IsTextAlwaysOnRight	Indica se il testo per l'elemento della barra multifunzione viene visualizzato a destra.
CMFCRibbonBaseElement::IsVisible	Indica se l'elemento della barra multifunzione è attualmente visualizzato.
CMFCRibbonBaseElement::IsWholeRowHeight	Indica se l'heigth visualizzato dell'elemento della barra multifunzione corrisponde all'altezza di visualizzazione del pannello della barra multifunzione che lo contiene.
CMFCRibbonBaseElement::NotifyCommand	Invia una notifica di comando alla finestra padre dell'elemento della barra multifunzione.
CMFCRibbonBaseElement::NotifyHighlightListItem	Notifica alla finestra padre della barra multifunzione quando un utente evidenzia un elemento della barra multifunzione che si trova in un elenco.
CMFCRibbonBaseElement::OnAddToQAToolbar	Aggiunge l'elemento della barra multifunzione alla barra degli strumenti di accesso rapido specificata.
CMFCRibbonBaseElement::OnAfterChangeRect	Aggiorna la descrizione comando per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::OnAutoRepeat	Aggiorna l'elemento della barra multifunzione in risposta all'input utente sostenuto.
CMFCRibbonBaseElement::OnCalcTextSize	Calcola le dimensioni del testo per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::OnChangeMenuHighlight	Chiamato dal framework quando l'evidenziazione cambia per un elemento della barra multifunzione che si trova in un menu.
CMFCRibbonBaseElement::OnDraw	Chiamato dal framework per disegnare l'elemento della barra multifunzione.
CMFCRibbonBaseElement::OnDrawKeyTip	Chiamato dal framework per disegnare il suggerimento per il tasto per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::OnDrawMenuImage	Chiamato dal framework quando viene disegnata l'immagine di menu per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::OnDrawOnList	Chiamato dal framework per disegnare l'elemento della barra multifunzione in una casella di riepilogo comandi.
CMFCRibbonBaseElement::OnKey	Chiamato dal framework quando l'utente preme un suggerimento per il tasto e l'elemento della barra multifunzione ha lo stato attivo.
CMFCRibbonBaseElement::OnMenuKey
CMFCRibbonBaseElement::OnRTLChanged	Chiamato dal framework quando il layout cambia direzione.
CMFCRibbonBaseElement::OnShow	Chiamato dal framework per visualizzare o nascondere l'elemento della barra multifunzione.
CMFCRibbonBaseElement::OnShowPopupMenu	Chiamato dal framework quando l'elemento della barra multifunzione visualizza un menu popup.
CMFCRibbonBaseElement::P ostMenuCommand
CMFCRibbonBaseElement::Redraw	Aggiorna la visualizzazione per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::SetACCData	Imposta i dati di accessibilità per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::SetCompactMode	Imposta le dimensioni di visualizzazione per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::SetData	Associa un elemento di dati all'elemento della barra multifunzione.
CMFCRibbonBaseElement::SetDefaultMenuLook
CMFCRibbonBaseElement::SetDescription	Imposta la descrizione dell'elemento della barra multifunzione.
CMFCRibbonBaseElement::SetID	Imposta l'ID comando dell'elemento della barra multifunzione.
CMFCRibbonBaseElement::SetInitialMode	Imposta le dimensioni di visualizzazione iniziali per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::SetKeys	Imposta un suggerimento per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::SetOriginal	Imposta l'elemento della barra multifunzione originale per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::SetParentCategory	Imposta la categoria padre per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::SetParentMenu	Imposta il contenitore di menu padre per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::SetParentRibbonBar	Imposta la barra multifunzione padre per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::SetRect	Imposta le dimensioni del rettangolo visualizzato per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::SetText	Imposta il testo per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::SetTextAlwaysOnRight	Imposta il testo per l'elemento della barra multifunzione da visualizzare a destra.
CMFCRibbonBaseElement::SetToolTipText	Imposta il testo della descrizione comando per l'elemento della barra multifunzione.
CMFCRibbonBaseElement::SetVisible	Imposta lo stato di visibilità dell'elemento della barra multifunzione.
CMFCRibbonBaseElement::StretchHorizontally	Estende la larghezza dell'elemento della barra multifunzione.
CMFCRibbonBaseElement::StretchToWholeRow	Modifica l'altezza di visualizzazione dell'elemento della barra multifunzione impostando l'altezza della riga specificata.
CMFCRibbonBaseElement::UpdateTooltipInfo	Aggiorna il testo della descrizione comando usando la risorsa di comando per l'elemento della barra multifunzione.

Metodi protetti

Nome	Descrizione
CMFCRibbonBaseElement::OnProcessKey	Chiamato dal framework quando l'utente preme un tasto di scelta rapida.
CMFCRibbonBaseElement::OnSetFocus	Chiamato dal framework quando un elemento della barra multifunzione riceve o perde lo stato attivo dell'input.

Osservazioni:

La CMFCRibbonBaseElement classe definisce le proprietà comuni a tutti gli elementi della barra multifunzione che includono l'ID comando, l'etichetta di testo, il testo della descrizione comando, la descrizione dell'elemento e lo stato ,che possono essere evidenziati, evidenziati, premuti, disabilitati, selezionati o eliminati.

Le dimensioni dell'immagine di un elemento della barra multifunzione sono definite dal RibbonImageType membro, che può essere uno dei valori seguenti:

RibbonImageLarge
RibbonImageSmall

A seconda delle dimensioni, un elemento della barra multifunzione visualizza un'immagine piccola o grande.

Esempio

L'esempio seguente illustra come usare i vari metodi nella classe CMFCRibbonBaseElement . Nell'esempio viene illustrato come ottenere un CMFCRibbonBaseElement oggetto da una CMFCRibbonStatusBar classe, impostare la descrizione per l'elemento della barra multifunzione, impostare il testo, impostare una descrizione comando e impostare il testo della descrizione comando per l'elemento della barra multifunzione. Questo frammento di codice fa parte dell' esempio Draw Client.

// CMFCRibbonStatusBar m_wndStatusBar
CMFCRibbonBaseElement *pPane = m_wndStatusBar.FindByID(nID);

pPane->SetDescription(_T("a pane"));
// CString strText
pPane->SetText(strText);
pPane->SetKeys(_T("p"));
pPane->SetToolTipText(_T("this is a pane"));

Gerarchia di ereditarietà

CObject

CMFCRibbonBaseElement

Requisiti

Intestazione: afxbaseribbonelement.h

CMFCRibbonBaseElement::AddToKeyList

Aggiunge un suggerimento chiave per l'elemento della barra multifunzione a una matrice di suggerimenti per i tasti di scelta rapida.

virtual void AddToKeyList(
    CArray<CMFCRibbonKeyTip*, CMFCRibbonKeyTip*>& arElems);

Parametri

arElems
[in] Riferimento a un oggetto CArray di suggerimenti per i tasti.

Osservazioni:

Quando la funzionalità dei suggerimenti per i tasti della barra multifunzione è abilitata, il framework visualizza i suggerimenti per la barra multifunzione quando l'utente preme IL tasto ALT o F10.

CMFCRibbonBaseElement::AddToListBox

Aggiunge un elemento della barra multifunzione alla casella di riepilogo dei comandi della barra multifunzione specificata.

virtual int AddToListBox(
    CMFCRibbonCommandsListBox* pWndListBox,
    BOOL bDeep);

Parametri

pWndListBox
[in] Puntatore a una casella di riepilogo comandi.

bDeep
[in] Questo parametro non viene usato.

Valore restituito

Indice in base zero dell'elemento della barra multifunzione aggiunto.

Osservazioni:

Il framework aggiunge elementi della barra multifunzione a una casella di riepilogo comandi per consentire all'utente di personalizzare l'interfaccia utente.

CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar

Indica se l'elemento della barra multifunzione può essere aggiunto alla barra degli strumenti di accesso rapido.

virtual BOOL CanBeAddedToQuickAccessToolBar() const;

Valore restituito

TRUE se l'elemento può essere aggiunto; in caso contrario, FALSE.

Osservazioni:

CMFCRibbonBaseElement::CanBeCompacted

Indica se le dimensioni dell'elemento della barra multifunzione possono essere compattate.

virtual BOOL CanBeCompacted() const;

Valore restituito

TRUE se le dimensioni dell'elemento della barra multifunzione possono essere compattate; in caso contrario, FALSE.

Osservazioni:

Le dimensioni di un elemento della barra multifunzione possono essere compattate, intermedie o grandi.

CMFCRibbonBaseElement::CanBeStretched

Indica se l'altezza dell'elemento della barra multifunzione può aumentare verticalmente fino all'altezza di una riga della barra multifunzione.

virtual BOOL CanBeStretched();

Valore restituito

Restituisce sempre TRUE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce sempre TRUE. Eseguire l'override di questo metodo per indicare se l'altezza dell'elemento della barra multifunzione può aumentare verticalmente fino all'altezza di una riga della barra multifunzione.

CMFCRibbonBaseElement::CanBeStretchedHorizontally

Indica se la larghezza dell'elemento della barra multifunzione può cambiare.

virtual BOOL CanBeStretchedHorizontally();

Valore restituito

Restituisce sempre FALSE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce sempre FALSE. Eseguire l'override di questo metodo per indicare se la larghezza dell'elemento della barra multifunzione può cambiare.

CMFCRibbonBaseElement::CleanUpSizes

Pulisce le impostazioni della dimensione per l'elemento della barra multifunzione.

virtual void CleanUpSizes();

Osservazioni:

Per impostazione predefinita, questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo in una classe derivata per reimpostare le impostazioni della dimensione per l'elemento della barra multifunzione.

CMFCRibbonBaseElement::ClosePopupMenu

Chiude il menu a comparsa per l'elemento della barra multifunzione.

virtual void ClosePopupMenu();

Osservazioni:

CMFCRibbonBaseElement::CopyFrom

Copia lo stato dell'oggetto CMFCRibbonBaseElement specificato nell'oggetto corrente.

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Parametri

src
[in] Oggetto CMFCRibbonBaseElement di origine.

Osservazioni:

CMFCRibbonBaseElement::D estroyCtrl

Elimina definitivamente l'elemento della barra multifunzione.

virtual void DestroyCtrl();

Osservazioni:

Per impostazione predefinita, questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo in una classe derivata per eliminare definitivamente l'elemento della barra multifunzione.

CMFCRibbonBaseElement::D rawImage

Disegna l'immagine per l'elemento della barra multifunzione.

virtual void DrawImage(
    CDC* pDC,
    RibbonImageType type,
    CRect rectImage);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

type
[in] Valore enumerato di tipo immagine. Per un elenco dei valori possibili, vedere la sezione Osservazioni.

rectImage
[in] Rettangolo immagine.

Osservazioni:

Per impostazione predefinita, questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo in una classe derivata per disegnare l'immagine per l'elemento della barra multifunzione.

Nella tabella seguente sono elencati i valori possibili per il parametro di tipo :

valore	Descrizione
`RibbonImageLarge`	Grandi dimensioni dell'immagine da 32x32 pixel.
`RibbonImageSmall`	Piccole dimensioni dell'immagine da 16x16 pixel.

CMFCRibbonBaseElement::Find

Restituisce il puntatore specificato se punta all'oggetto corrente.

virtual CMFCRibbonBaseElement* Find(const CMFCRibbonBaseElement* pElement);

Parametri

pElement
[in] Puntatore a un elemento della barra multifunzione.

Valore restituito

Puntatore all'elemento della barra multifunzione se pElement punta all'oggetto corrente; in caso contrario, NULL.

Osservazioni:

CMFCRibbonBaseElement::FindByData

Recupera un puntatore all'elemento della barra multifunzione se contiene i dati specificati.

virtual CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData);

Parametri

dwData
[in] Dati associati a un elemento della barra multifunzione.

Valore restituito

Puntatore all'elemento della barra multifunzione se contiene i dati specificati; in caso contrario NULL.

Osservazioni:

CMFCRibbonBaseElement::FindByID

Recupera un puntatore all'elemento della barra multifunzione se tale elemento è identificato dall'ID comando specificato.

virtual CMFCRibbonBaseElement* FindByID(UINT uiCmdID);

Parametri

uiCmdID
[in] ID comando per un elemento della barra multifunzione.

Valore restituito

Puntatore all'elemento della barra multifunzione se tale elemento è identificato dall'ID comando specificato; in caso contrario NULL.

Osservazioni:

CMFCRibbonBaseElement::FindByOriginal

Recupera un puntatore all'elemento della barra multifunzione corrente se l'elemento della barra multifunzione originale corrisponde all'elemento della barra multifunzione specificato.

virtual CMFCRibbonBaseElement* FindByOriginal(CMFCRibbonBaseElement* pOriginal);

Parametri

pOriginal
[in] Puntatore a un elemento della barra multifunzione.

Valore restituito

Puntatore all'elemento della barra multifunzione se l'elemento della barra multifunzione originale corrisponde all'elemento della barra multifunzione specificato; in caso contrario NULL.

Osservazioni:

Gli elementi della barra multifunzione copiati in un altro contenitore mantengono un puntatore all'elemento della barra multifunzione originale.

CMFCRibbonBaseElement::GetCompactSize

Restituisce la dimensione compatta dell'elemento della barra multifunzione.

virtual CSize GetCompactSize(CDC* pDC);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

Valore restituito

Dimensione compatta di un elemento della barra multifunzione.

Nota

La dimensione compatta indica che l'elemento della barra multifunzione viene troncato (visualizza un'immagine piccola o un'immagine senza testo).

CMFCRibbonBaseElement::GetData

Recupera i dati definiti dall'utente associati all'elemento della barra multifunzione.

DWORD_PTR GetData() const;

Valore restituito

Dati definiti dall'utente associati all'elemento della barra multifunzione.

CMFCRibbonBaseElement::GetDescription

Restituisce la descrizione dell'elemento della barra multifunzione.

virtual CString GetDescription() const;

Valore restituito

Descrizione dell'elemento della barra multifunzione. La descrizione viene visualizzata sulla barra di stato o in una descrizione comando oppure sotto il pulsante del menu se l'elemento della barra multifunzione si trova nella classe CMFCRibbonMainPanel.

CMFCRibbonBaseElement::GetDroppedDown

Recupera un puntatore all'elemento della barra multifunzione se il relativo menu a comparsa viene eliminato.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Valore restituito

Puntatore all'elemento della barra multifunzione se il menu a comparsa viene eliminato; in caso contrario NULL.

Osservazioni:

CMFCRibbonBaseElement::GetElements

Aggiunge l'elemento della barra multifunzione corrente alla matrice specificata.

virtual void GetElements(
    CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parametri

arElements
[in, out] Matrice di elementi della barra multifunzione.

Osservazioni:

CMFCRibbonBaseElement::GetElementsByID

Aggiunge l'elemento della barra multifunzione corrente alla matrice specificata se l'elemento della barra multifunzione corrente contiene l'ID comando specificato.

virtual void GetElementsByID(
    UINT uiCmdID,
    CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parametri

uiCmdID
[in] ID comando di un elemento della barra multifunzione.

arElements
[in] Matrice di elementi della barra multifunzione.

Osservazioni:

CMFCRibbonBaseElement::GetHighlighted

Recupera un puntatore all'elemento della barra multifunzione, se evidenziato.

virtual CMFCRibbonBaseElement* GetHighlighted();

Valore restituito

Puntatore all'elemento della barra multifunzione, se evidenziato; in caso contrario NULL.

Osservazioni:

CMFCRibbonBaseElement::GetID

Restituisce l'ID comando dell'elemento della barra multifunzione.

UINT GetID() const;

Valore restituito

ID comando dell'elemento della barra multifunzione.

CMFCRibbonBaseElement::GetImageSize

Restituisce la dimensione dell'immagine dell'elemento della barra multifunzione.

virtual CSize GetImageSize(RibbonImageType R) const;

Valore restituito

Dimensioni dell'immagine dell'elemento della barra multifunzione.

CMFCRibbonBaseElement::GetIntermediateSize

Restituisce la dimensione dell'elemento della barra multifunzione nello stato intermedio.

virtual CSize GetIntermediateSize(CDC* pDC);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

Valore restituito

Dimensione dell'elemento della barra multifunzione nello stato intermedio.

CMFCRibbonBaseElement::GetKeys

Restituisce il suggerimento chiave associato all'elemento della barra multifunzione.

LPCTSTR GetKeys() const;

Valore restituito

Descrizione comando associata all'elemento della barra multifunzione.

CMFCRibbonBaseElement::GetKeyTipRect

Recupera il rettangolo limite del suggerimento tasto per l'elemento della barra multifunzione.

virtual CRect GetKeyTipRect(
    CDC* pDC,
    BOOL bIsMenu);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

bIsMenu
[in] TRUE se l'elemento della barra multifunzione visualizza un menu a comparsa; in caso contrario FALSE.

Valore restituito

Restituisce sempre un rettangolo con 0 valori.

Osservazioni:

Eseguire l'override di questo metodo in una classe derivata per restituire il rettangolo limite della descrizione chiave.

CMFCRibbonBaseElement::GetKeyTipSize

Recupera le dimensioni del testo della descrizione tasto.

virtual CSize GetKeyTipSize(CDC* pDC);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

Valore restituito

Dimensioni del testo del suggerimento per i tasti.

Osservazioni:

CMFCRibbonBaseElement::GetLocationInGroup

Indica la posizione di visualizzazione dell'elemento della barra multifunzione in un gruppo della barra multifunzione.

RibbonElementLocation GetLocationInGroup() const;

Valore restituito

Valore RibbonElementLocation enumerato. Nella tabella seguente sono elencati i valori possibili.

valore	Descrizione
`RibbonElementNotInGroup`	L'elemento della barra multifunzione non è contenuto in un gruppo della barra multifunzione.
`RibbonElementSingleInGroup`	L'elemento della barra multifunzione viene visualizzato come unico elemento di un gruppo della barra multifunzione.
`RibbonElementFirstInGroup`	L'elemento della barra multifunzione viene visualizzato all'estremità sinistra di un gruppo della barra multifunzione.
`RibbonElementLastInGroup`	L'elemento della barra multifunzione viene visualizzato all'estremità destra di un gruppo della barra multifunzione.
`RibbonElementMiddleInGroup`	L'elemento della barra multifunzione non viene visualizzato in una delle estremità di un gruppo della barra multifunzione.

Osservazioni:

I gruppi di elementi della barra multifunzione sono allineati solo orizzontalmente.

CMFCRibbonBaseElement::GetMenuKeys

Restituisce il suggerimento del menu per l'elemento della barra multifunzione.

LPCTSTR GetMenuKeys() const;

Valore restituito

Suggerimento del menu associato all'elemento della barra multifunzione.

Osservazioni:

Quando viene richiamato, viene visualizzato un menu a comparsa.

CMFCRibbonBaseElement::GetNotifyID

Recupera l'ID del comando di notifica per l'elemento della barra multifunzione.

virtual UINT GetNotifyID();

Valore restituito

ID del comando di notifica.

Osservazioni:

CMFCRibbonBaseElement::GetOriginal

Recupera l'elemento della barra multifunzione originale.

CMFCRibbonBaseElement* GetOriginal() const;

Valore restituito

Puntatore all'elemento della barra multifunzione originale.

Osservazioni:

Gli elementi della barra multifunzione copiati in un altro contenitore mantengono un puntatore all'elemento della barra multifunzione originale.

CMFCRibbonBaseElement::GetParentCategory

Recupera la categoria della barra multifunzione per l'elemento della barra multifunzione.

CMFCRibbonCategory* GetParentCategory() const;

Valore restituito

Puntatore alla categoria della barra multifunzione.

Osservazioni:

CMFCRibbonBaseElement::GetParentPanel

Recupera il pannello della barra multifunzione che contiene l'elemento della barra multifunzione.

virtual CMFCRibbonPanel* GetParentPanel() const;

Valore restituito

Puntatore al pannello della barra multifunzione che contiene l'elemento della barra multifunzione.

Osservazioni:

CMFCRibbonBaseElement::GetParentRibbonBar

Recupera la barra multifunzione padre per l'elemento della barra multifunzione.

CMFCRibbonBar* GetParentRibbonBar() const;

Valore restituito

Puntatore alla barra multifunzione padre per l'elemento della barra multifunzione.

Osservazioni:

CMFCRibbonBaseElement::GetParentWnd

Recupera la finestra padre per l'elemento della barra multifunzione.

virtual CWnd* GetParentWnd() const;

Valore restituito

Puntatore alla finestra padre per l'elemento della barra multifunzione se il metodo ha avuto esito positivo; in caso contrario, NULL.

Osservazioni:

La finestra padre per un elemento della barra multifunzione è una classe CMFCRibbonBar o CMFCRibbonPanelMenuBar .

CMFCRibbonBaseElement::GetPressed

Recupera un puntatore all'elemento della barra multifunzione se l'utente lo preme attualmente.

virtual CMFCRibbonBaseElement* GetPressed();

Valore restituito

Puntatore all'elemento della barra multifunzione se l'utente lo preme attualmente; in caso contrario, NULL.

Osservazioni:

CMFCRibbonBaseElement::GetQuickAccessToolBarID

Recupera l'ID comando dell'elemento della barra multifunzione quando si trova nella barra degli strumenti di accesso rapido.

virtual UINT GetQuickAccessToolBarID() const;

Valore restituito

ID comando dell'elemento della barra multifunzione quando si trova nella barra degli strumenti di accesso rapido.

Osservazioni:

CMFCRibbonBaseElement::GetRect

Restituisce il rettangolo di delimitazione dell'elemento della barra multifunzione.

CRect GetRect() const;

Valore restituito

Rettangolo di delimitazione dell'elemento della barra multifunzione. La posizione del rettangolo si trova nelle coordinate del controllo barra multifunzione padre.

CMFCRibbonBaseElement::GetRegularSize

Restituisce la dimensione regolare dell'elemento della barra multifunzione.

virtual CSize GetRegularSize(CDC* pDC) = 0;

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

Valore restituito

Dimensioni regolari dell'elemento della barra multifunzione.

Osservazioni:

Nota

La dimensione regolare è la dimensione massima possibile dell'elemento della barra multifunzione.

CMFCRibbonBaseElement::GetSize

Restituisce le dimensioni correnti dell'elemento della barra multifunzione.

virtual CSize GetSize(CDC* pDC);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

Valore restituito

Dimensione corrente dell'elemento della barra multifunzione.

CMFCRibbonBaseElement::GetText

Restituisce il testo associato all'elemento della barra multifunzione.

LPCTSTR GetText() const;

Valore restituito

Testo associato all'elemento della barra multifunzione.

CMFCRibbonBaseElement::GetToolTipText

Restituisce il testo della descrizione comando dell'elemento della barra multifunzione.

virtual CString GetToolTipText() const;

Valore restituito

Testo della descrizione comando dell'elemento della barra multifunzione.

CMFCRibbonBaseElement::GetTopLevelRibbonBar

Recupera la barra multifunzione di primo livello per l'elemento della barra multifunzione.

CMFCRibbonBar* GetTopLevelRibbonBar() const;

Valore restituito

Puntatore alla barra multifunzione di primo livello per l'elemento della barra multifunzione se il metodo ha avuto esito positivo; in caso contrario, NULL.

Osservazioni:

CMFCRibbonBaseElement::HasCompactMode

Specifica se l'elemento della barra multifunzione dispone di una modalità compatta.

virtual BOOL HasCompactMode() const;

Valore restituito

TRUE se l'elemento della barra multifunzione ha una modalità compatta. FALSE in caso contrario.

Osservazioni:

Nota

Nella modalità compatta un elemento visualizza solo un'immagine di piccole dimensioni.

CMFCRibbonBaseElement::HasIntermediateMode

Specifica se l'elemento della barra multifunzione dispone di una modalità intermedia.

virtual BOOL HasIntermediateMode() const;

Valore restituito

TRUE se l'elemento della barra multifunzione ha una modalità intermedia, FALSE in caso contrario. Nella modalità intermedia, un elemento visualizza un'immagine e un testo di piccole dimensioni a destra dell'immagine.

Osservazioni:

CMFCRibbonBaseElement::HasLargeMode

Specifica se l'elemento della barra multifunzione dispone di una modalità di dimensioni elevate.

virtual BOOL HasLargeMode() const;

Valore restituito

TRUE se l'elemento della barra multifunzione ha una modalità grande. FALSE in caso contrario.

Osservazioni:

Nella modalità grande, un elemento può accettare l'altezza completa del pannello padre.

CMFCRibbonBaseElement::HasMenu

Indica se l'elemento della barra multifunzione dispone di un menu.

virtual BOOL HasMenu() const;

Valore restituito

Restituisce sempre FALSE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce sempre FALSE. Eseguire l'override di questo metodo in una classe derivata per indicare se l'elemento della barra multifunzione dispone di un menu.

CMFCRibbonBaseElement::HitTest

Recupera un puntatore all'elemento della barra multifunzione se il punto specificato si trova in esso.

virtual CMFCRibbonBaseElement* HitTest(CPoint point);

Parametri

point
[in] Questo parametro non viene usato.

Valore restituito

Puntatore all'elemento della barra multifunzione, se presente; in caso contrario FALSE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce sempre un puntatore valido all'elemento della barra multifunzione quando esiste. Eseguire l'override di questo metodo per indicare se il punto si trova nell'elemento della barra multifunzione.

CMFCRibbonBaseElement::IsAlignByColumn

Indica se l'elemento della barra multifunzione è allineato verticalmente con altri elementi della barra multifunzione.

virtual BOOL IsAlignByColumn() const;

Valore restituito

Restituisce sempre TRUE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce sempre TRUE. Eseguire l'override di questo metodo in una classe derivata per indicare se l'elemento della barra multifunzione derivata è allineato verticalmente con altri elementi della barra multifunzione.

CMFCRibbonBaseElement::IsAlwaysLargeImage

Indica se le dimensioni dell'immagine dell'elemento della barra multifunzione sono sempre grandi.

virtual BOOL IsAlwaysLargeImage() const;

Valore restituito

TRUE se la dimensione dell'immagine dell'elemento della barra multifunzione è sempre grande; in caso contrario FALSE.

Osservazioni:

Le dimensioni dell'immagine di grandi dimensioni sono 32 x 32 pixel.

CMFCRibbonBaseElement::IsAutoRepeatMode

Indica se l'elemento della barra multifunzione è in modalità di ripetizione automatica.

virtual BOOL IsAutoRepeatMode(int& nDelay) const;

Parametri

nDelay
[in] Questo parametro non viene usato.

Valore restituito

Restituisce sempre FALSE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce sempre FALSE. Eseguire l'override di questo metodo per indicare se l'elemento della barra multifunzione è in modalità di ripetizione automatica.

In modalità di ripetizione automatica, l'elemento della barra multifunzione risponde a un intervallo impostato, misurato in millisecondi, per sostenere l'input dell'utente.

CMFCRibbonBaseElement::IsChecked

Specifica se l'elemento della barra multifunzione è selezionato.

virtual BOOL IsChecked() const;

Valore restituito

TRUE se l'elemento della barra multifunzione è selezionato; in caso contrario FALSE.

CMFCRibbonBaseElement::IsCompactMode

Specifica se l'elemento della barra multifunzione è in modalità compatta.

BOOL IsCompactMode() const;

Valore restituito

TRUE se l'elemento della barra multifunzione è in modalità compatta; in caso contrario FALSE.

CMFCRibbonBaseElement::IsDefaultMenuLook

Indica se l'elemento della barra multifunzione è impostato per essere visualizzato come comando popup.

BOOL IsDefaultMenuLook() const;

Valore restituito

TRUE se l'elemento della barra multifunzione è impostato per essere visualizzato come comando popup; in caso contrario FALSE.

Osservazioni:

CMFCRibbonBaseElement::IsDisabled

Specifica se l'elemento della barra multifunzione è disabilitato.

virtual BOOL IsDisabled() const;

Valore restituito

TRUE se l'elemento della barra multifunzione è disabilitato; in caso contrario FALSE.

CMFCRibbonBaseElement::IsDroppedDown

Specifica se l'elemento della barra multifunzione visualizza un menu a comparsa e viene eliminato.

virtual BOOL IsDroppedDown() const;

Valore restituito

TRUE se l'elemento della barra multifunzione viene eliminato e visualizza un menu a comparsa; in caso contrario FALSE.

CMFCRibbonBaseElement::IsFocused

Specifica se l'elemento della barra multifunzione ha lo stato attivo.

virtual BOOL IsFocused() const;

Valore restituito

TRUE se l'elemento della barra multifunzione ha lo stato attivo; in caso contrario FALSE.

CMFCRibbonBaseElement::IsGalleryIcon

Indica se l'elemento della barra multifunzione è contenuto in una raccolta della barra multifunzione.

virtual BOOL IsGalleryIcon() const;

Valore restituito

Restituisce sempre FALSE.

Osservazioni:

CMFCRibbonBaseElement::IsHighlighted

Specifica se l'elemento della barra multifunzione è evidenziato.

virtual BOOL IsHighlighted() const;

Valore restituito

TRUE se l'elemento della barra multifunzione è evidenziato; in caso contrario FALSE.

Osservazioni:

CMFCRibbonBaseElement::IsIntermediateMode

Indica se l'immagine corrente per l'elemento della barra multifunzione è di dimensioni intermedie.

BOOL IsIntermediateMode() const;

Valore restituito

TRUE se l'immagine per l'elemento della barra multifunzione è di dimensioni intermedie; in caso contrario FALSE.

Osservazioni:

Le dimensioni intermedie dell'immagine sono 16 x 16 pixel.

CMFCRibbonBaseElement::IsLargeMode

Indica se l'immagine corrente per l'elemento della barra multifunzione è di grandi dimensioni.

BOOL IsLargeMode() const;

Valore restituito

TRUE se l'immagine per l'elemento della barra multifunzione è grande; in caso contrario FALSE.

Osservazioni:

Le dimensioni dell'immagine di grandi dimensioni sono 32 x 32 pixel.

CMFCRibbonBaseElement::IsMenuMode

Indica se l'elemento della barra multifunzione è contenuto in un menu.

BOOL IsMenuMode() const;

Valore restituito

TRUE se l'elemento della barra multifunzione è contenuto in un menu; in caso contrario, FALSE.

Osservazioni:

CMFCRibbonBaseElement::IsPressed

Indica se l'utente ha fatto clic sull'elemento della barra multifunzione.

virtual BOOL IsPressed() const;

Valore restituito

TRUE se l'utente ha fatto clic sull'elemento della barra multifunzione; in caso contrario FALSE.

CMFCRibbonBaseElement::IsQATMode

Indica se l'elemento della barra multifunzione è contenuto nella barra degli strumenti di accesso rapido.

BOOL IsQATMode() const;

Valore restituito

TRUE se l'elemento della barra multifunzione è contenuto nella barra degli strumenti di accesso rapido; in caso contrario, FALSE.

Osservazioni:

CMFCRibbonBaseElement::IsSeparator

Indica se l'elemento della barra multifunzione è un separatore di visualizzazione.

virtual BOOL IsSeparator() const;

Valore restituito

TRUE se l'elemento della barra multifunzione è un separatore di visualizzazione; in caso contrario FALSE.

Osservazioni:

CMFCRibbonBaseElement::IsShowGroupBorder

Indica se l'elemento della barra multifunzione è contenuto in un gruppo che visualizza un bordo comune.

BOOL IsShowGroupBorder() const;

Valore restituito

TRUE se l'elemento della barra multifunzione è contenuto in un gruppo che visualizza un bordo comune; in caso contrario, FALSE.

Osservazioni:

CMFCRibbonBaseElement::IsShowTooltipOnBottom

Indica se la descrizione comando viene visualizzata sotto l'elemento della barra multifunzione.

virtual BOOL IsShowTooltipOnBottom() const;

Valore restituito

TRUE se la descrizione comando viene visualizzata sotto l'elemento della barra multifunzione; FALSE se la descrizione comando viene visualizzata vicino al puntatore.

Osservazioni:

CMFCRibbonBaseElement::IsTabStop

Indica se l'elemento della barra multifunzione può essere selezionato con la tastiera.

virtual BOOL IsTabStop() const;

Valore restituito

Restituisce sempre TRUE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce sempre TRUE. Eseguire l'override di questo metodo per indicare se l'elemento della barra multifunzione può essere selezionato con la tastiera.

CMFCRibbonBaseElement::IsTextAlwaysOnRight

Indica se il testo per l'elemento della barra multifunzione viene visualizzato a destra.

BOOL IsTextAlwaysOnRight() const;

Valore restituito

TRUE se il testo per l'elemento della barra multifunzione viene visualizzato a destra; in caso contrario, FALSE.

Osservazioni:

CMFCRibbonBaseElement::IsVisible

Indica se l'elemento della barra multifunzione è attualmente visualizzato.

BOOL IsVisible() const;

Valore restituito

TRUE se l'elemento della barra multifunzione è attualmente visualizzato; in caso contrario, FALSE.

Osservazioni:

CMFCRibbonBaseElement::IsWholeRowHeight

Indica se l'altezza di visualizzazione dell'elemento della barra multifunzione corrisponde all'altezza di visualizzazione del pannello della barra multifunzione che lo contiene.

virtual BOOL IsWholeRowHeight() const;

Valore restituito

Restituisce sempre FALSE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce sempre FALSE. Eseguire l'override di questo metodo per indicare se l'altezza di visualizzazione dell'elemento della barra multifunzione corrisponde all'altezza di visualizzazione del pannello della barra multifunzione che lo contiene.

CMFCRibbonBaseElement::NotifyCommand

Invia una notifica di comando alla finestra padre dell'elemento della barra multifunzione.

BOOL NotifyCommand(BOOL bWithDelay = FALSE);

Parametri

bWithDelay
[in] TRUE per aggiungere la notifica del comando alla coda di messaggi della finestra padre; FALSE per inviare il messaggio immediatamente alla finestra padre.

Valore restituito

TRUE se il messaggio è stato inviato; in caso contrario, FALSE.

Osservazioni:

CMFCRibbonBaseElement::NotifyHighlightListItem

Notifica alla finestra padre della barra multifunzione quando un utente evidenzia un elemento della barra multifunzione che si trova in un elenco.

virtual void NotifyHighlightListItem(int nIndex);

Parametri

nIndex
[in] Indice dell'elemento della barra multifunzione nell'elenco.

Osservazioni:

CMFCRibbonBaseElement::OnAddToQAToolbar

Aggiunge l'elemento della barra multifunzione alla barra degli strumenti di accesso rapido specificata.

virtual BOOL OnAddToQAToolbar(CMFCRibbonQuickAccessToolBar& qat);

Parametri

Qat
[in] Barra degli strumenti di accesso rapido.

Valore restituito

Restituisce sempre TRUE che indica che l'elemento della barra multifunzione è stato aggiunto alla barra degli strumenti di accesso rapido.

Osservazioni:

CMFCRibbonBaseElement::OnAfterChangeRect

Aggiorna la descrizione comando per l'elemento della barra multifunzione.

virtual void OnAfterChangeRect(CDC* pDC);

Parametri

pDC
[in] Questo parametro non viene usato.

Osservazioni:

Per impostazione predefinita, questo metodo aggiorna la descrizione comando per l'elemento della barra multifunzione. Eseguire l'override di questo metodo per aggiornare l'elemento della barra multifunzione dopo la modifica del relativo rettangolo di visualizzazione.

CMFCRibbonBaseElement::OnAutoRepeat

Aggiorna l'elemento della barra multifunzione in risposta all'input utente sostenuto.

virtual BOOL OnAutoRepeat();

Valore restituito

Restituisce sempre FALSE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce sempre FALSE. Eseguire l'override di questo metodo per elaborare l'input utente sostenuto.

CMFCRibbonBaseElement::OnCalcTextSize

Calcola le dimensioni del testo per l'elemento della barra multifunzione.

virtual void OnCalcTextSize(CDC* pDC);

Parametri

pDC
[in] Questo parametro non viene usato.

Osservazioni:

Per impostazione predefinita, questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo per calcolare le dimensioni del testo per l'elemento della barra multifunzione.

CMFCRibbonBaseElement::OnChangeMenuHighlight

Chiamato dal framework quando l'evidenziazione cambia per un elemento della barra multifunzione che si trova in un menu.

virtual void OnChangeMenuHighlight(CMFCRibbonPanelMenuBar* pPanelMenuBar
    CMFCRibbonBaseElement* pHot);

Parametri

pPanelMenuBar
[in] Questo parametro non viene usato.

Phot
[in] Questo parametro non viene usato.

Osservazioni:

Per impostazione predefinita, questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo per aggiornare un elemento della barra multifunzione che si trova in un menu quando cambia l'evidenziazione.

CMFCRibbonBaseElement::OnDraw

Chiamato dal framework per disegnare l'elemento della barra multifunzione.

virtual void OnDraw(CDC* pDC) = 0;

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

Osservazioni:

Eseguire l'override di questo metodo in una classe derivata se si desidera personalizzare il disegno di un elemento della barra multifunzione specifico.

CMFCRibbonBaseElement::OnDrawKeyTip

Chiamato dal framework per disegnare il suggerimento per il tasto per l'elemento della barra multifunzione.

virtual void OnDrawKeyTip(
    CDC* pDC,
    const CRect& rect,
    BOOL bIsMenu);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

rect
[in] Rettangolo limite per il suggerimento tasto.

bIsMenu
[in] TRUE se il suggerimento per il tasto di scelta rapida è relativo a un pulsante di menu a comparsa; in caso contrario, FALSE.

Osservazioni:

CMFCRibbonBaseElement::OnDrawMenuImage

Chiamato dal framework quando viene disegnata l'immagine di menu per l'elemento della barra multifunzione.

virtual BOOL OnDrawMenuImage(
    CDC* pDC,
    CRect rect);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

rect
[in] Rettangolo immagine menu.

Valore restituito

Restituisce sempre TRUE per indicare che l'immagine è stata disegnata.

Osservazioni:

CMFCRibbonBaseElement::OnDrawOnList

Chiamato dal framework per disegnare l'elemento della barra multifunzione in una casella di riepilogo comandi.

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo per l'elemento della barra multifunzione.

strText
[in] Testo visualizzato.

nTextOffset
[in] Distanza, in pixel, dal lato sinistro della casella di riepilogo al testo visualizzato.

rect
[in] Rettangolo di visualizzazione per l'elemento della barra multifunzione.

bIsSelected
[in] Questo parametro non viene usato.

bHighlighted
[in] Questo parametro non viene usato.

Osservazioni:

La casella di riepilogo comandi visualizza gli elementi della barra multifunzione per consentire agli utenti di personalizzare la barra degli strumenti di accesso rapido.

CMFCRibbonBaseElement::OnKey

Chiamato dal framework quando l'utente preme un suggerimento per il tasto e l'elemento della barra multifunzione ha lo stato attivo.

virtual BOOL OnKey(BOOL bIsMenuKey);

Parametri

bIsMenuKey
[in] TRUE se il suggerimento del tasto viene visualizzato un menu a comparsa; in caso contrario, FALSE.

Valore restituito

TRUE se l'evento è stato gestito; in caso contrario FALSE.

Osservazioni:

CMFCRibbonBaseElement::OnMenuKey

Chiamato dal framework quando l'utente preme una descrizione del menu nel pannello principale.

virtual BOOL OnMenuKey(UINT nUpperChar);

Parametri

nUpperChar
[in] Questo parametro non viene usato.

Valore restituito

Restituisce sempre FALSE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce sempre FALSE. Eseguire l'override di questo metodo per rispondere quando un utente preme una descrizione del menu nel pannello principale.

CMFCRibbonBaseElement::OnProcessKey

Chiamato dal framework quando l'utente preme un tasto di scelta rapida.

virtual BOOL OnProcessKey(UINT nChar);

Parametri

nChar
[in] Questo parametro non viene usato.

Valore restituito

Restituisce sempre FALSE.

Osservazioni:

Eseguire l'override di questo metodo se si desidera che l'elemento della barra multifunzione elabori un tasto di scelta rapida.

CMFCRibbonBaseElement::OnRTLChanged

Chiamato dal framework quando il layout cambia direzione.

virtual void OnRTLChanged(BOOL bIsRTL);

Parametri

bIsRTL
[in] Questo parametro non viene usato.

Osservazioni:

Per impostazione predefinita, questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo per regolare l'elemento della barra multifunzione quando il layout cambia direzione. La direzione predefinita del layout è da sinistra a destra.

CMFCRibbonBaseElement::OnSetFocus

Chiamato dal framework quando un elemento della barra multifunzione riceve o perde lo stato attivo dell'input.

virtual void OnSetFocus(BOOL B);

Osservazioni:

Eseguire l'override di questo metodo in una classe derivata se si vuole che l'applicazione gestisca una modifica nello stato attivo di un elemento della barra multifunzione.

CMFCRibbonBaseElement::OnShow

Chiamato dal framework per visualizzare o nascondere l'elemento della barra multifunzione.

virtual void OnShow(BOOL bShow);

Parametri

bShow
[in] Questo parametro non viene usato.

Osservazioni:

Per impostazione predefinita, questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo per visualizzare o nascondere l'elemento della barra multifunzione.

CMFCRibbonBaseElement::OnShowPopupMenu

Chiamato dal framework prima che l'elemento della barra multifunzione mostri un menu a comparsa.

virtual void OnShowPopupMenu();

Osservazioni:

Questo metodo notifica alla finestra padre della barra multifunzione che l'elemento della barra multifunzione visualizzerà un menu a comparsa.

CMFCRibbonBaseElement::P ostMenuCommand

Chiude il menu a comparsa per l'elemento della barra multifunzione e invia un messaggio di chiusura al menu padre.

void PostMenuCommand(UINT uiCmdId);

Parametri

uiCmdId
[in] Il parametro non viene utilizzato.

Osservazioni:

Il messaggio di chiusura viene inviato solo se l'elemento della barra multifunzione si trova in un menu a comparsa.

CMFCRibbonBaseElement::Redraw

Aggiorna la visualizzazione per l'elemento della barra multifunzione.

virtual void Redraw();

Osservazioni:

Questo metodo ridisegna il rettangolo di visualizzazione per l'elemento della barra multifunzione chiamando CWnd::RedrawWindow con i flag RDW_INVALIDATE, RDW_ERASE e RDW_UPDATENOW impostati.

CMFCRibbonBaseElement::SetACCData

Imposta i dati di accessibilità per l'elemento della barra multifunzione.

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

Parametri

pParent
Finestra padre per l'elemento della barra multifunzione.

data
Dati di accessibilità per l'elemento della barra multifunzione.

Valore restituito

Restituisce sempre TRUE.

Osservazioni:

Per impostazione predefinita, questo metodo imposta i dati di accessibilità per l'elemento della barra multifunzione e restituisce sempre TRUE. Eseguire l'override di questo metodo per impostare i dati di accessibilità e restituire un valore che indica l'esito positivo o negativo.

CMFCRibbonBaseElement::SetCompactMode

Imposta le dimensioni di visualizzazione per l'elemento della barra multifunzione.

virtual void SetCompactMode(BOOL bCompactMode = TRUE);

Parametri

bCompactMode
[in] TRUE per ridurre le dimensioni di visualizzazione dell'elemento della barra multifunzione; FALSE per aumentare le dimensioni di visualizzazione dell'elemento della barra multifunzione.

Osservazioni:

La tabella seguente riepiloga la logica per questo metodo.

bCompactMode	Dimensioni correnti dell'elemento della barra multifunzione	Nuove dimensioni degli elementi della barra multifunzione
TRUE	Compact	Nessuna modifica.
TRUE	Intermedio	Compatta se possibile.
TRUE	Grande	Intermedio se possibile.
FALSE	Compact	Intermedio se possibile; altrimenti grande.

CMFCRibbonBaseElement::SetData

Associa un elemento di dati all'elemento della barra multifunzione.

void SetData(DWORD_PTR dwData);

Parametri

dwData
[in] Valore dei dati.

CMFCRibbonBaseElement::SetDefaultMenuLook

Imposta l'elemento della barra multifunzione da visualizzare come comando popup.

void SetDefaultMenuLook(BOOL bIsDefaultMenuLook = TRUE);

Parametri

bIsDefaultMenuLook
[in] TRUE per impostare l'elemento della barra multifunzione da visualizzare come comando popup; in caso contrario FALSE.

Osservazioni:

CMFCRibbonBaseElement::SetDescription

Imposta la descrizione dell'elemento della barra multifunzione.

virtual void SetDescription(LPCTSTR lpszText);

Parametri

lpszText
[in] Descrizione dell'elemento della barra multifunzione.

Osservazioni:

Il framework visualizza la nuova descrizione sulla barra di stato o nella descrizione comando o sotto il pulsante di menu.

CMFCRibbonBaseElement::SetID

Imposta l'ID comando dell'elemento della barra multifunzione.

virtual void SetID(UINT nID);

Parametri

nID
[in] ID comando.

CMFCRibbonBaseElement::SetInitialMode

Imposta le dimensioni di visualizzazione iniziali per l'elemento della barra multifunzione.

virtual void SetInitialMode(BOOL bOneRow = FALSE);

Parametri

bOneRow
[in] TRUE per limitare le dimensioni di visualizzazione per l'elemento della barra multifunzione a compattare o intermedio; in caso contrario, FALSE.

Osservazioni:

Le dimensioni di visualizzazione degli elementi della barra multifunzione possono essere compattate, intermedie o grandi.

CMFCRibbonBaseElement::SetKeys

Imposta i suggerimenti per i tasti per l'elemento della barra multifunzione.

virtual void SetKeys(
    LPCTSTR lpszKeys,
    LPCTSTR lpszMenuKeys=NULL);

Parametri

lpszKeys
[in] Descrizione comando per l'elemento della barra multifunzione.

lpszMenuKeys
[in] Suggerimento per il menu a comparsa dell'elemento della barra multifunzione.

CMFCRibbonBaseElement::SetOriginal

Imposta l'elemento della barra multifunzione originale per l'elemento della barra multifunzione.

virtual void SetOriginal(CMFCRibbonBaseElement* pOriginal);

Parametri

pOriginal
[in] Puntatore a un elemento della barra multifunzione.

Osservazioni:

Gli elementi della barra multifunzione copiati in un altro contenitore mantengono un puntatore all'elemento della barra multifunzione originale.

CMFCRibbonBaseElement::SetParentCategory

Imposta la categoria padre per l'elemento della barra multifunzione.

virtual void SetParentCategory(CMFCRibbonCategory* pParent);

Parametri

pParent
[in] Puntatore a una categoria della barra multifunzione.

Osservazioni:

I gruppi a schede nei controlli della barra multifunzione sono denominati categorie.

CMFCRibbonBaseElement::SetParentMenu

Imposta il contenitore di menu padre per l'elemento della barra multifunzione.

virtual void SetParentMenu(CMFCRibbonPanelMenuBar* pMenuBar);

Parametri

pMenuBar
[in] Menu padre.

Osservazioni:

CMFCRibbonBaseElement::SetParentRibbonBar

Imposta la barra multifunzione padre per l'elemento della barra multifunzione.

virtual void SetParentRibbonBar(CMFCRibbonBar* pRibbonBar);

Parametri

pRibbonBar
[in] Puntatore alla barra multifunzione padre.

Osservazioni:

CMFCRibbonBaseElement::SetRect

Imposta le dimensioni del rettangolo di visualizzazione per l'elemento della barra multifunzione.

void SetRect(CRect rect);

Parametri

rect
[in] Dimensioni del rettangolo.

Osservazioni:

CMFCRibbonBaseElement::SetText

Imposta il testo e il suggerimento per l'elemento della barra multifunzione.

virtual void SetText(LPCTSTR lpszText);

Parametri

lpszText
[in] Testo e descrizione comando per l'elemento della barra multifunzione.

Osservazioni:

Per impostare il suggerimento per il tasto di scelta rapida per l'elemento della barra multifunzione, aggiungere la sequenza di escape di nuova riga seguita dai caratteri del suggerimento tasto a lpszText.

Esempio

//Set the text for the ribbon element
SetText(_T("Margins"))
//Set the text and a single-letter keytip
SetText(_T("Margins\nm"))
//Set the text and a multiple-letter keytip
SetText(_T("Line Numbers\nln"))

CMFCRibbonBaseElement::SetTextAlwaysOnRight

Imposta il testo per l'elemento della barra multifunzione da visualizzare a destra.

virtual void SetTextAlwaysOnRight(BOOL bSet = TRUE);

Parametri

bSet
[in] TRUE per visualizzare il testo a destra; in caso contrario FALSE.

Osservazioni:

CMFCRibbonBaseElement::SetToolTipText

Imposta il testo della descrizione comando per l'elemento della barra multifunzione.

virtual void SetToolTipText(LPCTSTR lpszText);

Parametri

lpszText
[in] Testo della descrizione comando.

CMFCRibbonBaseElement::SetVisible

Imposta la visibilità dell'elemento della barra multifunzione.

void SetVisible(BOOL bIsVisible);

Parametri

bIsVisible
[in] TRUE per visualizzare l'elemento della barra multifunzione; FALSE per nascondere l'elemento della barra multifunzione.

Osservazioni:

CMFCRibbonBaseElement::StretchHorizontally

Estende la larghezza dell'elemento della barra multifunzione.

virtual void StretchHorizontally();

Osservazioni:

Per impostazione predefinita, questo metodo genera un errore di asserzione nelle compilazioni di debug e pertanto non deve essere chiamato. Eseguire l'override di questo metodo per estendere la larghezza dell'elemento della barra multifunzione.

CMFCRibbonBaseElement::StretchToWholeRow

Modifica l'altezza di visualizzazione dell'elemento della barra multifunzione impostando l'altezza della riga specificata.

virtual BOOL StretchToWholeRow(
    CDC* pDC,
    int nHeight);

Parametri

pDC
[in] Questo parametro non viene usato.

nHeight
[in] Altezza della riga.

Valore restituito

TRUE se l'altezza di visualizzazione è stata impostata; in caso contrario, FALSE.

Osservazioni:

Eseguire l'override di questo metodo per modificare l'altezza di visualizzazione dell'elemento della barra multifunzione impostando l'altezza della riga specificata.

CMFCRibbonBaseElement::UpdateTooltipInfo

Aggiorna il testo della descrizione comando usando la risorsa di comando per l'elemento della barra multifunzione.

virtual void UpdateTooltipInfo();

Osservazioni:

CMFCRibbonBaseElement::HasFocus

Indica se l'elemento padre ha lo stato attivo della tastiera.

virtual BOOL HasFocus() const;

Valore restituito

TRUE se l'elemento della barra multifunzione è attivo; in caso contrario FALSE.

Osservazioni:

Vedi anche

Grafico della gerarchia
Classi

Condividi tramite

Classe CMFCRibbonBaseElement

Sintassi

Membri

Costruttori pubblici

Metodi pubblici

Metodi protetti

Osservazioni:

Esempio

Gerarchia di ereditarietà

Requisiti

CMFCRibbonBaseElement::AddToKeyList

Parametri

Osservazioni:

CMFCRibbonBaseElement::AddToListBox

Parametri

Valore restituito

Osservazioni:

CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar

Valore restituito

Osservazioni:

CMFCRibbonBaseElement::CanBeCompacted

Valore restituito

Osservazioni:

CMFCRibbonBaseElement::CanBeStretched

Valore restituito

Osservazioni:

CMFCRibbonBaseElement::CanBeStretchedHorizontally

Valore restituito

Osservazioni:

CMFCRibbonBaseElement::CleanUpSizes

Osservazioni:

CMFCRibbonBaseElement::ClosePopupMenu

Osservazioni:

CMFCRibbonBaseElement::CopyFrom

Parametri

Osservazioni:

CMFCRibbonBaseElement::D estroyCtrl

Osservazioni:

CMFCRibbonBaseElement::D rawImage

Parametri

Osservazioni:

CMFCRibbonBaseElement::Find

Parametri

Valore restituito

Osservazioni:

CMFCRibbonBaseElement::FindByData

Parametri

Valore restituito

Osservazioni:

CMFCRibbonBaseElement::FindByID

Parametri

Valore restituito

Osservazioni:

CMFCRibbonBaseElement::FindByOriginal

Parametri

Valore restituito

Osservazioni:

CMFCRibbonBaseElement::GetCompactSize

Parametri

Valore restituito

CMFCRibbonBaseElement::GetData

Valore restituito

CMFCRibbonBaseElement::GetDescription

Valore restituito

CMFCRibbonBaseElement::GetDroppedDown

Valore restituito

Osservazioni:

CMFCRibbonBaseElement::GetElements

Parametri

Osservazioni:

CMFCRibbonBaseElement::GetElementsByID

Parametri

Osservazioni:

CMFCRibbonBaseElement::GetHighlighted

Valore restituito

Osservazioni:

CMFCRibbonBaseElement::GetID

Valore restituito

CMFCRibbonBaseElement::GetImageSize