CMFCRibbonColorButton Sınıfı
sınıfı, CMFCRibbonColorButton
şerit çubuğuna ekleyebileceğiniz bir renk düğmesi uygular. Şerit rengi düğmesi, bir veya daha fazla renk paleti içeren bir açılan menü görüntüler.
Sözdizimi
class CMFCRibbonColorButton : public CMFCRibbonGallery
Üyeler
Ortak Oluşturucular
Ad | Tanım |
---|---|
CMFCRibbonColorButton::CMFCRibbonColorButton |
Genel Yöntemler
Açıklamalar
Şerit rengi düğmesi, kullanıcı bastığında bir renk çubuğu görüntüler. Varsayılan olarak, bu renk çubuğu normal renk alanı olarak adlandırılan bir renk seçimi paleti içerir. İsteğe bağlı olarak, renk çubuğunda kullanıcının varsayılan bir renk seçmesini sağlayan otomatik bir düğme ve ek renkler içeren bir açılır renk paleti görüntüleyen Diğer düğmesi görüntülenebilir.
Örnek
Aşağıdaki örnekte, sınıftaki çeşitli yöntemlerin nasıl kullanılacağı gösterilmektedir CMFCRibbonColorButton
. Örnekte nesne CMFCRibbonColorButton
oluşturma, büyük resmi ayarlama, Otomatik düğmesini etkinleştirme, Diğer düğmesini etkinleştirme, sütun sayısını ayarlama, renk çubuğunda görünen tüm renk öğelerinin boyutunu ayarlama, normal renk alanına bir renk grubu ekleme ve belge renk alanında görüntülenecek RGB değerlerinin listesini belirtme işlemleri gösterilmektedir. Bu kod parçacığı, draw client örneğinin bir parçasıdır.
// Create the "Paper Color" button
CMFCRibbonColorButton *pBtnPaperColor = new CMFCRibbonColorButton(ID_VIEW_PAPERCOLOR, _T("Paper Color\ng"), TRUE, 13, 1);
pBtnPaperColor->SetAlwaysLargeImage();
pBtnPaperColor->EnableAutomaticButton(_T("&Automatic"), RGB(255, 255, 255));
pBtnPaperColor->EnableOtherButton(_T("&More Colors..."), _T("More Colors"));
pBtnPaperColor->SetColumns(10);
pBtnPaperColor->SetColorBoxSize(CSize(17, 17));
// CList<COLORREF,COLORREF> m_lstMainColors
pBtnPaperColor->AddColorsGroup(_T("Theme Colors"), m_lstMainColors, TRUE);
// CList<COLORREF,COLORREF> m_lstAdditionalColors
pBtnPaperColor->AddColorsGroup(_T(""), m_lstAdditionalColors, FALSE);
// CList<COLORREF,COLORREF> m_lstStandardColors
pBtnPaperColor->AddColorsGroup(_T("Standard Colors"), m_lstStandardColors, TRUE);
CList<COLORREF, COLORREF> lstColors;
lstColors.AddTail(RGB(255, 0, 0));
lstColors.AddTail(RGB(0, 255, 0));
lstColors.AddTail(RGB(0, 0, 255));
pBtnPaperColor->SetDocumentColors(_T("Document Colors"), lstColors);
Devralma Hiyerarşisi
Gereksinimler
Üst bilgi: afxribboncolorbutton.h
CMFCRibbonColorButton::AddColorsGroup
Normal renk alanına bir renk grubu ekler.
void AddColorsGroup(
LPCTSTR lpszName,
const CList<COLORREF,COLORREF>& lstColors,
BOOL bContiguousColumns=FALSE);
Parametreler
Lpszname
[in] Grup adı.
lstColors
[in] Renk listesi.
bContiguousColumns
[in] Renk öğelerinin grupta nasıl görüntüleneceğini denetler. TRUE ise, renk öğeleri dikey aralık olmadan çizilir. YANLIŞ ise, renk öğeleri dikey aralıklarla çizilir.
Açıklamalar
Renk açılır penceresinin birkaç renk grubu görüntülemesini sağlamak için bu işlevi kullanın. Renklerin grupta nasıl görüntüleneceğini denetleyebilirsiniz.
CMFCRibbonColorButton::CMFCRibbonColorButton
Bir CMFCRibbonColorButton
nesne oluşturur.
CMFCRibbonColorButton();
CMFCRibbonColorButton(
UINT nID,
LPCTSTR lpszText,
int nSmallImageIndex,
COLORREF color = RGB(0, 0, 0));
CMFCRibbonColorButton(
UINT nID,
LPCTSTR lpszText,
BOOL bSimpleButtonLook,
int nSmallImageIndex,
int nLargeImageIndex,
COLORREF color = RGB(0, 0, 0));
Parametreler
Nıd
[in] Kullanıcı düğmeye tıkladığında yürütülecek komutun komut kimliğini belirtir.
lpszText
[in] Düğmede görüntülenecek metni belirtir.
nSmallImageIndex
[in] Düğmede görünecek küçük görüntünün sıfır tabanlı dizini.
Renk
[in] Düğmenin rengi (varsayılan olarak siyahtır).
bSimpleButtonLook
[in] TRUE ise, düğme basit bir dikdörtgen olarak çizilir.
nLargeImageIndex
[in] Düğmede görünecek büyük görüntünün sıfır tabanlı dizini.
İade Değeri
Açıklamalar
CMFCRibbonColorButton::EnableAutomaticButton
Otomatik düğmesinin etkinleştirilip etkinleştirilmediğini belirtir.
void EnableAutomaticButton(
LPCTSTR lpszLabel,
COLORREF colorAutomatic,
BOOL bEnable=TRUE,
LPCTSTR lpszToolTip=NULL,
BOOL bOnTop=TRUE,
BOOL bDrawBorder=FALSE);
Parametreler
lpszLabel
[in] Otomatik düğmesinin etiketi.
Colorautomatic
[in] Otomatik düğmesinin varsayılan rengini belirten RGB değeri.
bEnable
[in] Otomatik düğmesi etkinse TRUE; Devre dışıysa YANLIŞ.
lpszToolTip
[in] Otomatik düğmesinin araç ipucu.
bOnTop
[in] Otomatik düğmesinin renk paleti öncesinde en üstte olup olmadığını belirtir.
bDrawBorder
[in] Uygulama şerit renk düğmesindeki renk çubuğunun çevresine kenarlık çiziyorsa TRUE. Renk çubuğu seçili durumdaki rengi görüntüler. Uygulama kenarlık çizmiyorsa YANLIŞ
CMFCRibbonColorButton::EnableOtherButton
Diğer düğmesini etkinleştirir.
void EnableOtherButton(
LPCTSTR lpszLabel,
LPCTSTR lpszToolTip=NULL);
Parametreler
lpszLabel
Düğmenin etiketi.
lpszToolTip
Diğer düğmesinin araç ipucu metni.
Açıklamalar
Diğer düğmesi, renk grubunun altında görüntülenen düğmedir. Kullanıcı Diğer düğmesine tıkladığında bir renk iletişim kutusu görüntüler.
CMFCRibbonColorButton::GetAutomaticColor
Geçerli otomatik düğme rengini alır.
COLORREF GetAutomaticColor() const;
İade Değeri
Geçerli otomatik düğme rengini temsil eden RGB renk değeri.
Açıklamalar
Otomatik düğme rengi, yöntemine colorAutomatic
CMFCRibbonColorButton::EnableAutomaticButton
geçirilen parametre tarafından ayarlanır.
CMFCRibbonColorButton::GetColor
Seçili olan rengi döndürür.
COLORREF GetColor() const;
İade Değeri
Düğmeye tıklayarak seçilen renk.
CMFCRibbonColorButton::GetColorBoxSize
Renk çubuğunda görünen renk öğelerinin boyutunu döndürür.
CSize GetColorBoxSize() const;
İade Değeri
Açılan renk paletindeki renk düğmelerinin boyutu.
CMFCRibbonColorButton::GetColumns
Şerit rengi düğmesinin galeri görüntüsünün bir satırındaki öğe sayısını alır.
int GetColumns() const;
İade Değeri
Her satırdaki simge sayısını döndürür.
Açıklamalar
CMFCRibbonColorButton::GetHighlightedColor
Açılır renk paletinde seçili durumdaki öğenin rengini döndürür.
COLORREF GetHighlightedColor() const;
İade Değeri
Açılır renk paletinde seçili durumdaki öğenin rengi.
CMFCRibbonColorButton::RemoveAllColorGroups
Normal renk alanından tüm renk gruplarını kaldırır.
void RemoveAllColorGroups();
CMFCRibbonColorButton::SetColor
Normal renk alanından bir renk seçer.
void SetColor(COLORREF color);
Parametreler
Renk
[in] Ayarlanacağı renk.
CMFCRibbonColorButton::SetColorBoxSize
Renk çubuğunda görünen tüm renk öğelerinin boyutunu ayarlar.
void SetColorBoxSize(CSize sizeBox);
Parametreler
sizeBox
[in] Renk paletindeki renk düğmelerinin yeni boyutu.
CMFCRibbonColorButton::SetColorName
Belirtilen renk için yeni bir ad ayarlar.
static void __stdcall SetColorName(
COLORREF color,
const CString& strName);
Parametreler
Renk
[in] Bir rengin RGB değeri.
strName
[in] Belirtilen rengin yeni adı.
Açıklamalar
çağırdığı CMFCColorBar::SetColorName
için bu yöntem, uygulamanızdaki tüm CMFCColorBar
nesnelerde belirtilen rengin adını değiştirir.
CMFCRibbonColorButton::SetColumns
Kullanıcının renk seçimi işlemi sırasında kullanıcıya sunulan renk tablosunda görüntülenen sütun sayısını ayarlar.
void SetColumns(int nColumns);
Parametreler
nSütunlar
[in] Her satırda görüntülenecek renk simgelerinin sayısı.
Açıklamalar
CMFCRibbonColorButton::SetDocumentColors
Belge renk alanında görüntülenecek RGB değerlerinin listesini belirtir.
void SetDocumentColors(
LPCTSTR lpszLabel,
CList<COLORREF,COLORREF>& lstColors);
Parametreler
lpszLabel
[in] Belge renkleriyle görüntülenecek metin.
lstColors
[in] RGB değerleri listesine başvuru.
CMFCRibbonColorButton::SetPalette
Renk düğmesinin görüntülediği renk tablosunda görüntülenecek standart renkleri belirtir.
void SetPalette(CPalette* pPalette);
Parametreler
pPalette
[in] Renk paleti işaretçisi.
Açıklamalar
CMFCRibbonColorButton::UpdateColor
Kullanıcı renk düğmesine tıkladığında görüntülenen renk tablosundan bir renk seçtiğinde çerçeve tarafından çağrılır.
void UpdateColor(COLORREF color);
Parametreler
Renk
[in] Kullanıcı tarafından seçilen bir renk.
Açıklamalar
yöntemi, CMFCRibbonColorButton::UpdateColor
seçili durumdaki düğmenin rengini değiştirir ve BN_CLICKED standart bir bildirimle WM_COMMAND bir ileti göndererek üst öğesini uyarır. Seçilen rengi almak için CMFCRibbonColorButton::GetColor yöntemini kullanın.
Ayrıca bkz.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin