CMFCRibbonBaseElement Sınıfı

Makale
08/04/2024

CMFCRibbonBaseElement sınıfı, şerit çubuğuna ekleyebileceğiniz tüm öğeler için temel sınıftır. Şerit öğelerine örnek olarak şerit düğmeleri, şerit onay kutuları ve şerit birleşik giriş kutuları verilebilir.

Sözdizimi

class CMFCRibbonBaseElement : public CObject

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
`CMFCRibbonBaseElement`	Bir `CMFCRibbonBaseElement` nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CMFCRibbonBaseElement::AddToKeyList	Şerit öğesi için bir tuş ipucu dizisine bir tuş ipucu ekler.
CMFCRibbonBaseElement::AddToListBox	Belirtilen şerit komutları liste kutusuna bir şerit öğesi ekler.
CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar	Şerit öğesinin hızlı erişim araç çubuğuna eklenip eklenemeyeceğini gösterir.
CMFCRibbonBaseElement::CanBeCompacted	Şerit öğesinin boyutunun sıkıştırılıp sıkıştırılamayacağını gösterir.
CMFCRibbonBaseElement::CanBeStretched	Şerit öğesinin yüksekliğinin, şerit satırının yüksekliğine dikey olarak artırılıp artırılamayacağını gösterir.
CMFCRibbonBaseElement::CanBeStretchedHorizontally	Şerit öğesinin genişliğinin değişip değişemeyeceğini gösterir.
CMFCRibbonBaseElement::CleanUpSizes	Şerit öğesinin boyut ayarlarını temizler.
CMFCRibbonBaseElement::ClosePopupMenu	Şerit öğesinin açılır menüsünü kapatır.
CMFCRibbonBaseElement::CopyFrom	Belirtilen `CMFCRibbonBaseElement` durumunu geçerli nesneye kopyalar.
CMFCRibbonBaseElement::D estroyCtrl	Şerit öğesini yok eder.
CMFCRibbonBaseElement::D rawImage	Şerit öğesi için resmi çizer.
CMFCRibbonBaseElement::Find	Geçerli nesneye işaret ederse, şerit öğesinin belirtilen işaretçisini döndürür.
CMFCRibbonBaseElement::FindByData	Belirtilen verileri içeriyorsa şerit öğesinin işaretçisini alır.
CMFCRibbonBaseElement::FindByID	Bu öğe belirtilen komut kimliğiyle tanımlanırsa şerit öğesine yönelik bir işaretçi alır.
CMFCRibbonBaseElement::FindByOriginal	Özgün şerit öğesi belirtilen şerit öğesiyle eşleşiyorsa şerit öğesinin işaretçisini alır.
CMFCRibbonBaseElement::GetCompactSize	Şerit öğesinin küçük boyutunu döndürür.
CMFCRibbonBaseElement::GetData	Şerit öğesiyle ilişkili kullanıcı tanımlı verileri alır.
CMFCRibbonBaseElement::GetDescription	Şerit öğesinin açıklamasını döndürür.
CMFCRibbonBaseElement::GetDroppedDown	Açılan menüsü aşağı bırakılırsa şerit öğesinin işaretçisini alır.
CMFCRibbonBaseElement::GetElements	Geçerli şerit öğesini belirtilen diziye ekler.
CMFCRibbonBaseElement::GetElementsByID	Geçerli şerit öğesi belirtilen komut kimliğini içeriyorsa, geçerli şerit öğesini belirtilen diziye ekler.
CMFCRibbonBaseElement::GetHighlighted	Vurgulanmışsa şerit öğesinin işaretçisini alır.
CMFCRibbonBaseElement::GetID	Şerit öğesinin komut kimliğini döndürür.
CMFCRibbonBaseElement::GetImageSize	Şerit öğesinin görüntü boyutunu döndürür.
CMFCRibbonBaseElement::GetIntermediateSize	Şerit öğesinin boyutunu ara durumunda döndürür.
CMFCRibbonBaseElement::GetKeys	Şerit öğesiyle ilişkilendirilmiş tuş ipucu döndürür.
CMFCRibbonBaseElement::GetKeyTipRect	Şerit öğesi için tuş ipucu sınır dikdörtgenini alır.
CMFCRibbonBaseElement::GetKeyTipSize	Tuş ipucu metninin boyutunu alır.
CMFCRibbonBaseElement::GetLocationInGroup	Şerit grubundaki şerit öğesinin görüntüleme konumunu gösterir.
CMFCRibbonBaseElement::GetMenuKeys	Bir düğmeyle ilişkili tuş ipuçlarını döndürür.
CMFCRibbonBaseElement::GetNotifyID	Şerit öğesinin bildirim komut kimliğini alır.
CMFCRibbonBaseElement::GetOriginal	Özgün şerit öğesini alır.
CMFCRibbonBaseElement::GetParentCategory	Şerit öğesinin şerit kategorisini alır.
CMFCRibbonBaseElement::GetParentPanel	Şerit öğesini içeren şerit panelini alır.
CMFCRibbonBaseElement::GetParentRibbonBar	Şerit öğesinin üst şerit çubuğunu alır.
CMFCRibbonBaseElement::GetParentWnd	Şerit öğesinin üst penceresini alır.
CMFCRibbonBaseElement::GetPressed	Kullanıcı şu anda basıyorsa şerit öğesine bir işaretçi alır.
CMFCRibbonBaseElement::GetQuickAccessToolBarID	Hızlı erişim araç çubuğunda bulunduğunda şerit öğesinin komut kimliğini alır.
CMFCRibbonBaseElement::GetRect	Şerit öğesinin sınırlayıcı dikdörtgenini döndürür.
CMFCRibbonBaseElement::GetRegularSize	Şerit öğesinin normal boyutunu döndürür.
CMFCRibbonBaseElement::GetSize	Şerit öğesinin geçerli boyutunu döndürür.
CMFCRibbonBaseElement::GetText	Şerit öğesiyle ilişkili metni döndürür.
CMFCRibbonBaseElement::GetToolTipText	Şerit öğesinin araç ipucu metnini döndürür.
CMFCRibbonBaseElement::GetTopLevelRibbonBar	Şerit öğesinin en üst düzey şerit çubuğunu alır.
CMFCRibbonBaseElement::HasCompactMode	Şerit öğesinin sıkıştırılmış bir moda sahip olup olmadığını belirtir.
CMFCRibbonBaseElement::HasFocus	Üst öğenin klavye odağı olup olmadığını gösterir.
CMFCRibbonBaseElement::HasIntermediateMode	Şerit öğesinin ara moda sahip olup olmadığını belirtir.
CMFCRibbonBaseElement::HasLargeMode	Şerit öğesinin büyük bir moda sahip olup olmadığını belirtir.
CMFCRibbonBaseElement::HasMenu	Şerit öğesinin bir menüsü olup olmadığını gösterir.
CMFCRibbonBaseElement::HitTest	Belirtilen nokta içinde yer alıyorsa şerit öğesinin işaretçisini alır.
CMFCRibbonBaseElement::IsAlignByColumn	Şerit öğesinin diğer şerit öğeleriyle dikey olarak hizalanıp hizalı olmadığını gösterir.
CMFCRibbonBaseElement::IsAlwaysLargeImage	Şerit öğesi görüntü boyutunun her zaman büyük olup olmadığını gösterir.
CMFCRibbonBaseElement::IsAutoRepeatMode	Şerit öğesinin otomatik yineleme modunda olup olmadığını gösterir.
CMFCRibbonBaseElement::IsChecked	Şerit öğesinin işaretli olup olmadığını belirtir.
CMFCRibbonBaseElement::IsCompactMode	Şerit öğesinin sıkıştırılmış modda olup olmadığını belirtir.
CMFCRibbonBaseElement::IsDefaultMenuLook
CMFCRibbonBaseElement::IsDisabled	Şerit öğesinin devre dışı bırakılıp bırakılmadığını belirtir.
CMFCRibbonBaseElement::IsDroppedDown	Şerit öğesinin bir açılır menü görüntüleyip görüntülemediğini ve aşağı bırakılıp bırakılmayacağını belirler.
CMFCRibbonBaseElement::IsFocused	Odağın şerit öğesinde olup olmadığını belirtir.
CMFCRibbonBaseElement::IsGalleryIcon	Şerit öğesinin bir şerit galerisinde yer alıp almayacağını gösterir.
CMFCRibbonBaseElement::IsHighlighted	Şerit öğesinin vurgulanıp vurgulu olmadığını belirtir.
CMFCRibbonBaseElement::IsIntermediateMode	Şerit öğesinin geçerli görüntüsünün ara boyut olup olmadığını gösterir.
CMFCRibbonBaseElement::IsLargeMode	Şerit öğesinin geçerli görüntüsünün büyük boyutlu olup olmadığını gösterir.
CMFCRibbonBaseElement::IsMenuMode	Şerit öğesinin bir menüde yer alıp almayacağını gösterir.
CMFCRibbonBaseElement::IsPressed	Kullanıcının şerit öğesine tıklayıp tıklamadığını gösterir.
CMFCRibbonBaseElement::IsQATMode	Şerit öğesinin hızlı erişim araç çubuğunda bulunup bulunmadığını gösterir.
CMFCRibbonBaseElement::IsSeparator	Şerit öğesinin bir görüntü ayırıcısı olup olmadığını gösterir.
CMFCRibbonBaseElement::IsShowGroupBorder	Şerit öğesinin ortak kenarlık görüntüleyen bir grupta bulunup bulunmadığını gösterir.
CMFCRibbonBaseElement::IsShowTooltipOnBottom	Araç ipucunun şerit öğesinin altında görüntülenip görüntülenmeyeceğini gösterir.
CMFCRibbonBaseElement::IsTabStop	Şerit öğesinin klavyeyle seçilip seçilemeyeceğini gösterir.
CMFCRibbonBaseElement::IsTextAlwaysOnRight	Şerit öğesinin metninin sağda görüntülenip görüntülenmeyeceğini gösterir.
CMFCRibbonBaseElement::IsVisible	Şerit öğesinin şu anda görüntülenip görüntülenmediğini gösterir.
CMFCRibbonBaseElement::IsWholeRowHeight	Şerit öğesinin ekran heigth'inin, onu içeren şerit panelinin ekran yüksekliğiyle aynı olup olmadığını gösterir.
CMFCRibbonBaseElement::NotifyCommand	Şerit öğesinin üst penceresine bir komut bildirimi gönderir.
CMFCRibbonBaseElement::NotifyHighlightListItem	Kullanıcı listede bulunan bir şerit öğesini vurguladığında şerit çubuğunun üst penceresine bildirir.
CMFCRibbonBaseElement::OnAddToQAToolbar	Şerit öğesini belirtilen hızlı erişim araç çubuğuna ekler.
CMFCRibbonBaseElement::OnAfterChangeRect	Şerit öğesinin araç ipucu nu güncelleştirir.
CMFCRibbonBaseElement::OnAutoRepeat	Şerit öğesini sürekli kullanıcı girişine yanıt olarak güncelleştirir.
CMFCRibbonBaseElement::OnCalcTextSize	Şerit öğesinin metninin boyutunu hesaplar.
CMFCRibbonBaseElement::OnChangeMenuHighlight	Bir menüde bulunan şerit öğesi için vurgu değiştiğinde çerçeve tarafından çağrılır.
CMFCRibbonBaseElement::OnDraw	Şerit öğesini çizmek için çerçeve tarafından çağrılır.
CMFCRibbonBaseElement::OnDrawKeyTip	Şerit öğesi için tuş ipucu çizmek için çerçeve tarafından çağrılır.
CMFCRibbonBaseElement::OnDrawMenuImage	Şerit öğesinin menü görüntüsü çizildiğinde çerçeve tarafından çağrılır.
CMFCRibbonBaseElement::OnDrawOnList	Komutlar liste kutusunda şerit öğesini çizmek için çerçeve tarafından çağrılır.
CMFCRibbonBaseElement::OnKey	Kullanıcı bir tuş ipucuna bastığında ve odak şerit öğesinde olduğunda çerçeve tarafından çağrılır.
CMFCRibbonBaseElement::OnMenuKey
CMFCRibbonBaseElement::OnRTLChanged	Düzen yön değiştirdiğinde çerçeve tarafından çağrılır.
CMFCRibbonBaseElement::OnShow	Şerit öğesini göstermek veya gizlemek için çerçeve tarafından çağrılır.
CMFCRibbonBaseElement::OnShowPopupMenu	Şerit öğesi bir açılır menü görüntüleyecekken çerçeve tarafından çağrılır.
CMFCRibbonBaseElement::P ostMenuCommand
CMFCRibbonBaseElement::Redraw	Şerit öğesinin görünümünü güncelleştirir.
CMFCRibbonBaseElement::SetACCData	Şerit öğesi için erişilebilirlik verilerini ayarlar.
CMFCRibbonBaseElement::SetCompactMode	Şerit öğesinin görüntü boyutunu ayarlar.
CMFCRibbonBaseElement::SetData	Bir veri öğesini şerit öğesiyle ilişkilendirir.
CMFCRibbonBaseElement::SetDefaultMenuLook
CMFCRibbonBaseElement::SetDescription	Şerit öğesinin açıklamasını ayarlar.
CMFCRibbonBaseElement::SetID	Şerit öğesinin komut kimliğini ayarlar.
CMFCRibbonBaseElement::SetInitialMode	Şerit öğesi için ilk görüntü boyutunu ayarlar.
CMFCRibbonBaseElement::SetKeys	Şerit öğesi için bir tuş ipucu ayarlar.
CMFCRibbonBaseElement::SetOriginal	Şerit öğesi için özgün şerit öğesini ayarlar.
CMFCRibbonBaseElement::SetParentCategory	Şerit öğesi için üst kategoriyi ayarlar.
CMFCRibbonBaseElement::SetParentMenu	Şerit öğesi için üst menü kapsayıcısını ayarlar.
CMFCRibbonBaseElement::SetParentRibbonBar	Şerit öğesinin üst şerit çubuğunu ayarlar.
CMFCRibbonBaseElement::SetRect	Şerit öğesi için görüntülendiği boyutları ayarlar.
CMFCRibbonBaseElement::SetText	Şerit öğesinin metnini ayarlar.
CMFCRibbonBaseElement::SetTextAlwaysOnRight	Şerit öğesinin sağda görüntülenecek metnini ayarlar.
CMFCRibbonBaseElement::SetToolTipText	Şerit öğesi için araç ipucu metnini ayarlar.
CMFCRibbonBaseElement::SetVisible	Şerit öğesinin görünürlük durumunu ayarlar.
CMFCRibbonBaseElement::StretchHorizontally	Şerit öğesinin genişliğini uzatır.
CMFCRibbonBaseElement::StretchToWholeRow	Şerit öğesinin görüntüleme yüksekliğini belirtilen satır yüksekliğine değiştirir.
CMFCRibbonBaseElement::UpdateTooltipInfo	Şerit öğesinin komut kaynağını kullanarak araç ipucu metnini güncelleştirir.

Korumalı Yöntemler

Veri Akışı Adı	Açıklama
CMFCRibbonBaseElement::OnProcessKey	Kullanıcı bir kısayol tuşuna bastığında çerçeve tarafından çağrılır.
CMFCRibbonBaseElement::OnSetFocus	Şerit öğesi giriş odağını aldığında veya kaybettiğinde çerçeve tarafından çağrılır.

Açıklamalar

sınıfı CMFCRibbonBaseElement , komut kimliği, metin etiketi, araç ipucu metni, öğe açıklaması ve durum (odaklanmış, vurgulanmış, basılmış, devre dışı bırakılmış, işaretlenebilir veya bırakılabilir) içeren tüm şerit öğeleri için ortak olan özellikleri tanımlar.

Şerit öğesinin görüntü boyutu, üye tarafından RibbonImageType tanımlanır ve bu da aşağıdaki değerlerden biri olabilir:

RibbonImageLarge
RibbonImageSmall

Boyutuna bağlı olarak, şerit öğesi küçük veya büyük bir görüntü görüntüler.

Örnek

Aşağıdaki örnekte, sınıftaki çeşitli yöntemlerin nasıl kullanılacağı gösterilmektedir CMFCRibbonBaseElement . Örnekte bir sınıftan CMFCRibbonStatusBar nesne almaCMFCRibbonBaseElement, şerit öğesinin açıklamasını ayarlama, metni ayarlama, tuş ipucu ayarlama ve şerit öğesi için araç ipucu metnini ayarlama gösterilmektedir. Bu kod parçacığı, draw client örneğinin bir parçasıdır.

// CMFCRibbonStatusBar m_wndStatusBar
CMFCRibbonBaseElement *pPane = m_wndStatusBar.FindByID(nID);

pPane->SetDescription(_T("a pane"));
// CString strText
pPane->SetText(strText);
pPane->SetKeys(_T("p"));
pPane->SetToolTipText(_T("this is a pane"));

Devralma Hiyerarşisi

CObject

CMFCRibbonBaseElement

Gereksinimler

Üst bilgi: afxbaseribbonelement.h

CMFCRibbonBaseElement::AddToKeyList

Şerit öğesi için bir tuş ipucu dizisine bir tuş ipucu ekler.

virtual void AddToKeyList(
    CArray<CMFCRibbonKeyTip*, CMFCRibbonKeyTip*>& arElems);

Parametreler

arElems
[in] Anahtar ipuçlarının CArray'sine başvuru.

Açıklamalar

Şerit tuş ipuçları özelliği etkinleştirildiğinde, kullanıcı ALT tuşuna veya F10 tuşuna bastığında çerçeve şerit tuş ipuçlarını görüntüler.

CMFCRibbonBaseElement::AddToListBox

Belirtilen şerit komutları liste kutusuna bir şerit öğesi ekler.

virtual int AddToListBox(
    CMFCRibbonCommandsListBox* pWndListBox,
    BOOL bDeep);

Parametreler

pWndListBox
[in] Komutlar liste kutusunun işaretçisi.

bDeep
[in] Bu parametre kullanılmaz.

Dönüş Değeri

Eklenen şerit öğesinin sıfır tabanlı dizini.

Açıklamalar

Çerçeve, kullanıcının kullanıcı arabirimini özelleştirmesini sağlamak için komutlar liste kutusuna şerit öğeleri ekler.

CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar

Şerit öğesinin hızlı erişim araç çubuğuna eklenip eklenemeyeceğini gösterir.

virtual BOOL CanBeAddedToQuickAccessToolBar() const;

Dönüş Değeri

Öğe eklenebiliyorsa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::CanBeCompacted

Şerit öğesinin boyutunun sıkıştırılıp sıkıştırılamayacağını gösterir.

virtual BOOL CanBeCompacted() const;

Dönüş Değeri

Şerit öğesinin boyutu küçük olabilirse TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Şerit öğesinin boyutu küçük, orta veya büyük olabilir.

CMFCRibbonBaseElement::CanBeStretched

Şerit öğesinin yüksekliğinin, şerit satırının yüksekliğine dikey olarak artırılıp artırılamayacağını gösterir.

virtual BOOL CanBeStretched();

Dönüş Değeri

Her zaman DOĞRU döndürür.

Açıklamalar

Varsayılan olarak bu yöntem her zaman TRUE döndürür. Şerit öğesinin yüksekliğini bir şerit satırının yüksekliğine dikey olarak artırıp artıramayacağını belirtmek için bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::CanBeStretchedHorizontally

Şerit öğesinin genişliğinin değişip değişemeyeceğini gösterir.

virtual BOOL CanBeStretchedHorizontally();

Dönüş Değeri

Her zaman YANLIŞ döndürür.

Açıklamalar

Varsayılan olarak bu yöntem her zaman YANLIŞ döndürür. Şerit öğesinin genişliğinin değişip değişemeyeceğini belirtmek için bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::CleanUpSizes

Şerit öğesinin boyut ayarlarını temizler.

virtual void CleanUpSizes();

Açıklamalar

Varsayılan olarak bu yöntem hiçbir şey yapmaz. Şerit öğesinin boyut ayarlarını sıfırlamak için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::ClosePopupMenu

Şerit öğesinin açılır menüsünü kapatır.

virtual void ClosePopupMenu();

Açıklamalar

CMFCRibbonBaseElement::CopyFrom

Belirtilen CMFCRibbonBaseElement durumunu geçerli nesneye kopyalar.

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Parametreler

Src
[in] Kaynak CMFCRibbonBaseElement nesnesi.

Açıklamalar

CMFCRibbonBaseElement::D estroyCtrl

Şerit öğesini yok eder.

virtual void DestroyCtrl();

Açıklamalar

Varsayılan olarak bu yöntem hiçbir şey yapmaz. Şerit öğesini yok etmek için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::D rawImage

Şerit öğesi için resmi çizer.

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

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

type
[in] Numaralandırılmış bir görüntü türü değeri. Olası değerlerin listesi için Açıklamalar bölümüne bakın.

rectImage
[in] Görüntü dikdörtgeni.

Açıklamalar

Varsayılan olarak bu yöntem hiçbir şey yapmaz. Şerit öğesinin görüntüsünü çizmek için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

Aşağıdaki tabloda tür parametresi için olası değerler listelenir:

Value	Açıklama
`RibbonImageLarge`	Büyük 32x32 piksel görüntü boyutu.
`RibbonImageSmall`	Küçük 16x16 piksel görüntü boyutu.

CMFCRibbonBaseElement::Find

Geçerli nesneye işaret ederse belirtilen işaretçiyi döndürür.

virtual CMFCRibbonBaseElement* Find(const CMFCRibbonBaseElement* pElement);

Parametreler

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

Dönüş Değeri

pElement geçerli nesneye işaret ederse şerit öğesine işaret eden bir işaretçi; aksi takdirde NULL.

Açıklamalar

CMFCRibbonBaseElement::FindByData

Belirtilen verileri içeriyorsa şerit öğesinin işaretçisini alır.

virtual CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData);

Parametreler

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

Dönüş Değeri

Belirtilen verileri içeriyorsa şerit öğesinin işaretçisi; aksi takdirde NULL.

Açıklamalar

CMFCRibbonBaseElement::FindByID

Bu öğe belirtilen komut kimliğiyle tanımlanırsa şerit öğesine yönelik bir işaretçi alır.

virtual CMFCRibbonBaseElement* FindByID(UINT uiCmdID);

Parametreler

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

Dönüş Değeri

Bu öğe belirtilen komut kimliğiyle tanımlanırsa şerit öğesinin işaretçisi; aksi takdirde NULL.

Açıklamalar

CMFCRibbonBaseElement::FindByOriginal

Özgün şerit öğesi belirtilen şerit öğesiyle eşleşiyorsa geçerli şerit öğesinin işaretçisini alır.

virtual CMFCRibbonBaseElement* FindByOriginal(CMFCRibbonBaseElement* pOriginal);

Parametreler

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

Dönüş Değeri

Özgün şerit öğesi belirtilen şerit öğesiyle eşleşiyorsa şerit öğesinin işaretçisi; aksi takdirde NULL.

Açıklamalar

Başka bir kapsayıcıya kopyalanan şerit öğeleri, özgün şerit öğesine bir işaretçi tutar.

CMFCRibbonBaseElement::GetCompactSize

Şerit öğesinin küçük boyutunu döndürür.

virtual CSize GetCompactSize(CDC* pDC);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

Dönüş Değeri

Şerit öğesinin küçük boyutu.

Not

Küçük boyut, şerit öğesinin kesildiğini gösterir (küçük bir resim veya metin içermeyen bir görüntü görüntüler).

CMFCRibbonBaseElement::GetData

Şerit öğesiyle ilişkili kullanıcı tanımlı verileri alır.

DWORD_PTR GetData() const;

Dönüş Değeri

Şerit öğesiyle ilişkili kullanıcı tanımlı veriler.

CMFCRibbonBaseElement::GetDescription

Şerit öğesinin açıklamasını döndürür.

virtual CString GetDescription() const;

Dönüş Değeri

Şerit öğesi açıklaması. Açıklama, durum çubuğunda veya araç ipucunda ya da şerit öğesi CMFCRibbonMainPanel Sınıfında bulunuyorsa menü düğmesinin altında görüntülenir.

CMFCRibbonBaseElement::GetDroppedDown

Açılan menüsü aşağı bırakılırsa şerit öğesinin işaretçisini alır.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Dönüş Değeri

Açılan menüsü aşağı bırakılırsa şerit öğesinin işaretçisi; aksi takdirde NULL.

Açıklamalar

CMFCRibbonBaseElement::GetElements

Geçerli şerit öğesini belirtilen diziye ekler.

virtual void GetElements(
    CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parametreler

arElements
[in, out] Şerit öğeleri dizisi.

Açıklamalar

CMFCRibbonBaseElement::GetElementsByID

Geçerli şerit öğesi belirtilen komut kimliğini içeriyorsa, geçerli şerit öğesini belirtilen diziye ekler.

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

Parametreler

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

arElements
[in] Şerit öğeleri dizisi.

Açıklamalar

CMFCRibbonBaseElement::GetHighlighted

Vurgulanmışsa şerit öğesinin işaretçisini alır.

virtual CMFCRibbonBaseElement* GetHighlighted();

Dönüş Değeri

Vurgulanmışsa şerit öğesinin işaretçisi; aksi takdirde NULL.

Açıklamalar

CMFCRibbonBaseElement::GetID

Şerit öğesinin komut kimliğini döndürür.

UINT GetID() const;

Dönüş Değeri

Şerit öğesinin komut kimliği.

CMFCRibbonBaseElement::GetImageSize

Şerit öğesinin görüntü boyutunu döndürür.

virtual CSize GetImageSize(RibbonImageType R) const;

Dönüş Değeri

Şerit öğesinin görüntü boyutu.

CMFCRibbonBaseElement::GetIntermediateSize

Şerit öğesinin boyutunu ara durumunda döndürür.

virtual CSize GetIntermediateSize(CDC* pDC);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

Dönüş Değeri

Şerit öğesinin ara durumundaki boyutu.

CMFCRibbonBaseElement::GetKeys

Şerit öğesiyle ilişkilendirilmiş tuş ipucu döndürür.

LPCTSTR GetKeys() const;

Dönüş Değeri

Şerit öğesiyle ilişkilendirilmiş bir tuş ipucu.

CMFCRibbonBaseElement::GetKeyTipRect

Şerit öğesi için tuş ipucu sınır dikdörtgenini alır.

virtual CRect GetKeyTipRect(
    CDC* pDC,
    BOOL bIsMenu);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

bIsMenu
[in] Şerit öğesi bir açılır menü görüntülüyorsa DOĞRU; aksi takdirde YANLIŞ.

Dönüş Değeri

Her zaman 0 değer içeren bir dikdörtgen döndürür.

Açıklamalar

Anahtar ipucu sınırı dikdörtgenini döndürmek için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::GetKeyTipSize

Tuş ipucu metninin boyutunu alır.

virtual CSize GetKeyTipSize(CDC* pDC);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

Dönüş Değeri

Tuş ipucu metninin boyutu.

Açıklamalar

CMFCRibbonBaseElement::GetLocationInGroup

Şerit grubundaki şerit öğesinin görüntüleme konumunu gösterir.

RibbonElementLocation GetLocationInGroup() const;

Dönüş Değeri

RibbonElementLocation Numaralandırılmış değer. Aşağıdaki tabloda olası değerler listelemektedir.

Value	Açıklama
`RibbonElementNotInGroup`	Şerit öğesi bir şerit grubunda yer almaz.
`RibbonElementSingleInGroup`	Şerit öğesi, şerit grubundaki tek öğe olarak görüntülenir.
`RibbonElementFirstInGroup`	Şerit öğesi, şerit grubunun sol ucunda görüntülenir.
`RibbonElementLastInGroup`	Şerit öğesi, şerit grubunun sağ ucunda görüntülenir.
`RibbonElementMiddleInGroup`	Şerit öğesi şerit grubunun her iki ucunda da görüntülenmez.

Açıklamalar

Şerit öğe grupları yalnızca yatay olarak hizalanır.

CMFCRibbonBaseElement::GetMenuKeys

Şerit öğesi için menü tuş ipucu döndürür.

LPCTSTR GetMenuKeys() const;

Dönüş Değeri

Şerit öğesiyle ilişkili menü tuş ipucu.

Açıklamalar

Çağrıldığında, menü tuş ipucu bir açılır menü görüntüler.

CMFCRibbonBaseElement::GetNotifyID

Şerit öğesinin bildirim komut kimliğini alır.

virtual UINT GetNotifyID();

Dönüş Değeri

Bildirim komut kimliği.

Açıklamalar

CMFCRibbonBaseElement::GetOriginal

Özgün şerit öğesini alır.

CMFCRibbonBaseElement* GetOriginal() const;

Dönüş Değeri

Özgün şerit öğesinin işaretçisi.

Açıklamalar

Başka bir kapsayıcıya kopyalanan şerit öğeleri, özgün şerit öğesine bir işaretçi tutar.

CMFCRibbonBaseElement::GetParentCategory

Şerit öğesinin şerit kategorisini alır.

CMFCRibbonCategory* GetParentCategory() const;

Dönüş Değeri

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

Açıklamalar

CMFCRibbonBaseElement::GetParentPanel

Şerit öğesini içeren şerit panelini alır.

virtual CMFCRibbonPanel* GetParentPanel() const;

Dönüş Değeri

Şerit öğesini içeren şerit panelinin işaretçisi.

Açıklamalar

CMFCRibbonBaseElement::GetParentRibbonBar

Şerit öğesinin üst şerit çubuğunu alır.

CMFCRibbonBar* GetParentRibbonBar() const;

Dönüş Değeri

Şerit öğesinin üst şerit çubuğunun işaretçisi.

Açıklamalar

CMFCRibbonBaseElement::GetParentWnd

Şerit öğesinin üst penceresini alır.

virtual CWnd* GetParentWnd() const;

Dönüş Değeri

Yöntem başarılı olursa şerit öğesinin üst penceresine yönelik bir işaretçi; aksi takdirde NULL.

Açıklamalar

Şerit öğesinin üst penceresi bir CMFCRibbonBar Sınıfı veya CMFCRibbonPanelMenuBar'dır.

CMFCRibbonBaseElement::GetPressed

Kullanıcı şu anda basıyorsa şerit öğesine bir işaretçi alır.

virtual CMFCRibbonBaseElement* GetPressed();

Dönüş Değeri

Kullanıcı o anda basıyorsa şerit öğesinin işaretçisi; aksi takdirde NULL.

Açıklamalar

CMFCRibbonBaseElement::GetQuickAccessToolBarID

Hızlı erişim araç çubuğunda bulunduğunda şerit öğesinin komut kimliğini alır.

virtual UINT GetQuickAccessToolBarID() const;

Dönüş Değeri

Hızlı erişim araç çubuğunda bulunduğunda şerit öğesinin komut kimliği.

Açıklamalar

CMFCRibbonBaseElement::GetRect

Şerit öğesinin sınırlayıcı dikdörtgenini döndürür.

CRect GetRect() const;

Dönüş Değeri

Şerit öğesinin sınırlayıcı dikdörtgeni. Dikdörtgenin konumu üst Şerit denetiminin koordinatlarındadır.

CMFCRibbonBaseElement::GetRegularSize

Şerit öğesinin normal boyutunu döndürür.

virtual CSize GetRegularSize(CDC* pDC) = 0;

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

Dönüş Değeri

Şerit öğesinin normal boyutu.

Açıklamalar

Not

Normal boyut, şerit öğesinin mümkün olan en büyük boyutudur.

CMFCRibbonBaseElement::GetSize

Şerit öğesinin geçerli boyutunu döndürür.

virtual CSize GetSize(CDC* pDC);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

Dönüş Değeri

Şerit öğesinin geçerli boyutu.

CMFCRibbonBaseElement::GetText

Şerit öğesiyle ilişkili metni döndürür.

LPCTSTR GetText() const;

Dönüş Değeri

Şerit öğesiyle ilişkili metin.

CMFCRibbonBaseElement::GetToolTipText

Şerit öğesinin araç ipucu metnini döndürür.

virtual CString GetToolTipText() const;

Dönüş Değeri

Şerit öğesinin araç ipucu metni.

CMFCRibbonBaseElement::GetTopLevelRibbonBar

Şerit öğesinin en üst düzey şerit çubuğunu alır.

CMFCRibbonBar* GetTopLevelRibbonBar() const;

Dönüş Değeri

Yöntem başarılı olursa şerit öğesinin en üst düzey şerit çubuğuna yönelik bir işaretçi; aksi takdirde NULL.

Açıklamalar

CMFCRibbonBaseElement::HasCompactMode

Şerit öğesinin sıkıştırılmış bir moda sahip olup olmadığını belirtir.

virtual BOOL HasCompactMode() const;

Dönüş Değeri

Şerit öğesinin sıkıştırılmış bir modu varsa TRUE. FALSE aksi takdirde.

Açıklamalar

Not

Kompakt modda, bir öğe yalnızca küçük bir görüntü görüntüler.

CMFCRibbonBaseElement::HasIntermediateMode

Şerit öğesinin ara moda sahip olup olmadığını belirtir.

virtual BOOL HasIntermediateMode() const;

Dönüş Değeri

Şerit öğesinin ara modu varsa TRUE, aksi takdirde YANLIŞ. Ara modda, bir öğe görüntünün sağında küçük bir görüntü ve metin görüntüler.

Açıklamalar

CMFCRibbonBaseElement::HasLargeMode

Şerit öğesinin büyük bir moda sahip olup olmadığını belirler.

virtual BOOL HasLargeMode() const;

Dönüş Değeri

Şerit öğesinin büyük bir modu varsa TRUE. FALSE aksi takdirde.

Açıklamalar

Büyük modda, bir öğe üst panelin tam yüksekliğini alabilir.

CMFCRibbonBaseElement::HasMenu

Şerit öğesinin bir menüsü olup olmadığını gösterir.

virtual BOOL HasMenu() const;

Dönüş Değeri

Her zaman YANLIŞ döndürür.

Açıklamalar

Varsayılan olarak bu yöntem her zaman YANLIŞ döndürür. Şerit öğesinin bir menüsü olup olmadığını belirtmek için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::HitTest

Belirtilen nokta içinde yer alıyorsa şerit öğesinin işaretçisini alır.

virtual CMFCRibbonBaseElement* HitTest(CPoint point);

Parametreler

nokta
[in] Bu parametre kullanılmaz.

Dönüş Değeri

Varsa şerit öğesinin işaretçisi; aksi takdirde YANLIŞ.

Açıklamalar

Varsayılan olarak bu yöntem, şerit öğesi mevcut olduğunda her zaman geçerli bir işaretçi döndürür. Noktanın şerit öğesinde olup olmadığını belirtmek için bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::IsAlignByColumn

Şerit öğesinin diğer şerit öğeleriyle dikey olarak hizalanıp hizalı olmadığını gösterir.

virtual BOOL IsAlignByColumn() const;

Dönüş Değeri

Her zaman DOĞRU döndürür.

Açıklamalar

Varsayılan olarak bu yöntem her zaman TRUE döndürür. Türetilmiş şerit öğesinin diğer şerit öğeleriyle dikey olarak hizalanıp hizalanmamış olduğunu belirtmek için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::IsAlwaysLargeImage

Şerit öğesi görüntü boyutunun her zaman büyük olup olmadığını gösterir.

virtual BOOL IsAlwaysLargeImage() const;

Dönüş Değeri

Şerit öğesi görüntü boyutu her zaman büyükse DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

Büyük resim boyutu 32 x 32 pikseldir.

CMFCRibbonBaseElement::IsAutoRepeatMode

Şerit öğesinin otomatik yineleme modunda olup olmadığını gösterir.

virtual BOOL IsAutoRepeatMode(int& nDelay) const;

Parametreler

nDelay
[in] Bu parametre kullanılmaz.

Dönüş Değeri

Her zaman YANLIŞ döndürür.

Açıklamalar

Varsayılan olarak bu yöntem her zaman YANLIŞ döndürür. Şerit öğesinin otomatik yineleme modunda olup olmadığını belirtmek için bu yöntemi geçersiz kılın.

Otomatik yineleme modunda şerit öğesi, sürekli kullanıcı girişine milisaniye cinsinden ölçülen belirli bir aralıkta yanıt verir.

CMFCRibbonBaseElement::IsChecked

Şerit öğesinin işaretli olup olmadığını belirtir.

virtual BOOL IsChecked() const;

Dönüş Değeri

Şerit öğesi işaretliyse TRUE; aksi takdirde YANLIŞ.

CMFCRibbonBaseElement::IsCompactMode

Şerit öğesinin sıkıştırılmış modda olup olmadığını belirtir.

BOOL IsCompactMode() const;

Dönüş Değeri

Şerit öğesi sıkıştırılmış moddaysa TRUE; aksi takdirde YANLIŞ.

CMFCRibbonBaseElement::IsDefaultMenuLook

Şerit öğesinin açılır komut olarak görünecek şekilde ayarlanıp ayarlanmadığını gösterir.

BOOL IsDefaultMenuLook() const;

Dönüş Değeri

Şerit öğesi açılır komut olarak görünecek şekilde ayarlandıysa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::IsDisabled

Şerit öğesinin devre dışı bırakılıp bırakılmadığını belirtir.

virtual BOOL IsDisabled() const;

Dönüş Değeri

Şerit öğesi devre dışıysa TRUE; aksi takdirde YANLIŞ.

CMFCRibbonBaseElement::IsDroppedDown

Şerit öğesinin bir açılır menü görüntüleyip görüntülemediğini ve aşağı bırakılıp bırakılmayacağını belirtir.

virtual BOOL IsDroppedDown() const;

Dönüş Değeri

Şerit öğesi aşağı bırakılır ve bir açılır menü görüntülerse TRUE; aksi takdirde YANLIŞ.

CMFCRibbonBaseElement::IsFocused

Odağın şerit öğesinde olup olmadığını belirtir.

virtual BOOL IsFocused() const;

Dönüş Değeri

Odak şerit öğesindeyse DOĞRU; aksi takdirde YANLIŞ.

CMFCRibbonBaseElement::IsGalleryIcon

Şerit öğesinin bir şerit galerisinde yer alıp almayacağını gösterir.

virtual BOOL IsGalleryIcon() const;

Dönüş Değeri

Her zaman YANLIŞ döndürür.

Açıklamalar

Varsayılan olarak bu yöntem her zaman YANLIŞ döndürür. Şerit öğesinin bir şerit galerisinde yer alıp almadığını belirtmek için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::IsHighlighted

Şerit öğesinin vurgulanıp vurgulu olmadığını belirtir.

virtual BOOL IsHighlighted() const;

Dönüş Değeri

Şerit öğesi vurgulanmışsa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::IsIntermediateMode

Şerit öğesinin geçerli görüntüsünün ara boyut olup olmadığını gösterir.

BOOL IsIntermediateMode() const;

Dönüş Değeri

Şerit öğesinin resmi ara boyuttaysa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Ara görüntü boyutu 16 x 16 pikseldir.

CMFCRibbonBaseElement::IsLargeMode

Şerit öğesinin geçerli görüntüsünün büyük boyutlu olup olmadığını gösterir.

BOOL IsLargeMode() const;

Dönüş Değeri

Şerit öğesinin resmi büyük boyutluysa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Büyük resim boyutu 32 x 32 pikseldir.

CMFCRibbonBaseElement::IsMenuMode

Şerit öğesinin bir menüde yer alıp almayacağını gösterir.

BOOL IsMenuMode() const;

Dönüş Değeri

Şerit öğesi bir menüde yer alırsa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::IsPressed

Kullanıcının şerit öğesine tıklayıp tıklamadığını gösterir.

virtual BOOL IsPressed() const;

Dönüş Değeri

Kullanıcı şerit öğesine tıkladıysa TRUE; aksi takdirde YANLIŞ.

CMFCRibbonBaseElement::IsQATMode

Şerit öğesinin hızlı erişim araç çubuğunda bulunup bulunmadığını gösterir.

BOOL IsQATMode() const;

Dönüş Değeri

Şerit öğesi hızlı erişim araç çubuğunda yer alırsa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::IsSeparator

Şerit öğesinin bir görüntü ayırıcısı olup olmadığını gösterir.

virtual BOOL IsSeparator() const;

Dönüş Değeri

Şerit öğesi bir görüntü ayırıcısıysa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::IsShowGroupBorder

Şerit öğesinin ortak kenarlık görüntüleyen bir grupta bulunup bulunmadığını gösterir.

BOOL IsShowGroupBorder() const;

Dönüş Değeri

Şerit öğesi ortak bir kenarlık görüntüleyen bir grupta yer alırsa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::IsShowTooltipOnBottom

Araç ipucunun şerit öğesinin altında görüntülenip görüntülenmeyeceğini gösterir.

virtual BOOL IsShowTooltipOnBottom() const;

Dönüş Değeri

Araç ipucu şerit öğesinin altında görüntüleniyorsa TRUE; araç ipucu işaretçinin yanında görüntüleniyorsa YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::IsTabStop

Şerit öğesinin klavyeyle seçilip seçilemeyeceğini gösterir.

virtual BOOL IsTabStop() const;

Dönüş Değeri

Her zaman DOĞRU döndürür.

Açıklamalar

Varsayılan olarak bu yöntem her zaman TRUE döndürür. Şerit öğesinin klavyeyle seçilip seçilemeyeceğini belirtmek için bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::IsTextAlwaysOnRight

Şerit öğesinin metninin sağda görüntülenip görüntülenmeyeceğini gösterir.

BOOL IsTextAlwaysOnRight() const;

Dönüş Değeri

Şerit öğesinin metni sağda görüntüleniyorsa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::IsVisible

Şerit öğesinin şu anda görüntülenip görüntülenmediğini gösterir.

BOOL IsVisible() const;

Dönüş Değeri

Şerit öğesi şu anda görüntüleniyorsa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::IsWholeRowHeight

Şerit öğesinin görüntüleme yüksekliğinin, onu içeren şerit panelinin ekran yüksekliğiyle aynı olup olmadığını gösterir.

virtual BOOL IsWholeRowHeight() const;

Dönüş Değeri

Her zaman YANLIŞ döndürür.

Açıklamalar

Varsayılan olarak bu yöntem her zaman YANLIŞ döndürür. Şerit öğesinin görüntüleme yüksekliğinin, onu içeren şerit panelinin ekran yüksekliğiyle aynı olup olmadığını belirtmek için bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::NotifyCommand

Şerit öğesinin üst penceresine bir komut bildirimi gönderir.

BOOL NotifyCommand(BOOL bWithDelay = FALSE);

Parametreler

bWithDelay
[in] Üst pencerenin ileti kuyruğuna komut bildirimi eklemek için TRUE; iletiyi üst pencereye hemen göndermek için YANLIŞ.

Dönüş Değeri

İleti gönderildiyse TRUE; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::NotifyHighlightListItem

Kullanıcı listede bulunan bir şerit öğesini vurguladığında şerit çubuğunun üst penceresine bildirir.

virtual void NotifyHighlightListItem(int nIndex);

Parametreler

nIndex
[in] Listedeki şerit öğesinin dizini.

Açıklamalar

CMFCRibbonBaseElement::OnAddToQAToolbar

Şerit öğesini belirtilen hızlı erişim araç çubuğuna ekler.

virtual BOOL OnAddToQAToolbar(CMFCRibbonQuickAccessToolBar& qat);

Parametreler

Qat
[in] Hızlı erişim araç çubuğu.

Dönüş Değeri

Şerit öğesinin hızlı erişim araç çubuğuna eklendiğini gösteren her zaman DOĞRU döndürür.

Açıklamalar

CMFCRibbonBaseElement::OnAfterChangeRect

Şerit öğesinin araç ipucu nu güncelleştirir.

virtual void OnAfterChangeRect(CDC* pDC);

Parametreler

pDC
[in] Bu parametre kullanılmaz.

Açıklamalar

Varsayılan olarak bu yöntem şerit öğesinin araç ipucu nu güncelleştirir. Şerit öğesini görüntüleme dikdörtgeni değiştikten sonra güncelleştirmek için bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::OnAutoRepeat

Şerit öğesini sürekli kullanıcı girişine yanıt olarak güncelleştirir.

virtual BOOL OnAutoRepeat();

Dönüş Değeri

Her zaman YANLIŞ döndürür.

Açıklamalar

Varsayılan olarak bu yöntem her zaman FALSE döndürür. Sürekli kullanıcı girişini işlemek için bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::OnCalcTextSize

Şerit öğesinin metninin boyutunu hesaplar.

virtual void OnCalcTextSize(CDC* pDC);

Parametreler

pDC
[in] Bu parametre kullanılmaz.

Açıklamalar

Varsayılan olarak bu yöntem hiçbir şey yapmaz. Şerit öğesinin metninin boyutunu hesaplamak için bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::OnChangeMenuHighlight

Bir menüde bulunan şerit öğesi için vurgu değiştiğinde çerçeve tarafından çağrılır.

virtual void OnChangeMenuHighlight(CMFCRibbonPanelMenuBar* pPanelMenuBar
    CMFCRibbonBaseElement* pHot);

Parametreler

pPanelMenuBar
[in] Bu parametre kullanılmaz.

pHot
[in] Bu parametre kullanılmaz.

Açıklamalar

Varsayılan olarak bu yöntem hiçbir şey yapmaz. Vurgu değiştiğinde bir menüde bulunan şerit öğesini güncelleştirmek için bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::OnDraw

Şerit öğesini çizmek için çerçeve tarafından çağrılır.

virtual void OnDraw(CDC* pDC) = 0;

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

Açıklamalar

Belirli bir şerit öğesinin çizimini özelleştirmek istiyorsanız, türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::OnDrawKeyTip

Şerit öğesi için tuş ipucu çizmek için çerçeve tarafından çağrılır.

virtual void OnDrawKeyTip(
    CDC* pDC,
    const CRect& rect,
    BOOL bIsMenu);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

Rect
[in] Anahtar ipucu için sınır dikdörtgeni.

bIsMenu
[in] Tuş ipucu bir açılır menü düğmesi içinse DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::OnDrawMenuImage

Şerit öğesinin menü görüntüsü çizildiğinde çerçeve tarafından çağrılır.

virtual BOOL OnDrawMenuImage(
    CDC* pDC,
    CRect rect);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

Rect
[in] Menü görüntüsü dikdörtgeni.

Dönüş Değeri

Görüntünün çizildiğini belirtmek için her zaman DOĞRU döndürür.

Açıklamalar

CMFCRibbonBaseElement::OnDrawOnList

Komutlar liste kutusunda şerit öğesini çizmek için çerçeve tarafından çağrılır.

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Parametreler

pDC
[in] Şerit öğesi için bir cihaz bağlamı işaretçisi.

strText
[in] Görüntüleme metni.

nTextOffset
[in] Liste kutusunun sol tarafından görünen metne piksel cinsinden uzaklık.

Rect
[in] Şerit öğesinin görüntü dikdörtgeni.

bIsSelected
[in] Bu parametre kullanılmaz.

bHighlighted
[in] Bu parametre kullanılmaz.

Açıklamalar

Komutlar liste kutusunda, kullanıcıların hızlı erişim araç çubuğunu özelleştirmesini sağlamak için şerit öğeleri görüntülenir.

CMFCRibbonBaseElement::OnKey

Kullanıcı bir tuş ipucuna bastığında ve odak şerit öğesinde olduğunda çerçeve tarafından çağrılır.

virtual BOOL OnKey(BOOL bIsMenuKey);

Parametreler

bIsMenuKey
[in] Tuş ipucu bir açılır menü görüntülüyorsa DOĞRU; aksi takdirde YANLIŞ.

Dönüş Değeri

Olay işlendiyse TRUE; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::OnMenuKey

Kullanıcı ana panelde bir menü tuş ipucuna bastığında çerçeve tarafından çağrılır.

virtual BOOL OnMenuKey(UINT nUpperChar);

Parametreler

nUpperChar
[in] Bu parametre kullanılmaz.

Dönüş Değeri

Her zaman YANLIŞ döndürür.

Açıklamalar

Varsayılan olarak bu yöntem her zaman YANLIŞ döndürür. Kullanıcı ana panelde bir menü tuş ipucuna bastığında yanıt vermek için bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::OnProcessKey

Kullanıcı bir kısayol tuşuna bastığında çerçeve tarafından çağrılır.

virtual BOOL OnProcessKey(UINT nChar);

Parametreler

nChar
[in] Bu parametre kullanılmaz.

Dönüş Değeri

Her zaman YANLIŞ döndürür.

Açıklamalar

Şerit öğesinin bir kısayol tuşunu işlemesini istiyorsanız bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::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] Bu parametre kullanılmaz.

Açıklamalar

Varsayılan olarak bu yöntem hiçbir şey yapmaz. Düzen yön değiştirdiğinde şerit öğesini ayarlamak için bu yöntemi geçersiz kılın. Varsayılan düzen yönü soldan sağadır.

CMFCRibbonBaseElement::OnSetFocus

Şerit öğesi giriş odağını aldığında veya kaybettiğinde çerçeve tarafından çağrılır.

virtual void OnSetFocus(BOOL B);

Açıklamalar

Uygulamanızın şerit öğesinin odağındaki bir değişikliği işlemesini istiyorsanız, türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::OnShow

Şerit öğesini göstermek veya gizlemek için çerçeve tarafından çağrılır.

virtual void OnShow(BOOL bShow);

Parametreler

bShow
[in] Bu parametre kullanılmaz.

Açıklamalar

Varsayılan olarak bu yöntem hiçbir şey yapmaz. Şerit öğesini göstermek veya gizlemek için bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::OnShowPopupMenu

Şerit öğesi bir açılır menü göstermeden önce çerçeve tarafından çağrılır.

virtual void OnShowPopupMenu();

Açıklamalar

Bu yöntem, şerit çubuğunun üst penceresine şerit öğesinin bir açılır menü göstereceğini bildirir.

CMFCRibbonBaseElement::P ostMenuCommand

Şerit öğesinin açılır menüsünü kapatır ve üst menüye yakın bir ileti gönderir.

void PostMenuCommand(UINT uiCmdId);

Parametreler

uiCmdId
[in] parametresi kullanılmaz.

Açıklamalar

Kapat iletisi yalnızca şerit öğesi bir açılır menüde bulunuyorsa gönderilir.

CMFCRibbonBaseElement::Redraw

Şerit öğesinin görünümünü güncelleştirir.

virtual void Redraw();

Açıklamalar

Bu yöntem RDW_INVALIDATE, RDW_ERASE ve RDW_UPDATENOW bayrakları ayarlanmış şekilde CWnd::RedrawWindow'u çağırarak şerit öğesinin görüntü dikdörtgenini yeniden çizer.

CMFCRibbonBaseElement::SetACCData

Şerit öğesi 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

Her zaman DOĞRU döndürür.

Açıklamalar

Varsayılan olarak bu yöntem şerit öğesinin erişilebilirlik verilerini ayarlar ve her zaman TRUE döndürür. Erişilebilirlik verilerini ayarlamak ve başarılı veya başarısız olduğunu belirten bir değer döndürmek için bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::SetCompactMode

Şerit öğesinin görüntü boyutunu ayarlar.

virtual void SetCompactMode(BOOL bCompactMode = TRUE);

Parametreler

bCompactMode
[in] Şerit öğesinin görüntü boyutunu küçültmek için TRUE; Şerit öğesinin görüntü boyutunu artırmak için YANLIŞ.

Açıklamalar

Aşağıdaki tabloda bu yöntemin mantığı özetlenmektedir.

bCompactMode	Geçerli şerit öğesi boyutu	Yeni şerit öğesi boyutu
TRUE	Compact	Bir değişiklik olmadı.
TRUE	Orta	Mümkünse kompakt.
TRUE	Büyük	Mümkünse ara.
FALSE	Compact	Mümkünse ara; aksi takdirde büyük.

CMFCRibbonBaseElement::SetData

Bir veri öğesini şerit öğesiyle ilişkilendirir.

void SetData(DWORD_PTR dwData);

Parametreler

dwData
[in] Veri değeri.

CMFCRibbonBaseElement::SetDefaultMenuLook

Şerit öğesini açılır komut olarak görünecek şekilde ayarlar.

void SetDefaultMenuLook(BOOL bIsDefaultMenuLook = TRUE);

Parametreler

bIsDefaultMenuLook
[in] Şerit öğesini açılır komut olarak görünecek şekilde ayarlamak için DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::SetDescription

Şerit öğesinin açıklamasını ayarlar.

virtual void SetDescription(LPCTSTR lpszText);

Parametreler

lpszText
[in] Şerit öğesinin açıklaması.

Açıklamalar

Çerçeve, yeni açıklamayı durum çubuğunda veya araç ipucunda ya da menü düğmesinin altında görüntüler.

CMFCRibbonBaseElement::SetID

Şerit öğesinin komut kimliğini ayarlar.

virtual void SetID(UINT nID);

Parametreler

Nıd
[in] Komut kimliği.

CMFCRibbonBaseElement::SetInitialMode

Şerit öğesi için ilk görüntü boyutunu ayarlar.

virtual void SetInitialMode(BOOL bOneRow = FALSE);

Parametreler

bOneRow
[in] Şerit öğesinin görüntü boyutunu sıkıştırma veya ara değerle sınırlamak için TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Şerit öğelerinin görüntü boyutu küçük, orta veya büyük olabilir.

CMFCRibbonBaseElement::SetKeys

Şerit öğesinin tuş ipuçlarını ayarlar.

virtual void SetKeys(
    LPCTSTR lpszKeys,
    LPCTSTR lpszMenuKeys=NULL);

Parametreler

lpszKeys
[in] Şerit öğesinin tuş ipucu.

lpszMenuKeys
[in] Şerit öğesinin açılır menüsünün tuş ipucu.

CMFCRibbonBaseElement::SetOriginal

Şerit öğesi için özgün şerit öğesini ayarlar.

virtual void SetOriginal(CMFCRibbonBaseElement* pOriginal);

Parametreler

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

Açıklamalar

Başka bir kapsayıcıya kopyalanan şerit öğeleri, özgün şerit öğesine bir işaretçi tutar.

CMFCRibbonBaseElement::SetParentCategory

Şerit öğesi için üst kategoriyi ayarlar.

virtual void SetParentCategory(CMFCRibbonCategory* pParent);

Parametreler

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

Açıklamalar

Şerit denetimlerindeki sekmeli gruplara kategori adı verilir.

CMFCRibbonBaseElement::SetParentMenu

Şerit öğesi için üst menü kapsayıcısını ayarlar.

virtual void SetParentMenu(CMFCRibbonPanelMenuBar* pMenuBar);

Parametreler

pMenuBar
[in] Üst menü.

Açıklamalar

CMFCRibbonBaseElement::SetParentRibbonBar

Şerit öğesinin üst şerit çubuğunu ayarlar.

virtual void SetParentRibbonBar(CMFCRibbonBar* pRibbonBar);

Parametreler

pRibbonBar
[in] Üst şerit çubuğunun işaretçisi.

Açıklamalar

CMFCRibbonBaseElement::SetRect

Şerit öğesi için görüntü dikdörtgeninin boyutlarını ayarlar.

void SetRect(CRect rect);

Parametreler

Rect
[in] Dikdörtgenin boyutları.

Açıklamalar

CMFCRibbonBaseElement::SetText

Şerit öğesi için metin ve tuş ipucu ayarlar.

virtual void SetText(LPCTSTR lpszText);

Parametreler

lpszText
[in] Şerit öğesinin metni ve tuş ipucu.

Açıklamalar

Şerit öğesi için tuş ipucu ayarlamak için, yeni satır kaçış sırasını ve ardından tuş ipucu karakterlerini lpszText'e ekler.

Örnek

//Set the text for the ribbon element
SetText(_T("Margins"))
//Set the text and a single-letter keytip
SetText(_T("Margins\nm"))
//Set the text and a multiple-letter keytip
SetText(_T("Line Numbers\nln"))

CMFCRibbonBaseElement::SetTextAlwaysOnRight

Şerit öğesinin sağda görüntülenecek metnini ayarlar.

virtual void SetTextAlwaysOnRight(BOOL bSet = TRUE);

Parametreler

bSet
[in] Sağda metni görüntülemek için DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::SetToolTipText

Şerit öğesi için araç ipucu metnini ayarlar.

virtual void SetToolTipText(LPCTSTR lpszText);

Parametreler

lpszText
[in] Araç ipucu metni.

CMFCRibbonBaseElement::SetVisible

Şerit öğesinin görünürlüğünü ayarlar.

void SetVisible(BOOL bIsVisible);

Parametreler

bIsVisible
[in] Şerit öğesini görüntülemek için TRUE; Şerit öğesini gizlemek için YANLIŞ.

Açıklamalar

CMFCRibbonBaseElement::StretchHorizontally

Şerit öğesinin genişliğini uzatır.

virtual void StretchHorizontally();

Açıklamalar

Varsayılan olarak bu yöntem hata ayıklama derlemelerinde onay hatası oluşturur ve bu nedenle çağrılmamalıdır. Şerit öğesinin genişliğini uzatmak için bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::StretchToWholeRow

Şerit öğesinin görüntüleme yüksekliğini belirtilen satır yüksekliğine değiştirir.

virtual BOOL StretchToWholeRow(
    CDC* pDC,
    int nHeight);

Parametreler

pDC
[in] Bu parametre kullanılmaz.

nHeight
[in] Satırın yüksekliği.

Dönüş Değeri

Görüntü yüksekliği ayarlandıysa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Şerit öğesinin görüntü yüksekliğini belirtilen satır yüksekliğine değiştirmek için bu yöntemi geçersiz kılın.

CMFCRibbonBaseElement::UpdateTooltipInfo

Şerit öğesinin komut kaynağını kullanarak araç ipucu metnini güncelleştirir.

virtual void UpdateTooltipInfo();

Açıklamalar

CMFCRibbonBaseElement::HasFocus

Üst öğenin klavye odağı olup olmadığını gösterir.

virtual BOOL HasFocus() const;

Aracılığıyla paylaş

CMFCRibbonBaseElement Sınıfı

Sözdizimi

Üyeler

Ortak Oluşturucular

Genel Yöntemler

Korumalı Yöntemler

Açıklamalar

Örnek

Devralma Hiyerarşisi

Gereksinimler

CMFCRibbonBaseElement::AddToKeyList

Parametreler

Açıklamalar

CMFCRibbonBaseElement::AddToListBox

Parametreler

Dönüş Değeri

Açıklamalar

CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar

Dönüş Değeri

Açıklamalar

CMFCRibbonBaseElement::CanBeCompacted

Dönüş Değeri

Açıklamalar

CMFCRibbonBaseElement::CanBeStretched

Dönüş Değeri

Açıklamalar

CMFCRibbonBaseElement::CanBeStretchedHorizontally

Dönüş Değeri

Açıklamalar

CMFCRibbonBaseElement::CleanUpSizes

Açıklamalar

CMFCRibbonBaseElement::ClosePopupMenu

Açıklamalar

CMFCRibbonBaseElement::CopyFrom

Parametreler

Açıklamalar

CMFCRibbonBaseElement::D estroyCtrl

Açıklamalar

CMFCRibbonBaseElement::D rawImage

Parametreler

Açıklamalar

CMFCRibbonBaseElement::Find

Parametreler

Dönüş Değeri

Açıklamalar

CMFCRibbonBaseElement::FindByData

Parametreler

Dönüş Değeri

Açıklamalar

CMFCRibbonBaseElement::FindByID

Parametreler

Dönüş Değeri

Açıklamalar

CMFCRibbonBaseElement::FindByOriginal

Parametreler

Dönüş Değeri

Açıklamalar

CMFCRibbonBaseElement::GetCompactSize

Parametreler

Dönüş Değeri

CMFCRibbonBaseElement::GetData

Dönüş Değeri

CMFCRibbonBaseElement::GetDescription

Dönüş Değeri

CMFCRibbonBaseElement::GetDroppedDown

Dönüş Değeri

Açıklamalar

CMFCRibbonBaseElement::GetElements

Parametreler

Açıklamalar

CMFCRibbonBaseElement::GetElementsByID

Parametreler

Açıklamalar

CMFCRibbonBaseElement::GetHighlighted

Dönüş Değeri

Açıklamalar

CMFCRibbonBaseElement::GetID

Dönüş Değeri

CMFCRibbonBaseElement::GetImageSize