CMFCRibbonButton sınıfı

Makale
02/26/2013

CMFCRibbonButton Sınıfı, paneller, hızlı erişim araç çubukları ve kısayol menüleri gibi şerit çubuğu öğeleri üzerinde konumlandırmak düğmeleri uygular.

class CMFCRibbonButton : public CMFCRibbonBaseElement

Üyeler

Ortak Oluşturucusu

Ad	Description
CMFCRibbonButton::CMFCRibbonButton	Kurdele düğme nesnesi oluşturur.

Public yöntemler

Ad	Description
CMFCRibbonButton::AddSubItem	Düğmeyle ilişkili açılır menüsünde bir menü öğesi ekler.
CMFCRibbonButton::CanBeStretched	(Geçersiz kılar CMFCRibbonBaseElement::CanBeStretched.)
CMFCRibbonButton::CleanUpSizes	(Geçersiz kılar CMFCRibbonBaseElement::CleanUpSizes.)
CMFCRibbonButton::ClosePopupMenu	(Geçersiz kılar CMFCRibbonBaseElement::ClosePopupMenu.)
CMFCRibbonButton::DrawBottomText
CMFCRibbonButton::DrawImage	(Geçersiz kılar CMFCRibbonBaseElement::DrawImage.)
CMFCRibbonButton::DrawRibbonText
CMFCRibbonButton::FindSubItemIndexByID	Belirtilen komut kimliği ile ilişkili bir açılır menü öğesi dizinini döndürür
CMFCRibbonButton::GetCommandRect
CMFCRibbonButton::GetCompactSize	Şerit öğesi kompakt boyutuna döndürür.(Geçersiz kılar CMFCRibbonBaseElement::GetCompactSize.)
CMFCRibbonButton::GetIcon
CMFCRibbonButton::GetImageIndex	Düğmeyle ilişkili görüntü dizinini döndürür.
CMFCRibbonButton::GetImageSize	Şerit öğesi görüntü boyutunu döndürür.(Geçersiz kılar CMFCRibbonBaseElement::GetImageSize.)
CMFCRibbonButton::GetIntermediateSize	Şerit öğesi boyutunu Ara durumuna döndürür.(Geçersiz kılar CMFCRibbonBaseElement::GetIntermediateSize.)
CMFCRibbonButton::GetMenu	Kurdele düğmeye atanmış bir Windows menüsü için bir tanıtıcı döndürür.
CMFCRibbonButton::GetMenuRect
CMFCRibbonButton::GetRegularSize	Şerit öğesi normal boyutuna döndürür.(Geçersiz kılar CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonButton::GetSubItems
CMFCRibbonButton::GetTextRowHeight
CMFCRibbonButton::GetToolTipText	Kurdele öğesinin ToolTip metni döndürür.(Geçersiz kılar CMFCRibbonBaseElement::GetToolTipText.)
CMFCRibbonButton::HasCompactMode	Kompakt moda şerit öğesi olup olmadığını belirtir.(Geçersiz kılar CMFCRibbonBaseElement::HasCompactMode.)
CMFCRibbonButton::HasIntermediateMode	Şerit öğesi Ara modunda olup olmadığını belirtir.(Geçersiz kılar CMFCRibbonBaseElement::HasIntermediateMode.)
CMFCRibbonButton::HasLargeMode	Büyük mod şerit öğesi olup olmadığını belirler.(Geçersiz kılar CMFCRibbonBaseElement::HasLargeMode.)
CMFCRibbonButton::HasMenu	(Geçersiz kılar CMFCRibbonBaseElement::HasMenu.)
CMFCRibbonButton::IsAlwaysDrawBorder
CMFCRibbonButton::IsAlwaysLargeImage	(Geçersiz kılar CMFCRibbonBaseElement::IsAlwaysLargeImage.)
CMFCRibbonButton::IsApplicationButton
CMFCRibbonButton::IsCommandAreaHighlighted
CMFCRibbonButton::IsDefaultCommand	Kurdele düğmesi için varsayılan komut etkin olup olmadığını belirler.
CMFCRibbonButton::IsDefaultPanelButton
CMFCRibbonButton::IsDrawTooltipImage
CMFCRibbonButton::IsLargeImage
CMFCRibbonButton::IsMenuAreaHighlighted
CMFCRibbonButton::IsMenuOnBottom
CMFCRibbonButton::IsPopupDefaultMenuLook
CMFCRibbonButton::IsRightAlignMenu	Menüyü sağa hizalı olup olmadığını belirler.
CMFCRibbonButton::IsSingleLineText
CMFCRibbonButton::OnCalcTextSize	(Geçersiz kılar CMFCRibbonBaseElement::OnCalcTextSize.)
CMFCRibbonButton::OnDrawBorder
CMFCRibbonButton::OnDraw	Şerit öğesi çizmek için çerçevesi tarafından çağrıldı.(Geçersiz kılar CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonButton::OnFillBackground
CMFCRibbonButton::RemoveAllSubItems	Açılan menüde tüm menü öğelerini kaldırır.
CMFCRibbonButton::RemoveSubItem	Açılır menüden bir menü öğesini kaldırır.
CMFCRibbonButton::SetACCData	(Geçersiz kılar CMFCRibbonBaseElement::SetACCData.)
CMFCRibbonButton::SetAlwaysLargeImage	Kullanıcı düğmeyi daraltıldığında düğme geniş görüntüler ya da küçük bir görüntü belirtir.
CMFCRibbonButton::SetDefaultCommand	Kurdele düğmesi için varsayılan komut sağlar.
CMFCRibbonButton::SetDescription	Şerit öğesi için açıklama ayarlar.(Geçersiz kılar CMFCRibbonBaseElement::SetDescription.)
CMFCRibbonButton::SetImageIndex	Bir dizin düğme resminin atar.
CMFCRibbonButton::SetMenu	Bir açılır menü şerit düğmeye atar.
CMFCRibbonButton::SetParentCategory	(Geçersiz kılar CMFCRibbonBaseElement::SetParentCategory.)
CMFCRibbonButton::SetRightAlignMenu	Açılır menü düğmesini sağa hizalar.
CMFCRibbonButton::SetText	Şerit öğesi için metni ayarlar.(Geçersiz kılar CMFCRibbonBaseElement::SetText.)

Korumalı yöntemleri

Ad	Description
CMFCRibbonButton::OnClick	Kullanıcı düğmeyi tıkladığında çerçevesi tarafından çağrıldı.

Örnek

Aşağıdaki örnekte çeşitli yöntemlerle kullanımı gösterilmiştir CMFCRibbonButton sınıfı.Bir nesnenin nasıl örnek gösterir CMFCRibbonButton sınıf, bir açılır menü şerit düğmeye atamak Ayarla düğmesinin açıklaması, açılır menüden bir menü öğesini kaldır ve açılır menü düğmesi kenarını sağa hizalamak için.

    strTemp.LoadString(IDS_RIBBON_STYLE);
    // The first parameter is the command ID of the button.
    // The third parameter is a zero-based index of the button's small image in the 
    // image list of the parent category.
    // The fourth parameter is a zero-based index of the button's large image in the 
    // image list of the parent category.
    CMFCRibbonButton* pVisualStyleButton = new CMFCRibbonButton(1, strTemp, -1, -1);
    
    pVisualStyleButton->SetMenu(IDR_THEME_MENU, TRUE, TRUE);

    strTemp.LoadString(IDS_RIBBON_STYLE_TIP);
    pVisualStyleButton->SetToolTipText(strTemp);
    strTemp.LoadString(IDS_RIBBON_STYLE_DESC);
    pVisualStyleButton->SetDescription(strTemp);
    pVisualStyleButton->RemoveSubItem(0);
    pVisualStyleButton->SetRightAlignMenu(TRUE);

Notlar

Kurdele düğmeyi bir uygulamada kullanmak için düğme nesnesi oluşturmak ve uygun Şeride eklemek panel.

CMFCRibbonPanel* pPanel = pCategory->AddPanel (
    _T("Clipboard"),                       // Panel name
    m_PanelIcons.ExtractIcon (0));  // Panel icon
// Create the first button ("Paste"):
CMFCRibbonButton* pPasteButton = 
    new CMFCRibbonButton (ID_EDIT_PASTE, _T("Paste"), -1, 0);
// The third parameter (-1) disables small images for button.
// This button is always displayed with a large image
// Associate a pop-up menu with the "Paste" button:
pPasteButton->SetMenu (IDR_CONTEXT_MENU);
// Add buttons to the panel. These buttons have only small images.
pPanel->Add (new CMFCRibbonButton (ID_EDIT_CUT, _T("Cut"), 1));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_COPY, _T("Copy"), 2));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_PAINT, _T("Paint"), 9));