Classe CMFCRibbonButtonsGroup

La CMFCRibbonButtonsGroup classe consente di organizzare un set di pulsanti della barra multifunzione in un gruppo. Tutti i pulsanti nel gruppo sono direttamente adiacenti l'uno rispetto all'altro in senso orizzontale e racchiusi da un bordo.

Sintassi

class CMFCRibbonButtonsGroup : public CMFCRibbonBaseElement

Membri

Costruttori pubblici

Metodi pubblici

Osservazioni:

Il gruppo è derivato da CMFCBaseRibbonElement e può essere modificato come singola entità. È possibile posizionare il gruppo in qualsiasi pannello o menu popup.

Esempio

L'esempio seguente illustra come usare i vari metodi nella classe CMFCRibbonButtonsGroup . Nell'esempio viene illustrato come costruire un CMFCRibbonButtonsGroup oggetto, assegnare immagini al gruppo di pulsanti della barra multifunzione e aggiungere un pulsante al gruppo di pulsanti della barra multifunzione. Questo frammento di codice fa parte dell' esempio Draw Client.

CMFCRibbonButtonsGroup *pSBGroup = new CMFCRibbonButtonsGroup;

CMFCToolBarImages images;
images.SetImageSize(CSize(14, 14));

CMFCToolBarImages hotimages;
hotimages.SetImageSize(CSize(14, 14));

if (images.Load(IDB_STATUSBAR_1) && hotimages.Load(IDB_STATUSBAR_2))
{
   pSBGroup->SetImages(&images, &hotimages, NULL);
}

pSBGroup->AddButton(new CMFCRibbonButton(ID_FILE_PRINT_PREVIEW, _T(""), 0));
pSBGroup->AddButton(new CMFCRibbonButton(ID_FILE_SUMMARYINFO, _T(""), 1));

// CMFCRibbonStatusBar m_wndStatusBar
m_wndStatusBar.AddExtendedElement(pSBGroup, _T("View Shortcuts"));

Gerarchia di ereditarietà

CObject

CMFCRibbonBaseElement

CMFCRibbonButtonsGroup

Requisiti

Intestazione: afxribbonbuttonsgroup.h

CMFCRibbonButtonsGroup::AddButton

Aggiunge un pulsante a un gruppo.

void AddButton(CMFCRibbonBaseElement* pButton);

Parametri

pButton
[in] Puntatore a un pulsante da aggiungere.

CMFCRibbonButtonsGroup::AddButtons

Aggiunge un elenco di pulsanti a un gruppo.

void AddButtons(
    const CList<CMFCRibbonBaseElement*,CMFCRibbonBaseElement*>& lstButtons);

Parametri

lstButtons
[in] Elenco di puntatori ai pulsanti da aggiungere.

CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup

Costruisce un oggetto CMFCRibbonButtonsGroup.

CMFCRibbonButtonsGroup();
CMFCRibbonButtonsGroup(CMFCRibbonBaseElement* pButton);

Parametri

pButton
[in] Specifica un pulsante da aggiungere all'oggetto appena creato CMFCRibbonButtonsGroup .

Valore restituito

Osservazioni:

CMFCRibbonButtonsGroup::GetButton

Restituisce un puntatore al pulsante che si trova in corrispondenza di un indice specificato.

CMFCRibbonBaseElement* GetButton(int i) const;

Parametri

i
[in] Indice in base zero di un pulsante da restituire.

Valore restituito

Puntatore al pulsante che si trova in corrispondenza dell'indice specificato. NULL se l'indice specificato non è compreso nell'intervallo.

Osservazioni:

CMFCRibbonButtonsGroup::GetCount

Restituisce il numero di pulsanti nel gruppo.

int GetCount() const;

Valore restituito

Numero di pulsanti nel gruppo.

CMFCRibbonButtonsGroup::GetImageSize

Recupera le dimensioni dell'immagine di origine del membro m_ImagesprotettoCMFCToolBarImages.

const CSize GetImageSize() const;

Valore restituito

Restituisce le dimensioni dell'immagine di origine delle immagini della barra degli strumenti, se presenti o pari CSize a zero in caso contrario.

Osservazioni:

CMFCRibbonButtonsGroup::GetRegularSize

Recupera le dimensioni massime possibili dell'elemento del gruppo della barra multifunzione.

virtual CSize GetRegularSize(CDC* pDC);

Parametri

pDC
[in] Puntatore al contesto di dispositivo del gruppo della barra multifunzione.

Valore restituito

Osservazioni:

CMFCRibbonButtonsGroup::HasImages

Indica se l'oggetto CMFCRibbonButtonsGroup contiene immagini della barra degli strumenti.

BOOL HasImages() const;

Valore restituito

Restituisce TRUE se il membro m_Images protetto CMFCToolBarImages contiene immagini o FALSE in caso contrario.

Osservazioni:

CMFCRibbonButtonsGroup::OnDrawImage

Disegna l'immagine appropriata per un pulsante specificato, a seconda che il pulsante sia normale, evidenziato o disabilitato.

virtual void OnDrawImage(
    CDC* pDC,
    CRect rectImage,
    CMFCRibbonBaseElement* pButton,
    int nImageIndex);

Parametri

pDC
[in] Puntatore al contesto di dispositivo dell'oggetto CMFCRibbonButtonsGroup .

rectImage
[in] Rettangolo all'interno del quale disegnare l'immagine.

pButton
[in] Pulsante per il quale disegnare l'immagine.

nImageIndex
[in] Indice dell'immagine da disegnare sul pulsante (in una delle tre matrici di immagini per i pulsanti normali, evidenziati o disabilitati).

Osservazioni:

CMFCRibbonButtonsGroup::RemoveAll

Rimuove tutti i pulsanti dall'oggetto CMFCRibbonButtonsGroup .

void RemoveAll();

Osservazioni:

CMFCRibbonButtonsGroup::SetImages

Assegna immagini al gruppo di pulsanti della barra multifunzione.

void SetImages(
    CMFCToolBarImages* pImages,
    CMFCToolBarImages* pHotImages,
    CMFCToolBarImages* pDisabledImages);

Parametri

pImages
[in] Immagini regolari.

pHotImages
[in] Immagini ad accesso frequente.

pDisabledImages
[in] Immagini disabilitate.

Osservazioni:

Chiamare SetImages prima di aggiungere pulsanti a un gruppo. Il numero di immagini deve essere maggiore o uguale al numero di pulsanti da aggiungere al gruppo.

CMFCRibbonButtonsGroup::SetParentCategory

Imposta l'elemento padre CMFCRibbonCategory dell'oggetto CMFCRibbonButtonsGroup e tutti i pulsanti al suo interno.

virtual void SetParentCategory(CMFCRibbonCategory* pCategory);

Parametri

pCategory
[in] Puntatore alla categoria padre da impostare (i gruppi a schede nei controlli della barra multifunzione sono denominati categorie).

Osservazioni:

Vedi anche

Grafico della gerarchia
Classi