`CMFCRibbonBar` Sınıf

Makale
07/05/2024

sınıfı, CMFCRibbonBar Office 2007'de kullanılana benzer bir şerit çubuğu uygular.

Daha fazla ayrıntı için Visual Studio yüklemenizin mfc klasöründe bulunan kaynak koduna bakın. Örneğin, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Sözdizimi

class CMFCRibbonBar : public CPane

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
`CMFCRibbonBar::CMFCRibbonBar`	Varsayılan oluşturucu.

Genel Yöntemler

Veri Akışı Adı	Açıklama
`CMFCRibbonBar::ActivateContextCategory`	Zaten görünür durumda olan bir bağlam kategorisini etkinleştirir.
`CMFCRibbonBar::AddCategory`	Şeride yeni bir şerit kategorisi ekler.
`CMFCRibbonBar::AddContextCategory`	Bağlam kategorisi ekler.
`CMFCRibbonBar::AddMainCategory`	Yeni bir ana şerit kategorisi ekler.
`CMFCRibbonBar::AddPrintPreviewCategory`
`CMFCRibbonBar::AddQATOnlyCategory`
`CMFCRibbonBar::AddToTabs`	Şerit çubuğunun sağ tarafına bir şerit öğesi ekleyin.
`CMFCRibbonBar::CreateEx`	Bir denetim çubuğu oluşturur ve bunu nesneye `CPane` ekler. (Geçersiz Kılmalar `CPane::CreateEx`.)
`CMFCRibbonBar::Create`	Şerit çubuğu denetimi oluşturur ve bir şerit çubuğuna ekler.
`CMFCRibbonBar::DeactivateKeyboardFocus`
`CMFCRibbonBar::DrawMenuImage`
`CMFCRibbonBar::DWMCompositionChanged`
`CMFCRibbonBar::EnableKeyTips`	Şerit denetimi için tuş ipuçlarını etkinleştirin veya devre dışı bırakın.
`CMFCRibbonBar::EnablePrintPreview`	Baskı Önizleme sekmesini etkinleştirin.
`CMFCRibbonBar::EnableToolTips`	Şerit çubuğunda araç ipuçlarını ve araç ipucu açıklamalarını etkinleştirir veya devre dışı bırakır.
`CMFCRibbonBar::FindByData`	Kullanıcının belirttiği verileri kullanarak bir şerit öğesi bulun.
`CMFCRibbonBar::FindByID`	Belirtilen komut kimliğine sahip bir şerit öğesi bulur.
`CMFCRibbonBar::FindCategoryIndexByData`	Kullanıcı tanımlı verileri içeren şerit kategorisinin dizinini bulur.
`CMFCRibbonBar::ForceRecalcLayout`
`CMFCRibbonBar::GetActiveCategory`	Etkin bir kategoriye yönelik bir işaretçi alır.
`CMFCRibbonBar::GetCaptionHeight`	Resim yazısı yüksekliğini döndürür. (Geçersiz Kılmalar `CBasePane::GetCaptionHeight`.)
`CMFCRibbonBar::GetCategory`	İşaretçiyi belirtilen dizinde bulunan bir kategoriye alır.
`CMFCRibbonBar::GetCategoryCount`	Şerit çubuğundaki şerit kategorilerinin sayısını alır.
`CMFCRibbonBar::GetCategoryHeight`
`CMFCRibbonBar::GetCategoryIndex`	Şerit kategorisinin dizinini döndürür.
`CMFCRibbonBar::GetContextName`	Kimlik kullanarak belirttiğiniz bağlam kategorisi resim yazısının adını alır.
`CMFCRibbonBar::GetDroppedDown`
`CMFCRibbonBar::GetElementsByID`	Belirtilen kimliği içeren tüm şerit öğelerinin işaretçilerini içeren bir dizi alır.
`CMFCRibbonBar::GetApplicationButton`	Şerit düğmesinin işaretçisini alır.
`CMFCRibbonBar::GetFocused`	Odaklanmış bir öğe döndürür.
`CMFCRibbonBar::GetHideFlags`
`CMFCRibbonBar::GetItemIDsList`
`CMFCRibbonBar::GetKeyboardNavigationLevel`
`CMFCRibbonBar::GetKeyboardNavLevelCurrent`
`CMFCRibbonBar::GetKeyboardNavLevelParent`
`CMFCRibbonBar::GetMainCategory`	Seçili durumdaki şerit kategorisine bir işaretçi döndürür.
`CMFCRibbonBar::GetQATCommandsLocation`
`CMFCRibbonBar::GetQATDroppedDown`
`CMFCRibbonBar::GetQuickAccessCommands`	Hızlı Erişim Araç Çubuğu'nda görünen tüm öğelerin komut kimliklerini içeren listeyi doldurur.
`CMFCRibbonBar::GetQuickAccessToolbarLocation`
`CMFCRibbonBar::GetTabTrancateRatio`
`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`
`CMFCRibbonBar::GetTooltipFixedWidthRegular`
`CMFCRibbonBar::GetVisibleCategoryCount`
`CMFCRibbonBar::HideAllContextCategories`	Etkin ve görünür olan tüm kategorileri gizler.
`CMFCRibbonBar::HideKeyTips`
`CMFCRibbonBar::HitTest`	Şerit çubuğunun istemci koordinatlarında belirtilen noktada bulunan şerit öğesinin işaretçisini bulur.
`CMFCRibbonBar::IsKeyTipEnabled`	Anahtar ipuçlarının etkinleştirilip etkinleştirilmediğini belirler.
`CMFCRibbonBar::IsMainRibbonBar`
`CMFCRibbonBar::IsPrintPreviewEnabled`	Baskı Önizleme sekmesinin etkinleştirilip etkinleştirilmediğini belirler.
`CMFCRibbonBar::IsQATEmpty`
`CMFCRibbonBar::IsQuickAccessToolbarOnTop`	Hızlı Erişim Araç Çubuğu'nda şerit çubuğunun üzerinde bulunup bulunmadığını belirtir.
`CMFCRibbonBar::IsReplaceFrameCaption`	Şerit çubuğunun ana çerçeve resim yazısının yerini alıp almayacağını veya çerçeve resim yazısının altına eklenip eklenmeyeceğini belirler.
`CMFCRibbonBar::IsShowGroupBorder`
`CMFCRibbonBar::IsToolTipDescrEnabled`	Araç ipucu açıklamalarının etkinleştirilip etkinleştirilmediğini belirler.
`CMFCRibbonBar::IsToolTipEnabled`	Şerit çubuğu için araç ipuçlarının etkinleştirilip etkinleştirilmediğini belirler.
`CMFCRibbonBar::IsTransparentCaption`
`CMFCRibbonBar::IsWindows7Look`	Şeridin Windows 7 stili bir görünüme (küçük dikdörtgen uygulama düğmesi) sahip olup olmadığını gösterir.
`CMFCRibbonBar::LoadFromResource`	Aşırı yüklendi. Uygulama kaynaklarından bir Şerit Çubuğu yükler.
`CMFCRibbonBar::OnClickButton`
`CMFCRibbonBar::OnEditContextMenu`
`CMFCRibbonBar::OnRTLChanged`	(Geçersiz Kılmalar `CPane::OnRTLChanged`.)
`CMFCRibbonBar::OnSetAccData`	(Geçersiz Kılmalar `CBasePane::OnSetAccData`.)
`CMFCRibbonBar::OnShowRibbonContextMenu`
`CMFCRibbonBar::OnShowRibbonQATMenu`
`CMFCRibbonBar::OnSysKeyDown`
`CMFCRibbonBar::OnSysKeyUp`
`CMFCRibbonBar::PopTooltip`
`CMFCRibbonBar::PreTranslateMessage`	(Geçersiz Kılmalar `CBasePane::PreTranslateMessage`.)
`CMFCRibbonBar::RecalcLayout`	(Geçersiz Kılmalar `CPane::RecalcLayout`.)
`CMFCRibbonBar::RemoveAllCategories`	Şerit çubuğundaki tüm şerit kategorilerini kaldırır.
`CMFCRibbonBar::RemoveAllFromTabs`	Sekme alanından tüm şerit öğelerini kaldırır.
`CMFCRibbonBar::RemoveCategory`	Belirtilen dizinde bulunan şerit kategorisini kaldırır.
`CMFCRibbonBar::SaveToXMLBuffer`	Şerit Çubuğu'nu arabelleğe kaydeder.
`CMFCRibbonBar::SaveToXMLFile`	Şerit Çubuğunu XML dosyasına kaydeder.
`CMFCRibbonBar::SetActiveCategory`	Belirtilen şerit kategorisini etkin olarak ayarlar.
`CMFCRibbonBar::SetActiveMDIChild`
`CMFCRibbonBar::SetElementKeys`	Belirtilen komut kimliğine sahip tüm şerit öğeleri için belirtilen tuş ipuçlarını ayarlar.
`CMFCRibbonBar::SetApplicationButton`	Şerit çubuğuna bir uygulama şerit düğmesi atar.
`CMFCRibbonBar::SetKeyboardNavigationLevel`
`CMFCRibbonBar::SetMaximizeMode`
`CMFCRibbonBar::SetQuickAccessCommands`	Hızlı Erişim Araç Çubuğu'na bir veya daha fazla şerit öğesi ekler.
`CMFCRibbonBar::SetQuickAccessDefaultState`	Hızlı Erişim Araç Çubuğu için varsayılan durumu belirtir.
`CMFCRibbonBar::SetQuickAccessToolbarOnTop`	Hızlı Erişim Araç Çubuğu'nu (QAT) şerit çubuğunun üstüne veya altına konumlandırın.
`CMFCRibbonBar::SetTooltipFixedWidth`
`CMFCRibbonBar::SetWindows7Look`	Şeridi etkinleştir/devre dışı bırak Windows 7 stili görünüm (küçük dikdörtgen uygulama düğmesi)
`CMFCRibbonBar::ShowCategory`	Belirtilen şerit kategorisini gösterir veya gizler.
`CMFCRibbonBar::ShowContextCategories`	Belirtilen kimliği içeren bağlam kategorilerini gösterir veya gizler.
`CMFCRibbonBar::ShowKeyTips`
`CMFCRibbonBar::ToggleMimimizeState`	Şerit çubuğunu simge durumuna küçültülmüş ve ekranı kaplamış durumlar arasında değiştirir.
`CMFCRibbonBar::TranslateChar`

Açıklamalar

Microsoft, Microsoft Office 2007'yi aynı anda yayımladığında Office Fluent Şeridi'ni kullanıma sunar. Bu şerit çubuğu yalnızca yeni bir denetim değildir. Yeni bir kullanıcı arabirimi paradigması temsil eder. Şerit, kategoriler adlı bir sekme kümesi içeren bir bölmedir. Her kategori mantıksal olarak şerit panellerine ayrılır ve her panel çeşitli denetimler ve komut düğmeleri içerebilir.

Şerit çubuğunda görüntülenen öğeler genişletilip daraltılarak kullanılabilir alanın en iyi şekilde kullanılması sağlanır. Örneğin, şerit panelinin öğelerini görüntülemek için yeterli alanı yoksa, açılır menüde alt öğeleri görüntüleyen bir menü düğmesi olur. Şerit çubuğu statik (kayan olmayan) bir denetim çubuğu gibi davranır ve çerçevenin en üstüne yerleştirilebilir.

Sınıfını CMFCRibbonStatusBar , Office 2007'de kullanılana benzer bir durum çubuğu uygulamak için kullanabilirsiniz. Şerit kategorisi, şerit panellerinden oluşan bir grup içerir (ve görüntüler). Her şerit paneli, öğesinden CMFCRibbonBaseElementtüretilen bir veya daha fazla şerit öğesi içerir.

Mevcut MFC uygulamanıza şerit çubuğu ekleme hakkında bilgi için bkz . İzlenecek Yol: MFC Karalama Uygulamasını Güncelleştirme.

Devralma Hiyerarşisi

Gereksinimler

Üstbilgi:afxribbonbar.h

`CMFCRibbonBar::ActivateContextCategory`

Zaten görünür durumda olan bir bağlam kategorisini etkinleştirir.

BOOL ActivateContextCategory(UINT uiContextID);

Parametreler

uiContextID
[in] Bağlam kategorisi kimliği.

Dönüş Değeri

TRUE ile uiContextID bir bağlam kategorisi bulunur ve etkinleştirilirse; aksi takdirde FALSE.

`CMFCRibbonBar::AddCategory`

Şerit çubuğu için yeni bir şerit kategorisi oluşturur ve başlatır.

CMFCRibbonCategory* AddCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage= CSize(16,
    16),
    CSize sizeLargeImage= CSize(32,
    32),
    int nInsertAt = -1,
    CRuntimeClass* pRTI= NULL);

Parametreler

lpszName
[in] Şerit kategorisinin adı.

uiSmallImagesResID
[in] Şerit kategorisi için küçük resim listesinin kaynak kimliği.

uiLargeImagesResID
[in] Şerit kategorisi için büyük resim listesinin kaynak kimliği.

sizeSmallImage
[in] Şerit kategorisi için küçük resimlerin boyutunu belirtir.

sizeLargeImage
[in] Şerit kategorisi için büyük resimlerin boyutunu belirtir.

nInsertAt
[in] Kategori konumunun sıfır tabanlı dizini.

pRTI
[in] CMFCRibbonCategory Çalışma zamanında dinamik olarak şerit kategorisi oluşturmak için Sınıf çalışma zamanı sınıfına işaretçi.

Dönüş Değeri

Yöntem başarılı olursa yeni şerit kategorisine bir işaretçi; aksi takdirde , NULL.

Açıklamalar

pRTI parametresi değilseNULL, yeni şerit kategorisi çalışma zamanı sınıfı kullanılarak dinamik olarak oluşturulur.

Örnek

Aşağıdaki örnekte sınıfında yönteminin AddCategory nasıl kullanılacağı gösterilmektedir CMFCRibbonBar .

// Add "Home" category.
// CMFCRibbonBar m_wndRibbonBar
strTemp.LoadString(IDS_RIBBON_HOME);
CMFCRibbonCategory *pCategoryHome = m_wndRibbonBar.AddCategory(strTemp,
                                                               IDB_WRITESMALL, IDB_WRITELARGE);

`CMFCRibbonBar::AddContextCategory`

Şerit çubuğu için yeni bir bağlam kategorisi oluşturur ve başlatır.

CMFCRibbonCategory* AddContextCategory(
    LPCTSTR lpszName,
    LPCTSTR lpszContextName,
    UINT uiContextID,
    AFX_RibbonCategoryColor clrContext,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32),
    CRuntimeClass* pRTI = NULL);

Parametreler

lpszName
[in] Kategorinin adı.

lpszContextName
[in] Bağlam kategorisi resim yazısının adı.

uiContextID
[in] Bağlam Kimliği.

clrContext
[in] Bağlam kategorisi resim yazısının rengi.

uiSmallImagesResID
[in] Bağlam kategorisinin küçük görüntüsünün kaynak kimliği.

uiLargeImagesResID
[in] Bağlam kategorisinin büyük görüntüsünün kaynak kimliği.

sizeSmallImage
[in] Küçük bir görüntünün boyutu.

sizeLargeImage
[in] Büyük bir görüntünün boyutu.

pRTI
[in] Çalışma zamanı sınıfına işaretçi.

Dönüş Değeri

Yeni oluşturulan kategorinin işaretçisi veya NULL yöntemi CreateObject belirtilen kategoriyi oluşturamıyorsapRTI.

Açıklamalar

Bağlam kategorisi eklemek için bu işlevi kullanın. Bağlam kategorileri, geçerli uygulama bağlamı bağlı olarak çalışma zamanında gösterilebilen veya gizlenebilen özel bir kategori türüdür. Örneğin, kullanıcı bir nesne seçtiğinde, belirli bir seçili nesneyi değiştirmek için kullandığınız bağlam kategorilerine sahip özel sekmeler görüntüleyebilirsiniz.

Bağlam kategorisinin rengi aşağıdaki değerlerden biri olabilir:

AFX_CategoryColor_None
AFX_CategoryColor_Red
AFX_CategoryColor_Orange
AFX_CategoryColor_Yellow
AFX_CategoryColor_Green
AFX_CategoryColor_Blue
AFX_CategoryColor_Indigo
AFX_CategoryColor_Violet

`CMFCRibbonBar::AddMainCategory`

Şerit çubuğu için yeni bir ana şerit kategorisi oluşturur.

CMFCRibbonMainPanel* AddMainCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32));

Parametreler

lpszName
[in] Ana şerit kategorisinin adı.

uiSmallImagesResID
[in] Küçük görüntülerin kaynak kimliği.

uiLargeImagesResID
[in] Büyük görüntülerin kaynak kimliği.

sizeSmallImage
[in] Küçük resimlerin boyutu.

sizeLargeImage
[in] Büyük resimlerin boyutu.

Dönüş Değeri

Yöntem başarılı olursa yeni ana şerit kategorisi işaretçisi; aksi takdirde , NULL.

Açıklamalar

Ana şerit kategorisi zaten varsa, bu kategori silinir.

Örnek

Aşağıdaki örnekte sınıfında yönteminin AddMainCategory nasıl kullanılacağı gösterilmektedir CMFCRibbonBar .

// m_wndRibbonBar is declared as a protected member variable
// CMFCRibbonBar m_wndRibbonBar.
// strTemp is a CString variable.
strTemp.LoadString(IDS_RIBBON_FILE);
CMFCRibbonMainPanel *pMainPanel = m_wndRibbonBar.AddMainCategory(strTemp,
                                                                 IDB_FILESMALL, IDB_FILELARGE);

`CMFCRibbonBar::AddPrintPreviewCategory`

Şerit çubuğunda bir baskı önizleme kategorisi oluşturur.

CMFCRibbonCategory* AddPrintPreviewCategory();

Dönüş Değeri

Yöntem başarılı olursa yeni şerit kategorisine bir işaretçi; aksi takdirde , NULL.

Açıklamalar

Bu yöntem, bir şerit kategorisi ve baskı önizlemesi sağlamak için gereken denetimleri oluşturur.

`CMFCRibbonBar::AddQATOnlyCategory`

Hızlı erişim araç çubuğu şerit kategorisi oluşturur.

CMFCRibbonCategory* AddQATOnlyCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    CSize sizeSmallImage = CSize(16,
    16));

Parametreler

lpszName
[in] Kategorinin adı.

uiSmallImagesResID
[in] Kategorinin görüntü listesinin kaynak kimliği.

sizeSmallImage
[in] Kategorideki şerit öğeleri için görüntülerin boyutu.

Dönüş Değeri

Yöntem başarılı olursa yeni kategori işaretçisi; aksi takdirde , NULL.

Açıklamalar

Hızlı erişim araç çubuğu şerit kategorisi yalnızca hızlı erişim araç çubuğu özelleştirme iletişim kutusunda kullanılır.

`CMFCRibbonBar::AddToTabs`

Belirtilen şerit öğesini şerit çubuğunun sekmeler satırına ekler.

void AddToTabs(CMFCRibbonBaseElement* pElement);

Parametreler

pElement
[in] Şerit öğesinin işaretçisi.

Açıklamalar

Şerit öğesi herhangi bir sistem düğmesinden önce konumlandırılır.

`CMFCRibbonBar::CMFCRibbonBar`

Bir CMFCRibbonBar nesneyi oluşturur ve başlatır.

CMFCRibbonBar(BOOL bReplaceFrameCaption = TRUE);

Parametreler

bReplaceFrameCaption
[in] TRUE şerit çubuğunun ana çerçeve penceresinin resim yazısını değiştirmesi için; FALSE ana çerçeve penceresinin resim yazısının altındaki şerit çubuğunu bulmak için.

Açıklamalar

`CMFCRibbonBar::Create`

Şerit çubuğu için bir pencere oluşturur.

BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

Parametreler

pParentWnd
[in] Şerit çubuğunun üst penceresinin işaretçisi.

dwStyle
[in] Yeni pencere için stillerin mantıksal birleşimi.

nID
[in] Yeni pencerenin kimliği.

Dönüş Değeri

TRUE pencere oluşturulduysa; aksi takdirde FALSE.

Açıklamalar

Örnek

Aşağıdaki örnekte sınıfının yönteminin Create nasıl kullanılacağı gösterilmektedir CMFCRibbonBar .

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.Create(this, WS_CHILD | CBRS_TOP);

`CMFCRibbonBar::CreateEx`

Şerit çubuğu için bir pencere oluşturur.

BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle = 0,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

Parametreler

pParentWnd
[in] Şerit çubuğunun üst penceresinin işaretçisi.

dwCtrlStyle
[in] Bu parametre kullanılmaz.

dwStyle
[in] Yeni pencere için stillerin mantıksal birleşimi.

nID
[in] Yeni pencerenin kimliği.

Dönüş Değeri

TRUE pencere oluşturulduysa; aksi takdirde FALSE.

Açıklamalar

`CMFCRibbonBar::DeactivateKeyboardFocus`

Şerit çubuğundaki tüm tuş ipucu denetimlerini kapatır.

void DeactivateKeyboardFocus(BOOL bSetFocus = TRUE);

Parametreler

bSetFocus
[in] TRUE seçeneğine tıklayın.

Açıklamalar

`CMFCRibbonBar::DrawMenuImage`

Menü düğmesinin resmini çizer.

BOOL DrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuItem,
    const CRect& rectImage);

Parametreler

pDC
[in] Menü düğmesi için bir cihaz bağlamı işaretçisi.

pMenuItem
[in] Araç çubuğu menü düğmesinin işaretçisi.

rectImage
[in] Menü düğmesinin görüntü dikdörtgeni.

Dönüş Değeri

TRUE resim çizildiyse; aksi takdirde FALSE.

Açıklamalar

`CMFCRibbonBar::DWMCompositionChanged`

Masaüstü Pencere Yöneticisi (DWM) bileşimi etkinleştirildiğinde veya devre dışı bırakıldığında şerit çubuğunun görünümünü ayarlar.

virtual void DWMCompositionChanged();

Açıklamalar

`CMFCRibbonBar::EnableKeyTips`

Şerit çubuğu için tuş ipucu özelliğini etkinleştirir veya devre dışı bırakır.

void EnableKeyTips(BOOL bEnable = TRUE);

Parametreler

bEnable
[in] TRUE anahtar ipuçları özelliğini etkinleştirmek için; FALSE tuş ipuçları özelliğini devre dışı bırakın.

Açıklamalar

Bu özelliği etkinleştirdiğinizde, kullanıcı ALT veya F10 tuşlarına bastığında tuş ipuçları görüntülenir. Kullanıcı ALT tuşuna bastığında, tuş ipuçları 200 milisaniyelik bir gecikmeyle görüntülenir. Bu gecikme, basılan ALT tuşunun ALT tuşunu içeren diğer bileşimlerle karışmaması için kısayolların yürütülmesini sağlar.

`CMFCRibbonBar::EnablePrintPreview`

Baskı Önizleme özelliğini etkinleştirir veya devre dışı bırakır.

void EnablePrintPreview(BOOL bEnable = TRUE);

Parametreler

bEnable
[in] TRUE baskı önizleme özelliğini etkinleştirmek; FALSE Baskı Önizleme özelliğini devre dışı bırakmak için.

Açıklamalar

Varsa bEnableFALSE ve bir baskı önizleme kategorisi varsa, bu kategori silinir.

Varsayılan olarak Baskı Önizleme özelliği etkindir.

`CMFCRibbonBar::EnableToolTips`

Şerit çubuğunda araç ipuçlarını ve isteğe bağlı araç ipucu açıklamalarını etkinleştirir veya devre dışı bırakır.

void EnableToolTips(
    BOOL bEnable = TRUE,
    BOOL bEnableDescr = TRUE);

Parametreler

bEnable
[in] TRUE şerit çubuğunda araç ipuçlarını etkinleştirmek için; FALSE şerit çubuğunda araç ipuçlarını devre dışı bırakmak için.

bEnableDescr
[in] TRUE araç ipucu açıklamalarını etkinleştirmek için; FALSE araç ipucu açıklamalarını devre dışı bırakmak için.

Açıklamalar

parametresi, bEnable fare bir şerit öğesinin üzerine geldiğinde araç ipuçlarının görüntülenip görüntülenmeyeceğini belirler. parametresi, bEnableDescr araç ipucu metniyle birlikte ek açıklayıcı metnin görünüp görünmeyeceğini belirler.

`CMFCRibbonBar::FindByData`

Belirtilen veri ve görünürlüğe sahipse şerit öğesine işaretçi alır.

CMFCRibbonBaseElement* FindByData(
    DWORD_PTR dwData,
    BOOL bVisibleOnly = TRUE) const;

Parametreler

dwData
[in] Şerit öğesiyle ilişkili veriler.

bVisibleOnly
[in] TRUE yalnızca görünür şerit öğelerini aramak için; FALSE tüm şerit öğelerini aramak için.

Dönüş Değeri

Belirtilen veri ve görünürlüğe sahipse şerit öğesine işaretçi; aksi takdirde NULL.

Açıklamalar

Şerit öğesi, şerit düğmesi, şerit kategorisi veya şerit kaydırıcısı gibi şeride ekleyebileceğiniz herhangi bir denetimdir.

`CMFCRibbonBar::FindByID`

Belirtilen komut kimliğine ve arama değerlerine sahip şerit öğesine yönelik bir işaretçi alır.

CMFCRibbonBaseElement* FindByID(
    UINT uiCmdID,
    BOOL bVisibleOnly = TRUE,
    BOOL bExcludeQAT = FALSE) const;

Parametreler

uiCmdID
[in] Şerit öğesinin komut kimliği.

bVisibleOnly
[in] TRUE yalnızca görünür şerit öğelerini aramak için; FALSE tüm şerit öğelerini aramak için.

bExcludeQAT
[in] TRUE hızlı erişim araç çubuğu öğelerini aramanın dışında tutmak için; aksi takdirde , FALSE.

Dönüş Değeri

Belirtilen komut kimliğine ve arama değerlerine sahipse şerit öğesinin işaretçisi; aksi takdirde , NULL.

Açıklamalar

Şerit öğesi, şerit düğmesi, şerit kategorisi veya şerit kaydırıcısı gibi şeride eklenebilen herhangi bir şerit denetimidir.

Genel olarak, aynı komut kimliğine sahip birden fazla şerit öğesi olabilir. Belirtilen komut kimliğini kullanan tüm şerit öğelerinin işaretçilerini almak istiyorsanız yöntemini kullanın CMFCRibbonBar::GetElementsByID .

`CMFCRibbonBar::FindCategoryIndexByData`

Belirtilen verileri içeren şerit kategorisinin dizinini alır.

int FindCategoryIndexByData(DWORD dwData) const;

Parametreler

dwData
[in] Şerit kategorisiyle ilişkili veriler.

Dönüş Değeri

Yöntem başarılı olursa şerit kategorisinin sıfır tabanlı dizini; aksi takdirde -1.

`CMFCRibbonBar::ForceRecalcLayout`

Şerit çubuğundaki ve üst penceredeki tüm öğelerin düzenini ayarlar ve tüm pencereyi yeniden çizer.

void ForceRecalcLayout();

Açıklamalar

`CMFCRibbonBar::GetActiveCategory`

Etkin şerit kategorisine yönelik bir işaretçi alır.

CMFCRibbonCategory* GetActiveCategory() const;

Dönüş Değeri

Etkin şerit kategorisine ilişkin bir işaretçi; veya NULL etkin kategori yoksa.

Açıklamalar

Bir kategori, odaktaysa etkindir. Varsayılan olarak, etkin kategori şerit çubuğunun sol tarafındaki ilk kategoridir.

Kullanıcı uygulama düğmesine bastığında ana kategori görüntülenir ve etkin kategori olamaz.

`CMFCRibbonBar::GetApplicationButton`

Uygulama düğmesinin işaretçisini alır.

CMFCRibbonApplicationButton* GetApplicationButton() const;

Dönüş Değeri

Uygulama düğmesinin işaretçisi; veya NULL düğme ayarlanmamışsa.

`CMFCRibbonBar::GetCaptionHeight`

Şerit çubuğunun resim yazısı alanının yüksekliğini alır.

int GetCaptionHeight() const;

Dönüş Değeri

Şerit çubuğunun resim yazısı alanının piksel cinsinden yüksekliği.

Açıklamalar

`CMFCRibbonBar::GetCategory`

Belirtilen dizinde şerit kategorisine yönelik bir işaretçi alır.

CMFCRibbonCategory* GetCategory(int nIndex) const;

Parametreler

nIndex
[in] Şerit çubuğunda yer alan şerit kategorileri listesindeki şerit kategorisinin sıfır tabanlı dizini.

Dönüş Değeri

Belirtilen dizinde şerit kategorisine işaret eden bir işaretçi; aksi takdirde, NULL aralık dışındaysa nIndex .

`CMFCRibbonBar::GetCategoryCount`

Şerit çubuğundaki şerit kategorilerinin sayısını alır.

int GetCategoryCount() const;

Dönüş Değeri

Şerit çubuğundaki şerit kategorilerinin sayısı.

`CMFCRibbonBar::GetCategoryHeight`

Kategorinin yüksekliğini alır.

int GetCategoryHeight() const;

Dönüş Değeri

Kategorinin yüksekliği.

Açıklamalar

Kategori yüksekliği, kategori sekmesinin yüksekliğini içerir.

`CMFCRibbonBar::GetCategoryIndex`

Belirtilen şerit kategorisinin dizinini alır.

int GetCategoryIndex(CMFCRibbonCategory* pCategory) const;

Parametreler

pCategory
[in] Şerit kategorisi işaretçisi.

Dönüş Değeri

tarafından belirtilen pCategoryşerit kategorisinin sıfır tabanlı dizini veya şerit kategorisi bulunamazsa -1.

`CMFCRibbonBar::GetContextName`

Bağlam kimliği tarafından belirtilen bağlam kategorisi resim yazısının adını alır.

BOOL GetContextName(
    UINT uiContextID,
    CString& strName) const;

Parametreler

uiContextID
[in] Şerit kategorisi bağlam kimliği.

strName
[out] Bağlam kategorisi resim yazısının adı.

Dönüş Değeri

TRUE yöntemi başarılı olursa; aksi takdirde, FALSE sıfır ise uiContextID veya bağlam kategorisi resim yazısı bulunamadı.

`CMFCRibbonBar::GetDroppedDown`

Şu anda açılan şerit öğesini alır.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Dönüş Değeri

Şu anda açılan şerit öğesi; veya NULL şu anda hiçbir şerit öğesi bırakılmadıysa.

Açıklamalar

`CMFCRibbonBar::GetElementsByID`

Belirli bir komut kimliğine sahip tüm şerit öğelerine yönelik bir işaretçi dizisi alır.

void GetElementsByID(
    UINT uiCmdID,
    CArray<CMFCRibbonBaseElement*,CMFCRibbonBaseElement*>& arButtons);

Parametreler

uiCmdID
[in] Şerit öğesinin komut kimliği.

arButtons
[out] Şerit öğelerine yönelik bir işaretçi dizisi.

Açıklamalar

Bazı şerit öğeleri hızlı erişim araç çubuğuna kopyalanabildiği için birden çok şerit öğesi aynı komut kimliğine sahip olabilir.

`CMFCRibbonBar::GetHideFlags`

Şerit çubuğunun ne kadarının görünür olduğunu gösteren bayrakları alır.

DWORD GetHideFlags() const;

Dönüş Değeri

Şerit çubuğunun ne kadarının görünür olduğunu gösteren bayraklar.

Açıklamalar

Aşağıdaki tabloda, dönüş değeri için olası bayrak birleşimi listelenir:

Bayrak	Açıklama
`AFX_RIBBONBAR_HIDE_ELEMENTS`	Şerit çubuğu dikey olarak simge durumuna küçültülmüş ve yalnızca kategori sekmeleri, ana düğme ve hızlı erişim araç çubuğu görünür.
`AFX_RIBBONBAR_HIDE_ALL`	Şerit çubuğunun genişliği minimum genişlikten küçüktür ve tamamen gizlidir.

`CMFCRibbonBar::GetItemIDsList`

Şerit çubuğundaki belirtilen şerit öğeleri koleksiyonu için komut kimliklerini alır.

void GetItemIDsList(CList<UINT, UINT>& lstItems,
    BOOL bHiddenOnly = FALSE) const;

Parametreler

lstItems
[out] Şerit çubuğunda yer alan şerit öğelerinin komut kimlikleri listesi.

bHiddenOnly
[in] TRUE görüntülenen şerit öğelerini dışlamak için; FALSE şerit çubuğuna tüm şerit öğelerini eklemek için.

Açıklamalar

`CMFCRibbonBar::GetKeyboardNavigationLevel`

Kullanıcı şerit çubuğundaki tuş ipuçlarına bastığında geçerli gezinti düzeyini alır.

int GetKeyboardNavigationLevel() const;

Dönüş Değeri

Kullanıcı şerit çubuğunda bulunan tuş ipuçlarına bastığında geçerli gezinti düzeyi. Aşağıdaki tabloda olası dönüş değerleri listelemektedir:

Value	Açıklama
-1	Tuş ipuçları görüntülenmez.
0	Tuş ipuçları görüntülenir.
1	Kullanıcı görüntülenen bir tuş ipucuna bastı.

Açıklamalar

`CMFCRibbonBar::GetKeyboardNavLevelCurrent`

Şerit çubuğundaki geçerli klavye gezinti nesnesini alır.

CObject* GetKeyboardNavLevelCurrent() const;

Dönüş Değeri

Şerit çubuğundaki geçerli klavye gezinti nesnesi; aksi takdirde NULL , şu anda hiçbir nesne tuş ipuçlarını görüntülemiyorsa.

Açıklamalar

Şu anda tuş ipuçlarını görüntüleyen nesne, geçerli klavye gezinti nesnesidir.

`CMFCRibbonBar::GetKeyboardNavLevelParent`

Şerit çubuğundaki üst klavye gezinti nesnesini alır.

CObject* GetKeyboardNavLevelParent() const;

Dönüş Değeri

Şerit çubuğundaki üst klavye gezinti nesnesi; aksi takdirde NULL.

Açıklamalar

Kullanıcı şerit çubuğunda bir tuş ipucuna bastığında, geçerli klavye gezinti nesnesi üst klavye gezinti nesnesi olur.

`CMFCRibbonBar::GetMainCategory`

Ana şerit kategorisine yönelik bir işaretçi alır.

CMFCRibbonCategory* GetMainCategory() const;

Dönüş Değeri

Ana şerit kategorisine ilişkin bir işaretçi.

Açıklamalar

Ana şerit kategorisi ana şerit panelini içerir.

`CMFCRibbonBar::GetQATCommandsLocation`

Hızlı erişim araç çubuğunun komutlar bölümü için görüntü dikdörtgenini alır.

CRect GetQATCommandsLocation() const;

Dönüş Değeri

Hızlı erişim araç çubuğunun komutlar bölümü için görüntü dikdörtgeni.

Açıklamalar

Görüntü dikdörtgeninin komutlar bölümünde özelleştirme düğmesi yoktur.

`CMFCRibbonBar::GetQATDroppedDown`

Açılan menüsü açılan hızlı erişim araç çubuğundaki şerit öğesinin işaretçisini alır.

CMFCRibbonBaseElement* GetQATDroppedDown();

Dönüş Değeri

Açılan menüsü açılan hızlı erişim araç çubuğundaki şerit öğesinin işaretçisi.

Açıklamalar

`CMFCRibbonBar::GetQuickAccessCommands`

Hızlı erişim araç çubuğundaki şerit öğeleri için komut kimliklerinin listesini alır.

void GetQuickAccessCommands(CList<UINT,UINT>& lstCommands);

Parametreler

lstCommands
[out] Hızlı erişim araç çubuğundaki şerit öğelerinin komut kimlikleri listesi.

Açıklamalar

Listede denetim ayırıcıları olan şerit öğeleri yoktur.

`CMFCRibbonBar::GetQuickAccessToolbarLocation`

Hızlı erişim araç çubuğu için görüntü dikdörtgenini alır.

CRect GetQuickAccessToolbarLocation() const;

Dönüş Değeri

Hızlı erişim araç çubuğunun görüntü dikdörtgeni.

Açıklamalar

`CMFCRibbonBar::GetTabTrancateRatio`

Kategori sekmelerinin görüntüleme genişliğindeki yüzde boyutu azaltmasını alır.

int GetTabTrancateRatio() const;

Dönüş Değeri

Kategori sekmelerinin görüntüleme genişliğindeki yüzde boyutu azaltma.

Açıklamalar

Şerit çubuğunda yeterli genişlik olmadığında kategori sekmelerinin genişliği azalır.

`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`

Şerit çubuğu için araç ipucu genişliğinin büyük boyutunu alır.

int GetTooltipFixedWidthLargeImage() const;

Dönüş Değeri

Piksel cinsinden araç ipucu genişliğinin büyük boyutu.

Açıklamalar

Araç ipucu genişliğinin büyük boyutu 0 ise, genişlik değişir.

`CMFCRibbonBar::GetTooltipFixedWidthRegular`

Şerit çubuğu için araç ipucu genişliğinin normal boyutunu alır.

int GetTooltipFixedWidthRegular() const;

Dönüş Değeri

Araç ipucu genişliğinin piksel cinsinden normal boyutu.

Açıklamalar

Araç ipucu genişliğinin normal boyutu 0 ise, genişlik değişir.

`CMFCRibbonBar::GetVisibleCategoryCount`

Şerit çubuğundaki görünür kategorilerin sayısını alır.

int GetVisibleCategoryCount() const;

Dönüş Değeri

Şerit çubuğundaki görünür kategorilerin sayısı.

Açıklamalar

`CMFCRibbonBar::HideAllContextCategories`

Şerit çubuğundaki tüm bağlam kategorilerini gizler.

BOOL HideAllContextCategories();

Dönüş Değeri

TRUE en az bir bağlam kategorisi gizlendiyse; aksi takdirde , FALSE.

Açıklamalar

Bağlam kategorisi etkinse, etkin kategori kategori listesindeki ilk görünür kategoriye sıfırlanır.

`CMFCRibbonBar::HideKeyTips`

Şerit çubuğundaki tüm tuş ipuçlarını gizler.

void HideKeyTips();

Açıklamalar

`CMFCRibbonBar::HitTest`

Noktanın konumu tarafından belirtilen şerit öğesinin işaretçisini alır.

virtual CMFCRibbonBaseElement* HitTest(
    CPoint point,
    BOOL bCheckActiveCategory= FALSE,
    BOOL bCheckPanelCaption= FALSE);

Parametreler

point
[in] Şerit çubuğu koordinatlarındaki noktanın konumu.

bCheckActiveCategory
[in] TRUE etkin kategoride arama yapmak için; FALSE etkin kategoride arama yapmak için değil.

bCheckPanelCaption
[in] TRUE şerit panelinin resim yazısını içinde bulunan noktayla test etmek için; FALSE şerit panelinin resim yazısını içinde bulunan noktayla test etmemeye dikkat edin. Daha fazla bilgi için Açıklamalar bölümüne bakın.

Dönüş Değeri

Belirtilen noktada bulunan şerit öğesinin işaretçisi; aksi takdirde NULL nokta bir şerit öğesinde yer almıyorsa.

Açıklamalar

Şerit panelinin içinde nokta bulunan resim yazısı, parametresi bCheckActiveCategoryolmadığı sürece TRUE test edilmez.

`CMFCRibbonBar::IsKeyTipEnabled`

Anahtar ipuçları özelliğinin etkinleştirilip etkinleştirilmediğini gösterir.

BOOL IsKeyTipEnabled() const;

Dönüş Değeri

TRUE anahtar ipuçları özelliği etkinse; aksi takdirde FALSE.

`CMFCRibbonBar::IsMainRibbonBar`

Şerit çubuğunun birincil şerit çubuğu olup olmadığını gösterir.

virtual BOOL IsMainRibbonBar() const;

Dönüş Değeri

Her zaman TRUE döndürür.

Açıklamalar

Varsayılan olarak bu yöntem her zaman döndürür TRUE. Şerit çubuğunun birincil şerit çubuğu olup olmadığını belirtmek için bu yöntemi geçersiz kılın.

`CMFCRibbonBar::IsPrintPreviewEnabled`

Baskı Önizleme özelliğinin etkinleştirilip etkinleştirilmediğini gösterir.

BOOL IsPrintPreviewEnabled() const;

Dönüş Değeri

TRUE Baskı Önizleme özelliği etkinse; aksi takdirde FALSE.

`CMFCRibbonBar::IsQATEmpty`

Hızlı erişim araç çubuğunun komut düğmeleri içerip içermediğini gösterir.

BOOL IsQATEmpty() const;

Dönüş Değeri

TRUE Hızlı erişim araç çubuğunda komut düğmeleri varsa; aksi takdirde FALSE.

Açıklamalar

`CMFCRibbonBar::IsQuickAccessToolbarOnTop`

Hızlı erişim araç çubuğunun şerit çubuğunun üzerinde mi yoksa altında mı bulunduğunu gösterir.

BOOL IsQuickAccessToolbarOnTop() const;

Dönüş Değeri

TRUE hızlı erişim araç çubuğu şerit çubuğunun üzerindeyse; FALSE hızlı erişim araç çubuğu şerit çubuğunun altında yer alıyorsa.

`CMFCRibbonBar::IsReplaceFrameCaption`

Şerit çubuğunun değiştirilip değiştirilmediğini veya ana çerçeve penceresinin başlığı altında yer alıp almayacağını gösterir.

BOOL IsReplaceFrameCaption() const;

Dönüş Değeri

TRUE şerit çubuğu ana çerçeve penceresinin resim yazısının yerini alırsa; FALSE şerit çubuğu ana çerçeve penceresinin resim yazısı altındaysa.

`CMFCRibbonBar::IsShowGroupBorder`

Şerit çubuğunda bulunan düğme gruplarının grup kenarlı olup olmadığını gösterir.

virtual BOOL IsShowGroupBorder(CMFCRibbonButtonsGroup* pGroup) const;

Parametreler

pGroup
[in] Bu parametre kullanılmaz.

Dönüş Değeri

Her zaman FALSE döndürür.

Açıklamalar

Varsayılan olarak bu yöntem her zaman döndürür FALSE. Şerit çubuğunda bulunan düğme gruplarının grup kenarını görüntüleyip görüntülemediğini belirtmek için bu yöntemi geçersiz kılın.

`CMFCRibbonBar::IsToolTipDescrEnabled`

Araç ipucu açıklamalarının etkinleştirilip etkinleştirilmediğini gösterir.

BOOL IsToolTipDescrEnabled() const;

Dönüş Değeri

TRUE araç ipucu açıklamaları etkinse; FALSE araç ipucu açıklamaları devre dışıysa.

Açıklamalar

Araç ipucu açıklamaları, araç ipucu metniyle birlikte görüntülenen ek açıklayıcı metinlerdir.

`CMFCRibbonBar::IsToolTipEnabled`

Şerit çubuğu için araç ipuçlarının etkinleştirilip etkinleştirilmediğini veya devre dışı bırakılıp bırakılmadığını gösterir.

BOOL IsToolTipEnabled() const;

Dönüş Değeri

TRUE araç ipuçları etkinse; FALSE araç ipuçları devre dışıysa.

`CMFCRibbonBar::IsTransparentCaption`

Ekranın Windows Aero renk düzeni için ayarlanıp ayarlanmadığını gösterir.

BOOL IsTransparentCaption() const;

Dönüş Değeri

TRUE renk düzeni Windows Aero ise; aksi takdirde FALSE.

Açıklamalar

`CMFCRibbonBar::OnClickButton`

Bu yöntem mevcut uygulamalarla geriye dönük uyumluluk için korunur ve yeni geliştirme için kullanılmamalıdır.

virtual void OnClickButton(
    CMFCRibbonButton* pButton,
    CPoint point);

Parametreler

pButton
[in] Tıklanan düğmenin işaretçisi.

point
[in] Bu parametre kullanılmaz.

Açıklamalar

`CMFCRibbonBar::OnEditContextMenu`

virtual void OnEditContextMenu(
    CMFCRibbonRichEditCtrl* pEdit,
    CPoint point);

Parametreler

[in] pEdit
[in] point

Açıklamalar

`CMFCRibbonBar::OnRTLChanged`

Düzen yön değiştirdiğinde çerçeve tarafından çağrılır.

virtual void OnRTLChanged(BOOL bIsRTL);

Parametreler

bIsRTL
[in] TRUE düzen sağdan sola ise; FALSE düzeni soldan sağa ise.

Açıklamalar

Bu yöntem, yeni düzen yönü için şerit çubuğundaki tüm denetimlerin düzenini ayarlar.

`CMFCRibbonBar::OnSetAccData`

Bu yöntem Framework'ün içindedir ve kullanıcı kodundan çağrılmak üzere tasarlanmamıştır.

BOOL OnSetAccData(long lVal);

Parametreler

long lVal Erişilebilir nesnenin dizini.

Dönüş Değeri

S_OK başarılı olursa; aksi takdirde FALSE veya S_FALSE.

Açıklamalar

`CMFCRibbonBar::OnShowRibbonContextMenu`

virtual BOOL OnShowRibbonContextMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

Parametreler

[in] pWnd
[in] x
[in] y
[in] pHit

Dönüş Değeri

Açıklamalar

`CMFCRibbonBar::OnShowRibbonQATMenu`

virtual BOOL OnShowRibbonQATMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

Parametreler

[in] pWnd
[in] x
[in] y
[in] pHit

Dönüş Değeri

Açıklamalar

`CMFCRibbonBar::OnSysKeyDown`

Kullanıcı F10 tuşuna bastığında veya ALT tuşunu basılı tuttuğunda ve ardından başka bir tuşa bastığında çerçeve tarafından çağrılır.

BOOL OnSysKeyDown(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

Parametreler

pFrameWnd
[in] Şerit çubuğunun üst ana çerçeve penceresinin işaretçisi.

wParam
[in] Basılan anahtarın sanal anahtar kodu.

lParam
[in] Tuşa basıldığında klavye durumu bayrakları.

Dönüş Değeri

TRUE tuş vuruşu olayı işlendiyse; aksi takdirde FALSE.

Açıklamalar

`CMFCRibbonBar::OnSysKeyUp`

Kullanıcı F10 tuşunu, ALT tuşunu veya ALT tuşu basılı tutulduğunda basılan bir anahtarı serbest bıraktığında çerçeve tarafından çağrılır.

BOOL OnSysKeyUp(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

Parametreler

pFrameWnd
[in] Şerit çubuğunun üst ana çerçeve penceresinin işaretçisi.

wParam
[in] Yayımlanan anahtarın sanal anahtar kodu.

lParam
[in] Bu parametre kullanılmaz.

Dönüş Değeri

TRUE tuş vuruşu olayı işlendiyse; aksi takdirde FALSE.

Açıklamalar

`CMFCRibbonBar::PopTooltip`

Görünümden araç ipucu kaldırır.

void PopTooltip();

Açıklamalar

`CMFCRibbonBar::PreTranslateMessage`

Belirtilen iletinin şerit çubuğu tarafından işlenip işlenmediğini belirler.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametreler

pMsg
[in] İleti işaretçisi.

Dönüş Değeri

TRUE ileti şerit çubuğu tarafından işlendiyse; aksi takdirde FALSE.

Açıklamalar

`CMFCRibbonBar::RecalcLayout`

Şerit çubuğundaki tüm denetimlerin düzenini ayarlar.

virtual void RecalcLayout();

Açıklamalar

Düzen ayarlamasının ardından şerit çubuğunun görünümü güncelleştirilir.

`CMFCRibbonBar::RemoveAllCategories`

Şerit çubuğundaki tüm şerit kategorilerini siler.

void RemoveAllCategories();

Açıklamalar

Bu yöntem tüm şerit kategorilerini bellekten ve kategori listesinden siler.

`CMFCRibbonBar::RemoveAllFromTabs`

Sekme alanından tüm şerit öğelerini kaldırır.

void RemoveAllFromTabs();

Açıklamalar

Yöntemini kullanarak CMFCRibbonBar::AddToTabs sekme alanına eklediğiniz tüm öğeleri kaldırmak istiyorsanız bu işlevi kullanın.

`CMFCRibbonBar::RemoveCategory`

Belirtilen şerit kategorisini şerit çubuğundan siler.

BOOL RemoveCategory(int nIndex);

Parametreler

nIndex
[in] Şerit çubuğunda yer alan şerit kategorileri listesindeki bir kategorinin sıfır tabanlı dizini.

Dönüş Değeri

TRUE belirtilen şerit kategorisi silindiyse; aksi takdirde FALSE.

Açıklamalar

Belirtilen şerit kategorisi bellekten ve kategori listesinden silinir.

`CMFCRibbonBar::SetActiveCategory`

Belirtilen şerit kategorisini etkin kategori olarak ayarlar.

BOOL SetActiveCategory(
    CMFCRibbonCategory* pCategory,
    BOOL bForceRestore= FALSE);

Parametreler

pCategory
[in] Şerit çubuğunda yer alan bir şerit kategorisi.

bForceRestore
[in] TRUE simge durumuna küçültülmüşse şerit çubuğunu en üst düzeye çıkarmak için; FALSE şerit çubuğu simge durumuna küçültülmüşse etkin kategoriyi bir açılır pencerede görüntülemek için.

Dönüş Değeri

TRUE belirtilen kategori etkin kategori olarak ayarlandıysa; aksi takdirde FALSE.

Açıklamalar

Ana şerit kategorisi etkin kategori olamaz.

tarafından pCategory belirtilen kategori görüntülenmiyorsa, etkin kategori olarak ayarlanamaz.

`CMFCRibbonBar::SetActiveMDIChild`

Şerit çubuğundaki çok belgeli arabirim (MDI) alt penceresine ait sistem düğmelerini belirtilen MDI alt penceresiyle ilişkilendirir.

void SetActiveMDIChild(CWnd* pWnd);

Parametreler

pWnd
[in] MDI alt penceresinin işaretçisi.

Açıklamalar

`CMFCRibbonBar::SetApplicationButton`

Şerit çubuğuna bir uygulama şerit düğmesi atar.

void SetApplicationButton(
    CMFCRibbonApplicationButton* pButton,
    CSize sizeButton);

Parametreler

pButton
[in] Uygulama şerit düğmesinin işaretçisi.

sizeButton
[in] Uygulama şerit düğmesinin boyutu.

Açıklamalar

Uygulama şerit düğmesi, Şerit denetiminin sol üst köşesinde bulunan büyük bir yuvarlatılmış düğmedir.

Örnek

Aşağıdaki örnekte sınıfında yönteminin SetApplicationButton nasıl kullanılacağı gösterilmektedir CMFCRibbonBar .

// Init main button:
// CMFCRibbonApplicationButton m_MainButton
m_MainButton.SetImage(IDB_MAIN);
m_MainButton.SetText(_T("\nf"));
m_MainButton.SetToolTipText(strTemp);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetApplicationButton(&m_MainButton, CSize(45, 45));

`CMFCRibbonBar::SetElementKeys`

Belirtilen komut kimliğine sahip tüm şerit öğeleri için tuş ipuçlarını ayarlar.

BOOL SetElementKeys(
    UINT uiCmdID,
    LPCTSTR lpszKeys,
    LPCTSTR lpszMenuKeys= NULL);

Parametreler

uiCmdID
[in] Şerit öğesinin komut kimliği.

lpszKeys
[in] Anahtar ipucu.

lpszMenuKeys
[in] Menü tuş ipucu.

Dönüş Değeri

TRUE en az bir şerit öğesinin tuş ipuçları ayarlanmışsa; aksi takdirde FALSE.

Açıklamalar

İsteğe bağlı menü tuş ipucu, açılan menüyü açan bölünmüş düğmeli şerit öğeleri içindir.

`CMFCRibbonBar::SetKeyboardNavigationLevel`

Kullanıcı şerit çubuğundaki tuş ipuçlarına bastığında klavye gezinti düzeyini ayarlar.

void SetKeyboardNavigationLevel(
    CObject* pLevel,
    BOOL bSetFocus = TRUE);

Parametreler

pLevel
[in] Geçerli klavye gezinti nesnesinin işaretçisi.

bSetFocus
[in] TRUE klavye odağını şerit çubuğuna ayarlamak için.

Açıklamalar

Kullanıcı ALT veya F10 tuşuna bastığında şerit çubuğunun klavye gezintisi başlar. Kullanıcı, şerit çubuğundaki bir tuş ipucuna basarak bir sonraki gezinti düzeyini seçer. Kullanıcı, kaçış tuşuna basarak önceki gezinti düzeyine dönebilir.

`CMFCRibbonBar::SetMaximizeMode`

Çok belgeli arabirim (MDI) alt penceresinin pencere boyutu ekranı kaplamış duruma girdiğinde veya ayrıldığında şerit çubuğunu ayarlar.

void SetMaximizeMode(
    BOOL bMax,
    CWnd* pWnd = NULL);

Parametreler

bMax
[in] TRUE şerit çubuğunda bir MDI alt penceresinin sistem düğmelerini görüntülemek için; FALSE bir MDI alt penceresinin sistem düğmelerini şerit çubuğundan kaldırmak için.

pWnd
[in] Şerit çubuğunun ana çerçeve penceresinin işaretçisi.

Açıklamalar

Bir MDI alt penceresi ekranı kapladığında şerit çubuğunda, sekme satırında MDI alt penceresinin sistem düğmeleri görüntülenir.

`CMFCRibbonBar::SetQuickAccessCommands`

Hızlı Erişim Araç Çubuğu'na bir veya daha fazla şerit öğesi ekler.

void SetQuickAccessCommands(
    const CList<UINT,UINT>& lstCommands,
    BOOL bRecalcLayout=TRUE);

Parametreler

lstCommands
[in] Hızlı Erişim Araç Çubuğu'na yerleştirilecek komutların listesi.

bRecalcLayout
[in] TRUE şerit öğelerini ekledikten sonra şeridi yeniden çizmek istiyorsanız; FALSE yoksa.

Örnek

Aşağıdaki örnekte sınıfında yönteminin SetQuickAccessCommands nasıl kullanılacağı gösterilmektedir CMFCRibbonBar .

// Add quick access commands to the toolbar
CList<UINT, UINT> lstQATCmds;

lstQATCmds.AddTail(ID_FILE_NEW);
lstQATCmds.AddTail(ID_FILE_OPEN);
lstQATCmds.AddTail(ID_FILE_SAVE);
lstQATCmds.AddTail(ID_FILE_PRINT_DIRECT);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessCommands(lstQATCmds);

`CMFCRibbonBar::SetQuickAccessDefaultState`

Hızlı erişim araç çubuğunu varsayılan duruma ayarlar.

void SetQuickAccessDefaultState(const CMFCRibbonQuickAccessToolBarDefaultState& state);

Parametreler

state
[in] Hızlı erişim araç çubuğu varsayılan durumu.

Açıklamalar

Hızlı erişim araç çubuğu durumu, komutların listesini ve bunların görünürlüğünü içerir.

Örnek

Aşağıdaki örnekte sınıfında yönteminin SetQuickAccessDefaultState nasıl kullanılacağı gösterilmektedir CMFCRibbonBar .

CMFCRibbonQuickAccessToolBarDefaultState *qaToolBarState =
    new CMFCRibbonQuickAccessToolBarDefaultState();
qaToolBarState->AddCommand(ID_FILE_NEW, true);
qaToolBarState->AddCommand(ID_FILE_OPEN, true);
// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessDefaultState(*qaToolBarState);

`CMFCRibbonBar::SetQuickAccessToolbarOnTop`

Hızlı erişim araç çubuğunu şerit çubuğunun üstüne veya altına konumlandırın.

void SetQuickAccessToolbarOnTop(BOOL bOnTop);

Parametreler

bOnTop
[in] TRUE hızlı erişim araç çubuğunu şerit çubuğunun üzerine konumlandırmak için; FALSE hızlı erişim araç çubuğunu şerit çubuğunun altına konumlandırmak için.

`CMFCRibbonBar::SetTooltipFixedWidth`

Şerit çubuğu için normal ve büyük boyutlu araç ipucu sabit genişliklerini ayarlar.

void SetTooltipFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Parametreler

nWidthRegular
[in] Normal sabit boyutlu araç ipucunun piksel cinsinden genişliği.

nWidthLargeImage
[in] Büyük bir sabit boyutlu araç ipucunun piksel cinsinden genişliği.

Açıklamalar

Parametrenin 0 olarak ayarlanması, ilgili genişliğin değişmesine neden olur.

`CMFCRibbonBar::ShowCategory`

Belirtilen şerit kategorisini gösterir veya gizler.

void ShowCategory(
    int nIndex,
    BOOL bShow=TRUE);

Parametreler

nIndex
[in] Şerit kategorisinin dizini.

bShow
[in] ise TRUEşerit kategorisini gösterin; aksi takdirde şerit kategorisini gizleyin.

`CMFCRibbonBar::ShowContextCategories`

Belirtilen kimliği içeren bağlam kategorilerini gösterir veya gizler.

void ShowContextCategories(
    UINT uiContextID,
    BOOL bShow=TRUE);

Parametreler

uiContextID
[in] Bağlam kategorisi kimliği.

bShow
[in] ise TRUE, belirtilen kimliği içeren kategorileri gösterin; aksi takdirde, belirtilen kimliği içeren kategorileri gizleyin.

`CMFCRibbonBar::ShowKeyTips`

Şerit çubuğundaki her şerit öğesinin tuş ipuçlarını gösterir.

void ShowKeyTips();

Açıklamalar

`CMFCRibbonBar::ToggleMimimizeState`

Şerit çubuğunu simge durumuna küçültülmüş ve ekranı kaplamış durumlar arasında değiştirir.

void ToggleMimimizeState();

Açıklamalar

Yöntem adındaki yazım hatası bilinen bir sorundur.

Simge durumuna küçültülmüş durumda, şerit denetimi gizlenir ve yalnızca sekmeler görüntülenir. Kullanıcı bir sekmeye tıkladığında, şerit denetimi açılır pencere olarak görüntülenir. Kullanıcı bir komutu tıkladığında veya yürütürken pencere kapanır.

`CMFCRibbonBar::TranslateChar`

Belirtilen tuş vuruşu karakter kodunun şerit çubuğu tarafından işlenip işlenmeyeceğini belirler.

virtual BOOL TranslateChar(UINT nChar);

Parametreler

nChar
[in] Kullanıcı tuş vuruşu karakter kodu.

Dönüş Değeri

TRUE karakter kodu şerit çubuğu tarafından işlendiyse; aksi takdirde FALSE.

Açıklamalar

Tuş ipuçları özelliği, kullanıcıların klavyeyi kullanarak şerit çubuğunda gezinmesini sağlar.

`CMFCRibbonBar::GetFocused`

Odaklanmış bir öğe döndürür.

virtual CMFCRibbonBaseElement* GetFocused();

Dönüş Değeri

Odaklanmış bir öğe veya NULLişaretçisi.

Açıklamalar

`CMFCRibbonBar::IsWindows7Look`

Şeridin Windows 7 görünümüne (küçük dikdörtgen uygulama düğmesi) sahip olup olmadığını gösterir.

BOOL IsWindows7Look() const;

Dönüş Değeri

TRUE Şeritte Windows 7 görünümü varsa; aksi takdirde FALSE.

Açıklamalar

`CMFCRibbonBar::LoadFromResource`

Aşırı yüklendi. Uygulama kaynaklarından bir Şerit Çubuğu yükler.

virtual BOOL LoadFromResource(
    UINT uiXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

virtual BOOL LoadFromResource(
    LPCTSTR lpszXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

Parametreler

uiXMLResID
Şerit Çubuğu bilgileriyle XML dizesinin kaynak kimliğini belirtir.

lpszResType
konumunda uiXMLResIDbulunan kaynağın türünü belirtir.

hInstance
Yürütülebilir dosyası kaynağı içeren modülün tanıtıcısı. ise hInstanceNULLsistem, geçerli işlemi oluşturmak için kullanılan modülden kaynağı yükler.

lpszXMLResID
Şerit Çubuğu bilgileriyle kaynak kimliğini (dize biçiminde) belirtir.

Dönüş Değeri

TRUE yük başarılı olursa; aksi takdirde FALSE.

Açıklamalar

`CMFCRibbonBar::SaveToXMLBuffer`

Şerit Çubuğu'nu arabelleğe kaydeder.

UINT SaveToXMLBuffer(LPBYTE* ppBuffer) const;

Parametreler

ppBuffer
Bu işlev döndürdüğünde, ppBuffer bu yöntem tarafından ayrılan arabelleğe işaret edin ve ŞERIT Çubuğu bilgilerini XML biçiminde içerir.

Dönüş Değeri

TRUE başarılı olursa; aksi takdirde FALSE.

Açıklamalar

`CMFCRibbonBar::SaveToXMLFile`

Şerit Çubuğu'nu bir XML dosyasına kaydeder.

BOOL SaveToXMLFile(LPCTSTR lpszFilePath) const;

Parametreler

lpszFilePath
Çıkış dosyasını belirtir.

Dönüş Değeri

TRUE başarılı olursa; aksi takdirde FALSE.

Açıklamalar

`CMFCRibbonBar::SetWindows7Look`

Şerit için Windows 7 görünümünü (küçük dikdörtgen uygulama düğmesi) etkinleştirir veya devre dışı bırakır.

void SetWindows7Look(
    BOOL bWindows7Look,
    BOOL bRecalc = TRUE);

Parametreler

bWindows7Look
TRUE Bir Windows 7 görünümü ayarlar; FALSE yoksa.

bRecalc
TRUE şerit düzenini yeniden hesaplar; FALSE yoksa.

Açıklamalar

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CPane Sınıf
CMFCRibbonCategory Sınıf
CMFCRibbonPanel Sınıf
CMFCRibbonBaseElement Sınıf
İzlenecek Yol: MFC Karalama Uygulamasını Güncelleştirme

Aracılığıyla paylaş

CMFCRibbonBar Sınıf

Sözdizimi

Üyeler

Ortak Oluşturucular

Genel Yöntemler

Açıklamalar

Devralma Hiyerarşisi

Gereksinimler

CMFCRibbonBar::ActivateContextCategory

Parametreler

Dönüş Değeri

CMFCRibbonBar::AddCategory

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

CMFCRibbonBar::AddContextCategory

Parametreler

Dönüş Değeri

Açıklamalar

CMFCRibbonBar::AddMainCategory

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

CMFCRibbonBar::AddPrintPreviewCategory

Dönüş Değeri

Açıklamalar

CMFCRibbonBar::AddQATOnlyCategory

Parametreler

Dönüş Değeri

Açıklamalar

CMFCRibbonBar::AddToTabs

Parametreler

Açıklamalar

CMFCRibbonBar::CMFCRibbonBar

Parametreler

Açıklamalar

CMFCRibbonBar::Create

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

CMFCRibbonBar::CreateEx

Parametreler

Dönüş Değeri

Açıklamalar

CMFCRibbonBar::DeactivateKeyboardFocus

Parametreler

Açıklamalar

CMFCRibbonBar::DrawMenuImage

Parametreler

Dönüş Değeri

Açıklamalar

CMFCRibbonBar::DWMCompositionChanged

Açıklamalar

CMFCRibbonBar::EnableKeyTips

Parametreler

Açıklamalar

CMFCRibbonBar::EnablePrintPreview

Parametreler

Açıklamalar

CMFCRibbonBar::EnableToolTips

Parametreler

Açıklamalar

CMFCRibbonBar::FindByData

Parametreler

Dönüş Değeri

Açıklamalar

CMFCRibbonBar::FindByID

Parametreler

Dönüş Değeri

Açıklamalar

CMFCRibbonBar::FindCategoryIndexByData

Parametreler

Dönüş Değeri

CMFCRibbonBar::ForceRecalcLayout

Açıklamalar

CMFCRibbonBar::GetActiveCategory

`CMFCRibbonBar` Sınıf

`CMFCRibbonBar::ActivateContextCategory`

`CMFCRibbonBar::AddCategory`

`CMFCRibbonBar::AddContextCategory`

`CMFCRibbonBar::AddMainCategory`

`CMFCRibbonBar::AddPrintPreviewCategory`

`CMFCRibbonBar::AddQATOnlyCategory`

`CMFCRibbonBar::AddToTabs`

`CMFCRibbonBar::CMFCRibbonBar`

`CMFCRibbonBar::Create`

`CMFCRibbonBar::CreateEx`

`CMFCRibbonBar::DeactivateKeyboardFocus`

`CMFCRibbonBar::DrawMenuImage`

`CMFCRibbonBar::DWMCompositionChanged`

`CMFCRibbonBar::EnableKeyTips`

`CMFCRibbonBar::EnablePrintPreview`

`CMFCRibbonBar::EnableToolTips`

`CMFCRibbonBar::FindByData`

`CMFCRibbonBar::FindByID`

`CMFCRibbonBar::FindCategoryIndexByData`

`CMFCRibbonBar::ForceRecalcLayout`

`CMFCRibbonBar::GetActiveCategory`

`CMFCRibbonBar::GetApplicationButton`

`CMFCRibbonBar::GetCaptionHeight`

`CMFCRibbonBar::GetCategory`

`CMFCRibbonBar::GetCategoryCount`

`CMFCRibbonBar::GetCategoryHeight`

`CMFCRibbonBar::GetCategoryIndex`

`CMFCRibbonBar::GetContextName`

`CMFCRibbonBar::GetDroppedDown`

`CMFCRibbonBar::GetElementsByID`

`CMFCRibbonBar::GetHideFlags`

`CMFCRibbonBar::GetItemIDsList`

`CMFCRibbonBar::GetKeyboardNavigationLevel`

`CMFCRibbonBar::GetKeyboardNavLevelCurrent`

`CMFCRibbonBar::GetKeyboardNavLevelParent`

`CMFCRibbonBar::GetMainCategory`

`CMFCRibbonBar::GetQATCommandsLocation`

`CMFCRibbonBar::GetQATDroppedDown`

`CMFCRibbonBar::GetQuickAccessCommands`

`CMFCRibbonBar::GetQuickAccessToolbarLocation`

`CMFCRibbonBar::GetTabTrancateRatio`

`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`

`CMFCRibbonBar::GetTooltipFixedWidthRegular`

`CMFCRibbonBar::GetVisibleCategoryCount`