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