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
| Nome | Descrizione |
|---|---|
| CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup | Costruisce un oggetto CMFCRibbonButtonsGroup. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CMFCRibbonButtonsGroup::AddButton | Aggiunge un pulsante a un gruppo. |
| CMFCRibbonButtonsGroup::AddButtons | Aggiunge un elenco di pulsanti a un gruppo. |
| CMFCRibbonButtonsGroup::GetButton | Restituisce un puntatore al pulsante che si trova in corrispondenza di un indice specificato. |
| CMFCRibbonButtonsGroup::GetCount | Restituisce il numero di pulsanti nel gruppo. |
| CMFCRibbonButtonsGroup::GetImageSize | Restituisce le dimensioni delle immagini normali nel gruppo della barra multifunzione (esegue l'override di CMFCRibbonBaseElement::GetImageSize). |
| CMFCRibbonButtonsGroup::GetRegularSize | Restituisce le dimensioni regolari dell'elemento della barra multifunzione (esegue l'override di CMFCRibbonBaseElement::GetRegularSize). |
| CMFCRibbonButtonsGroup::HasImages | Indica se l'oggetto CMFCRibbonButtonsGroup contiene immagini della barra degli strumenti. |
| CMFCRibbonButtonsGroup::OnDrawImage | Disegna l'immagine appropriata per un pulsante specificato, a seconda che il pulsante sia normale, evidenziato o disabilitato. |
| CMFCRibbonButtonsGroup::RemoveAll | Rimuove tutti i pulsanti dall'oggetto CMFCRibbonButtonsGroup . |
| CMFCRibbonButtonsGroup::SetImages | Assegna immagini al gruppo. |
| CMFCRibbonButtonsGroup::SetParentCategory | Imposta l'elemento padre CMFCRibbonCategory dell'oggetto CMFCRibbonButtonsGroup e tutti i pulsanti all'interno di esso (esegue l'override di CMFCRibbonBaseElement::SetParentCategory). |
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à
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.
Nota
Le immagini ad accesso frequente sono immagini visualizzate quando l'utente passa il mouse sul pulsante. Le immagini disabilitate sono immagini visualizzate quando il pulsante è disabilitato.
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).