Klasa CMFCRibbonButtonsGroup

Klasa CMFCRibbonButtonsGroup umożliwia organizowanie zestawu przycisków wstążki w grupie. Wszystkie przyciski w grupie są bezpośrednio sąsiadujące ze sobą w poziomie i ujęte w obramowanie.

Składnia

class CMFCRibbonButtonsGroup : public CMFCRibbonBaseElement

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup	CMFCRibbonButtonsGroup Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CMFCRibbonButtonsGroup::AddButton	Dodaje przycisk do grupy.
CMFCRibbonButtonsGroup::AddButtons	Dodaje listę przycisków do grupy.
CMFCRibbonButtonsGroup::GetButton	Zwraca wskaźnik do przycisku znajdującego się w określonym indeksie.
CMFCRibbonButtonsGroup::GetCount	Zwraca liczbę przycisków w grupie.
CMFCRibbonButtonsGroup::GetImageSize	Zwraca rozmiar obrazu normalnych obrazów w grupie wstążki (zastępuje cmFCRibbonBaseElement ::GetImageSize).
CMFCRibbonButtonsGroup::GetRegularSize	Zwraca zwykły rozmiar elementu wstążki (zastępuje element CMFCRibbonBaseElement::GetRegularSize).
CMFCRibbonButtonsGroup::HasImages	Zgłasza, czy CMFCRibbonButtonsGroup obiekt zawiera obrazy paska narzędzi.
CMFCRibbonButtonsGroup::OnDrawImage	Rysuje odpowiedni obraz dla określonego przycisku, w zależności od tego, czy przycisk jest normalny, wyróżniony lub wyłączony.
CMFCRibbonButtonsGroup::RemoveAll	Usuwa wszystkie przyciski z CMFCRibbonButtonsGroup obiektu.
CMFCRibbonButtonsGroup::SetImages	Przypisuje obrazy do grupy.
CMFCRibbonButtonsGroup::SetParentCategory	Ustawia element nadrzędny CMFCRibbonCategory CMFCRibbonButtonsGroup obiektu i wszystkie przyciski w nim (zastępuje cmFCRibbonBaseElement::SetParentCategory).

Uwagi

Grupa pochodzi z elementu CMFCBaseRibbonElement i może być manipulowana jako pojedyncza jednostka. Grupę można umieścić w dowolnym panelu lub menu podręcznym.

Przykład

W poniższym przykładzie pokazano, jak używać różnych metod w CMFCRibbonButtonsGroup klasie . W przykładzie pokazano, jak utworzyć CMFCRibbonButtonsGroup obiekt, przypisać obrazy do grupy przycisków wstążki i dodać przycisk do grupy przycisków wstążki. Ten fragment kodu jest częścią przykładu 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"));

Hierarchia dziedziczenia

Obiekt CObject

CMFCRibbonBaseElement

CMFCRibbonButtonsGroup

Wymagania

Nagłówek: afxribbonbuttonsgroup.h

CMFCRibbonButtonsGroup::AddButton

Dodaje przycisk do grupy.

void AddButton(CMFCRibbonBaseElement* pButton);

Parametry

PButton
[in] Wskaźnik do przycisku do dodania.

CMFCRibbonButtonsGroup::AddButtons

Dodaje listę przycisków do grupy.

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

Parametry

lstButtons
[in] Lista wskaźników do przycisków, które chcesz dodać.

CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup

CMFCRibbonButtonsGroup Tworzy obiekt.

CMFCRibbonButtonsGroup();
CMFCRibbonButtonsGroup(CMFCRibbonBaseElement* pButton);

Parametry

PButton
[in] Określa przycisk, który ma zostać dodany do nowo utworzonego CMFCRibbonButtonsGroup obiektu.

Wartość zwracana

Uwagi

CMFCRibbonButtonsGroup::GetButton

Zwraca wskaźnik do przycisku znajdującego się w określonym indeksie.

CMFCRibbonBaseElement* GetButton(int i) const;

Parametry

i
[in] Indeks zerowy przycisku, który ma być zwracany.

Wartość zwracana

Wskaźnik do przycisku znajdującego się w określonym indeksie. Wartość NULL, jeśli określony indeks jest poza zakresem.

Uwagi

CMFCRibbonButtonsGroup::GetCount

Zwraca liczbę przycisków w grupie.

int GetCount() const;

Wartość zwracana

Liczba przycisków w grupie.

CMFCRibbonButtonsGroup::GetImageSize

Pobiera rozmiar obrazu źródłowego chronionego CMFCToolBarImages elementu członkowskiego m_Images.

const CSize GetImageSize() const;

Wartość zwracana

Zwraca rozmiar obrazu źródłowego obrazów paska narzędzi, jeśli istnieją, lub zero CSize , jeśli nie.

Uwagi

CMFCRibbonButtonsGroup::GetRegularSize

Pobiera maksymalny możliwy rozmiar elementu grupy wstążki.

virtual CSize GetRegularSize(CDC* pDC);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia grupy wstążki.

Wartość zwracana

Uwagi

CMFCRibbonButtonsGroup::HasImages

Zgłasza, czy CMFCRibbonButtonsGroup obiekt zawiera obrazy paska narzędzi.

BOOL HasImages() const;

Wartość zwracana

Zwraca wartość TRUE, jeśli chroniony element członkowski CMFCToolBarImages m_Images zawiera jakiekolwiek obrazy lub WARTOŚĆ FALSE, jeśli nie.

Uwagi

CMFCRibbonButtonsGroup::OnDrawImage

Rysuje odpowiedni obraz dla określonego przycisku, w zależności od tego, czy przycisk jest normalny, wyróżniony lub wyłączony.

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

Parametry

PDC
[in] Wskaźnik do kontekstu CMFCRibbonButtonsGroup urządzenia obiektu.

rectImage
[in] Prostokąt, w którym chcesz narysować obraz.

PButton
[in] Przycisk, dla którego chcesz narysować obraz.

nImageIndex
[in] Indeks obrazu do rysowania na przycisku (w jednej z trzech tablic obrazów dla normalnych, wyróżnionych lub wyłączonych przycisków).

Uwagi

CMFCRibbonButtonsGroup::RemoveAll

Usuwa wszystkie przyciski z CMFCRibbonButtonsGroup obiektu.

void RemoveAll();

Uwagi

CMFCRibbonButtonsGroup::SetImages

Przypisuje obrazy do grupy przycisków wstążki.

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

Parametry

pImages
[in] Zwykłe obrazy.

pHotImages
[in] Gorące obrazy.

pDisabledImages
[in] Wyłączone obrazy.

Uwagi

Wywołaj metodę SetImages przed dodaniem przycisków do grupy. Liczba obrazów musi być większa lub równa liczbie przycisków do dodania do grupy.

Uwaga

Gorące obrazy to obrazy, które są wyświetlane po umieszczeniu wskaźnika myszy użytkownika na przycisku. Wyłączone obrazy to obrazy wyświetlane po wyłączeniu przycisku.

CMFCRibbonButtonsGroup::SetParentCategory

Ustawia element nadrzędny CMFCRibbonCategory CMFCRibbonButtonsGroup obiektu i wszystkie przyciski w nim.

virtual void SetParentCategory(CMFCRibbonCategory* pCategory);

Parametry

pCategory
[in] Wskaźnik do kategorii nadrzędnej w celu ustawienia (grupy z kartami w kontrolkach wstążki są nazywane kategoriami).

Uwagi

Zobacz też

Wykres hierarchii
Klasy