CMFCRibbonButtonsGroup Sınıfı

Not

Microsoft Foundation Sınıfları (MFC) kitaplığına destek verilmeye devam ediliyor. Ancak artık özellik eklemeyeceğiz veya belgeleri güncelleştirmeyeceğiz.

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

Veri Akışı Adı	Açıklama
CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup	Bir CMFCRibbonButtonsGroup nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
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 CMFCRibbonCategory üst CMFCRibbonButtonsGroup öğ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.

Dönüş 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

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

Dönüş 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;

Dönüş Değeri

Gruptaki düğmelerin sayısı.

CMFCRibbonButtonsGroup::GetImageSize

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

const CSize GetImageSize() const;

Dönüş 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.

Dönüş Değeri

Açıklamalar

CMFCRibbonButtonsGroup::HasImages

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

BOOL HasImages() const;

Dönüş 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.

Not

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