CMFCRibbonPanel Sınıfı

Şerit öğeleri kümesi içeren bir panel uygular. Panel çizildiğinde, panelin boyutu göz önüne alındığında mümkün olduğunca çok öğe görüntüler.

Daha fazla ayrıntı için Visual Studio yüklemenizin VC\atlmfc\src\mfc klasöründe bulunan kaynak koduna bakın.

Sözdizimi

class CMFCRibbonPanel : public CObject

Üyeler

Korumalı Oluşturucular

Veri Akışı Adı	Açıklama
CMFCRibbonPanel::CMFCRibbonPanel	Bir CMFCRibbonPanel nesneyi oluşturur ve başlatır.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CMFCRibbonPanel::Add	Panele bir şerit öğesi ekler.
CMFCRibbonPanel::AddSeparator	Şerit paneline bir ayırıcı ekler.
CMFCRibbonPanel::AddToolBar	Şerit paneline bir araç çubuğu ekler.
CMFCRibbonPanel::FindByData
CMFCRibbonPanel::FindByID	Belirtilen komut kimliği tarafından tanımlanan bir öğe döndürür.
CMFCRibbonPanel::GetCaptionHeight
CMFCRibbonPanel::GetCount	Şerit panelindeki öğelerin sayısını döndürür.
CMFCRibbonPanel::GetData	Panelle ilişkili kullanıcı tanımlı verileri döndürür.
CMFCRibbonPanel::GetDefaultButton
CMFCRibbonPanel::GetDroppedDown
CMFCRibbonPanel::GetElement	Belirtilen dizinde bulunan şerit öğesini döndürür.
CMFCRibbonPanel::GetElements	Şerit panelinde bulunan tüm öğeleri alır.
CMFCRibbonPanel::GetElementsByID
CMFCRibbonPanel::GetFocused	Odaklanmış bir öğe döndürür.
CMFCRibbonPanel::GetGalleryRect	Gallery öğesinin sınırlayıcı bir dikdörtgenini döndürür.
CMFCRibbonPanel::GetHighlighted
CMFCRibbonPanel::GetIndex
CMFCRibbonPanel::GetItemIDsList
CMFCRibbonPanel::GetName
CMFCRibbonPanel::GetParentButton
CMFCRibbonPanel::GetParentCategory	Şerit panelinin üst kategorisini döndürür.
CMFCRibbonPanel::GetParentMenuBar
CMFCRibbonPanel::GetPreferedMenuLocation
CMFCRibbonPanel::GetPressed
CMFCRibbonPanel::GetRect
CMFCRibbonPanel::GetVisibleElements	Görünür öğelerden oluşan bir dizi alır.
CMFCRibbonPanel::HasElement
CMFCRibbonPanel::HitTest
CMFCRibbonPanel::HitTestEx
CMFCRibbonPanel::Insert	Verilen konuma bir şerit öğesi ekler.
CMFCRibbonPanel::InsertSeparator	Verilen konuma bir ayırıcı ekler.
CMFCRibbonPanel::IsCenterColumnVert	Tüm panel öğelerinin dikey olarak, sütuna göre ortalanıp ortalanmayacağını belirtir.
CMFCRibbonPanel::IsCollapsed
CMFCRibbonPanel::IsHighlighted
CMFCRibbonPanel::IsJustifyColumns	Tüm panel sütunlarının aynı genişliğe sahip olup olmadığını belirtir.
CMFCRibbonPanel::IsMainPanel
CMFCRibbonPanel::IsMenuMode
CMFCRibbonPanel::MakeGalleryItemVisible	Belirtilen Şerit öğesini görünür hale getirmek için galeriyi kaydırıyor.
CMFCRibbonPanel::OnKey
CMFCRibbonPanel::RecalcWidths
CMFCRibbonPanel::Remove	Belirtilen dizinde bulunan bir öğeyi kaldırır ve isteğe bağlı olarak siler.
CMFCRibbonPanel::RemoveAll	Şerit panelindeki tüm öğeleri kaldırır.
CMFCRibbonPanel::Replace	İlgili dizin değerlerine göre bir öğeyi başka bir öğeyle değiştirir.
CMFCRibbonPanel::ReplaceByID	Belirtilen komut kimliğine göre bir öğeyi başka bir öğeyle değiştirir.
CMFCRibbonPanel::SetCenterColumnVert	Panel, öğeleri sütuna göre dikey olarak hizalamak için sıralar.
CMFCRibbonPanel::SetData	Kullanıcı tanımlı verileri şerit paneliyle ilişkilendirir.
CMFCRibbonPanel::SetElementMenu	Verilen komut kimliğine sahip öğeye bir açılır menü atar.
CMFCRibbonPanel::SetElementRTC	Sağlanan çalışma zamanı sınıf bilgileri tarafından belirtilen bir şerit öğesini şerit paneline ekler.
CMFCRibbonPanel::SetElementRTCByID	Sağlanan çalışma zamanı sınıf bilgileri tarafından belirtilen bir şerit öğesini şerit paneline ekler.
CMFCRibbonPanel::SetFocused	Odağı belirtilen Şerit öğesine ayarlar.
CMFCRibbonPanel::SetJustifyColumns	Sütun gerekçesini etkinleştirir veya devre dışı bırakır.
CMFCRibbonPanel::SetKeys	Şerit panelini görüntüleyen klavye kısayolunu ayarlar.
CMFCRibbonPanel::ShowPopup

Açıklamalar

Şerit panelleri, şerit kategorilerinde oluşturduğunuz ilgili görevlerin mantıksal gruplandırmalardır. Şeridin boyutu değiştikçe, panel düzeni mümkün olduğunca çok öğe görüntülenecek şekilde otomatik olarak ayarlanır.

CMFCRibbonCategory::GetPanel yöntemini çağırarak şerit kategorisinde yer alan bir şerit panelleri alabilirsiniz.

Örnek

Aşağıdaki örnekte, sınıfındaki çeşitli yöntemleri kullanarak bir CMFCRibbonPanel nesnenin nasıl yapılandırılır gösterilmektedir CMFCRibbonPanel . Örnekte şerit panelini görüntüleyen klavye kısayolunun nasıl ayarlanacağı, paneldeki öğelerin sütuna göre dikey olarak hizalanacağı ve sütun yaslama özelliğinin nasıl etkinleştirileceği gösterilmektedir. Bu kod parçacığı MS Office 2007 Tanıtım örneğinin bir parçasıdır.

// CMFCRibbonCategory* pCategory
// CMFCToolBarImages m_PanelImages
CMFCRibbonPanel *pPanelClipboard = pCategory->AddPanel(_T("Clipboard"), m_PanelImages.ExtractIcon(1));
pPanelClipboard->SetKeys(_T("zc"));
pPanelClipboard->SetCenterColumnVert();
pPanelClipboard->SetJustifyColumns();

Devralma Hiyerarşisi

CObject

CMFCRibbonPanel

Gereksinimler

Üst bilgi: afxRibbonPanel.h

CMFCRibbonPanel::Add

Belirtilen şerit öğesini şerit panelinde bulunan şerit öğeleri dizisine ekler.

virtual void Add(CMFCRibbonBaseElement* pElem);

Parametreler

pElem
[in, out] Şerit öğesinin işaretçisi.

Açıklamalar

CMFCRibbonPanel::AddSeparator

Şerit paneline bir ayırıcı ekler.

virtual void AddSeparator();

Açıklamalar

Şerit paneline ayırıcı eklemek için bu yöntemi çağırın. Ayırıcı, ÖNCEKI CMFCRibbonPanel::Add çağrısı tarafından eklenen şerit öğesinin yanına eklenir. Belirli bir konuma ayırıcı eklemek için CMFCRibbonPanel::InsertSeparator çağrısında bulun.

CMFCRibbonPanel::AddToolBar

Şerit paneline bir araç çubuğu ekler.

CMFCRibbonButtonsGroup* AddToolBar(
UINT uiToolbarResID,
UINT uiColdResID = 0,
UINT uiHotResID = 0,
UINT uiDisabledResID = 0);

Parametreler

uiToolbarResID
[in] Eklenecek araç çubuğunun kaynak kimliğini belirtir.

uiColdResID
[in] Araç çubuğunun soğuk görüntülerinin kaynak kimliğini belirtir.

uiHotResID
[in] Araç çubuğunun sık erişimli görüntülerinin kaynak kimliğini belirtir.

uiDisabledResID
[in] Araç çubuğunun devre dışı bırakılan görüntülerinin kaynak kimliğini belirtir.

Dönüş Değeri

Şerit paneline araç çubuğu eklemek için bu yöntemi çağırın. Önceki CMFCRibbonPanel::Add çağrısı tarafından eklenen şerit öğesinin yanına araç çubuğu eklenir.

Açıklamalar

Araç çubukları, sık erişimli görüntüler, soğuk görüntüler ve devre dışı bırakılan görüntüler hakkında daha fazla bilgi için bkz . CMFCToolBar Sınıfı.

CMFCRibbonPanel::CMFCRibbonPanel

CMFCRibbonPanel nesnesini oluşturur ve başlatır.

CMFCRibbonPanel(
LPCTSTR lpszName = NULL,
HICON hIcon = NULL);

CMFCRibbonPanel(CMFCRibbonGallery* pPaletteButton);

Parametreler

lpszName
[in] Şerit panelinin adı.

hIcon
[in] Şerit paneli için varsayılan düğmenin simgesine tutamaç.

pPaletteButton
[in] Şerit paneli için şerit galerisi işaretçisi.

CMFCRibbonPanel::FindByData

Belirtilen verilerle ilişkili şerit öğesini alır.

CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData) const;

Parametreler

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

Dönüş Değeri

Yöntem başarılı olursa şerit öğesinin işaretçisi; aksi takdirde NULL.

Açıklamalar

CMFCRibbonPanel::FindByID

Belirtilen komut kimliğiyle tanımlanan şerit öğesini alır.

CMFCRibbonBaseElement* FindByID(UINT uiCmdID) const;

Parametreler

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

Dönüş Değeri

Belirtilen komut kimliğiyle tanımlanan şerit öğesi; aksi takdirde, belirtilen komut kimliğiyle hiçbir şerit öğesi tanımlanmazsa NULL olur.

CMFCRibbonPanel::GetCaptionHeight

Şerit paneli için resim yazısının yüksekliğini alır.

int GetCaptionHeight() const;

Dönüş Değeri

Şerit paneli için resim yazısının piksel cinsinden yüksekliği.

Açıklamalar

CMFCRibbonPanel::GetCount

Şerit panelinde bulunan şerit öğelerinin sayısını alır.

int GetCount() const;

Dönüş Değeri

Şerit panelinde yer alan şerit öğelerinin sayısı.

CMFCRibbonPanel::GetData

Panelle ilişkili kullanıcı tanımlı verileri döndürür.

DWORD_PTR GetData() const;

Dönüş Değeri

Panelle ilişkili kullanıcı tanımlı veriler.

CMFCRibbonPanel::GetDefaultButton

Şerit paneli için varsayılan düğmeyi alır.

CMFCRibbonButton& GetDefaultButton();

Dönüş Değeri

Şerit paneli için varsayılan düğme.

Açıklamalar

Şerit panelinin şerit öğelerini görüntülemek için yeterli alanı olmadığında varsayılan düğme görüntülenir.

CMFCRibbonPanel::GetDroppedDown

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

CMFCRibbonBaseElement* GetDroppedDown() const;

Dönüş Değeri

Açılan menüsü açılan şerit öğesinin işaretçisi; aksi takdirde, hiçbir şerit öğesi açılır menüsü bırakılmış değilse NULL olur.

Açıklamalar

Yalnızca şerit panelinde bulunan şerit öğeleri test edilir.

CMFCRibbonPanel::GetElement

Belirtilen dizinde bulunan şerit öğesini döndürür.

CMFCRibbonBaseElement* GetElement(int nIndex) const;

Parametreler

nIndex
[in] Alınacak öğenin sıfır tabanlı dizinini belirtir.

Dönüş Değeri

Şerit panelinde nIndex konumunda bulunan temel şerit öğesine geçerli bir işaretçi veya belirtilen dizinde öğe yoksa NULL.

CMFCRibbonPanel::GetElements

Şerit panelinde bulunan tüm şerit öğelerini alır.

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

Parametreler

arElements
[out] Şerit panelinde yer alan tüm şerit öğeleriyle doldurulacak bir dizi.

Açıklamalar

CMFCRibbonPanel::GetElementsByID

Belirtilen komut kimliğine sahip şerit öğelerini belirtilen diziye ekler.

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

Parametreler

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

arElements
[in] Şerit öğeleri dizisi.

Açıklamalar

Yalnızca şerit panelinde bulunan şerit öğeleri test edilir.

CMFCRibbonPanel::GetHighlighted

Şerit panelinde vurgulanan şerit öğesini alır.

CMFCRibbonBaseElement* GetHighlighted() const;

Dönüş Değeri

Şerit panelinde vurgulanan şerit öğesinin işaretçisi.

Açıklamalar

CMFCRibbonPanel::GetIndex

Şerit panelinde bulunan şerit öğeleri dizisinden belirtilen şerit öğesinin sıfır tabanlı dizinini alır.

virtual int GetIndex(CMFCRibbonBaseElement* pElem) const;

Parametreler

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

Dönüş Değeri

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

Açıklamalar

CMFCRibbonPanel::GetItemIDsList

Şerit panelindeki tüm şerit öğeleri için komut kimliklerini alır.

void GetItemIDsList(CList<UINT, UINT>& lstItems) const;

Parametreler

lstItems
[out] Şerit panelinde yer alan şerit öğeleri için komut kimliklerinin listesi.

Açıklamalar

CMFCRibbonPanel::GetName

Şerit panelinin adını alır.

LPCTSTR GetName() const;

Dönüş Değeri

Şerit panelinin adı.

Açıklamalar

CMFCRibbonPanel::GetParentButton

CMFCRibbonBaseElement* GetParentButton() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonPanel::GetParentCategory

Şerit panelinin üst kategorisini döndürür.

CMFCRibbonCategory* GetParentCategory() const;

Dönüş Değeri

Bu şerit panelini içeren şerit kategorisi işaretçisi.

CMFCRibbonPanel::GetParentMenuBar

CMFCRibbonPanelMenuBar* GetParentMenuBar() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonPanel::GetPreferedMenuLocation

Şerit panelinin açılır menüsü için tercih edilen görüntü dikdörtgenini alır.

virtual BOOL GetPreferedMenuLocation(CRect& rect);

Parametreler

Rect
[out] Bu parametre kullanılmaz.

Dönüş Değeri

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

Açıklamalar

Bu yöntem her zaman YANLIŞ döndürür. Şerit panelinin açılır menüsü için tercih edilen görüntü dikdörtgenini almak için bu yöntemi geçersiz kılın.

CMFCRibbonPanel::GetPressed

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

CMFCRibbonBaseElement* GetPressed() const;

Dönüş Değeri

Kullanıcı o anda basıyorsa şerit öğesine yönelik bir işaretçi; aksi takdirde NULL.

Açıklamalar

CMFCRibbonPanel::GetRect

Şerit paneli için görüntü dikdörtgenini alır.

const CRect& GetRect() const;

Dönüş Değeri

Şerit panelinin görüntü dikdörtgeni.

Açıklamalar

CMFCRibbonPanel::HasElement

Şerit panelinin belirtilen şerit öğesini içerip içermediğini gösterir.

BOOL HasElement(const CMFCRibbonBaseElement* pElem) const;

Parametreler

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

Dönüş Değeri

Şerit paneli belirtilen şerit öğesini içeriyorsa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonPanel::Highlight

Seçili şerit paneli ve nokta tarafından belirtilen şerit öğesi için vurgu rengini ayarlar.

virtual void Highlight(
BOOL bHighlight,
CPoint point);

Parametreler

bHighlight
[in] Şerit panelini vurgulamak için TRUE; ŞERIT panelini göstermek için YANLIŞ...

nokta
[in] pencerenin sol üst köşesine göre işaretçinin x ve y koordinatları.

Açıklamalar

CMFCRibbonPanel::HitTest

Belirtilen nokta içinde yer alıyorsa şerit öğesini alır.

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

Parametreler

nokta
[in] pencerenin sol üst köşesine göre işaretçinin x ve y koordinatları.

bCheckPanelCaption
[in] Şerit paneli resim yazısını test etmek için TRUE; aksi takdirde YANLIŞ.

Dönüş Değeri

Belirtilen nokta içinde yer alıyorsa şerit öğesinin işaretçisi; aksi takdirde NULL.

Açıklamalar

Yalnızca şerit panelinde bulunan şerit öğeleri test edilir.

CMFCRibbonPanel::HitTestEx

Belirtilen noktanın bulunduğu şerit öğesinin sıfır tabanlı dizinini alır.

virtual int HitTestEx(CPoint point) const;

Parametreler

nokta
[in] pencerenin sol üst köşesine göre işaretçinin x ve y koordinatları.

Dönüş Değeri

Belirtilen noktanın bulunduğu şerit öğesinin sıfır tabanlı dizini; aksi takdirde -1.

Açıklamalar

Yalnızca şerit panelinde bulunan şerit öğeleri test edilir.

CMFCRibbonPanel::Insert

Belirtilen şerit öğesini, şerit panelinde bulunan şerit öğeleri dizisine belirtilen konuma ekler.

virtual BOOL Insert(
CMFCRibbonBaseElement* pElem,
int nIndex);

Parametreler

pElem
[in, out] Şerit öğesinin işaretçisi.

nIndex
[in] -1 ile dizideki şerit öğelerinin sayısı arasında değişen sıfır tabanlı değer.

Dönüş Değeri

Şerit öğesi başarıyla eklendiyse DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

nIndex değeri -1 ise veya nIndex dizideki şerit öğelerinin sayısına eşitse, belirtilen şerit öğesi dizinin sonuna eklenir. nIndex değeri aralık dışındaysa yöntem başarısız olur.

CMFCRibbonPanel::InsertSeparator

Verilen konuma bir ayırıcı ekler.

virtual BOOL InsertSeparator(int nIndex);

Parametreler

nIndex
[in] Ayırıcının eklendiği sıfır tabanlı dizini belirtir.

Dönüş Değeri

Ayırıcı başarıyla eklendiyse TRUE; aksi takdirde YANLIŞ.

Açıklamalar

nIndex tarafından belirtilen konuma bir ayırıcı eklemek için bu yöntemi çağırın. En son eklenen şerit öğesinin yanına ayırıcı eklemek için CMFCRibbonPanel::AddSeparator'ı çağırın.

CMFCRibbonPanel::IsCenterColumnVert

Şerit öğelerinin dikey konumlarının, görüntü dikdörtgenleri içinde ortalanıp ortalanmamış olduğunu gösterir.

BOOL IsCenterColumnVert() const;

Dönüş Değeri

Şerit öğelerinin dikey konumları görüntü dikdörtgenleri içinde ortalanmışsa TRUE; aksi takdirde YANLIŞ.

CMFCRibbonPanel::IsCollapsed

Şerit panelinin ekran boyutunun yatay yönde simge durumuna küçültülmüş olup olmadığını gösterir.

BOOL IsCollapsed() const;

Dönüş Değeri

Şerit panelinin ekran boyutu yatay yönde simge durumuna küçültülmüşse TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Şerit paneli daraltıldığında yalnızca varsayılan düğmesini, adını ve açılan oku görüntüler.

CMFCRibbonPanel::IsHighlighted

Şerit panelinin ekranının vurgulanıp vurgulu olmadığını gösterir.

BOOL IsHighlighted() const;

Dönüş Değeri

Şerit panelinin ekranı vurgulanmışsa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

İşaretçi üzerine geldiğinde şerit panelinin görüntüsü vurgulanır.

CMFCRibbonPanel::IsJustifyColumns

Şerit panelinde aynı sütunda yer alan şerit öğelerinin görüntü boyutlarının aynı genişliğe ayarlanıp ayarlanmadığını gösterir.

BOOL IsJustifyColumns() const;

Dönüş Değeri

Şerit panelinde aynı sütunda yer alan şerit öğelerinin görüntü boyutları aynı genişliğe ayarlanırsa DOĞRU; aksi takdirde YANLIŞ.

CMFCRibbonPanel::IsMainPanel

Şerit panelinin ana şerit paneli olup olmadığını gösterir.

virtual BOOL IsMainPanel() const;

Dönüş Değeri

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

Açıklamalar

Bu yöntem her zaman YANLIŞ döndürür. Şerit panelinin ana şerit paneli olup olmadığını belirtmek için bu yöntemi geçersiz kılın.

Kullanıcı uygulama düğmesini seçtiğinde ana şerit paneli görüntülenir.

CMFCRibbonPanel::IsMenuMode

BOOL IsMenuMode() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonPanel::OnKey

virtual BOOL OnKey(UINT nChar);

Parametreler

[in] nChar

Dönüş Değeri

Açıklamalar

CMFCRibbonPanel::RecalcWidths

Şerit paneli için her ekran düzeni yapılandırmasının genişliğini yeniden hesaplar.

virtual void RecalcWidths(
CDC* pDC,
int nHeight);

Parametreler

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

nHeight
[in] Şerit panelinin yüksekliği.

Açıklamalar

Şerit paneli, kullanılabilir genişlik değiştikçe düzen yapılandırmasını değiştirir.

CMFCRibbonPanel::Remove

Belirtilen dizinde bulunan bir öğeyi kaldırır ve isteğe bağlı olarak siler.

BOOL Remove(
int nIndex,
BOOL bDelete = TRUE);

Parametreler

nIndex
[in] Şerit panelinden kaldırılan öğenin sıfır tabanlı dizinini belirtir.

bDelete
[in] Kaldırılan öğeyi silmek için TRUE; aksi takdirde YANLIŞ.

Dönüş Değeri

Öğe kaldırıldıysa ve silindiyse TRUE (bDelete TRUE ise); Öğe kaldırılmadıysa veya nIndex konumunda şerit öğesi yoksa YANLIŞ.

Açıklamalar

Şerit panelinden bir öğeyi kaldırmak için bu yöntemi çağırın.

CMFCRibbonPanel::RemoveAll

Şerit panelindeki tüm şerit öğelerini siler.

void RemoveAll();

Açıklamalar

Tüm şerit öğeleri şerit panelinden silinir ve yok edilir.

CMFCRibbonPanel::Replace

Dizin değerine göre bir öğeyi başka bir öğeyle değiştirir.

BOOL Replace(
int nIndex,
CMFCRibbonBaseElement* pElem);

Parametreler

nIndex
[in] Değiştirilecek öğenin sıfır tabanlı dizinini belirtir.

pElem
[in, out] Özgün öğenin yerini alan öğeye yönelik geçerli bir işaretçi.

Dönüş Değeri

Özgün şerit öğesi yeni şerit öğesiyle başarıyla değiştirildiyse TRUE; Şerit öğesi değiştirilmediyse veya belirtilen dizinde öğe yoksa YANLIŞ.

Açıklamalar

Şerit öğesini komut kimliğiyle değiştirmek için CMFCRibbonPanel::ReplaceByID çağrısı yapın.

CMFCRibbonPanel::ReplaceByID

Belirtilen komut kimliğine göre bir öğeyi başka bir öğeyle değiştirir.

BOOL ReplaceByID(
UINT uiCmdID,
CMFCRibbonBaseElement* pElem);

Parametreler

uiCmdID
[in] Değiştirilecek öğenin komut kimliğini belirtir.

pElem
[in, out] Özgün öğenin yerini alacak öğeye ilişkin geçerli bir işaretçi.

Dönüş Değeri

Özgün şerit öğesi yeni şerit öğesiyle başarıyla değiştirildiyse TRUE; Şerit öğesi değiştirilmediyse veya belirtilen komut kimliğine sahip bir öğe yoksa YANLIŞ.

Açıklamalar

Bir şerit öğesini konuma göre değiştirmek için CMFCRibbonPanel::Replace öğesini çağırın.

CMFCRibbonPanel::SetCenterColumnVert

Şerit öğelerinin dikey konumlarının görüntü dikdörtgeni içinde ortalanması özelliğini etkinleştirir veya devre dışı bırakır.

void SetCenterColumnVert(BOOL bSet = TRUE);

Parametreler

bSet
[in] Şerit öğelerinin dikey konumlarını görüntü dikdörtgenleri içinde ortalamak için DOĞRU; Bu özelliği devre dışı bırakmak için YANLIŞ...

Açıklamalar

CMFCRibbonPanel::SetData

Kullanıcı tanımlı verileri şerit paneliyle ilişkilendirir.

void SetData(DWORD_PTR dwData);

Parametreler

dwData
[in] Ayarlanacağı kullanıcı tanımlı verileri belirtir.

Açıklamalar

Kullanıcı tanımlı verileri şerit paneliyle ilişkilendirmek için bu yöntemi çağırın.

CMFCRibbonPanel::SetElementMenu

Verilen komut kimliğine sahip öğeye bir açılır menü atar.

BOOL SetElementMenu(
UINT uiCmdID,
HMENU hMenu,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);

BOOL SetElementMenu(
UINT uiCmdID,
UINT uiMenuResID,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);

Parametreler

uiCmdID
[in] Menünün eklendiği şerit öğesinin komut kimliğini belirtir.

hMenu
[in] Şerit paneline eklenecek Windows menüsünün tutamacını belirtir.

bIsDefautCommand
[in] Şerit öğesine tıklandığında şerit öğesiyle ilişkilendirilmiş komutun yürütülmesi gerektiğini belirtmek için TRUE. Bu durumda, menü yalnızca kullanıcı şerit öğesinin yanındaki oka tıkladığında açılır. Şerit öğesine tıklandığında şerit öğesiyle ilişkilendirilmiş komutun yürütülmemesi gerektiğini belirtmek için YANLIŞ. Bu durumda, kullanıcının öğeye tıkladığı yere bakılmaksızın açılır menü görüntülenir.

bRightAlign
[in] Açılır menünün sağa hizalı olduğunu belirtmek için TRUE; aksi takdirde YANLIŞ.

uiMenuResID
[in] Şerit paneline eklenecek menünün kaynak kimliğini belirtir.

Dönüş Değeri

Menü şerit öğesine atanmışsa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

Verilen komut kimliğine sahip şerit öğesine bir açılır menü atamak için bu yöntemi çağırın.

CMFCRibbonPanel::SetElementRTC

Sağlanan çalışma zamanı sınıf bilgileri tarafından belirtilen şerit öğesini şerit paneline ekler.

CMFCRibbonBaseElement* SetElementRTC(
int nIndex,
CRuntimeClass* pRTC);

Parametreler

nIndex
[in] Eklenecek şerit öğesinin sıfır tabanlı dizinini belirtir.

pRTC
[in, out] Şerit paneline eklenen şerit öğesinin çalışma zamanı sınıf bilgilerine yönelik bir işaretçi.

Dönüş Değeri

Belirtilen çalışma zamanı sınıf bilgileri kullanılarak oluşturulan şerit öğesi.

Açıklamalar

Şerit paneline özel bir öğe (örneğin, renk düğmesi) eklemek istiyorsanız, özel öğenin çalışma zamanı sınıf bilgilerini belirtmeniz gerekir. Şerit bu bilgileri depolar, özel öğeyi oluşturur ve belirtilen komut kimliğinde bulunan (tarafından tanımlanan) mevcut bir öğenin yerini alır. Şerit daha sonra yeni oluşturulan öğeye bir işaretçi döndürür.

CMFCRibbonPanel::SetElementRTCByID

Sağlanan çalışma zamanı sınıf bilgileri tarafından belirtilen bir şerit öğesini şerit paneline ekler.

CMFCRibbonBaseElement* SetElementRTCByID(
UINT uiCmdID,
CRuntimeClass* pRTC);

Parametreler

uiCmdID
[in] Eklenecek şerit öğesinin komut kimliğini belirtir.

pRTC
[in, out] Şerit paneline eklenen şerit öğesiyle ilişkilendirilmiş çalışma zamanı sınıf bilgilerini gösteren bir işaretçi.

Dönüş Değeri

Belirtilen çalışma zamanı sınıf bilgileri kullanılarak oluşturulan şerit öğesi.

Açıklamalar

Şerit paneline özel bir öğe (örneğin, renk düğmesi) eklemek istiyorsanız, özel öğenin çalışma zamanı sınıf bilgilerini belirtmeniz gerekir. Şerit bu bilgileri depolar, özel öğeyi oluşturur ve belirtilen komut kimliği tarafından bulunan mevcut bir öğenin yerini alır. Ardından yeni oluşturulan öğeye bir işaretçi döndürür.

Örnek

Aşağıdaki örnekte yönteminin nasıl kullanılacağı gösterilmektedir SetElementRTCByID :

// Load and add toolbar with standard buttons. This toolbar
// should display a custom color button with id ID_CHAR_COLOR:

pPanel->AddToolBar(IDR_MAINFRAME,
    IDB_MAINFRAME256);

CMFCRibbonColorButton* pColorButton =
(CMFCRibbonColorButton*)pPanel->SetElementRTCByID(
ID_CHAR_COLOR,
    RUNTIME_CLASS (CMFCRibbonColorButton));

// SetElementRTCByID sets runtime class and returns a pointer
// to the newly created custom button,
    which can be set up immediately:
pColorButton->EnableAutomaticButton(_T("Automatic"),
    RGB (0,
    0,
    0));

CMFCRibbonPanel::SetJustifyColumns

Aynı sütundaki şerit öğelerinin genişliğinin ayarlanmasını etkinleştirir veya devre dışı bırakır.

void SetJustifyColumns(BOOL bSet = TRUE);

Parametreler

bSet
[in] Aynı sütundaki şerit öğelerinin genişliğini sütundaki en büyük şerit öğesinin genişliğine ayarlamak için TRUE; Bu genişlik ayarlamasını devre dışı bırakmak için YANLIŞ.

Açıklamalar

Bu özellik şerit panelinde etkinleştirildiğinde, aynı sütundaki şerit öğelerinin genişlikleri aynı sütundaki en büyük şerit öğesinin genişliğine ayarlanır.

CMFCRibbonPanel::SetKeys

Şerit panelinin varsayılan düğmesi için tuş ipucu ayarlar.

void SetKeys(LPCTSTR lpszKeys);

Parametreler

lpszKeys
[in] Şerit panelinin varsayılan düğmesinin tuş ipucu.

Açıklamalar

Şerit panelinin şerit öğelerini görüntülemek için yeterli alanı olmadığında varsayılan düğme görüntülenir.

CMFCRibbonPanel::ShowPopup

Şerit paneli için bir açılır menü oluşturur ve görüntüler.

CMFCRibbonPanelMenu* ShowPopup(CMFCRibbonDefaultPanelButton* pButton = NULL);

Parametreler

pButton
[in] Şerit panelinin varsayılan düğmesinin işaretçisi.

Dönüş Değeri

Yöntem başarılı olursa şerit panelinin açılır menüsünün işaretçisi; aksi takdirde NULL.

Açıklamalar

Şerit panelinin açılır menüsü yalnızca şerit panelinin ekranı daraltıldığında kullanılabilir.

CMFCRibbonPanel::SetFocused

Odağı belirtilen Şerit öğesine ayarlar.

void SetFocused(CMFCRibbonBaseElement* pNewFocus);

Parametreler

pNewFocus
Odağı alan şerit öğesinin işaretçisi.

Açıklamalar

CMFCRibbonPanel::MakeGalleryItemVisible

Belirtilen Şerit öğesini görünür hale getirmek için galeriyi kaydırıyor.

void MakeGalleryItemVisible(CMFCRibbonBaseElement* pItem);

Parametreler

pItem
Gösterilecek Şerit öğesine işaret eden bir işaretçi.

Açıklamalar

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

CMFCRibbonPanel::GetVisibleElements

Görünür öğelerden oluşan bir dizi alır.

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

Parametreler

arElements
İşlev döndürdüğünde, bu parametre görünür öğelerden oluşan bir dizi içerir.

Açıklamalar

CMFCRibbonPanel::GetGalleryRect

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

CRect GetGalleryRect();

Dönüş Değeri

Galeri öğesinin bu panel içindeki boyutu ve konumu.

Açıklamalar

CMFCRibbonPanel::GetFocused

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

CMFCRibbonBaseElement* GetFocused() const;

Dönüş Değeri

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

Açıklamalar

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CObject Sınıfı
CMFCRibbonCategory Sınıfı
CMFCRibbonBaseElement Sınıfı