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
| Ad | Tanım |
|---|---|
| CMFCRibbonButton::CMFCRibbonButton | Şerit düğmesi nesnesi oluşturur. |
Genel Yöntemler
Korumalı Yöntemler
| Ad | Tanım |
|---|---|
| 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.
Nındex
[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();
İade 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.
Hıcon
[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
İade 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
İade 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.
İade 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;
İade Değeri
Açıklamalar
CMFCRibbonButton::GetCompactSize
virtual CSize GetCompactSize(CDC* pDC);
Parametreler
[in] Pdc
İade Değeri
Açıklamalar
CMFCRibbonButton::GetIcon
HICON GetIcon(BOOL bLargeIcon = TRUE) const;
Parametreler
[in] bLargeIcon
İade 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.
İade 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ü
İade Değeri
Açıklamalar
CMFCRibbonButton::GetIntermediateSize
virtual CSize GetIntermediateSize(CDC* pDC);
Parametreler
[in] Pdc
İade Değeri
Açıklamalar
CMFCRibbonButton::GetMenu
Şerit düğmesine atanmış bir Windows menüsü tutamacını döndürür.
HMENU GetMenu() const;
İade Değeri
Düğmeye atanmış bir Windows menüsünün tutamacı; Menü atanmamışsa NULL.
CMFCRibbonButton::GetMenuRect
CRect GetMenuRect() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::GetRegularSize
virtual CSize GetRegularSize(CDC* pDC);
Parametreler
[in] Pdc
İade Değeri
Açıklamalar
CMFCRibbonButton::GetSubItems
const CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& GetSubItems() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::GetTextRowHeight
int GetTextRowHeight() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::GetToolTipText
virtual CString GetToolTipText() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::HasCompactMode
virtual BOOL HasCompactMode() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::HasIntermediateMode
virtual BOOL HasIntermediateMode() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::HasLargeMode
virtual BOOL HasLargeMode() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::HasMenu
virtual BOOL HasMenu() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::IsAlwaysDrawBorder
virtual BOOL IsAlwaysDrawBorder() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::IsAlwaysLargeImage
virtual BOOL IsAlwaysLargeImage() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::IsApplicationButton
virtual BOOL IsApplicationButton() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::IsCommandAreaHighlighted
virtual BOOL IsCommandAreaHighlighted() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::IsDefaultCommand
Şerit düğmesi için varsayılan komutun etkinleştirilip etkinleştirilmediğini belirtir.
BOOL IsDefaultCommand() const;
İade Değeri
Şerit düğmesi için varsayılan komutu etkinleştirdiyseniz TRUE; FALSE aksi takdirde.
CMFCRibbonButton::IsDefaultPanelButton
virtual BOOL IsDefaultPanelButton() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::IsDrawTooltipImage
virtual BOOL IsDrawTooltipImage() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::IsLargeImage
BOOL IsLargeImage() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::IsMenuAreaHighlighted
virtual BOOL IsMenuAreaHighlighted() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::IsMenuOnBottom
BOOL IsMenuOnBottom() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::IsPopupDefaultMenuLook
virtual BOOL IsPopupDefaultMenuLook() const;
İade Değeri
Açıklamalar
CMFCRibbonButton::IsRightAlignMenu
Menünün sağa hizalı olup olmadığını belirtir.
BOOL IsRightAlignMenu() const;
İade Değeri
Menü sağa hizalıysa DOĞRU; aksi takdirde YANLIŞ.
CMFCRibbonButton::IssingleLineText
BOOL IsSingleLineText() const;
İade 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
İade 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
Nındex
[in] Kaldırmak istediğiniz menü öğesinin sıfır tabanlı dizinini belirtir.
İade 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.
Veri
Şerit öğesinin erişilebilirlik verileri.
İade 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
Nındex
[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.
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin