Classe CMFCRibbonPanel
Implementa un riquadro contenente un set di elementi della barra multifunzione. Quando il pannello viene disegnato, visualizza tutti gli elementi possibili in base alle proprie dimensioni.
Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.
Sintassi
class CMFCRibbonPanel : public CObject
Membri
Costruttori protetti
Nome | Descrizione |
---|---|
CMFCRibbonPanel::CMFCRibbonPanel | Costruisce e inizializza un oggetto CMFCRibbonPanel . |
Metodi pubblici
Nome | Descrizione |
---|---|
CMFCRibbonPanel::Add | Aggiunge un elemento della barra multifunzione al pannello. |
CMFCRibbonPanel::AddSeparator | Aggiunge un separatore al pannello della barra multifunzione. |
CMFCRibbonPanel::AddToolBar | Aggiunge una barra degli strumenti al pannello della barra multifunzione. |
CMFCRibbonPanel::FindByData | |
CMFCRibbonPanel::FindByID | Restituisce un elemento identificato da un ID comando specificato. |
CMFCRibbonPanel::GetCaptionHeight | |
CMFCRibbonPanel::GetCount | Restituisce il numero di elementi nel pannello della barra multifunzione. |
CMFCRibbonPanel::GetData | Restituisce i dati definiti dall'utente associati al pannello. |
CMFCRibbonPanel::GetDefaultButton | |
CMFCRibbonPanel::GetDroppedDown | |
CMFCRibbonPanel::GetElement | Restituisce l'elemento della barra multifunzione che si trova in corrispondenza di un indice specificato. |
CMFCRibbonPanel::GetElements | Recupera tutti gli elementi contenuti nel pannello della barra multifunzione. |
CMFCRibbonPanel::GetElementsByID | |
CMFCRibbonPanel::GetFocused | Restituisce un elemento con stato attivo. |
CMFCRibbonPanel::GetGalleryRect | Restituisce un rettangolo di delimitazione dell'elemento Gallery. |
CMFCRibbonPanel::GetHighlighted | |
CMFCRibbonPanel::GetIndex | |
CMFCRibbonPanel::GetItemIDsList | |
CMFCRibbonPanel::GetName | |
CMFCRibbonPanel::GetParentButton | |
CMFCRibbonPanel::GetParentCategory | Restituisce la categoria padre del pannello della barra multifunzione. |
CMFCRibbonPanel::GetParentMenuBar | |
CMFCRibbonPanel::GetPreferedMenuLocation | |
CMFCRibbonPanel::GetPressed | |
CMFCRibbonPanel::GetRect | |
CMFCRibbonPanel::GetVisibleElements | Ottiene una matrice di elementi visibili. |
CMFCRibbonPanel::HasElement | |
CMFCRibbonPanel::HitTest | |
CMFCRibbonPanel::HitTestEx | |
CMFCRibbonPanel::Insert | Inserisce un elemento della barra multifunzione nella posizione specificata. |
CMFCRibbonPanel::InsertSeparator | Inserisce un separatore nella posizione specificata. |
CMFCRibbonPanel::IsCenterColumnVert | Specifica se tutti gli elementi del pannello devono essere allineati al centro (allineati) verticalmente, in base alla colonna. |
CMFCRibbonPanel::IsCollapsed | |
CMFCRibbonPanel::IsHighlighted | |
CMFCRibbonPanel::IsJustifyColumns | Specifica se tutte le colonne del pannello hanno la stessa larghezza. |
CMFCRibbonPanel::IsMainPanel | |
CMFCRibbonPanel::IsMenuMode | |
CMFCRibbonPanel::MakeGalleryItemVisible | Scorre la raccolta per rendere visibile l'elemento della barra multifunzione specificato. |
CMFCRibbonPanel::OnKey | |
CMFCRibbonPanel::RecalcWidths | |
CMFCRibbonPanel::Remove | Rimuove ed elimina facoltativamente un elemento che si trova in corrispondenza dell'indice specificato. |
CMFCRibbonPanel::RemoveAll | Rimuove tutti gli elementi dal pannello della barra multifunzione. |
CMFCRibbonPanel::Replace | Sostituisce un elemento con un altro in base ai rispettivi valori di indice. |
CMFCRibbonPanel::ReplaceByID | Sostituisce un elemento con un altro in base a un ID di comando specificato. |
CMFCRibbonPanel::SetCenterColumnVert | Ordina al pannello di allineare gli elementi verticalmente, in base alla colonna. |
CMFCRibbonPanel::SetData | Associa i dati definiti dall'utente al pannello della barra multifunzione. |
CMFCRibbonPanel::SetElementMenu | Assegna un menu popup all'elemento con l'ID di comando specificato. |
CMFCRibbonPanel::SetElementRTC | Aggiunge un elemento della barra multifunzione specificato dalle informazioni sulla classe di runtime fornite al pannello della barra multifunzione. |
CMFCRibbonPanel::SetElementRTCByID | Aggiunge un elemento della barra multifunzione specificato dalle informazioni sulla classe di runtime fornite al pannello della barra multifunzione. |
CMFCRibbonPanel::SetFocused | Imposta lo stato attivo sull'elemento della barra multifunzione specificato. |
CMFCRibbonPanel::SetJustifyColumns | Abilita o disabilita la giustificazione delle colonne. |
CMFCRibbonPanel::SetKeys | Imposta la scelta rapida da tastiera che visualizza il pannello della barra multifunzione. |
CMFCRibbonPanel::ShowPopup |
Osservazioni:
I pannelli della barra multifunzione sono raggruppamenti logici di attività correlate create all'interno delle categorie della barra multifunzione. Man mano che cambiano le dimensioni della barra multifunzione, il layout del pannello si adatta automaticamente per visualizzare il maggior numero possibile di elementi.
È possibile ottenere un pannello della barra multifunzione contenuto in una categoria della barra multifunzione chiamando il metodo CMFCRibbonCategory::GetPanel .
Esempio
Nell'esempio seguente viene illustrato come configurare un CMFCRibbonPanel
oggetto usando vari metodi nella CMFCRibbonPanel
classe . Nell'esempio viene illustrato come impostare la scelta rapida da tastiera che visualizza il pannello della barra multifunzione, allineare gli elementi nel pannello verticalmente in base alla colonna e abilitare la giustificazione delle colonne. Questo frammento di codice fa parte dell'esempio demo di MS Office 2007.
// CMFCRibbonCategory* pCategory
// CMFCToolBarImages m_PanelImages
CMFCRibbonPanel *pPanelClipboard = pCategory->AddPanel(_T("Clipboard"), m_PanelImages.ExtractIcon(1));
pPanelClipboard->SetKeys(_T("zc"));
pPanelClipboard->SetCenterColumnVert();
pPanelClipboard->SetJustifyColumns();
Gerarchia di ereditarietà
Requisiti
Intestazione: afxRibbonPanel.h
CMFCRibbonPanel::Add
Aggiunge l'elemento della barra multifunzione specificato alla matrice di elementi della barra multifunzione contenuti nel pannello della barra multifunzione.
virtual void Add(CMFCRibbonBaseElement* pElem);
Parametri
pElem
[in, out] Puntatore a un elemento della barra multifunzione.
Osservazioni:
CMFCRibbonPanel::AddSeparator
Aggiunge un separatore al pannello della barra multifunzione.
virtual void AddSeparator();
Osservazioni:
Chiamare questo metodo per aggiungere un separatore al pannello della barra multifunzione. Il separatore verrà aggiunto accanto all'elemento della barra multifunzione aggiunto dalla chiamata precedente a CMFCRibbonPanel::Add. Per inserire un separatore in una determinata posizione, chiamare CMFCRibbonPanel::InsertSeparator.
CMFCRibbonPanel::AddToolBar
Aggiunge una barra degli strumenti al pannello della barra multifunzione.
CMFCRibbonButtonsGroup* AddToolBar(
UINT uiToolbarResID,
UINT uiColdResID = 0,
UINT uiHotResID = 0,
UINT uiDisabledResID = 0);
Parametri
uiToolbarResID
[in] Specifica l'ID risorsa della barra degli strumenti da aggiungere.
uiColdResID
[in] Specifica l'ID risorsa delle immagini ad accesso sporadico della barra degli strumenti.
uiHotResID
[in] Specifica l'ID risorsa delle immagini ad accesso frequente della barra degli strumenti.
uiDisabledResID
[in] Specifica l'ID risorsa delle immagini disabilitate della barra degli strumenti.
Valore restituito
Chiamare questo metodo per aggiungere una barra degli strumenti al pannello della barra multifunzione. La barra degli strumenti verrà aggiunta accanto all'elemento della barra multifunzione aggiunta dalla chiamata precedente a CMFCRibbonPanel::Add.
Osservazioni:
Per altre informazioni su barre degli strumenti, immagini ad accesso frequente, immagini ad accesso sporadico e immagini disabilitate, vedere Classe CMFCToolBar.
CMFCRibbonPanel::CMFCRibbonPanel
Costruisce e inizializza un oggetto CMFCRibbonPanel .
CMFCRibbonPanel(
LPCTSTR lpszName = NULL,
HICON hIcon = NULL);
CMFCRibbonPanel(CMFCRibbonGallery* pPaletteButton);
Parametri
lpszName
[in] Nome del pannello della barra multifunzione.
hIcon
[in] Handle per l'icona del pulsante predefinito per il pannello della barra multifunzione.
pPaletteButton
[in] Puntatore a una raccolta della barra multifunzione per il pannello della barra multifunzione.
CMFCRibbonPanel::FindByData
Recupera l'elemento della barra multifunzione associato ai dati specificati.
CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData) const;
Parametri
dwData
[in] Dati associati a un elemento della barra multifunzione.
Valore restituito
Puntatore a un elemento della barra multifunzione se il metodo ha avuto esito positivo; in caso contrario NULL.
Osservazioni:
CMFCRibbonPanel::FindByID
Recupera l'elemento della barra multifunzione identificato dall'ID del comando specificato.
CMFCRibbonBaseElement* FindByID(UINT uiCmdID) const;
Parametri
uiCmdID
[in] ID comando di un elemento della barra multifunzione.
Valore restituito
Elemento della barra multifunzione identificato dall'ID comando specificato; in caso contrario, NULL se non viene identificato alcun elemento della barra multifunzione con l'ID del comando specificato.
CMFCRibbonPanel::GetCaptionHeight
Recupera l'altezza di una didascalia per il pannello della barra multifunzione.
int GetCaptionHeight() const;
Valore restituito
Altezza, in pixel, di una didascalia per il pannello della barra multifunzione.
Osservazioni:
CMFCRibbonPanel::GetCount
Recupera il numero di elementi della barra multifunzione contenuti nel pannello della barra multifunzione.
int GetCount() const;
Valore restituito
Numero di elementi della barra multifunzione contenuti nel pannello della barra multifunzione.
CMFCRibbonPanel::GetData
Restituisce i dati definiti dall'utente associati al pannello.
DWORD_PTR GetData() const;
Valore restituito
Dati definiti dall'utente associati al pannello.
CMFCRibbonPanel::GetDefaultButton
Recupera il pulsante predefinito per il pannello della barra multifunzione.
CMFCRibbonButton& GetDefaultButton();
Valore restituito
Pulsante predefinito per il pannello della barra multifunzione.
Osservazioni:
Il pulsante predefinito viene visualizzato quando un pannello della barra multifunzione non dispone di spazio sufficiente per visualizzare gli elementi della barra multifunzione.
CMFCRibbonPanel::GetDroppedDown
Recupera un puntatore a un elemento della barra multifunzione se il relativo menu a comparsa viene eliminato.
CMFCRibbonBaseElement* GetDroppedDown() const;
Valore restituito
Puntatore all'elemento della barra multifunzione con il relativo menu a comparsa eliminato; in caso contrario, NULL se non è stato eliminato alcun elemento della barra multifunzione.
Osservazioni:
Vengono testati solo gli elementi della barra multifunzione contenuti nel pannello della barra multifunzione.
CMFCRibbonPanel::GetElement
Restituisce l'elemento della barra multifunzione che si trova in corrispondenza di un indice specificato.
CMFCRibbonBaseElement* GetElement(int nIndex) const;
Parametri
nIndex
[in] Specifica l'indice in base zero dell'elemento da recuperare.
Valore restituito
Puntatore valido all'elemento della barra multifunzione di base che si trova in corrispondenza della posizione nIndex nel pannello della barra multifunzione oppure NULL se non è presente alcun elemento in corrispondenza dell'indice specificato.
CMFCRibbonPanel::GetElements
Recupera tutti gli elementi della barra multifunzione contenuti nel pannello della barra multifunzione.
void GetElements(CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parametri
arElements
[out] Matrice da riempire con tutti gli elementi della barra multifunzione contenuti nel pannello della barra multifunzione.
Osservazioni:
CMFCRibbonPanel::GetElementsByID
Aggiunge elementi della barra multifunzione con l'ID di comando specificato alla matrice specificata.
void GetElementsByID(
UINT uiCmdID,
CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parametri
uiCmdID
[in] ID comando per un elemento della barra multifunzione.
arElements
[in] Matrice di elementi della barra multifunzione.
Osservazioni:
Vengono testati solo gli elementi della barra multifunzione contenuti nel pannello della barra multifunzione.
CMFCRibbonPanel::GetHighlighted
Recupera l'elemento della barra multifunzione evidenziato nel pannello della barra multifunzione.
CMFCRibbonBaseElement* GetHighlighted() const;
Valore restituito
Puntatore all'elemento della barra multifunzione evidenziato nel pannello della barra multifunzione.
Osservazioni:
CMFCRibbonPanel::GetIndex
Recupera l'indice in base zero dell'elemento della barra multifunzione specificato dalla matrice di elementi della barra multifunzione contenuti nel pannello della barra multifunzione.
virtual int GetIndex(CMFCRibbonBaseElement* pElem) const;
Parametri
pElem
[in] Puntatore a un elemento della barra multifunzione.
Valore restituito
Indice in base zero dell'elemento della barra multifunzione specificato se il metodo ha avuto esito positivo; in caso contrario -1.
Osservazioni:
CMFCRibbonPanel::GetItemIDsList
Recupera gli ID comando per tutti gli elementi della barra multifunzione nel pannello della barra multifunzione.
void GetItemIDsList(CList<UINT, UINT>& lstItems) const;
Parametri
lstItems
[out] Elenco di ID comando per gli elementi della barra multifunzione contenuti nel pannello della barra multifunzione.
Osservazioni:
CMFCRibbonPanel::GetName
Recupera il nome del pannello della barra multifunzione.
LPCTSTR GetName() const;
Valore restituito
Nome del pannello della barra multifunzione.
Osservazioni:
CMFCRibbonPanel::GetParentButton
CMFCRibbonBaseElement* GetParentButton() const;
Valore restituito
Osservazioni:
CMFCRibbonPanel::GetParentCategory
Restituisce la categoria padre del pannello della barra multifunzione.
CMFCRibbonCategory* GetParentCategory() const;
Valore restituito
Puntatore alla categoria della barra multifunzione che contiene questo pannello della barra multifunzione.
CMFCRibbonPanel::GetParentMenuBar
CMFCRibbonPanelMenuBar* GetParentMenuBar() const;
Valore restituito
Osservazioni:
CMFCRibbonPanel::GetPreferedMenuLocation
Recupera il rettangolo di visualizzazione preferito per il menu a comparsa del pannello della barra multifunzione.
virtual BOOL GetPreferedMenuLocation(CRect& rect);
Parametri
rect
[out] Questo parametro non viene usato.
Valore restituito
Restituisce sempre FALSE.
Osservazioni:
Questo metodo restituisce sempre FALSE. Eseguire l'override di questo metodo per recuperare il rettangolo di visualizzazione preferito per il menu a comparsa del pannello della barra multifunzione.
CMFCRibbonPanel::GetPressed
Recupera un puntatore a un elemento della barra multifunzione nel pannello della barra multifunzione se l'utente lo preme attualmente.
CMFCRibbonBaseElement* GetPressed() const;
Valore restituito
Puntatore a un elemento della barra multifunzione se l'utente lo preme; in caso contrario NULL.
Osservazioni:
CMFCRibbonPanel::GetRect
Recupera il rettangolo di visualizzazione per il pannello della barra multifunzione.
const CRect& GetRect() const;
Valore restituito
Rettangolo di visualizzazione per il pannello della barra multifunzione.
Osservazioni:
CMFCRibbonPanel::HasElement
Indica se il pannello della barra multifunzione contiene l'elemento della barra multifunzione specificato.
BOOL HasElement(const CMFCRibbonBaseElement* pElem) const;
Parametri
pElem
[in] Puntatore a un elemento della barra multifunzione.
Valore restituito
TRUE se il pannello della barra multifunzione contiene l'elemento della barra multifunzione specificato; in caso contrario FALSE.
Osservazioni:
CMFCRibbonPanel::Highlight
Imposta il colore di evidenziazione per il pannello della barra multifunzione selezionato e per l'elemento della barra multifunzione specificato dal punto.
virtual void Highlight(
BOOL bHighlight,
CPoint point);
Parametri
bHighlight
[in] TRUE per evidenziare il pannello della barra multifunzione; FALSE per annullare l'illuminazione del pannello della barra multifunzione.
point
[in] Coordinate x e y del puntatore, rispetto all'angolo superiore sinistro della finestra.
Osservazioni:
CMFCRibbonPanel::HitTest
Recupera un elemento della barra multifunzione se il punto specificato si trova in esso.
virtual CMFCRibbonBaseElement* HitTest(
CPoint point,
BOOL bCheckPanelCaption = FALSE);
Parametri
point
[in] Coordinate x e y del puntatore, rispetto all'angolo superiore sinistro della finestra.
bCheckPanelCaption
[in] TRUE per testare la didascalia del pannello della barra multifunzione; in caso contrario FALSE.
Valore restituito
Puntatore a un elemento della barra multifunzione se il punto specificato si trova in esso; in caso contrario NULL.
Osservazioni:
Vengono testati solo gli elementi della barra multifunzione contenuti nel pannello della barra multifunzione.
CMFCRibbonPanel::HitTestEx
Recupera l'indice in base zero dell'elemento della barra multifunzione che contiene il punto specificato.
virtual int HitTestEx(CPoint point) const;
Parametri
point
[in] Coordinate x e y del puntatore, rispetto all'angolo superiore sinistro della finestra.
Valore restituito
Indice in base zero dell'elemento della barra multifunzione che contiene il punto specificato; in caso contrario -1.
Osservazioni:
Vengono testati solo gli elementi della barra multifunzione contenuti nel pannello della barra multifunzione.
CMFCRibbonPanel::Insert
Inserisce l'elemento della barra multifunzione specificato nella posizione specificata nella matrice di elementi della barra multifunzione contenuti nel pannello della barra multifunzione.
virtual BOOL Insert(
CMFCRibbonBaseElement* pElem,
int nIndex);
Parametri
pElem
[in, out] Puntatore a un elemento della barra multifunzione.
nIndex
[in] Valore in base zero, compreso tra -1 e il numero di elementi della barra multifunzione contenuti nella matrice.
Valore restituito
TRUE se l'elemento della barra multifunzione è stato inserito correttamente; in caso contrario FALSE.
Osservazioni:
Se il valore di nIndex è -1 o se nIndex è uguale al numero di elementi della barra multifunzione nella matrice, l'elemento della barra multifunzione specificato viene aggiunto alla fine della matrice. Se il valore di nIndex non è compreso nell'intervallo, il metodo avrà esito negativo.
CMFCRibbonPanel::InsertSeparator
Inserisce un separatore nella posizione specificata.
virtual BOOL InsertSeparator(int nIndex);
Parametri
nIndex
[in] Specifica l'indice in base zero in cui viene inserito il separatore.
Valore restituito
TRUE se il separatore è stato inserito correttamente; in caso contrario, FALSE.
Osservazioni:
Chiamare questo metodo per inserire un separatore nella posizione specificata da nIndex. Per inserire un separatore accanto all'elemento della barra multifunzione aggiunto più di recente, chiama CMFCRibbonPanel::AddSeparator.
CMFCRibbonPanel::IsCenterColumnVert
Indica se le posizioni verticali degli elementi della barra multifunzione sono centrate all'interno del rettangolo di visualizzazione.
BOOL IsCenterColumnVert() const;
Valore restituito
TRUE se le posizioni verticali degli elementi della barra multifunzione sono centrate all'interno del relativo rettangolo di visualizzazione; in caso contrario FALSE.
CMFCRibbonPanel::IsCollapsed
Indica se le dimensioni di visualizzazione del pannello della barra multifunzione sono ridotte a icona nella direzione orizzontale.
BOOL IsCollapsed() const;
Valore restituito
TRUE se le dimensioni di visualizzazione del pannello della barra multifunzione sono ridotte a icona nella direzione orizzontale; in caso contrario FALSE.
Osservazioni:
Quando un pannello della barra multifunzione è compresso, visualizza solo il pulsante predefinito, il nome e una freccia a discesa.
CMFCRibbonPanel::IsHighlighted
Indica se la visualizzazione del pannello della barra multifunzione è evidenziata.
BOOL IsHighlighted() const;
Valore restituito
TRUE se la visualizzazione del pannello della barra multifunzione è evidenziata; in caso contrario FALSE.
Osservazioni:
La visualizzazione di un pannello della barra multifunzione viene evidenziata quando il puntatore è posizionato su di esso.
CMFCRibbonPanel::IsJustifyColumns
Indica se le dimensioni di visualizzazione degli elementi della barra multifunzione che si trovano nella stessa colonna del pannello della barra multifunzione sono impostate sulla stessa larghezza.
BOOL IsJustifyColumns() const;
Valore restituito
TRUE se le dimensioni di visualizzazione degli elementi della barra multifunzione che si trovano nella stessa colonna del pannello della barra multifunzione vengono impostate sulla stessa larghezza; in caso contrario FALSE.
CMFCRibbonPanel::IsMainPanel
Indica se il pannello della barra multifunzione è il pannello principale della barra multifunzione.
virtual BOOL IsMainPanel() const;
Valore restituito
Restituisce sempre FALSE.
Osservazioni:
Questo metodo restituisce sempre FALSE. Eseguire l'override di questo metodo per indicare se il pannello della barra multifunzione è il pannello principale della barra multifunzione.
Il pannello principale della barra multifunzione viene visualizzato quando l'utente seleziona il pulsante dell'applicazione.
CMFCRibbonPanel::IsMenuMode
BOOL IsMenuMode() const;
Valore restituito
Osservazioni:
CMFCRibbonPanel::OnKey
virtual BOOL OnKey(UINT nChar);
Parametri
[in] nChar
Valore restituito
Osservazioni:
CMFCRibbonPanel::RecalcWidths
Ricalcola la larghezza di ogni configurazione del layout di visualizzazione per il pannello della barra multifunzione.
virtual void RecalcWidths(
CDC* pDC,
int nHeight);
Parametri
pDC
[in] Puntatore a un contesto di dispositivo per il pannello della barra multifunzione.
nHeight
[in] Altezza del pannello della barra multifunzione.
Osservazioni:
Un pannello della barra multifunzione modifica la configurazione del layout man mano che cambia la larghezza disponibile.
CMFCRibbonPanel::Remove
Rimuove ed elimina facoltativamente un elemento che si trova in corrispondenza dell'indice specificato.
BOOL Remove(
int nIndex,
BOOL bDelete = TRUE);
Parametri
nIndex
[in] Specifica l'indice in base zero dell'elemento rimosso dal pannello della barra multifunzione.
bDelete
[in] TRUE per eliminare l'elemento da rimuovere; in caso contrario, FALSE.
Valore restituito
TRUE se l'elemento è stato rimosso ed eliminato (se bDelete è TRUE); FALSE se l'elemento non è stato rimosso o se non è presente alcun elemento della barra multifunzione che si trova in nIndex.
Osservazioni:
Chiamare questo metodo per rimuovere un elemento dal pannello della barra multifunzione.
CMFCRibbonPanel::RemoveAll
Elimina tutti gli elementi della barra multifunzione dal pannello della barra multifunzione.
void RemoveAll();
Osservazioni:
Tutti gli elementi della barra multifunzione vengono eliminati dal pannello della barra multifunzione e eliminati definitivamente.
CMFCRibbonPanel::Replace
Sostituisce un elemento con un altro in base al relativo valore di indice.
BOOL Replace(
int nIndex,
CMFCRibbonBaseElement* pElem);
Parametri
nIndex
[in] Specifica l'indice in base zero dell'elemento da sostituire.
pElem
[in, out] Puntatore valido all'elemento che sostituisce l'elemento originale.
Valore restituito
TRUE se l'elemento della barra multifunzione originale è stato sostituito correttamente dal nuovo elemento della barra multifunzione; FALSE se l'elemento della barra multifunzione non è stato sostituito o se non è presente alcun elemento in corrispondenza dell'indice specificato.
Osservazioni:
Per sostituire un elemento della barra multifunzione in base all'ID comando, chiamare CMFCRibbonPanel::ReplaceByID.
CMFCRibbonPanel::ReplaceByID
Sostituisce un elemento con un altro in base a un ID di comando specificato.
BOOL ReplaceByID(
UINT uiCmdID,
CMFCRibbonBaseElement* pElem);
Parametri
uiCmdID
[in] Specifica l'ID comando dell'elemento da sostituire.
pElem
[in, out] Puntatore valido all'elemento che sostituirà l'elemento originale.
Valore restituito
TRUE se l'elemento della barra multifunzione originale è stato sostituito correttamente dal nuovo elemento della barra multifunzione; FALSE se l'elemento della barra multifunzione non è stato sostituito o se non esiste alcun elemento con l'ID di comando specificato.
Osservazioni:
Per sostituire un elemento della barra multifunzione in base alla posizione, chiamare CMFCRibbonPanel::Replace.
CMFCRibbonPanel::SetCenterColumnVert
Abilita o disabilita il centro delle posizioni verticali degli elementi della barra multifunzione all'interno del relativo rettangolo di visualizzazione.
void SetCenterColumnVert(BOOL bSet = TRUE);
Parametri
bSet
[in] TRUE per centrare le posizioni verticali degli elementi della barra multifunzione all'interno del rettangolo di visualizzazione; FALSE per disabilitare questa funzionalità.
Osservazioni:
CMFCRibbonPanel::SetData
Associa i dati definiti dall'utente al pannello della barra multifunzione.
void SetData(DWORD_PTR dwData);
Parametri
dwData
[in] Specifica i dati definiti dall'utente da impostare.
Osservazioni:
Chiamare questo metodo per associare i dati definiti dall'utente al pannello della barra multifunzione.
CMFCRibbonPanel::SetElementMenu
Assegna un menu popup all'elemento con l'ID di comando specificato.
BOOL SetElementMenu(
UINT uiCmdID,
HMENU hMenu,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);
BOOL SetElementMenu(
UINT uiCmdID,
UINT uiMenuResID,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);
Parametri
uiCmdID
[in] Specifica l'ID comando dell'elemento della barra multifunzione in cui viene aggiunto il menu.
hMenu
[in] Specifica l'handle del menu di Windows da aggiungere al pannello della barra multifunzione.
bIsDefautCommand
[in] TRUE per specificare che il comando associato all'elemento della barra multifunzione deve essere eseguito se si fa clic sull'elemento della barra multifunzione. In questo caso, il menu viene aperto solo quando l'utente fa clic sulla freccia accanto all'elemento della barra multifunzione. FALSE per specificare che il comando associato all'elemento della barra multifunzione non deve essere eseguito se si fa clic sull'elemento della barra multifunzione. In questo caso, il menu popup viene visualizzato indipendentemente dalla posizione in cui l'utente fa clic sull'elemento.
bRightAlign
[in] TRUE per specificare che il menu popup è allineato a destra; in caso contrario, FALSE.
uiMenuResID
[in] Specifica l'ID risorsa del menu da aggiungere al pannello della barra multifunzione.
Valore restituito
TRUE se il menu è stato assegnato all'elemento della barra multifunzione; in caso contrario, FALSE.
Osservazioni:
Chiamare questo metodo per assegnare un menu popup all'elemento della barra multifunzione con l'ID di comando specificato.
CMFCRibbonPanel::SetElementRTC
Aggiunge l'elemento della barra multifunzione specificato dalle informazioni sulla classe di runtime fornite al pannello della barra multifunzione.
CMFCRibbonBaseElement* SetElementRTC(
int nIndex,
CRuntimeClass* pRTC);
Parametri
nIndex
[in] Specifica l'indice in base zero dell'elemento della barra multifunzione da aggiungere.
pRTC
[in, out] Puntatore alle informazioni sulla classe di runtime per l'elemento della barra multifunzione aggiunto al pannello della barra multifunzione.
Valore restituito
Elemento della barra multifunzione creato utilizzando le informazioni della classe di runtime specificate.
Osservazioni:
Se si desidera aggiungere un elemento personalizzato (ad esempio, un pulsante a colori) al pannello della barra multifunzione, è necessario specificare le informazioni sulla classe di runtime dell'elemento personalizzato. La barra multifunzione archivia queste informazioni, crea l'elemento personalizzato e sostituisce un elemento esistente che si trova (identificato da) l'ID comando specificato. La barra multifunzione restituisce quindi un puntatore all'elemento appena creato.
CMFCRibbonPanel::SetElementRTCByID
Aggiunge un elemento della barra multifunzione specificato dalle informazioni sulla classe di runtime fornite al pannello della barra multifunzione.
CMFCRibbonBaseElement* SetElementRTCByID(
UINT uiCmdID,
CRuntimeClass* pRTC);
Parametri
uiCmdID
[in] Specifica l'ID comando dell'elemento della barra multifunzione da aggiungere.
pRTC
[in, out] Puntatore alle informazioni sulla classe di runtime associate all'elemento della barra multifunzione aggiunto al pannello della barra multifunzione.
Valore restituito
Elemento della barra multifunzione creato utilizzando le informazioni della classe di runtime specificate.
Osservazioni:
Se si desidera aggiungere un elemento personalizzato (ad esempio, un pulsante a colori) al pannello della barra multifunzione, è necessario specificare le informazioni sulla classe di runtime dell'elemento personalizzato. La barra multifunzione archivia queste informazioni, crea l'elemento personalizzato e sostituisce un elemento esistente individuato dall'ID comando specificato. Restituisce quindi un puntatore all'elemento appena creato.
Esempio
Nell'esempio seguente viene illustrato come usare il SetElementRTCByID
metodo :
// Load and add toolbar with standard buttons. This toolbar
// should display a custom color button with id ID_CHAR_COLOR:
pPanel->AddToolBar(IDR_MAINFRAME,
IDB_MAINFRAME256);
CMFCRibbonColorButton* pColorButton =
(CMFCRibbonColorButton*)pPanel->SetElementRTCByID(
ID_CHAR_COLOR,
RUNTIME_CLASS (CMFCRibbonColorButton));
// SetElementRTCByID sets runtime class and returns a pointer
// to the newly created custom button,
which can be set up immediately:
pColorButton->EnableAutomaticButton(_T("Automatic"),
RGB (0,
0,
0));
CMFCRibbonPanel::SetJustifyColumns
Abilita o disabilita la regolazione della larghezza degli elementi della barra multifunzione nella stessa colonna.
void SetJustifyColumns(BOOL bSet = TRUE);
Parametri
bSet
[in] TRUE per regolare la larghezza degli elementi della barra multifunzione nella stessa colonna alla larghezza dell'elemento barra multifunzione più grande nella colonna; FALSE per disabilitare questa regolazione della larghezza.
Osservazioni:
Quando questa funzionalità è abilitata in un pannello della barra multifunzione, le larghezze degli elementi della barra multifunzione nella stessa colonna vengono regolate in base alla larghezza dell'elemento barra multifunzione più grande nella stessa colonna.
CMFCRibbonPanel::SetKeys
Imposta il suggerimento per il tasto predefinito del pannello della barra multifunzione.
void SetKeys(LPCTSTR lpszKeys);
Parametri
lpszKeys
[in] Suggerimento per il pulsante predefinito del pannello della barra multifunzione.
Osservazioni:
Il pulsante predefinito viene visualizzato quando un pannello della barra multifunzione non dispone di spazio sufficiente per visualizzare gli elementi della barra multifunzione.
CMFCRibbonPanel::ShowPopup
Crea e visualizza un menu a comparsa per il pannello della barra multifunzione.
CMFCRibbonPanelMenu* ShowPopup(CMFCRibbonDefaultPanelButton* pButton = NULL);
Parametri
pButton
[in] Puntatore al pulsante predefinito per il pannello della barra multifunzione.
Valore restituito
Puntatore al menu a comparsa per il pannello della barra multifunzione se il metodo ha avuto esito positivo; in caso contrario NULL.
Osservazioni:
Il menu a comparsa per il pannello della barra multifunzione è disponibile solo quando la visualizzazione del pannello della barra multifunzione è compressa.
CMFCRibbonPanel::SetFocused
Imposta lo stato attivo sull'elemento della barra multifunzione specificato.
void SetFocused(CMFCRibbonBaseElement* pNewFocus);
Parametri
pNewFocus
Puntatore a un elemento della barra multifunzione che riceve lo stato attivo.
Osservazioni:
CMFCRibbonPanel::MakeGalleryItemVisible
Scorre la raccolta per rendere visibile l'elemento della barra multifunzione specificato.
void MakeGalleryItemVisible(CMFCRibbonBaseElement* pItem);
Parametri
pItem
Puntatore a un elemento ribbon da visualizzare.
Osservazioni:
CMFCRibbonPanel::IsWindows7Look
Indica se la barra multifunzione padre ha un aspetto di Windows 7 (piccolo pulsante di applicazione rettangolare).
BOOL IsWindows7Look() const;
Valore restituito
TRUE se la barra multifunzione padre ha l'aspetto di Windows 7; in caso contrario FALSE.
Osservazioni:
CMFCRibbonPanel::GetVisibleElements
Recupera una matrice di elementi visibili.
void GetVisibleElements(
CArray<CMFCRibbonBaseElement*,
CMFCRibbonBaseElement*>& arElements);
Parametri
arElements
Quando la funzione termina, questo parametro contiene una matrice di elementi visibili.
Osservazioni:
CMFCRibbonPanel::GetGalleryRect
Restituisce un rettangolo di delimitazione di un elemento Gallery.
CRect GetGalleryRect();
Valore restituito
Dimensioni e posizione dell'elemento Gallery all'interno di questo pannello.
Osservazioni:
CMFCRibbonPanel::GetFocused
Restituisce un elemento con stato attivo.
CMFCRibbonBaseElement* GetFocused() const;
Valore restituito
Puntatore a un elemento con stato attivo o NULL.
Osservazioni:
Vedi anche
Grafico della gerarchia
Classi
Classe CObject
Classe CMFCRibbonCategory
Classe CMFCRibbonBaseElement