Aracılığıyla paylaş

CMFCRibbonButton Sınıfı

sınıfı, CMFCRibbonButton paneller, Hızlı Erişim Araç Çubukları ve açılır menüler gibi şerit çubuğu öğelerine yerleştirebileceğiniz düğmeler uygular.

Daha fazla ayrıntı için Visual Studio yüklemenizin VC\atlmfc\src\mfc klasöründe bulunan kaynak koduna bakın.

Sözdizimi

class CMFCRibbonButton : public CMFCRibbonBaseElement

Üyeler

Ortak Oluşturucular

Veri Akışı Adı Açıklama
CMFCRibbonButton::CMFCRibbonButton Şerit düğmesi nesnesi oluşturur.

Genel Yöntemler

Veri Akışı Adı Açıklama
CMFCRibbonButton::AddSubItem Düğmeyle ilişkili açılır menüye bir menü öğesi ekler.
CMFCRibbonButton::CanBeStretched (Geçersiz Kılmalar CMFCRibbonBaseElement::CanBeStretched.)
CMFCRibbonButton::CleanUpSizes (Geçersiz Kılmalar CMFCRibbonBaseElement::CleanUpSizes.)
CMFCRibbonButton::ClosePopupMenu (Geçersiz Kılmalar CMFCRibbonBaseElement::ClosePopupMenu.)
CMFCRibbonButton::D rawBottomText
CMFCRibbonButton::D rawImage (Geçersiz Kılmalar CMFCRibbonBaseElement::D rawImage.)
CMFCRibbonButton::D rawRibbonText
CMFCRibbonButton::FindSubItemIndexByID Belirtilen komut kimliğiyle ilişkilendirilmiş bir açılır menü öğesinin dizinini döndürür.
CMFCRibbonButton::GetCommandRect
CMFCRibbonButton::GetCompactSize Şerit öğesinin küçük boyutunu döndürür. (Geçersiz Kılmalar CMFCRibbonBaseElement::GetCompactSize.)
CMFCRibbonButton::GetIcon
CMFCRibbonButton::GetImageIndex Düğmeyle ilişkili görüntünün dizinini döndürür.
CMFCRibbonButton::GetImageSize Şerit öğesinin görüntü boyutunu döndürür. (Geçersiz Kılmalar CMFCRibbonBaseElement::GetImageSize.)
CMFCRibbonButton::GetIntermediateSize Şerit öğesinin boyutunu ara durumunda döndürür. (Geçersiz Kılmalar CMFCRibbonBaseElement::GetIntermediateSize.)
CMFCRibbonButton::GetMenu Şerit düğmesine atanmış bir Windows menüsü tutamacını döndürür.
CMFCRibbonButton::GetMenuRect
CMFCRibbonButton::GetRegularSize Şerit öğesinin normal boyutunu döndürür. (Geçersiz Kılmalar CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonButton::GetSubItems
CMFCRibbonButton::GetTextRowHeight
CMFCRibbonButton::GetToolTipText Şerit öğesinin araç ipucu metnini döndürür. (Geçersiz Kılmalar CMFCRibbonBaseElement::GetToolTipText.)
CMFCRibbonButton::HasCompactMode Şerit öğesinin sıkıştırılmış bir moda sahip olup olmadığını belirtir. (Geçersiz Kılmalar CMFCRibbonBaseElement::HasCompactMode.)
CMFCRibbonButton::HasIntermediateMode Şerit öğesinin ara moda sahip olup olmadığını belirtir. (Geçersiz Kılmalar CMFCRibbonBaseElement::HasIntermediateMode.)
CMFCRibbonButton::HasLargeMode Şerit öğesinin büyük bir moda sahip olup olmadığını belirler. (Geçersiz Kılmalar CMFCRibbonBaseElement::HasLargeMode.)
CMFCRibbonButton::HasMenu (Geçersiz Kılmalar CMFCRibbonBaseElement::HasMenu.)
CMFCRibbonButton::IsAlwaysDrawBorder
CMFCRibbonButton::IsAlwaysLargeImage (Geçersiz Kılmalar CMFCRibbonBaseElement::IsAlwaysLargeImage.)
CMFCRibbonButton::IsApplicationButton
CMFCRibbonButton::IsCommandAreaHighlighted
CMFCRibbonButton::IsDefaultCommand Şerit düğmesi için varsayılan komutu etkinleştirip etkinleştirmediğiniz belirler.
CMFCRibbonButton::IsDefaultPanelButton
CMFCRibbonButton::IsDrawTooltipImage
CMFCRibbonButton::IsLargeImage
CMFCRibbonButton::IsMenuAreaHighlighted
CMFCRibbonButton::IsMenuOnBottom
CMFCRibbonButton::IsPopupDefaultMenuLook
CMFCRibbonButton::IsRightAlignMenu Menünün sağa hizalı olup olmadığını belirler.
CMFCRibbonButton::IssingleLineText
CMFCRibbonButton::OnCalcTextSize (Geçersiz Kılmalar CMFCRibbonBaseElement::OnCalcTextSize.)
CMFCRibbonButton::OnDrawBorder
CMFCRibbonButton::OnDraw Şerit öğesini çizmek için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonButton::OnFillBackground
CMFCRibbonButton::RemoveAllSubItems Açılır menüden 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ılmalar CMFCRibbonBaseElement::SetACCData.)
CMFCRibbonButton::SetAlwaysLargeImage Kullanıcı düğmeyi daralttığında düğmenin büyük veya küçük bir görüntü görüntüleyip görüntülemeyeceğini belirtir.
CMFCRibbonButton::SetDefaultCommand Şerit düğmesi için varsayılan komutu etkinleştirir.
CMFCRibbonButton::SetDescription Şerit öğesinin açıklamasını ayarlar. (Geçersiz Kılmalar CMFCRibbonBaseElement::SetDescription.)
CMFCRibbonButton::SetImageIndex Düğmenin görüntüsüne bir dizin atar.
CMFCRibbonButton::SetMenu Şerit düğmesine bir açılır menü atar.
CMFCRibbonButton::SetParentCategory (Geçersiz Kılmalar CMFCRibbonBaseElement::SetParentCategory.)
CMFCRibbonButton::SetRightAlignMenu Açılır menüyü düğmenin sağındaki hizalar.
CMFCRibbonButton::SetText Şerit öğesinin metnini ayarlar. (Geçersiz Kılmalar CMFCRibbonBaseElement::SetText.)

Korumalı Yöntemler

Veri Akışı Adı Açıklama
CMFCRibbonButton::OnClick Kullanıcı düğmeye tıkladığında çerçeve tarafından çağrılır.

Örnek

Aşağıdaki örnekte, sınıfındaki çeşitli yöntemlerin nasıl kullanılacağı gösterilmektedir CMFCRibbonButton . Örnekte, sınıfın bir nesnesini oluşturma CMFCRibbonButton , şerit düğmesine açılır menü atama, düğmenin açıklamasını ayarlama, açılır menüden bir menü öğesini kaldırma ve açılır menüyü düğmenin kenarına sağ hizalama gösterilmektedir.

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

Açıklamalar

Uygulamada şerit düğmesi kullanmak için düğme nesnesini oluşturun ve uygun şerit paneline ekleyin.

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

Devralma Hiyerarşisi

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

Gereksinimler

Üst bilgi: afxribbonbutton.h

CMFCRibbonButton::AddSubItem

Düğmeyle ilişkili açılır menüye bir menü öğesi ekler.

void AddSubItem(
    CMFCRibbonBaseElement* pSubItem,
    int nIndex=-1);

Parametreler

pSubItem
[in] Eklenecek yeni öğenin işaretçisini belirtir.

nIndex
[in] öğesinin düğmenin menü öğeleri dizisine ekleneceği dizini belirtir; -1 öğesini menü öğeleri dizisinin sonuna eklemek için.

CMFCRibbonButton::CanBeStretched

virtual BOOL CanBeStretched();

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::CleanUpSizes

virtual void CleanUpSizes();

Açıklamalar

CMFCRibbonButton::ClosePopupMenu

virtual void ClosePopupMenu();

Açıklamalar

CMFCRibbonButton::CMFCRibbonButton

Şerit düğmesi nesnesi oluşturur.

CMFCRibbonButton(
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex=-1,
    int nLargeImageIndex=-1,
    BOOL bAlwaysShowDescription=FALSE);

CMFCRibbonButton(
    UINT nID,
    LPCTSTR lpszText,
    HICON hIcon,
    BOOL bAlwaysShowDescription=FALSE,
    HICON hIconSmall=NULL,
    BOOL bAutoDestroyIcon=FALSE,
    BOOL bAlphaBlendIcon=FALSE);

Parametreler

Nıd
[in] Düğmenin komut kimliğini belirtir.

lpszText
[in] Düğmenin metin etiketini belirtir.

nSmallImageIndex
[in] Üst kategorinin görüntü listesinde düğmenin küçük görüntüsünün sıfır tabanlı bir dizinini belirtir.

nLargeImageIndex
[in] Üst kategorinin görüntü listesinde düğmenin büyük görüntüsünün sıfır tabanlı bir dizinini belirtir.

hIcon
[in] Düğmenin görüntüsü olarak uygulamanın kullandığı simgenin tutamacını belirtir.

Örnek

Aşağıdaki örnek, bir CMFCRibbonButton nesnenin nasıl oluşturduğunu gösterir.

strTemp.LoadString(IDS_RIBBON_CUT);
CMFCRibbonButton *butn = new CMFCRibbonButton(ID_EDIT_CUT, strTemp, 1);
butn->SetKeys(_T("k"));

CMFCRibbonButton::D rawBottomText

CSize DrawBottomText(
    CDC* pDC,
    BOOL bCalcOnly);

Parametreler

[in] pDC
[in] bCalcOnly

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::D rawImage

virtual void DrawImage(
    CDC* pDC,
    RibbonImageType type,
    CRect rectImage);

Parametreler

[in] pDC
[in] tür
[in] rectImage

Açıklamalar

CMFCRibbonButton::D rawRibbonText

virtual int DrawRibbonText(
    CDC* pDC,
    const CString& strText,
    CRect rectText,
    UINT uiDTFlags,
    COLORREF clrText = (COLORREF)-1);

Parametreler

[in] pDC
[in] strText
[in] rectText
[in] uiDTFlags
[in] clrText

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::FindSubItemIndexByID

Belirtilen komut kimliğiyle ilişkilendirilmiş bir açılır menü öğesinin dizinini döndürür.

int FindSubItemIndexByID(UINT uiID) const;

Parametreler

uiID
[in] Açılır menü öğesinin komut kimliğini belirtir.

Dönüş Değeri

uiID ile ilişkili alt öğenin sıfır tabanlı dizini. Böyle bir alt öğe yoksa -1.

CMFCRibbonButton::GetCommandRect

CRect GetCommandRect() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::GetCompactSize

virtual CSize GetCompactSize(CDC* pDC);

Parametreler

[in] pDC

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::GetIcon

HICON GetIcon(BOOL bLargeIcon = TRUE) const;

Parametreler

[in] bLargeIcon

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::GetImageIndex

Düğmeyle ilişkili görüntünün dizinini döndürür.

int GetImageIndex(BOOL bLargeImage) const;

Parametreler

bLargeImage
[in] TRUE ise, büyük görüntüleri içeren görüntü listesindeki görüntü dizinini döndürür; aksi takdirde, küçük görüntüleri içeren görüntü listesinde görüntü dizinini döndürür.

Dönüş Değeri

İlişkili görüntü listesindeki düğme görüntüsünün dizini.

CMFCRibbonButton::GetImageSize

virtual CSize GetImageSize(RibbonImageType type) const;

Parametreler

[in] tür

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::GetIntermediateSize

virtual CSize GetIntermediateSize(CDC* pDC);

Parametreler

[in] pDC

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::GetMenu

Şerit düğmesine atanmış bir Windows menüsü tutamacını döndürür.

HMENU GetMenu() const;

Dönüş Değeri

Düğmeye atanmış bir Windows menüsünün tutamacı; Menü atanmamışsa NULL.

CMFCRibbonButton::GetMenuRect

CRect GetMenuRect() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::GetRegularSize

virtual CSize GetRegularSize(CDC* pDC);

Parametreler

[in] pDC

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::GetSubItems

const CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& GetSubItems() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::GetTextRowHeight

int GetTextRowHeight() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::GetToolTipText

virtual CString GetToolTipText() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::HasCompactMode

virtual BOOL HasCompactMode() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::HasIntermediateMode

virtual BOOL HasIntermediateMode() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::HasLargeMode

virtual BOOL HasLargeMode() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::HasMenu

virtual BOOL HasMenu() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::IsAlwaysDrawBorder

virtual BOOL IsAlwaysDrawBorder() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::IsAlwaysLargeImage

virtual BOOL IsAlwaysLargeImage() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::IsApplicationButton

virtual BOOL IsApplicationButton() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::IsCommandAreaHighlighted

virtual BOOL IsCommandAreaHighlighted() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::IsDefaultCommand

Şerit düğmesi için varsayılan komutun etkinleştirilip etkinleştirilmediğini belirtir.

BOOL IsDefaultCommand() const;

Dönüş Değeri

Şerit düğmesi için varsayılan komutu etkinleştirdiyseniz TRUE; FALSE aksi takdirde.

CMFCRibbonButton::IsDefaultPanelButton

virtual BOOL IsDefaultPanelButton() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::IsDrawTooltipImage

virtual BOOL IsDrawTooltipImage() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::IsLargeImage

BOOL IsLargeImage() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::IsMenuAreaHighlighted

virtual BOOL IsMenuAreaHighlighted() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::IsMenuOnBottom

BOOL IsMenuOnBottom() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::IsPopupDefaultMenuLook

virtual BOOL IsPopupDefaultMenuLook() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::IsRightAlignMenu

Menünün sağa hizalı olup olmadığını belirtir.

BOOL IsRightAlignMenu() const;

Dönüş Değeri

Menü sağa hizalıysa DOĞRU; aksi takdirde YANLIŞ.

CMFCRibbonButton::IssingleLineText

BOOL IsSingleLineText() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::OnCalcTextSize

virtual void OnCalcTextSize(CDC* pDC);

Parametreler

[in] pDC

Açıklamalar

CMFCRibbonButton::OnClick

Kullanıcı düğmeye tıkladığında çerçeve tarafından çağrılır.

virtual void OnClick(CPoint point);

Parametreler

nokta
[in] Fare tıklamasının konumunu belirtir.

Açıklamalar

Bu olayı işlemek istiyorsanız türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCRibbonButton::OnDraw

virtual void OnDraw(CDC* pDC);

Parametreler

[in] pDC

Açıklamalar

CMFCRibbonButton::OnDrawBorder

virtual void OnDrawBorder(CDC* pDC);

Parametreler

[in] pDC

Açıklamalar

CMFCRibbonButton::OnFillBackground

virtual COLORREF OnFillBackground(CDC* pDC);

Parametreler

[in] pDC

Dönüş Değeri

Açıklamalar

CMFCRibbonButton::RemoveAllSubItems

Açılır menüden tüm menü öğelerini kaldırır.

void RemoveAllSubItems();

CMFCRibbonButton::RemoveSubItem

Açılır menüden bir menü öğesini kaldırır.

BOOL RemoveSubItem(int nIndex);

Parametreler

nIndex
[in] Kaldırmak istediğiniz menü öğesinin sıfır tabanlı dizinini belirtir.

Dönüş Değeri

Belirtilen öğe başarıyla kaldırıldıysa TRUE; aksi takdirde nIndex negatifse veya açılır menüdeki menü öğelerinin sayısını aşarsa YANLIŞ.

CMFCRibbonButton::SetACCData

Şerit düğmesi için erişilebilirlik verilerini ayarlar.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parametreler

pParent
Şerit öğesinin üst penceresi.

data
Şerit öğesinin erişilebilirlik verileri.

Dönüş Değeri

Başarılı olursa DOĞRU döndürür; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonButton::SetAlwaysLargeImage

Kullanıcı düğmeyi daralttığında düğmenin büyük veya küçük bir görüntü görüntüleyip görüntülemeyeceğini belirtir.

void SetAlwaysLargeImage(BOOL bSet=TRUE);

Parametreler

bSet
[in] TRUE ise, düğme büyük bir görüntü görüntüler. Aksi takdirde düğme küçük bir görüntü görüntüler.

CMFCRibbonButton::SetDefaultCommand

Şerit düğmesi için varsayılan komutu etkinleştirir.

void SetDefaultCommand(BOOL bSet=TRUE);

Parametreler

bSet
[in] TRUE ise, düğme varsayılan komutunu yürütebilir. YANLIŞ ise, düğme varsayılan komutunu yürütemez.

Açıklamalar

bSet yalnızca düğmenin bir menüsü olduğunda geçerlidir. bSet TRUE ise, düğme varsayılan komutunu yürütebilir ve atanan açılır menü yalnızca kullanıcı düğmenin sağ kenarındaki oka tıkladığında görünür. Aksi takdirde, düğme varsayılan komutunu yürütemez ve kullanıcının düğmenin hangi alanına tıkladığına bakılmaksızın açılır menü görüntülenir.

CMFCRibbonButton::SetDescription

virtual void SetDescription(LPCTSTR lpszText);

Parametreler

[in] lpszText

Açıklamalar

CMFCRibbonButton::SetImageIndex

Düğmenin görüntüsüne bir dizin atar.

void SetImageIndex(
    int nIndex,
    BOOL bLargeImage);

Parametreler

nIndex
[in] Görüntü dizinini belirtir.

bLargeImage
[in] TRUE ise, belirtilen dizin büyük görüntülerin listesine başvurur. Aksi takdirde, dizin küçük görüntülerin listesine başvurur.

CMFCRibbonButton::SetMenu

Şerit düğmesine bir açılır menü atar.

void SetMenu(
    HMENU hMenu,
    BOOL bIsDefaultCommand=FALSE,
    BOOL bRightAlign=FALSE);

void SetMenu(
    UINT uiMenuResID,
    BOOL bIsDefaultCommand=FALSE,
    BOOL bRightAlign=FALSE);

Parametreler

hMenu
Windows menüsünün tutamacı.

bIsDefaultCommand
TRUE ise, düğme varsayılan komutunu yürütebilir; aksi takdirde, düğme bir açılır menü görüntüler.

bRightAlign
TRUE ise menü sağa hizalanır. Aksi takdirde menü sola hizalanır.

uiMenuResID
Menü kaynak kimliği.

Açıklamalar

Uygulama menüyü düğmeye atadığında, düğme sağ tarafında bir ok görüntüler. bIsDefaultCommand TRUE ise, menü yalnızca kullanıcı oka tıkladığında görünür. Kullanıcı düğmeye tıklarsa, varsayılan komutu yürütülür. bIsDefaultCommand YANLIŞ ise, düğmenin herhangi bir yerine tıklayarak menü görüntülenir.

CMFCRibbonButton::SetParentCategory

virtual void SetParentCategory(CMFCRibbonCategory* pParent);

Parametreler

[in] pParent

Açıklamalar

CMFCRibbonButton::SetRightAlignMenu

Açılır menüyü düğmenin kenarına hizalar.

void SetRightAlignMenu(BOOL bSet=TRUE);

Parametreler

bSet
[in] TRUE ise menü sağa hizalanır. Aksi takdirde, menü sola hizalı

CMFCRibbonButton::SetText

virtual void SetText(LPCTSTR lpszText);

Parametreler

[in] lpszText

Açıklamalar

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar

  • Last updated on