CMFCRibbonButtonsGroup Sınıfı

sınıfı, CMFCRibbonButtonsGroup şerit düğmeleri kümesini bir grup halinde düzenlemenize olanak tanır. Gruptaki tüm düğmeler yatay olarak birbirine doğrudan bitişiktir ve kenarlık içine alınır.

Sözdizimi

class CMFCRibbonButtonsGroup : public CMFCRibbonBaseElement

Üyeler

Ortak Oluşturucular

Ad	Tanım
CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup	Bir CMFCRibbonButtonsGroup nesne oluşturur.

Genel Yöntemler

Ad	Tanım
CMFCRibbonButtonsGroup::AddButton	Gruba bir düğme ekler.
CMFCRibbonButtonsGroup::AddButtons	Gruba düğme listesi ekler.
CMFCRibbonButtonsGroup::GetButton	Belirtilen dizinde bulunan düğmeye bir işaretçi döndürür.
CMFCRibbonButtonsGroup::GetCount	Gruptaki düğmelerin sayısını döndürür.
CMFCRibbonButtonsGroup::GetImageSize	Şerit grubundaki normal görüntülerin görüntü boyutunu döndürür (CMFCRibbonBaseElement::GetImageSize öğesini geçersiz kılar.)
CMFCRibbonButtonsGroup::GetRegularSize	Şerit öğesinin normal boyutunu döndürür (CMFCRibbonBaseElement::GetRegularSize öğesini geçersiz kılar.)
CMFCRibbonButtonsGroup::HasImages	Nesnenin CMFCRibbonButtonsGroup araç çubuğu görüntüleri içerip içermediğini bildirir.
CMFCRibbonButtonsGroup::OnDrawImage	Düğmenin normal, vurgulanmış veya devre dışı olmasına bağlı olarak, belirtilen düğme için uygun görüntüyü çizer.
CMFCRibbonButtonsGroup::RemoveAll	Nesneden CMFCRibbonButtonsGroup tüm düğmeleri kaldırır.
CMFCRibbonButtonsGroup::SetImages	Gruba görüntüler atar.
CMFCRibbonButtonsGroup::SetParentCategory	Nesnenin CMFCRibbonButtonsGroup üst CMFCRibbonCategory öğesini ve içindeki tüm düğmeleri ayarlar (CMFCRibbonBaseElement::SetParentCategory'yi geçersiz kılar.)

Açıklamalar

Grup CMFCBaseRibbonElement'ten türetilir ve tek bir varlık olarak değiştirilebilir. Grubu herhangi bir panele veya açılır menüye yerleştirebilirsiniz.

Örnek

Aşağıdaki örnekte, sınıftaki çeşitli yöntemlerin nasıl kullanılacağı gösterilmektedir CMFCRibbonButtonsGroup . Örnekte bir CMFCRibbonButtonsGroup nesne oluşturma, şerit düğmeleri grubuna resim atama ve şerit düğmeleri grubuna düğme ekleme işlemi gösterilmektedir. Bu kod parçacığı, draw client örneğinin bir parçasıdır.

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"));

Devralma Hiyerarşisi

Cobject

CMFCRibbonBaseElement

CMFCRibbonButtonsGroup

Gereksinimler

Üst bilgi: afxribbonbuttonsgroup.h

CMFCRibbonButtonsGroup::AddButton

Gruba bir düğme ekler.

void AddButton(CMFCRibbonBaseElement* pButton);

Parametreler

pButton
[in] Eklenecek düğme işaretçisi.

CMFCRibbonButtonsGroup::AddButtons

Gruba düğme listesi ekler.

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

Parametreler

lstButtons
[in] Eklemek istediğiniz düğmelerin işaretçilerinin listesi.

CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup

Bir CMFCRibbonButtonsGroup nesne oluşturur.

CMFCRibbonButtonsGroup();
CMFCRibbonButtonsGroup(CMFCRibbonBaseElement* pButton);

Parametreler

pButton
[in] Yeni oluşturulan CMFCRibbonButtonsGroup nesneye eklenecek düğmeyi belirtir.

İade Değeri

Açıklamalar

CMFCRibbonButtonsGroup::GetButton

Belirtilen dizinde bulunan düğmeye bir işaretçi döndürür.

CMFCRibbonBaseElement* GetButton(int i) const;

Parametreler

ı
[in] Döndürülecek düğmenin sıfır tabanlı dizini.

İade Değeri

Belirtilen dizinde bulunan düğmenin işaretçisi. Belirtilen dizin aralık dışındaysa NULL.

Açıklamalar

CMFCRibbonButtonsGroup::GetCount

Gruptaki düğmelerin sayısını döndürür.

int GetCount() const;

İade Değeri

Gruptaki düğmelerin sayısı.

CMFCRibbonButtonsGroup::GetImageSize

Korumalı CMFCToolBarImages üyenin m_Imageskaynak görüntü boyutunu alır.

const CSize GetImageSize() const;

İade Değeri

Varsa araç çubuğu görüntülerinin kaynak görüntü boyutunu veya CSize yoksa sıfırı döndürür.

Açıklamalar

CMFCRibbonButtonsGroup::GetRegularSize

Şerit grubu öğesinin mümkün olan en büyük boyutunu alır.

virtual CSize GetRegularSize(CDC* pDC);

Parametreler

Pdc
[in] Şerit grubunun cihaz bağlamının işaretçisi.

İade Değeri

Açıklamalar

CMFCRibbonButtonsGroup::HasImages

Nesnenin CMFCRibbonButtonsGroup araç çubuğu görüntüleri içerip içermediğini bildirir.

BOOL HasImages() const;

İade Değeri

Korumalı CMFCToolBarImages üye m_Images herhangi bir görüntü içeriyorsa TRUE veya değilse YANLIŞ döndürür.

Açıklamalar

CMFCRibbonButtonsGroup::OnDrawImage

Düğmenin normal, vurgulanmış veya devre dışı olmasına bağlı olarak, belirtilen düğme için uygun görüntüyü çizer.

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

Parametreler

Pdc
[in] Nesnenin cihaz bağlamının işaretçisi CMFCRibbonButtonsGroup .

rectImage
[in] Resmin çizildiği dikdörtgen.

pButton
[in] Resmin çizildiği düğme.

nImageIndex
[in] Düğmenin üzerine çizilen görüntünün dizini (normal, vurgulanmış veya devre dışı düğmelerin üç görüntü dizilerinden birinde).

Açıklamalar

CMFCRibbonButtonsGroup::RemoveAll

Nesneden CMFCRibbonButtonsGroup tüm düğmeleri kaldırır.

void RemoveAll();

Açıklamalar

CMFCRibbonButtonsGroup::SetImages

Şerit düğmeleri grubuna görüntüler atar.

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

Parametreler

pImages
[in] Normal görüntüler.

pHotImages
[in] Sık kullanılan görüntüler.

pDisabledImages
[in] Devre dışı bırakılan görüntüler.

Açıklamalar

Gruba düğme eklemeden önce arayın SetImages . Görüntü sayısı, gruba eklenecek düğme sayısına eşit veya daha büyük olmalıdır.

Dekont

Sık erişimli görüntüler, kullanıcı düğmenin üzerine geldiğinde görüntülenen görüntülerdir. Devre dışı bırakılan görüntüler, düğme devre dışı bırakıldığında görüntülenen görüntülerdir.

CMFCRibbonButtonsGroup::SetParentCategory

Nesnenin üst CMFCRibbonCategory öğesini CMFCRibbonButtonsGroup ve içindeki tüm düğmeleri ayarlar.

virtual void SetParentCategory(CMFCRibbonCategory* pCategory);

Parametreler

pCategory
[in] Ayarlanacağı üst kategori işaretçisi (şerit denetimlerindeki sekmeli gruplara kategori adı verilir).

Açıklamalar

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar