Classe CMFCRibbonGallery

Implementa raccolte della barra multifunzione di tipo Office 2007. Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

Sintassi

class CMFCRibbonGallery : public CMFCRibbonButton

Membri

Costruttori pubblici

Nome	Descrizione
CMFCRibbonGallery::CMFCRibbonGallery	Costruisce e inizializza un oggetto CMFCRibbonGallery.

Metodi pubblici

Nome	Descrizione
CMFCRibbonGallery::AddGroup	Aggiunge un nuovo gruppo alla raccolta.
CMFCRibbonGallery::AddSubItem	Aggiunge una nuova voce di menu al menu a discesa.
CMFCRibbonGallery::Clear	Cancella il contenuto della raccolta.
CMFCRibbonGallery::EnableMenuResize	Abilita o disabilita il ridimensionamento del pannello dei menu.
CMFCRibbonGallery::EnableMenuSideBar	Abilita o disabilita la barra laterale a sinistra del menu popup.
CMFCRibbonGallery::GetCompactSize	(sostituzioni )CMFCRibbonButton::GetCompactSize.
CMFCRibbonGallery::GetDroppedDown	(sostituzioni )CMFCRibbonBaseElement::GetDroppedDown.
CMFCRibbonGallery::GetGroupName	Restituisce il nome del gruppo che si trova in corrispondenza dell'indice specificato.
CMFCRibbonGallery::GetGroupOffset
CMFCRibbonGallery::GetIconsInRow	Restituisce il numero di elementi in una riga della raccolta della barra multifunzione.
CMFCRibbonGallery::GetItemToolTip	Restituisce il testo della descrizione comando associato a un elemento nella raccolta.
CMFCRibbonGallery::GetLastSelectedItem	Restituisce l'indice dell'ultimo elemento nella raccolta selezionato dall'utente.
CMFCRibbonGallery::GetPaletteID	Restituisce l'ID comando della raccolta corrente.
CMFCRibbonGallery::GetRegularSize	(sostituzioni )CMFCRibbonButton::GetRegularSize.
CMFCRibbonGallery::GetSelectedItem
CMFCRibbonGallery::HasMenu	(sostituzioni )CMFCRibbonButton::HasMenu.
CMFCRibbonGallery::IsButtonMode	Specifica se la raccolta è contenuta in un pulsante della raccolta.
CMFCRibbonGallery::IsMenuResizeEnabled	Specifica se il ridimensionamento dei menu è abilitato o disabilitato.
CMFCRibbonGallery::IsMenuResizeVertical
CMFCRibbonGallery::IsMenuSideBar	Specifica se la barra laterale è abilitata o disabilitata.
CMFCRibbonGallery::OnAfterChangeRect	Esegue l'override di CMFCRibbonButton::OnAfterChangeRect.
CMFCRibbonGallery::OnDraw	(sostituzioni )CMFCRibbonButton::OnDraw.
CMFCRibbonGallery::OnEnable	Esegue l'override di CMFCRibbonBaseElement::OnEnable.
CMFCRibbonGallery::OnRTLChanged	(sostituzioni )CMFCRibbonBaseElement::OnRTLChanged.
CMFCRibbonGallery::RedrawIcons	Ridisegna la raccolta.
CMFCRibbonGallery::RemoveItemToolTips	Rimuove le descrizioni comando da tutti gli elementi della raccolta.
CMFCRibbonGallery::SelectItem
CMFCRibbonGallery::SetACCData	(sostituzioni )CMFCRibbonButton::SetACCData.
CMFCRibbonGallery::SetButtonMode	Specifica se visualizzare la raccolta della barra multifunzione come pulsante a discesa o come tavolozza direttamente sulla barra multifunzione.
CMFCRibbonGallery::SetGroupName	Imposta il nome di un gruppo.
CMFCRibbonGallery::SetIconsInRow	Definisce il numero di elementi per riga nella raccolta.
CMFCRibbonGallery::SetItemToolTip	Imposta il testo della descrizione comando per un elemento nella raccolta.
CMFCRibbonGallery::SetPalette	Associa una tavolozza a una raccolta della barra multifunzione.
CMFCRibbonGallery::SetPaletteID	Definisce l'ID comando inviato nel messaggio di WM_COMMAND quando è stato selezionato un elemento della raccolta.

Metodi protetti

Nome	Descrizione
CMFCRibbonGallery::OnDrawPaletteIcon	Chiamato dal framework quando viene disegnata un'icona della raccolta.

Osservazioni:

Un pulsante della raccolta si comporta esattamente come un pulsante di menu normale, ad eccezione del fatto che visualizza una raccolta quando un utente lo apre. Quando si seleziona un elemento in una raccolta, il framework invia il messaggio WM_COMMAND insieme all'ID comando del pulsante. Quando si gestisce il messaggio, è necessario chiamare CMFCRibbonGallery::GetLastSelectedItem per determinare quale elemento è stato selezionato dalla raccolta.

Esempio

Nell'esempio seguente viene illustrato come utilizzare vari metodi nella CMFCRibbonGallery classe per configurare un CMFCRibbonGallery oggetto . Nell'esempio viene illustrato come specificare il numero di elementi per riga nella raccolta, abilitare il ridimensionamento del pannello di menu, abilitare la barra laterale a sinistra del menu a comparsa e visualizzare la raccolta della barra multifunzione come tavolozza direttamente sulla barra multifunzione. Questo frammento di codice fa parte dell' esempio Draw Client.

CMFCRibbonGallery *pBtnStyles = new CMFCRibbonGallery(ID_OBJECT_STYLES, _T("Styles\nk"), 0, 0, IDB_STYLES, 40);
pBtnStyles->SetIconsInRow(7);
pBtnStyles->EnableMenuResize(TRUE, TRUE);
pBtnStyles->EnableMenuSideBar();
pBtnStyles->SetButtonMode(false);
pBtnStyles->RedrawIcons();

Gerarchia di ereditarietà

CObject
└ CMFCRibbonBaseElement
 └ CMFCRibbonButton
  └ CMFCRibbonGallery

Requisiti

Intestazione: afxRibbonPaletteGallery.h

CMFCRibbonGallery::AddGroup

Aggiunge un nuovo gruppo alla raccolta.

void AddGroup(
    LPCTSTR lpszGroupName,
    UINT uiImagesPaletteResID,
    int cxPaletteImage);

void AddGroup(
    LPCTSTR lpszGroupName,
    CMFCToolBarImages& imagesGroup);

void AddGroup(
    LPCTSTR lpszGroupName,
    int nIconsNum);

Parametri

lpszGroupName
[in] Specifica il nome del gruppo.

uiImagesPaletteResID
[in] Specifica l'ID risorsa dell'elenco di immagini che contiene le immagini per il gruppo.

cxPaletteImage
[in] Specifica la larghezza in pixel di un'immagine.

imagesGroup
[in] Riferimento all'elenco di immagini che contiene immagini di gruppo.

nIconsNum
[in] Specifica il numero di icone nel gruppo. Questo parametro deve essere specificato solo per i gruppi personalizzati (disegnati dal proprietario).

Osservazioni:

È possibile dividere gli elementi in una raccolta della barra multifunzione in più gruppi chiamando questo metodo. Ogni gruppo può avere una didascalia.

CMFCRibbonGallery::AddSubItem

Aggiunge una nuova voce di menu al menu a discesa.

void AddSubItem(
    CMFCRibbonBaseElement* pSubItem,
    int nIndex=-1,
    BOOL bOnTop=FALSE);

Parametri

pSubItem
[in] Puntatore all'elemento da aggiungere al menu.

nIndex
[in] Specifica l'indice in base zero di una posizione in cui inserire l'elemento.

bOnTop
[in] TRUE per specificare che l'elemento deve essere inserito prima della raccolta della barra multifunzione; in caso contrario, FALSE.

Osservazioni:

È possibile combinare raccolte popup con voci di menu popup chiamando questo metodo. Le voci di menu possono essere inserite prima o dopo la raccolta.

Per inserire l'elemento prima della raccolta, impostare bOnTop su TRUE. Impostare bOnTop su FALSE per inserire l'elemento sotto la raccolta.

Nota

Il parametro nIndex specifica l'indice di inserimento sia nella parte superiore della raccolta che nella parte inferiore della raccolta. Ad esempio, se è necessario inserire un elemento una posizione prima della raccolta, impostare nIndex su 1 e bOnTop su TRUE. Analogamente, se è necessario inserire un elemento una posizione sotto la raccolta, impostare nIndex su 1 e bOnTop su FALSE.

CMFCRibbonGallery::Clear

Cancella il contenuto della raccolta.

virtual void Clear();

Osservazioni:

Chiamare questo metodo per rimuovere tutto il contenuto dalla raccolta della barra multifunzione. Questa operazione deve essere eseguita prima di collegare una nuova raccolta della barra multifunzione o un set di gruppi alla raccolta della barra multifunzione.

CMFCRibbonGallery::CMFCRibbonGallery

Costruisce e inizializza un oggetto CMFCRibbonGallery .

CMFCRibbonGallery (
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    int nLargeImageIndex,
    CMFCToolBarImages& imagesPalette);

CMFCRibbonGallery (
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    int nLargeImageIndex,
    UINT uiImagesPaletteResID=0,
    int cxPaletteImage=0);

CMFCRibbonGallery (
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    int nLargeImageIndex,
    CSize sizeIcon,
    int nIconsNum,
    BOOL bDefaultButtonStyle=TRUE);

Parametri

nID
Specifica l'ID comando del comando da eseguire quando un utente fa clic sul pulsante.

lpszText
Specifica il testo da visualizzare sul pulsante.

nSmallImageIndex
Indice in base zero dell'immagine piccola da visualizzare sul pulsante.

nLargeImageIndex
Indice in base zero dell'immagine di grandi dimensioni da visualizzare sul pulsante.

imagesPalette
Riferimento all'oggetto CMFCToolBarImages che contiene le immagini da visualizzare nella raccolta.

uiImagesPaletteResID
ID risorsa dell'elenco di immagini da visualizzare nella raccolta.

cxPaletteImage
Specifica la larghezza, in pixel, dell'immagine nella raccolta.

sizeIcon
Specifica le dimensioni, in pixel, dell'immagine della raccolta.

nIconsNum
Specifica il numero di icone nella raccolta.

bDefaultButtonStyle
Specifica se utilizzare lo stile predefinito o il pulsante disegnato dal proprietario.

Osservazioni:

CMFCRibbonGallery::EnableMenuResize

Abilita o disabilita il ridimensionamento del pannello dei menu.

void EnableMenuResize(
    BOOL bEnable = TRUE,
    BOOL bVertcalOnly = FALSE);

Parametri

bEnable
[in] TRUE per abilitare il ridimensionamento del menu; in caso contrario, FALSE.

bVertcalOnly
[in] TRUE per specificare che la raccolta può essere ridimensionata solo verticalmente; FALSE per specificare che la raccolta può essere ridimensionata sia verticalmente che orizzontalmente.

Osservazioni:

Usare questo metodo per abilitare o disabilitare il ridimensionamento della raccolta della barra multifunzione. Quando il ridimensionamento è abilitato, nella raccolta della barra multifunzione viene visualizzato un gripper che un utente può usare per ridimensionarlo.

CMFCRibbonGallery::EnableMenuSideBar

Abilita o disabilita la barra laterale a sinistra del menu popup.

void EnablMenuSideBar(BOOL bEnable=TRUE);

Parametri

bEnable
[in] TRUE per specificare che la barra laterale è abilitata; in caso contrario, FALSE.

Osservazioni:

Chiamare questo metodo per abilitare o disabilitare la barra laterale di tipo Office XP sul lato sinistro del menu.

CMFCRibbonGallery::GetCompactSize

virtual CSize GetCompactSize(CDC* pDC);

Parametri

[in] pDC

Valore restituito

Osservazioni:

CMFCRibbonGallery::GetDroppedDown

virtual CMFCRibbonBaseElement* GetDroppedDown();

Valore restituito

Osservazioni:

CMFCRibbonGallery::GetGroupName

Restituisce il nome del gruppo che si trova in corrispondenza dell'indice specificato.

LPCTSTR GetGroupName(int nGroupIndex) const;

Parametri

nGroupIndex
[in] Specifica l'indice in base zero per il gruppo di cui si desidera recuperare il nome.

Valore restituito

Nome del gruppo che si trova in corrispondenza dell'indice specificato. Il passaggio di un indice non valido comporterà un'asserzione non riuscita.

Osservazioni:

CMFCRibbonGallery::GetGroupOffset

virtual int GetGroupOffset() const;

Valore restituito

Osservazioni:

CMFCRibbonGallery::GetIconsInRow

Restituisce il numero di elementi in una riga della raccolta della barra multifunzione.

int GetIconsInRow() const;

Valore restituito

Numero di elementi in una riga.

Osservazioni:

CMFCRibbonGallery::GetItemToolTip

Restituisce il testo della descrizione comando associato a un elemento nella raccolta.

LPCTSTR GetItemToolTip(int nItemIndex) const;

Parametri

nItemIndex
[in] Specifica l'indice in base zero dell'elemento per il quale recuperare il testo della descrizione comando.

Valore restituito

Puntatore alla stringa della descrizione comando assegnata a un elemento nella raccolta della barra multifunzione. Può essere NULL se non viene assegnata alcuna descrizione comando a tale elemento.

Osservazioni:

CMFCRibbonGallery::GetLastSelectedItem

Restituisce l'indice dell'ultimo elemento nella raccolta della barra multifunzione selezionato dall'utente.

static int GetLastSelectedItem(UINT uiCmdID);

Parametri

uiCmdID
[in] Specifica l'ID comando della voce di menu che ha aperto la raccolta della barra multifunzione.

Valore restituito

Quando l'utente seleziona un elemento nella raccolta della barra multifunzione, la raccolta invia il messaggio WM_COMMAND insieme all'ID comando del pulsante di menu che ha aperto la raccolta della barra multifunzione.

Osservazioni:

CMFCRibbonGallery::GetPaletteID

Restituisce l'ID del comando della tavolozza corrente.

int GetPaletteID() const;

Valore restituito

ID del comando della tavolozza attualmente selezionata.

Osservazioni:

CMFCRibbonGallery::GetRegularSize

virtual CSize GetRegularSize(CDC* pDC);

Parametri

[in] pDC

Valore restituito

Osservazioni:

CMFCRibbonGallery::GetSelectedItem

int GetSelectedItem() const;

Valore restituito

Osservazioni:

CMFCRibbonGallery::HasMenu

virtual BOOL HasMenu() const;

Valore restituito

Osservazioni:

CMFCRibbonGallery::IsButtonMode

Specifica se la tavolozza è contenuta in un pulsante della raccolta.

BOOL IsButtonMode() const;

Valore restituito

TRUE se la tavolozza viene visualizzata come pulsante di menu a discesa; FALSE se la tavolozza viene visualizzata direttamente sulla barra multifunzione.

Osservazioni:

CMFCRibbonGallery::IsMenuResizeEnabled

Specifica se il ridimensionamento del menu è abilitato.

BOOL IsMenuResizeEnabled() const;

Valore restituito

TRUE se il ridimensionamento del menu è stato abilitato; in caso contrario, FALSE.

Osservazioni:

CMFCRibbonGallery::IsMenuResizeVertical

BOOL IsMenuResizeVertical() const;

Valore restituito

Osservazioni:

CMFCRibbonGallery::IsMenuSideBar

Specifica se la barra laterale è abilitata o disabilitata.

BOOL IsMenuSideBar() const;

Valore restituito

TRUE se la barra laterale di tipo Office XP viene disegnata sul lato sinistro del menu popup; in caso contrario, FALSE.

Osservazioni:

CMFCRibbonGallery::OnAfterChangeRect

virtual void OnAfterChangeRect(CDC* pDC);

Parametri

[in] pDC

Osservazioni:

CMFCRibbonGallery::OnDraw

virtual void OnDraw(CDC* pDC);

Parametri

[in] pDC

Osservazioni:

CMFCRibbonGallery::OnDrawPaletteIcon

Chiamato dal framework quando viene disegnata un'icona della raccolta.

virtual void OnDrawPaletteIcon(
    CDC* pDC,
    CRect rectIcon,
    int nIconIndex,
    CMFCRibbonGalleryIcon* pIcon,
    COLORREF clrText);

Parametri

pDC
[in] Puntatore al contesto di dispositivo utilizzato per il disegno.

rectIcon
[in] Specifica il rettangolo di delimitazione dell'icona da disegnare.

nIconIndex
[in] Specifica l'indice in base zero nell'elenco di immagini delle icone della raccolta dell'icona da disegnare.

pIcon
[in] Puntatore all'icona disegnata.

clrText
[in] Specifica il colore del testo dell'elemento da disegnare.

Osservazioni:

È possibile eseguire l'override di questo metodo in una classe derivata per personalizzare l'aspetto di una raccolta della barra multifunzione.

CMFCRibbonGallery::OnEnable

virtual void OnEnable(BOOL bEnable);

Parametri

[in] bEnable

Osservazioni:

CMFCRibbonGallery::OnRTLChanged

virtual void OnRTLChanged(BOOL bIsRTL);

Parametri

[in] bIsRTL

Osservazioni:

CMFCRibbonGallery::RedrawIcons

Ridisegna la raccolta.

void RedrawIcons();

Osservazioni:

Chiamare questa funzione per ridisegnare la raccolta. È necessario chiamare questo metodo se il contenuto della raccolta è stato modificato in fase di esecuzione.

CMFCRibbonGallery::RemoveItemToolTips

Rimuove le descrizioni comando da tutti gli elementi della raccolta.

void RemoveItemToolTips();

Osservazioni:

CMFCRibbonGallery::SelectItem

void SelectItem(int nItemIndex);

Parametri

[in] nItemIndex

Osservazioni:

CMFCRibbonGallery::SetACCData

Popola l'oggetto CAccessibilityData specificato usando i dati di accessibilità della raccolta della barra multifunzione.

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

Parametri

pParent
[in] Finestra padre della finestra della raccolta della barra multifunzione.

data
[out] Oggetto CAccessibilityData che riceve i dati di accessibilità dalla raccolta della barra multifunzione.

Valore restituito

Osservazioni:

TRUE se il metodo ha esito positivo; in caso contrario, FALSE.

CMFCRibbonGallery::SetButtonMode

Determina se visualizzare la raccolta della barra multifunzione come pulsante a discesa o come tavolozza direttamente sulla barra multifunzione.

void SetButtonMode(BOOL bSet=TRUE);

Parametri

bSet
[in] TRUE per visualizzare la raccolta della barra multifunzione come pulsante di menu a discesa; FALSE per visualizzare il contenuto della raccolta della barra multifunzione direttamente sulla barra multifunzione.

Osservazioni:

CMFCRibbonGallery::SetGroupName

Imposta il nome di un gruppo.

void SetGroupName(
    int nGroupIndex,
    LPCTSTR lpszGroupName);

Parametri

nGroupIndex
[in] Specifica l'indice in base zero per il gruppo per il quale viene modificato il nome.

lpszGroupName
[in] Specifica il nuovo nome per il gruppo.

Osservazioni:

Il gruppo il cui nome viene modificato deve essere stato aggiunto usando il metodo CMFCRibbonGallery::AddGroup .

CMFCRibbonGallery::SetIconsInRow

Specifica il numero di elementi per riga nella raccolta.

void SetIconsInRow(int nIconsInRow);

Parametri

nIconsInRow
[in] Specifica il numero di elementi da visualizzare in ogni riga della raccolta.

Osservazioni:

Utilizzare questo metodo per specificare la larghezza della raccolta della barra multifunzione.

CMFCRibbonGallery::SetItemToolTip

Imposta il testo della descrizione comando per un elemento nella raccolta.

void SetItemToolTip(
    int nItemIndex,
    LPCTSTR lpszToolTip);

Parametri

nItemIndex
[in] Indice in base zero dell'elemento della tavolozza con cui associare la descrizione comando.

lpszToolTip
[in] Testo da visualizzare nella descrizione comando.

Osservazioni:

CMFCRibbonGallery::SetPalette

Associa una tavolozza a una raccolta della barra multifunzione.

void SetPalette(CMFCToolBarImages& imagesPalette);

void SetPalette(
    UINT uiImagesPaletteResID,
    int cxPaletteImage);

Parametri

imagesPalette
[in] Specifica l'elenco di immagini che contiene le icone da visualizzare nella raccolta.

uiImagesPaletteResID
[in] Specifica l'ID risorsa dell'elenco di immagini che contiene le icone da visualizzare nella raccolta.

cxPaletteImage
[in] Specifica la larghezza, in pixel, di un'immagine nella raccolta.

Osservazioni:

CMFCRibbonGallery::SetPaletteID

Definisce l'ID comando inviato nel messaggio WM_COMMAND quando un utente seleziona un elemento della raccolta.

void SetPaletteID(UINT nID);

Parametri

nID
[in] Specifica l'ID comando inviato nel messaggio di WM_COMMAND quando un utente seleziona un elemento della raccolta.

Osservazioni:

Per determinare l'elemento specifico selezionato da un utente dalla raccolta, chiamare il metodo statico CMFCRibbonGallery::GetLastSelectedItem .

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCRibbonButton
Classe CMFCRibbonGalleryMenuButton