Classe CMFCRibbonBaseElement

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:

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 è contenuto in una raccolta della barra multifunzione.

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