CMFCRibbonGallery Sınıfı

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

Sözdizimi

class CMFCRibbonGallery : public CMFCRibbonButton

Üyeler

Ortak Oluşturucular

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

Genel Yöntemler

Veri Akışı Adı	Açıklama
CMFCRibbonGallery::AddGroup	Galeriye yeni bir grup ekler.
CMFCRibbonGallery::AddSubItem	Açılan menüye yeni bir menü öğesi ekler.
CMFCRibbonGallery::Clear	Galerinin içeriğini temizler.
CMFCRibbonGallery::EnableMenuResize	Menü panelini yeniden boyutlandırmayı etkinleştirir veya devre dışı bırakır.
CMFCRibbonGallery::EnableMenuSideBar	Açılır menünün solundaki yan çubuğu etkinleştirir veya devre dışı bırakır.
CMFCRibbonGallery::GetCompactSize	(Geçersiz Kılmalar CMFCRibbonButton::GetCompactSize.)
CMFCRibbonGallery::GetDroppedDown	(Geçersiz Kılmalar CMFCRibbonBaseElement::GetDroppedDown.)
CMFCRibbonGallery::GetGroupName	Belirtilen dizinde bulunan grubun adını döndürür.
CMFCRibbonGallery::GetGroupOffset
CMFCRibbonGallery::GetIconsInRow	Şerit galerisinin bir satırındaki öğe sayısını döndürür.
CMFCRibbonGallery::GetItemToolTip	Galerideki bir öğeyle ilişkili araç ipucu metnini döndürür.
CMFCRibbonGallery::GetLastSelectedItem	Kullanıcının seçtiği galerideki son öğenin dizinini döndürür.
CMFCRibbonGallery::GetPaletteID	Geçerli galerinin komut kimliğini döndürür.
CMFCRibbonGallery::GetRegularSize	(Geçersiz Kılmalar CMFCRibbonButton::GetRegularSize.)
CMFCRibbonGallery::GetSelectedItem
CMFCRibbonGallery::HasMenu	(Geçersiz Kılmalar CMFCRibbonButton::HasMenu.)
CMFCRibbonGallery::IsButtonMode	Galerinin bir galeri düğmesinde bulunup bulunmadığını belirtir.
CMFCRibbonGallery::IsMenuResizeEnabled	Menü yeniden boyutlandırmanın etkin mi yoksa devre dışı mı olduğunu belirtir.
CMFCRibbonGallery::IsMenuResizeVertical
CMFCRibbonGallery::IsMenuSideBar	Yan çubuğun etkin mi yoksa devre dışı mı olduğunu belirtir.
CMFCRibbonGallery::OnAfterChangeRect	(Geçersiz Kılmalar CMFCRibbonButton::OnAfterChangeRect.)
CMFCRibbonGallery::OnDraw	(Geçersiz Kılmalar CMFCRibbonButton::OnDraw.)
CMFCRibbonGallery::OnEnable	(Geçersiz Kılmalar CMFCRibbonBaseElement::OnEnable.)
CMFCRibbonGallery::OnRTLChanged	(Geçersiz Kılmalar CMFCRibbonBaseElement::OnRTLChanged.)
CMFCRibbonGallery::RedrawIcons	Galeriyi yeniden çizer.
CMFCRibbonGallery::RemoveItemToolTips	Araç ipuçlarını galerideki tüm öğelerden kaldırır.
CMFCRibbonGallery::SelectItem
CMFCRibbonGallery::SetACCData	(Geçersiz Kılmalar CMFCRibbonButton::SetACCData.)
CMFCRibbonGallery::SetButtonMode	Şerit galerisinin doğrudan şeritte açılan düğme olarak mı yoksa palet olarak mı görüntüleneceğini belirtir.
CMFCRibbonGallery::SetGroupName	Bir grubun adını ayarlar.
CMFCRibbonGallery::SetIconsInRow	Galerideki satır başına öğe sayısını tanımlar.
CMFCRibbonGallery::SetItemToolTip	Galerideki bir öğenin araç ipucu metnini ayarlar.
CMFCRibbonGallery::SetPalette	Şerit galerisine palet ekler.
CMFCRibbonGallery::SetPaletteID	Bir galeri öğesi seçildiğinde WM_COMMAND iletisinde gönderilen komut kimliğini tanımlar.

Korumalı Yöntemler

Veri Akışı Adı	Açıklama
CMFCRibbonGallery::OnDrawPaletteIcon	Bir galeri simgesi çizildiğinde çerçeve tarafından çağrılır.

Açıklamalar

Galeri düğmesi, normal bir menü düğmesi gibi davranır ancak kullanıcı galeriyi açtığında görüntüler. Galerideki bir öğeyi seçtiğinizde, çerçeve WM_COMMAND iletisini düğmenin komut kimliğiyle birlikte gönderir. İletiyi işlerken, galeriden hangi öğenin seçildiğini belirlemek için CMFCRibbonGallery::GetLastSelectedItem çağrısı yapmalısınız.

Örnek

Aşağıdaki örnekte, bir CMFCRibbonGallery nesneyi yapılandırmak için sınıftaki çeşitli yöntemlerin CMFCRibbonGallery nasıl kullanılacağı gösterilmektedir. Örnek, galerideki satır başına öğe sayısını belirtmeyi, menü panelini yeniden boyutlandırmayı etkinleştirmeyi, açılır menünün solundaki yan çubuğu etkinleştirmeyi ve şerit galerisini doğrudan şerit çubuğunda palet olarak görüntülemeyi gösterir. Bu kod parçacığı, draw client örneğinin bir parçasıdır.

CMFCRibbonGallery *pBtnStyles = new CMFCRibbonGallery(ID_OBJECT_STYLES, _T("Styles\nk"), 0, 0, IDB_STYLES, 40);
pBtnStyles->SetIconsInRow(7);
pBtnStyles->EnableMenuResize(TRUE, TRUE);
pBtnStyles->EnableMenuSideBar();
pBtnStyles->SetButtonMode(false);
pBtnStyles->RedrawIcons();

Devralma Hiyerarşisi

CObject
└ CMFCRibbonBaseElement
 └ CMFCRibbonButton
  └ CMFCRibbonGallery

Gereksinimler

Üst bilgi: afxRibbonPaletteGallery.h

CMFCRibbonGallery::AddGroup

Galeriye yeni bir grup ekler.

void AddGroup(
    LPCTSTR lpszGroupName,
    UINT uiImagesPaletteResID,
    int cxPaletteImage);

void AddGroup(
    LPCTSTR lpszGroupName,
    CMFCToolBarImages& imagesGroup);

void AddGroup(
    LPCTSTR lpszGroupName,
    int nIconsNum);

Parametreler

lpszGroupName
[in] Grubun adını belirtir.

uiImagesPaletteResID
[in] Grubun görüntülerini içeren görüntü listesinin kaynak kimliğini belirtir.

cxPaletteImage
[in] Görüntünün piksel cinsinden genişliğini belirtir.

imagesGroup
[in] Grup görüntüleri içeren resim listesine başvuru.

nIconsNum
[in] Gruptaki simgelerin sayısını belirtir. Bu parametre yalnızca özel (sahip tarafından çizilen) gruplar için belirtilmelidir.

Açıklamalar

Bu yöntemi çağırarak şerit galerisindeki öğeleri birden çok gruba bölebilirsiniz. Her grubun bir resim yazısı olabilir.

CMFCRibbonGallery::AddSubItem

Açılan menüye yeni bir menü öğesi ekler.

void AddSubItem(
    CMFCRibbonBaseElement* pSubItem,
    int nIndex=-1,
    BOOL bOnTop=FALSE);

Parametreler

pSubItem
[in] Menüye eklenecek öğe işaretçisi.

nIndex
[in] Öğenin eklendiği konumun sıfır tabanlı dizinini belirtir.

bOnTop
[in] Öğenin şerit galerisinden önce eklenmesi gerektiğini belirtmek için DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

Bu yöntemi çağırarak açılır galerileri açılır menü öğeleriyle birleştirebilirsiniz. Menü öğeleri galeriden önce veya sonra yerleştirilebilir.

Öğeyi galeriden önce eklemek için bOnTop değerini TRUE olarak ayarlayın. Öğeyi galerinin altına eklemek için bOnTop değerini YANLIŞ olarak ayarlayın.

Not

nIndex parametresi, ekleme dizinini hem galerinin en üstünde hem de galerinin alt kısmında belirtir. Örneğin, galeriden bir konum önce bir öğe eklemeniz gerekiyorsa nIndex değerini 1 ve bOnTop değerini TRUE olarak ayarlayın. Benzer şekilde, galerinin altına bir konum bir öğe eklemeniz gerekiyorsa nIndex değerini 1 ve bOnTop değerini YANLIŞ olarak ayarlayın.

CMFCRibbonGallery::Clear

Galerinin içeriğini temizler.

virtual void Clear();

Açıklamalar

Şerit galerisindeki tüm içeriği kaldırmak için bu yöntemi çağırın. Bu, şerit galerisine yeni bir şerit galerisi veya grup kümesi eklemeden önce yapılmalıdır.

CMFCRibbonGallery::CMFCRibbonGallery

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

CMFCRibbonGallery (
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    int nLargeImageIndex,
    CMFCToolBarImages& imagesPalette);

CMFCRibbonGallery (
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    int nLargeImageIndex,
    UINT uiImagesPaletteResID=0,
    int cxPaletteImage=0);

CMFCRibbonGallery (
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    int nLargeImageIndex,
    CSize sizeIcon,
    int nIconsNum,
    BOOL bDefaultButtonStyle=TRUE);

Parametreler

Nıd
Kullanıcı düğmeye tıkladığında yürütülecek komutun komut kimliğini belirtir.

lpszText
Düğmede görüntülenecek metni belirtir.

nSmallImageIndex
Düğmede görünecek küçük görüntünün sıfır tabanlı dizini.

nLargeImageIndex
Düğmede görünecek büyük görüntünün sıfır tabanlı dizini.

imagesPalette
Galeride görüntülenecek görüntüleri içeren CMFCToolBarImages nesnesine başvuru.

uiImagesPaletteResID
Galeride görüntülenecek görüntü listesinin kaynak kimliği.

cxPaletteImage
Galerideki görüntünün genişliğini piksel cinsinden belirtir.

sizeIcon
Galeri görüntüsünün boyutunu piksel cinsinden belirtir.

nIconsNum
Galerideki simge sayısını belirtir.

bDefaultButtonStyle
Varsayılan veya sahip tarafından çizilen düğme stilinin kullanılıp kullanılmayacağını belirtir.

Açıklamalar

CMFCRibbonGallery::EnableMenuResize

Menü panelini yeniden boyutlandırmayı etkinleştirir veya devre dışı bırakır.

void EnableMenuResize(
    BOOL bEnable = TRUE,
    BOOL bVertcalOnly = FALSE);

Parametreler

bEnable
[in] Menüyü yeniden boyutlandırmayı etkinleştirmek için TRUE; aksi takdirde YANLIŞ.

bVertcalOnly
[in] Galerinin yalnızca dikey olarak yeniden boyutlandırılabilmesini belirtmek için DOĞRU; YANLIŞ, galerinin hem dikey hem de yatay olarak yeniden boyutlandırılabilmesini belirtir.

Açıklamalar

Şerit galerisini yeniden boyutlandırmayı etkinleştirmek veya devre dışı bırakmak için bu yöntemi kullanın. Yeniden boyutlandırma etkinleştirildiğinde, şerit galerisi bir kullanıcının yeniden boyutlandırmak için kullanabileceği bir kavrama düğmesi görüntüler.

CMFCRibbonGallery::EnableMenuSideBar

Açılır menünün solundaki yan çubuğu etkinleştirir veya devre dışı bırakır.

void EnablMenuSideBar(BOOL bEnable=TRUE);

Parametreler

bEnable
[in] Yan çubuğun etkin olduğunu belirtmek için DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

Menünün sol tarafındaki Office XP stilindeki yan çubuğu etkinleştirmek veya devre dışı bırakmak için bu yöntemi çağırın.

CMFCRibbonGallery::GetCompactSize

virtual CSize GetCompactSize(CDC* pDC);

Parametreler

[in] pDC

Dönüş Değeri

Açıklamalar

CMFCRibbonGallery::GetDroppedDown

virtual CMFCRibbonBaseElement* GetDroppedDown();

Dönüş Değeri

Açıklamalar

CMFCRibbonGallery::GetGroupName

Belirtilen dizinde bulunan grubun adını döndürür.

LPCTSTR GetGroupName(int nGroupIndex) const;

Parametreler

nGroupIndex
[in] Adını almak istediğiniz grubun sıfır tabanlı dizinini belirtir.

Dönüş Değeri

Belirtilen dizinde bulunan grubun adı. Geçersiz bir dizin geçirilmesi başarısız onaylama işlemine neden olur.

Açıklamalar

CMFCRibbonGallery::GetGroupOffset

virtual int GetGroupOffset() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonGallery::GetIconsInRow

Şerit galerisinin bir satırındaki öğe sayısını döndürür.

int GetIconsInRow() const;

Dönüş Değeri

Bir satırdaki öğe sayısı.

Açıklamalar

CMFCRibbonGallery::GetItemToolTip

Galerideki bir öğeyle ilişkili araç ipucu metnini döndürür.

LPCTSTR GetItemToolTip(int nItemIndex) const;

Parametreler

nItemIndex
[in] Araç ipucu metninin alındığı öğenin sıfır tabanlı dizinini belirtir.

Dönüş Değeri

Şerit galerisindeki bir öğeye atanan araç ipucu dizesinin işaretçisi. Bu öğeye hiçbir araç ipucu atanmamışsa NULL olabilir.

Açıklamalar

CMFCRibbonGallery::GetLastSelectedItem

Şerit galerisinde kullanıcının seçtiği son öğenin dizinini döndürür.

static int GetLastSelectedItem(UINT uiCmdID);

Parametreler

uiCmdID
[in] Şerit galerisini açan menü öğesinin komut kimliğini belirtir.

Dönüş Değeri

Kullanıcı şerit galerisindeki herhangi bir öğeyi seçtiğinde, kitaplık şerit galerisini açan menü düğmesinin Komut Kimliği ile birlikte WM_COMMAND iletisini gönderir.

Açıklamalar

CMFCRibbonGallery::GetPaletteID

Geçerli paletin komut kimliğini döndürür.

int GetPaletteID() const;

Dönüş Değeri

Seçili durumdaki paletin komut kimliği.

Açıklamalar

CMFCRibbonGallery::GetRegularSize

virtual CSize GetRegularSize(CDC* pDC);

Parametreler

[in] pDC

Dönüş Değeri

Açıklamalar

CMFCRibbonGallery::GetSelectedItem

int GetSelectedItem() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonGallery::HasMenu

virtual BOOL HasMenu() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonGallery::IsButtonMode

Paletin galeri düğmesinde bulunup bulunmadığını belirtir.

BOOL IsButtonMode() const;

Dönüş Değeri

Palet açılan menü düğmesi olarak görüntüleniyorsa TRUE; Palet doğrudan şeritte görüntüleniyorsa YANLIŞ.

Açıklamalar

CMFCRibbonGallery::IsMenuResizeEnabled

Menü yeniden boyutlandırmanın etkinleştirilip etkinleştirilmediğini belirtir.

BOOL IsMenuResizeEnabled() const;

Dönüş Değeri

Menü yeniden boyutlandırma etkinleştirildiyse TRUE; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonGallery::IsMenuResizeVertical

BOOL IsMenuResizeVertical() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonGallery::IsMenuSideBar

Yan çubuğun etkin mi yoksa devre dışı mı olduğunu belirtir.

BOOL IsMenuSideBar() const;

Dönüş Değeri

Açılır menünün sol tarafında Office XP stilindeki yan çubuk çizilmişse DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

CMFCRibbonGallery::OnAfterChangeRect

virtual void OnAfterChangeRect(CDC* pDC);

Parametreler

[in] pDC

Açıklamalar

CMFCRibbonGallery::OnDraw

virtual void OnDraw(CDC* pDC);

Parametreler

[in] pDC

Açıklamalar

CMFCRibbonGallery::OnDrawPaletteIcon

Bir galeri simgesi çizildiğinde çerçeve tarafından çağrılır.

virtual void OnDrawPaletteIcon(
    CDC* pDC,
    CRect rectIcon,
    int nIconIndex,
    CMFCRibbonGalleryIcon* pIcon,
    COLORREF clrText);

Parametreler

pDC
[in] Çizim için kullanılan cihaz bağlamı işaretçisi.

rectIcon
[in] Çizilmesi gereken simgenin sınırlayıcı dikdörtgenini belirtir.

nIconIndex
[in] Çizecek simgenin galeri simgelerinin görüntü listesinde sıfır tabanlı dizini belirtir.

pIcon
[in] Çizilmekte olan simgenin işaretçisi.

clrText
[in] Çizecek öğe metninin rengini belirtir.

Açıklamalar

Şerit galerisinin görünümünü özelleştirmek için türetilmiş bir sınıfta bu yöntemi geçersiz kılabilirsiniz.

CMFCRibbonGallery::OnEnable

virtual void OnEnable(BOOL bEnable);

Parametreler

[in] bEnable

Açıklamalar

CMFCRibbonGallery::OnRTLChanged

virtual void OnRTLChanged(BOOL bIsRTL);

Parametreler

[in] bIsRTL

Açıklamalar

CMFCRibbonGallery::RedrawIcons

Galeriyi yeniden çizer.

void RedrawIcons();

Açıklamalar

Galeriyi yeniden çizmek için bu işlevi çağırın. Çalışma zamanında galerinin içeriğini değiştirdiyseniz bu yöntemi çağırmalısınız.

CMFCRibbonGallery::RemoveItemToolTips

Araç ipuçlarını galerideki tüm öğelerden kaldırır.

void RemoveItemToolTips();

Açıklamalar

CMFCRibbonGallery::SelectItem

void SelectItem(int nItemIndex);

Parametreler

[in] nItemIndex

Açıklamalar

CMFCRibbonGallery::SetACCData

Şerit galerisindeki erişilebilirlik verilerini kullanarak belirtilen CAccessibilityData nesneyi doldurur.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parametreler

pParent
[in] Şerit galerisi penceresinin üst penceresi.

data
[out] CAccessibilityData Şerit galerisinden erişilebilirlik verilerini alan nesne.

Dönüş Değeri

Açıklamalar

Yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.

CMFCRibbonGallery::SetButtonMode

Şerit galerisinin doğrudan şeritte açılan düğme olarak mı yoksa palet olarak mı görüntüleneceğini belirler.

void SetButtonMode(BOOL bSet=TRUE);

Parametreler

bSet
[in] Şerit galerisini açılan menü düğmesi olarak görüntülemek için TRUE; ŞERIT galerisinin içeriğini doğrudan şeritte görüntülemek için YANLIŞ.

Açıklamalar

CMFCRibbonGallery::SetGroupName

Bir grubun adını ayarlar.

void SetGroupName(
    int nGroupIndex,
    LPCTSTR lpszGroupName);

Parametreler

nGroupIndex
[in] Adın değiştirildiği grup için sıfır tabanlı dizini belirtir.

lpszGroupName
[in] Grubun yeni adını belirtir.

Açıklamalar

Adı değiştirilen grubun CMFCRibbonGallery::AddGroup yöntemi kullanılarak eklenmiş olması gerekir.

CMFCRibbonGallery::SetIconsInRow

Galerideki satır başına öğe sayısını belirtir.

void SetIconsInRow(int nIconsInRow);

Parametreler

nIconsInRow
[in] Galerinin her satırında görüntülenecek öğe sayısını belirtir.

Açıklamalar

Şerit galerisinin genişliğini belirtmek için bu yöntemi kullanın.

CMFCRibbonGallery::SetItemToolTip

Galerideki bir öğenin araç ipucu metnini ayarlar.

void SetItemToolTip(
    int nItemIndex,
    LPCTSTR lpszToolTip);

Parametreler

nItemIndex
[in] Araç ipucunun ilişkilendirildiği palet öğesinin sıfır tabanlı dizini.

lpszToolTip
[in] Araç ipucunda görüntülenecek metin.

Açıklamalar

CMFCRibbonGallery::SetPalette

Şerit galerisine palet ekler.

void SetPalette(CMFCToolBarImages& imagesPalette);

void SetPalette(
    UINT uiImagesPaletteResID,
    int cxPaletteImage);

Parametreler

imagesPalette
[in] Galeride görünecek simgeleri içeren resim listesini belirtir.

uiImagesPaletteResID
[in] Galeride görünecek simgeleri içeren resim listesinin kaynak kimliğini belirtir.

cxPaletteImage
[in] Galerideki bir görüntünün genişliğini piksel cinsinden belirtir.

Açıklamalar

CMFCRibbonGallery::SetPaletteID

Kullanıcı bir galeri öğesi seçtiğinde WM_COMMAND iletisinde gönderilen komut kimliğini tanımlar.

void SetPaletteID(UINT nID);

Parametreler

Nıd
[in] Kullanıcı bir galeri öğesi seçtiğinde WM_COMMAND iletisinde gönderilen komut kimliğini belirtir.

Açıklamalar

Bir kullanıcının galeriden seçtiği belirli öğeyi belirlemek için CMFCRibbonGallery::GetLastSelectedItem statik yöntemini çağırın.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CMFCRibbonButton Sınıfı
CMFCRibbonGalleryMenuButton Sınıfı