CMFCRibbonCategory Sınıfı
sınıfı, CMFCRibbonCategory şerit panellerinden oluşan bir grup içeren bir şerit sekmesi uygular.
Sözdizimi
class CMFCRibbonCategory : public CObject
Üyeler
Korumalı Oluşturucular
| Veri Akışı Adı | Açıklama |
|---|---|
| CMFCRibbonCategory::CMFCRibbonCategory | Oluşturucu. |
Genel Yöntemler
Açıklamalar
Genellikle, CMFCRibbonBar::AddCategory çağrısı yaparak dolaylı olarak bir şerit kategorisi oluşturursunuz ve bu da yeni oluşturulan şerit kategorisine bir işaretçi döndürür. CMFCRibbonCategory::AddPanel çağrısı yaparak kategoriye paneller eklersiniz.
CMFCRibbonTab sınıfı şerit kategorileri çizer. CMFCRibbonBaseElement Sınıfından türetilir.
Aşağıdaki örnekte şerit kategorisi oluşturma ve bu kategoriye panel ekleme işlemleri gösterilmektedir.
// Create a new ribbon category and get a pointer to it`
CMFCRibbonCategory* pCategory = m_wndRibbonBar.AddCategory
(_T("&Write"), // Category name
IDB_WRITE, // Category small images (16 x 16)
IDB_WRITE_LARGE); // Category large images (32 x 32)
// Add a panel to the new category
CMFCRibbonPanel* pPanel = pCategory->AddPanel (
_T("Clipboard"), // Panel name
m_PanelIcons.ExtractIcon (0)); // Panel icon
Aşağıdaki diyagramda, RibbonApp örnek uygulamasından Giriş kategorisinin bir şekli gösterilmektedir.
Devralma Hiyerarşisi
CMFCRibbonCategory
Gereksinimler
Üst bilgi: afxribboncategory.h
CMFCRibbonCategory::AddHidden
Belirtilen şerit öğesini özelleştirme iletişim kutusunda görüntülenen şerit öğeleri dizisine ekler.
void AddHidden(CMFCRibbonBaseElement* pElem);
Parametreler
pElem
[in] Şerit öğesinin işaretçisi.
Açıklamalar
Özelleştirme iletişim kutusundaki şerit öğeleri, hızlı erişim araç çubuğuna ekleyebileceğiniz komutlardır.
CMFCRibbonCategory::AddPanel
Şerit kategorisi için bir şerit paneli oluşturur.
CMFCRibbonPanel* AddPanel(
LPCTSTR lpszPanelName,
HICON hIcon = 0,
CRuntimeClass* pRTI = NULL);
Parametreler
lpszPanelName
[in] Yeni şerit panelinin adına işaret eden işaretçi.
hIcon
[in] Yeni şerit panelinin varsayılan simgesine tutamacı.
pRTI
[in] Özel şerit paneli için çalışma zamanı sınıf bilgileri işaretçisi.
Dönüş Değeri
Yöntem başarılı olursa yeni şerit panelinin işaretçisi; aksi takdirde panel oluşturulmadıysa NULL olur.
Açıklamalar
Özel bir şerit paneli oluşturmak istiyorsanız, pRTI'de çalışma zamanı sınıf bilgilerini belirtmeniz gerekir. Özel şerit paneli sınıfı sınıfından CMFCRibbonPanel türetilmelidir.
Şerit öğelerini görüntülemek için yeterli alan olmadığında şerit panelinin varsayılan simgesi görüntülenir.
Örnek
Aşağıdaki örnekte sınıfında yönteminin AddPanel nasıl kullanılacağı gösterilmektedir CMFCRibbonCategory .
// Create "Favorites" panel:
strTemp.LoadString(IDS_RIBBON_FAVORITES);
// CMFCRibbonCategory* pCategoryCustom
CMFCRibbonPanel *pPanelFavorites = pCategoryCustom->AddPanel(strTemp,
m_PanelImages.ExtractIcon(15));
CMFCRibbonCategory::CMFCRibbonCategory
CMFCRibbonCategory nesnesini oluşturur ve başlatır.
CMFCRibbonCategory(
CMFCRibbonBar* pParenrRibbonBar,
LPCTSTR lpszName,
UINT uiSmallImagesResID,
UINT uiLargeImagesResID,
CSize sizeSmallImage = CSize(16,
16),
CSize sizeLargeImage = CSize(32,
32));
Parametreler
pParenrRibbonBar
[in] Şerit kategorisinin üst şerit çubuğunun işaretçisi.
lpszName
[in] Şerit kategorisinin adı.
uiSmallImagesResID
[in] Şerit kategorisindeki şerit öğeleri tarafından kullanılan küçük resimler için resim listesinin kaynak kimliği.
uiLargeImagesResID
[in] Şerit kategorisindeki şerit öğeleri tarafından kullanılan büyük resimler için resim listesinin kaynak kimliği.
sizeSmallImage
[in] Şerit kategorisindeki şerit öğeleri için küçük resimlerin varsayılan boyutu.
sizeLargeImage
[in] Şerit kategorisindeki şerit öğeleri için büyük resimlerin varsayılan boyutu.
CMFCRibbonCategory::CopyFrom
Belirtilen CMFCRibbonCategory durumunu geçerli CMFCRibbonCategory nesnesine kopyalar.
virtual void CopyFrom(CMFCRibbonCategory& src);
Parametreler
Src
[in] Kaynak CMFCRibbonCategory nesne.
Açıklamalar
CMFCRibbonCategory::FindByData
Belirtilen verilerle ilişkili şerit öğesini alır.
CMFCRibbonBaseElement* FindByData(
DWORD_PTR dwData,
BOOL bVisibleOnly = TRUE) const;
Parametreler
dwData
[in] Şerit öğesiyle ilişkili veriler.
bVisibleOnly
[in] Aramaya hızlı erişim şerit öğeleri eklemek için DOĞRU; Aramadaki hızlı erişim şerit öğelerini dışlamak için YANLIŞ.
Dönüş Değeri
Yöntem başarılı olursa şerit öğesinin işaretçisi; aksi takdirde NULL.
Açıklamalar
CMFCRibbonCategory::FindByID
Belirtilen komut kimliğiyle ilişkili şerit öğesini alır.
CMFCRibbonBaseElement* FindByID(
UINT uiCmdID,
BOOL bVisibleOnly = TRUE) const;
Parametreler
uiCmdID
[in] Şerit öğesiyle ilişkilendirilmiş komut kimliği.
bVisibleOnly
[in] Aramaya hızlı erişim şerit öğeleri eklemek için DOĞRU; Aramadaki hızlı erişim şerit öğelerini dışlamak için YANLIŞ.
Dönüş Değeri
Yöntem başarılı olursa şerit öğesinin işaretçisi; aksi takdirde NULL.
Açıklamalar
CMFCRibbonCategory::FindPanelWithElem
Belirtilen şerit öğesini içeren şerit panelini alır.
CMFCRibbonPanel* FindPanelWithElem(const CMFCRibbonBaseElement* pElement);
Parametreler
pElement
[in] Şerit öğesinin işaretçisi.
Dönüş Değeri
Yöntem başarılı olursa şerit paneli işaretçisi; aksi takdirde NULL.
Açıklamalar
CMFCRibbonCategory::GetContextID
Şerit kategorisinin bağlam kimliğini alır.
UINT GetContextID() const;
Dönüş Değeri
Şerit kategorisinin bağlam kimliği.
Açıklamalar
Şerit kategorisi bir bağlam şeridi kategorisi değilse bağlam kimliği 0'dır.
CMFCRibbonCategory::GetData
Şerit kategorisiyle ilişkili kullanıcı tanımlı verileri alır.
DWORD_PTR GetData() const;
Dönüş Değeri
Şerit kategorisiyle ilişkili kullanıcı tanımlı veriler.
CMFCRibbonCategory::GetDroppedDown
Şu anda açılan menüsünün görüntülendiği şerit öğesinin işaretçisini alır.
CMFCRibbonBaseElement* GetDroppedDown();
Dönüş Değeri
Yöntem başarılı olursa şerit öğesinin işaretçisi; aksi takdirde NULL.
Açıklamalar
CMFCRibbonCategory::GetElements
Şerit kategorisindeki tüm şerit öğelerini alır.
void GetElements(
CArray <CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parametreler
arElements
[in, out] Şerit öğelerinin CArray'sine başvuru.
Açıklamalar
Hızlı erişim araç çubuğunda kullanılmak üzere tasarlanmış şerit öğeleri diziye eklenir.
CMFCRibbonCategory::GetElementsByID
Belirtilen komut kimliğiyle ilişkili tüm şerit öğelerini alır.
void GetElementsByID(
UINT uiCmdID,
CArray <CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parametreler
uiCmdID
[in] Şerit öğesiyle ilişkilendirilmiş komut kimliği.
arElements
[in, out] Şerit öğelerinin CArray'sine başvuru.
Açıklamalar
Hızlı erişim araç çubuğunda kullanılmak üzere tasarlanmış şerit öğeleri diziye eklenir.
CMFCRibbonCategory::GetFirstVisibleElement
Şerit kategorisine ait ilk görünür öğeyi alır.
CMFCRibbonBaseElement* GetFirstVisibleElement() const;
Dönüş Değeri
İlk görünür öğeye işaretçi; kategoride görünür öğe yoksa NULL olabilir.
Açıklamalar
CMFCRibbonCategory::GetFocused
Odaklanmış bir öğe döndürür.
CMFCRibbonBaseElement* GetFocused();
Dönüş Değeri
Odaklanmış bir öğe veya NULL işaretçisi.
Açıklamalar
CMFCRibbonCategory::GetHighlighted
Vurgulanmış bir öğe döndürür.
CMFCRibbonBaseElement* GetHighlighted();
Dönüş Değeri
Vurgulanmış öğe işaretçisi veya hiçbir öğe vurgulanmamışsa NULL.
Açıklamalar
CMFCRibbonCategory::GetImageCount
Şerit kategorisinde yer alan belirtilen resim listesindeki görüntü sayısını alır.
int GetImageCount(BOOL bIsLargeImage) const;
Parametreler
bIsLargeImage
[in] Büyük resim listesindeki görüntü sayısı için TRUE; Küçük resim listesindeki görüntü sayısı için YANLIŞ.
Dönüş Değeri
Belirtilen görüntü listesindeki görüntü sayısı.
Açıklamalar
CMFCRibbonCategory::GetImageSize
Şerit kategorisinde yer alan belirtilen resim listesindeki bir görüntünün boyutunu alır.
CSize GetImageSize(BOOL bIsLargeImage) const;
Parametreler
bIsLargeImage
[in] Büyük görüntülerin boyutu için TRUE; Küçük resimlerin boyutu için YANLIŞ.
Dönüş Değeri
Belirtilen görüntü listesindeki bir görüntünün boyutu.
Açıklamalar
Alınan boyut, genel görüntü ölçek faktörünü içerir.
CMFCRibbonCategory::GetItemIDsList
Şerit kategorisinde yer alan şerit öğelerinin komut kimliklerini alır.
void GetItemIDsList(
CList<UINT, UINT>& lstItems,
BOOL bHiddenOnly = FALSE) const;
Parametreler
lstItems
[out] Şerit kategorisindeki şerit öğelerinin komut kimlikleri listesi.
bHiddenOnly
[in] Şerit kategorisindeki şerit panellerinde görüntülenen şerit öğelerini dışlamak için DOĞRU; Tüm şerit öğelerini şerit kategorisine eklemek için YANLIŞ.
Açıklamalar
CMFCRibbonCategory::GetLargeImages
Şerit kategorisinde yer alan büyük resimlerin listesini alır.
CMFCToolBarImages& GetLargeImages();
Dönüş Değeri
Şerit kategorisinde yer alan büyük resimlerin listesi.
CMFCRibbonCategory::GetLastVisibleElement
Şerit kategorisine ait son görünür öğeyi alır.
CMFCRibbonBaseElement* GetLastVisibleElement() const;
Dönüş Değeri
Son görünür öğe işaretçisi; kategoride görünür öğe yoksa NULL olabilir.
Açıklamalar
CMFCRibbonCategory::GetMaxHeight
Şerit kategorisinde yer alan şerit panellerinin en yüksek yüksekliğini alır.
int GetMaxHeight(CDC* pDC);
Parametreler
pDC
[in] Şerit panelleri için bir cihaz bağlamı işaretçisi.
Dönüş Değeri
Şerit kategorisinde yer alan şerit panellerinin en yüksek yüksekliği.
Açıklamalar
Alınan değer, şerit panelleri için üst ve alt kenar boşluklarının yüksekliğini içerir.
CMFCRibbonCategory::GetName
Şerit kategorisinin adını alır.
LPCTSTR GetName() const;
Dönüş Değeri
Şerit kategorisinin adı.
Açıklamalar
CMFCRibbonCategory::GetPanel
Belirtilen dizinde bulunan şerit panelinin işaretçisini döndürür.
CMFCRibbonPanel* GetPanel(int nIndex);
Parametreler
nIndex
[in] Şerit panelinin sıfır tabanlı dizini.
Dönüş Değeri
Belirtilen dizinde bulunan şerit panelinin işaretçisi.
Açıklamalar
nIndex aralık dışındaysa bir özel durum oluşturulur.
CMFCRibbonCategory::GetPanelCount
Şerit kategorisindeki şerit panellerinin sayısını döndürür.
int GetPanelCount() const;
Dönüş Değeri
Şerit kategorisindeki şerit panellerinin sayısı.
CMFCRibbonCategory::GetPanelFromPoint
Belirtilen nokta içinde yer alıyorsa, şerit panelinin işaretçisini alır.
CMFCRibbonPanel* GetPanelFromPoint(CPoint point) const;
Parametreler
nokta
[in] pencerenin sol üst köşesine göre işaretçinin x ve y koordinatları.
Dönüş Değeri
Yöntem başarılı olursa şerit paneli işaretçisi; aksi takdirde NULL.
Açıklamalar
Yalnızca şerit kategorisinde yer alan şerit panelleri test edilir.
CMFCRibbonCategory::GetPanelIndex
Belirtilen şerit panelinin sıfır tabanlı dizinini alır.
int GetPanelIndex(const CMFCRibbonPanel* pPanel) const;
Parametreler
pPanel
[in] Şerit paneli işaretçisi.
Dönüş Değeri
Yöntem başarılı olursa belirtilen şerit panelinin sıfır tabanlı dizini; aksi takdirde -1.
Açıklamalar
Yalnızca şerit kategorisinde yer alan şerit panelleri aranıyor.
CMFCRibbonCategory::GetParentButton
Şerit kategorisinin üst şerit öğesini alır.
CMFCRibbonBaseElement* GetParentButton() const;
Dönüş Değeri
Üst şerit öğesine bir işaretçi veya üst öğe yoksa NULL döndürür.
Açıklamalar
CMFCRibbonCategory::GetParentMenuBar
Nesnenin üst menü çubuğuna CMFCRibbonCategory bir işaretçi döndürür.
CMFCRibbonPanelMenuBar* GetParentMenuBar() const;
Dönüş Değeri
Korumalı üyenin m_pParentMenuBar içeriğini döndürür.
Açıklamalar
CMFCRibbonCategory::GetParentRibbonBar
Şerit kategorisi için üst şerit çubuğunu alır.
CMFCRibbonBar* GetParentRibbonBar() const;
Dönüş Değeri
Şerit kategorisi için üst şerit çubuğunun işaretçisi.
Açıklamalar
CMFCRibbonCategory::GetRect
Şerit kategorisi için görüntü dikdörtgenini alır.
CRect GetRect() const;
Dönüş Değeri
Şerit kategorisi için görüntü dikdörtgeni.
Açıklamalar
Şerit kategorisinin görüntü dikdörtgeni kategori sekmesini içermez.
CMFCRibbonCategory::GetSmallImages
Şerit kategorisinde yer alan küçük resimlerin listesini alır.
CMFCToolBarImages& GetSmallImages();
Dönüş Değeri
Şerit kategorisinde yer alan küçük resimlerin listesi.
CMFCRibbonCategory::GetTabColor
Şerit kategorisi sekmesinin geçerli rengini döndürür.
AFX_RibbonCategoryColor GetTabColor() const;
Dönüş Değeri
Şerit kategorisi sekmesinin geçerli rengi.
Açıklamalar
Döndürülen değer aşağıdaki numaralandırılmış değerlerden biri olabilir:
AFX_CategoryColor_Red
AFX_CategoryColor_Orange
AFX_CategoryColor_Yellow
AFX_CategoryColor_Green
AFX_CategoryColor_Blue
AFX_CategoryColor_Indigo
AFX_CategoryColor_Violet
CMFCRibbonCategory::GetTabRect
Şerit kategorisi sekmesi için görüntü dikdörtgenini alır.
CRect GetTabRect() const;
Dönüş Değeri
Şerit kategorisi sekmesinin görüntü dikdörtgeni.
Açıklamalar
CMFCRibbonCategory::GetTextTopLine
Büyük resimleri görüntüleyen şerit kategorisindeki şerit düğmelerindeki metnin dikey konumunu alır.
int GetTextTopLine() const;
Dönüş Değeri
Büyük resimlerin görüntülendiği şerit düğmelerinde metnin piksel cinsinden dikey konumu.
Açıklamalar
CMFCRibbonCategory::GetVisibleElements
Şerit kategorisine ait tüm görünür öğeleri alır.
void GetVisibleElements(
CArray <CMFCRibbonBaseElement*,
CMFCRibbonBaseElement*>& arElements);
Parametreler
arElements
Tüm görünür öğelerin dizisi.
Açıklamalar
CMFCRibbonCategory::HighlightPanel
Belirtilen şerit panelini vurgular.
CMFCRibbonPanel* HighlightPanel(
CMFCRibbonPanel* pHLPanel,
CPoint point);
Parametreler
pHLPanel
[in] Vurgulamak için şerit panelinin işaretçisi.
nokta
[in] pencerenin sol üst köşesine göre işaretçinin x ve y koordinatları.
Dönüş Değeri
Önceden vurgulanan şerit panelinin işaretçisi; aksi takdirde, bu yöntem çağrıldığında şerit paneli vurgulanmazsa NULL olur.
Açıklamalar
Şerit panelini vurgulama hakkında daha fazla bilgi için bkz . CMFCRibbonPanel::Highlight.
CMFCRibbonCategory::HitTest
Belirtilen nokta içinde yer alıyorsa, şerit öğesinin işaretçisini alır.
CMFCRibbonBaseElement* HitTest(
CPoint point,
BOOL bCheckPanelCaption = FALSE) const;
Parametreler
nokta
[in] Pencerenin sol üst köşesine göre fare işaretçisinin x ve y koordinatları.
bCheckPanelCaption
[in] Şerit paneli resim yazısını test etmek için TRUE; Şerit paneli resim yazısını dışlamak için YANLIŞ...
Dönüş Değeri
Yöntem başarılı olursa şerit öğesinin işaretçisi; aksi takdirde NULL.
Açıklamalar
Yalnızca şerit kategorisinde yer alan şerit öğeleri test edilir.
CMFCRibbonCategory::HitTestEx
Belirtilen nokta içinde yer alıyorsa şerit öğesinin sıfır tabanlı dizinini alır.
int HitTestEx(CPoint point) const;
Parametreler
nokta
[in] Pencerenin sol üst köşesine göre fare işaretçisinin x ve y koordinatları.
Dönüş Değeri
Yöntem başarılı olursa şerit öğesinin sıfır tabanlı dizini; aksi takdirde -1.
Açıklamalar
Yalnızca şerit kategorisinde yer alan şerit öğeleri test edilir.
CMFCRibbonCategory::HitTestScrollButtons
Bir nokta şerit kategorisinin sol veya sağ kaydırma düğmesi içinde yer alırsa, bu düğmenin işaretçisini döndürür.
CMFCRibbonBaseElement* HitTestScrollButtons(CPoint point) const;
Parametreler
nokta
[in] Test etmek için gereken nokta.
Dönüş Değeri
Nokta, şerit kategorisinin sol veya sağ kaydırma düğmesinin sınırlayıcı dikdörtgeninin içinde yer alırsa, bu düğmeye bir işaretçi döndürür veya başka bir şekilde NULL döndürür.
Açıklamalar
CMFCRibbonCategory::IsActive
Şerit kategorisinin şerit çubuğundaki etkin kategori olup olmadığını gösterir.
BOOL IsActive() const;
Dönüş Değeri
Şerit kategorisi etkin kategoriyse TRUE; aksi takdirde YANLIŞ.
Açıklamalar
Etkin şerit kategorisi, şerit panellerini görüntüler.
CMFCRibbonCategory::IsVisible
Şerit kategorisinin görünür olup olmadığını gösterir.
BOOL IsVisible() const;
Dönüş Değeri
Şerit kategorisi görünür durumdaysa DOĞRU; aksi takdirde YANLIŞ.
Açıklamalar
Görünen şerit kategorileri bir kategori sekmesi görüntüler.
CMFCRibbonCategory::IsWindows7Look
Üst ş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
Üst şeritte Windows 7 görünümü varsa TRUE; aksi takdirde YANLIŞ.
Açıklamalar
CMFCRibbonCategory::NotifyControlCommand
İleti işlenene kadar içindeki CMFCRibbonCategory tüm CMFCRibbonPanel öğelere bir WM_NOTIFY komut iletisi sunar.
virtual BOOL NotifyControlCommand(
BOOL bAccelerator,
int nNotifyCode,
WPARAM wParam,
LPARAM lParam);
Parametreler
bAccelerator
[in] Bu komut bir hızlandırıcıdan geliyorsa TRUE veya başka bir şekilde YANLIŞ.
nNotifyCode
[in] Bildirim kodu.
wParam
[in] İletinin WPARAM alanı.
lParam
[in] İletinin LPARAM alanı.
Dönüş Değeri
İleti işlendiyse TRUE veya işlenmediyse YANLIŞ döndürür.
Açıklamalar
CMFCRibbonCategory::OnCancelMode
öğesinin CMFCRibbonPanel tüm öğelerinde CMFCRibbonCategoryiptal modunu çağırır.
virtual void OnCancelMode();
Açıklamalar
CMFCRibbonCategory::OnDraw
Şerit kategorisini çizmek için çerçeve tarafından çağrılır.
virtual void OnDraw(CDC* pDC);
Parametreler
pDC
[in] Şerit kategorisi için bir cihaz bağlamı işaretçisi.
Açıklamalar
CMFCRibbonCategory::OnDrawImage
Şerit kategorisinde belirtilen görüntüyü çizmek için çerçeve tarafından çağrılır.
virtual BOOL OnDrawImage(
CDC* pDC,
CRect rect,
CMFCRibbonBaseElement* pElement,
BOOL bIsLargeImage,
BOOL nImageIndex,
BOOL bCenter);
Parametreler
pDC
[in] Görüntü için bir cihaz bağlamı işaretçisi.
Rect
[in] Görüntü için dikdörtgen görüntüleme.
pElement
[in] Görüntüyü içeren şerit öğesinin işaretçisi.
bIsLargeImage
[in] Resim büyük boyutluysa TRUE; Resim küçük boyutluysa YANLIŞ.
nImageIndex
[in] Şerit kategorisinde yer alan görüntü dizisindeki görüntünün sıfır tabanlı dizini.
bCenter
[in] Görüntüyü görüntü dikdörtgeninde ortalamak için TRUE; Görüntü dikdörtgeninin sol üst köşesine resim çizmek için YANLIŞ.
Dönüş Değeri
Yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.
Açıklamalar
CMFCRibbonCategory::OnDrawMenuBorder
Bir açılır menünün kenarını çizmek için çerçeve tarafından çağrılır.
virtual void OnDrawMenuBorder(
CDC* pDC,
CMFCRibbonPanelMenuBar* pMenuBar);
Parametreler
pDC
[in] Bu parametre kullanılmaz.
pMenuBar
[in] Bu parametre kullanılmaz.
Açıklamalar
Varsayılan olarak bu yöntem hiçbir şey yapmaz. Açılan menünün kenarını çizmek için bu yöntemi geçersiz kılın.
CMFCRibbonCategory::OnKey
Kullanıcı bir klavye düğmesine bastığında çerçeve tarafından çağrılır.
virtual BOOL OnKey(UINT nChar);
Parametreler
nChar
Kullanıcının bastığı anahtarın sanal anahtar kodu.
Açıklamalar
CMFCRibbonCategory::OnLButtonDown
Kullanıcı sol fare düğmesine bastığında belirtilen noktanın altındaki şerit öğesini almak için çerçeve tarafından çağrılır.
virtual CMFCRibbonBaseElement* OnLButtonDown(CPoint point);
Parametreler
nokta
[in] Pencerenin sol üst köşesine göre fare işaretçisinin x ve y koordinatları.
Dönüş Değeri
Yöntem başarılı olursa şerit öğesinin işaretçisi; aksi takdirde NULL.
Açıklamalar
CMFCRibbonCategory::OnLButtonUp
Kullanıcı sol fare düğmesini serbest bıraktığında ve işaretçi şerit kategorisinin üzerinde olduğunda çerçeve tarafından çağrılır.
virtual void OnLButtonUp(CPoint point);
Parametreler
nokta
[in] pencerenin sol üst köşesine göre işaretçinin x ve y koordinatları.
Açıklamalar
CMFCRibbonCategory::OnMouseMove
şerit kategorisi görünümünü güncelleştirmek için işaretçi şerit çubuğunda hareket ettiğinde çerçeve tarafından çağrılır.
virtual void OnMouseMove(CPoint point);
Parametreler
nokta
[in] pencerenin sol üst köşesine göre işaretçinin x ve y koordinatları.
Açıklamalar
CMFCRibbonCategory::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] Düzen sağdan sola ise DOĞRU; Düzen soldan sağa ise YANLIŞ.
Açıklamalar
Bu yöntem, şerit kategorisinde yer alan tüm şerit panellerinin ve şerit öğelerinin düzenini ayarlar.
CMFCRibbonCategory::OnScrollHorz
Şerit kategorisini yatay yönde kaydırıyor.
virtual BOOL OnScrollHorz(
BOOL bScrollLeft,
int nScrollOffset = 0);
Parametreler
bScrollLeft
[in] Sola kaydırmak için DOĞRU; Sağa kaydırmak için YANLIŞ...
nScrollOffset
[in] Piksel cinsinden kaydırma uzaklığı.
Dönüş Değeri
Şerit kategorisi yatay yönde hareket ettiyse DOĞRU; aksi takdirde YANLIŞ.
Açıklamalar
CMFCRibbonCategory::OnUpdateCmdUI
OnUpdateCmdUI içindeki kullanıcı arabirimi öğelerini CMFCRibbonCategory etkinleştirmek veya devre dışı bırakmak için öğesinin öğelerinin her CMFCRibbonPanel birinde üye işlevini çağırır.
virtual void OnUpdateCmdUI(
CMFCRibbonCmdUI* pCmdUI,
CFrameWnd* pTarget,
BOOL bDisableIfNoHndler);
Parametreler
pCmdUI
[in] Hangi kullanıcı arabirimi öğelerinin CMFCRibbonCmdUI etkinleştirileceği ve hangilerinin devre dışı bırakılacağı belirten nesne işaretçisi.
pTarget
[in] Kullanıcı arabirimi öğelerinin etkinleştirilmesini veya devre dışı bırakılmasını denetleen pencere işaretçisi.
bDisableIfNoHndler
[in] İleti eşlemesinde işleyici tanımlanmamışsa kullanıcı arabirimi öğesini devre dışı bırakmak için TRUE; aksi takdirde YANLIŞ.
Açıklamalar
CMFCRibbonCategory::RecalcLayout
Şerit kategorisindeki tüm denetimlerin düzenini ayarlar.
virtual void RecalcLayout(CDC* pDC);
Parametreler
pDC
[in] Şerit kategorisi için bir cihaz bağlamı işaretçisi.
Açıklamalar
CMFCRibbonCategory::RemovePanel
Şerit kategorisinden şerit panelini kaldırır.
BOOL RemovePanel(
int nIndex,
BOOL bDelete = TRUE);
Parametreler
nIndex
[in] Kaldırılacak panelin dizin numarası. CMFCRibbonCategory::GetPanelIndex yöntemi çağrılarak elde edilir.
bDelete
[in] Panel nesnesini bellekten silmek için TRUE; PANEL nesnesini silmeden kaldırmak için YANLIŞ.
Dönüş Değeri
Yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.
CMFCRibbonCategory::ReposPanels
Şerit kategorisinde yer alan şerit panellerindeki tüm denetimlerin düzenini ayarlar.
virtual void ReposPanels(CDC* pDC);
Parametreler
pDC
[in] Şerit kategorisinde yer alan şerit panelleri için bir cihaz bağlamı işaretçisi.
Açıklamalar
CMFCRibbonCategory::SetCollapseOrder
Şerit kategorisinin şerit panellerinin daraltılma sırasını tanımlar.
void SetCollapseOrder(const CArray<int,int>& arCollapseOrder);
Parametreler
arCollapseOrder
[in] Daraltma sırasını belirtir. Dizi, şerit panellerinin sıfır tabanlı dizinlerini içerir.
Açıklamalar
Kitaplık daraltma sırasını tanımlar. Ancak, kategoriye daraltma sırasını belirten dizinlerin listesini sağlayarak bu davranışı özelleştirebilirsiniz.
Kategori bir şerit panelini daraltmak zorunda olduğunu algıladığında, belirtilen listede bir sonraki öğeyi arar. Liste boşsa veya yeterli öğe belirtmediyseniz, kategori iç algoritmayı kullanır.
Örneğin, kategori üç şerit panele sahiptir ve tüm paneller tamamen daraltılmış duruma gelene kadar birkaç kez daraltılabilir. Şu daraltma sırasını ayarlayabilirsiniz: 0, 0, 2, 2. Bu durumda, kategori paneli iki kez, panel 2 iki kez daraltacaktır. 1 dizinine sahip panel, toplamasız kalır.
Örnek
Aşağıdaki örnekte sınıfında yönteminin SetCollapseOrder nasıl kullanılacağı gösterilmektedir CMFCRibbonCategory . Örnekte daraltma sırası için bir dizi oluşturma ve daraltma sırasını şerit kategorisine ayarlama gösterilmektedir.
CArray<int, int> arCollapseOrder;
arCollapseOrder.Add(0);
arCollapseOrder.Add(1);
arCollapseOrder.Add(2);
// CMFCRibbonCategory* pCategoryHome
pCategoryHome->SetCollapseOrder(arCollapseOrder);
CMFCRibbonCategory::SetData
Şerit kategorisiyle ilişkilendirilecek kullanıcı tanımlı verileri ayarlar.
void SetData(DWORD_PTR dwData);
Parametreler
dwData
[in] Kullanıcı tanımlı veriler.
CMFCRibbonCategory::SetKeys
Şerit kategorisine bir tuş ipucu atar.
void SetKeys(LPCTSTR lpszKeys);
Parametreler
lpszKeys
[in] Tuş ipucu metni.
Açıklamalar
Kullanıcı Alt tuşuna veya F10 tuşuna bastığında tuş ipuçları görüntülenir.
CMFCRibbonCategory::SetName
Şerit kategorisine bir ad ve tuş ipucu atar.
void SetName(LPCTSTR lpszName);
Parametreler
lpszName
[in] Şerit kategorisinin adı ve tuş ipucu.
Açıklamalar
Şerit kategorisi için tuş ipucu ayarlamak için, lpszName'e yeni bir satır kaçış dizisi ve ardından tuş ipucu karakterleri ekler.
CMFCRibbonCategory::SetTabColor
Şerit kategorisinin rengini ayarlar.
void SetTabColor(AFX_RibbonCategoryColor color);
Parametreler
Renk
[in] Şerit kategorisinin yeni rengini belirtir.
Açıklamalar
Renk 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