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:
RibbonImageLargeRibbonImageSmall
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à
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.