Aracılığıyla paylaş

CMFCColorButton Sınıfı

  • Makale

CMFCColorButton ve CMFCColorBar Sınıf sınıfları bir renk seçici denetimi uygulamak için birlikte kullanılır.

Sözdizimi

class CMFCColorButton : public CMFCButton

Üyeler

Ortak Oluşturucular

Veri Akışı Adı Açıklama
CMFCColorButton::CMFCColorButton Yeni CMFCColorButton bir nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı Açıklama
CMFCColorButton::EnableAutomaticButton Normal renk düğmelerinin üzerine yerleştirilmiş bir "otomatik" düğmeyi etkinleştirir ve devre dışı bırakır. (Standart sistem otomatik düğmesi etiketlenmiştir Otomatik.)
CMFCColorButton::EnableOtherButton Normal renk düğmelerinin altına yerleştirilmiş bir "diğer" düğmesini etkinleştirir ve devre dışı bırakır. (Standart sistem "diğer" düğmesi etiketlenmiştir Diğer Renkler.)
CMFCColorButton::GetAutomaticColor Geçerli otomatik rengi alır.
CMFCColorButton::GetColor Düğmenin rengini alır.
CMFCColorButton::SetColor Düğmenin rengini ayarlar.
CMFCColorButton::SetColorName Bir renk adı ayarlar.
CMFCColorButton::SetColumnsNumber Renk seçici iletişim kutusundaki sütun sayısını ayarlar.
CMFCColorButton::SetDocumentColors Renk seçici iletişim kutusunda görüntülenen belgeye özgü renklerin listesini belirtir.
CMFCColorButton::SetPalette Standart görüntü renkleri paletini belirtir.
CMFCColorButton::SizeToContent Düğme denetiminin boyutunu, metin ve görüntü boyutuna bağlı olarak değiştirir.

Korumalı Yöntemler

Veri Akışı Adı Açıklama
CMFCColorButton::IsDrawXPTheme Geçerli renk düğmesinin Windows XP'nin görsel stilinde görüntülenip görüntülenmeyeceğini gösterir.
CMFCColorButton::OnDraw Düğmenin görüntüsünü görüntülemek için çerçeve tarafından çağrılır.
CMFCColorButton::OnDrawBorder Düğmenin kenarını görüntülemek için çerçeve tarafından çağrılır.
CMFCColorButton::OnDrawFocusRect Düğmenin odağı olduğunda odak dikdörtgenini görüntülemek için çerçeve tarafından çağrılır.
CMFCColorButton::OnShowColorPopup Renk seçici iletişim kutusu görüntülenmek üzereyken çerçeve tarafından çağrılır.
CMFCColorButton::RebuildPalette Korumalı veri üyesini m_pPalette belirtilen palete veya varsayılan sistem paletine başlatır.
CMFCColorButton::UpdateColor Kullanıcı renk seçici iletişim kutusunun paletinden bir renk seçtiğinde çerçeve tarafından çağrılır.

Veri Üyeleri

Veri Akışı Adı Açıklama
m_bAltColorDlg Boole dili. TRUE ise, çerçeve, diğer düğmeye tıklandığında CMFCColorDialog rengi iletişim kutusunu veya YANLIŞ ise sistem rengi iletişim kutusunu görüntüler. Varsayılan değer DOĞRU'dur. Daha fazla bilgi için bkz . CMFCColorButton::EnableOtherButton.
m_bAutoSetFocus Boole dili. TRUE ise, menü görüntülendiğinde çerçeve odağı renk menüsünde ayarlar veya YANLIŞ ise odağı değiştirmez. Varsayılan değer DOĞRU'dur.
CMFCColorButton::m_bEnabledInCustomizeMode Renk düğmesi için özelleştirme modunun etkinleştirilip etkinleştirilmediğini gösterir.
m_Color COLORREF değeri. Seçili olan rengi içerir.
m_ColorAutomatic COLORREF değeri. Seçili durumdaki varsayılan rengi içerir.
m_Colors COLORREF değerlerinin CArray değeri. Şu anda kullanılabilir olan renkleri içerir.
m_lstDocColors COLORREF değerlerinin CList'i. Geçerli belge renklerini içerir.
m_nColumns Tamsayı. Renk seçimi menüsündeki renk kılavuzunda görüntülenecek sütun sayısını içerir.
m_pPalette CPalette işaretçisi. Geçerli renk seçimi menüsünde kullanılabilen renkleri içerir.
m_pPopup CMFCColorPopupMenu Sınıfı nesnesinin işaretçisi. Renk düğmesine tıkladığınızda görüntülenen renk seçimi menüsü.
m_strAutoColorText Bir dize. Renk seçimi menüsündeki "otomatik" düğmesinin etiketi.
m_strDocColorsText Bir dize. Belge renklerini görüntüleyen bir renk seçimi menüsündeki düğmenin etiketi.
m_strOtherText Bir dize. Renk seçimi menüsündeki "diğer" düğmesinin etiketi.

Açıklamalar

Varsayılan olarak, CMFCColorButton sınıf bir renk seçici iletişim kutusunu açan bir anında iletme düğmesi olarak davranır. Renk seçici iletişim kutusu, küçük renk düğmelerinden oluşan bir dizi ve özel bir renk seçici görüntüleyen bir "diğer" düğme içerir. (Standart sistem "diğer" düğmesi etiketlenmiştir Diğer Renkler.) Kullanıcı yeni bir renk seçtiğinde CMFCColorButton , nesne değişikliği yansıtır ve seçili rengi görüntüler.

Doğrudan kodunuzda veya ClassWizard aracını ve bir iletişim kutusu şablonunu kullanarak bir renk düğmesi denetimi oluşturun. Doğrudan bir renk düğmesi denetimi oluşturursanız, uygulamanıza bir CMFCColorButton değişken ekleyin ve nesnenin oluşturucusunu ve Create yöntemlerini çağırın CMFCColorButton . ClassWizard kullanıyorsanız, uygulamanıza bir CButton değişken ekleyin ve değişkenin türünü olarak CButton CMFCColorButtondeğiştirin.

Çerçeve olay işleyicisini çağırdığındaOnLButtonDown, renk seçici iletişim kutusu (CMFCColorBar Sınıfı) CMFCColorButton::OnShowColorPopup yöntemi tarafından görüntülenir. CMFCColorButton::OnShowColorPopup yöntemi, özel renk seçimini desteklemek için geçersiz kılınabilir.

Nesne, CMFCColorButton bir rengin değiştiğini üst öğeye WM_COMMAND | göndererek bildirir BN_CLICKED bildirimi. Üst öğe, geçerli rengi almak için CMFCColorButton::GetColor yöntemini kullanır.

Örnek

Aşağıdaki örnekte, sınıftaki çeşitli yöntemleri kullanarak bir renk düğmesinin nasıl yapılandırılır gösterilmektedir CMFCColorButton . Yöntemler, renk düğmesinin rengini ve sütun sayısını ayarlar ve otomatik ve diğer düğmeleri etkinleştirir. Bu örnek, Durum Çubuğu Tanıtım örneğinin bir parçasıdır.

CMFCColorButton m_wndTextColor;

m_wndTextColor.EnableAutomaticButton(_T("Default"), afxGlobalData.clrBtnText);
m_wndTextColor.EnableOtherButton(_T("Other..."));
m_wndTextColor.SetColor((COLORREF)-1);
m_wndTextColor.SetColorName((COLORREF)-1, "Default Color");
m_wndTextColor.SetColumnsNumber(3);

Gereksinimler

Üst bilgi: afxcolorbutton.h

CMFCColorButton::CMFCColorButton

Yeni CMFCColorButton bir nesne oluşturur.

CMFCColorButton();

CMFCColorButton::EnableAutomaticButton

Renk seçici denetiminin "otomatik" düğmesini etkinleştirin veya devre dışı bırakın ve otomatik (varsayılan) rengi ayarlayın.

void EnableAutomaticButton(
    LPCTSTR lpszLabel,
    COLORREF colorAutomatic,
    BOOL bEnable=TRUE);

Parametreler

lpszLabel
[in] Otomatik düğmenin metnini belirtir.

colorAutomatic
[in] Otomatik düğmenin varsayılan rengini belirten RGB değeri.

bEnable
[in] Otomatik düğmenin etkin mi yoksa devre dışı mı olduğunu belirtir.

Açıklamalar

CMFCColorButton::EnableOtherButton

Normal renk düğmelerinin altında görünen "diğer" düğmesini etkinleştirin veya devre dışı bırakın.

void EnableOtherButton(
    LPCTSTR lpszLabel,
    BOOL bAltColorDlg=TRUE,
    BOOL bEnable=TRUE);

Parametreler

lpszLabel
[in] Düğmenin metnini belirtir.

bAltColorDlg
[in] Kullanıcı düğmeye tıkladığında CMFCColorDialog iletişim kutusunun veya sistem rengi iletişim kutusunun açılıp açılmayacağını belirtir.

bEnable
[in] "Diğer" düğmesinin etkin mi yoksa devre dışı mı olduğunu belirtir.

Açıklamalar

Renk iletişim kutusunu görüntülemek için "diğer" düğmesine tıklayın. bAltColorDlg parametresi TRUE ise, CMFCColorDialog Sınıfı görüntülenir; aksi takdirde sistem rengi iletişim kutusu görüntülenir.

CMFCColorButton::GetAutomaticColor

Geçerli otomatik (varsayılan) rengi alır.

COLORREF GetAutomaticColor() const;

Dönüş Değeri

Geçerli otomatik rengi temsil eden bir RGB değeri.

Açıklamalar

Geçerli otomatik renk CMFCColorButton::EnableAutomaticButton yöntemi tarafından ayarlanır.

CMFCColorButton::GetColor

Seçili olan rengi alır.

COLORREF GetColor() const;

Dönüş Değeri

RGB değeri.

Açıklamalar

CMFCColorButton::IsDrawXPTheme

Geçerli renk düğmesinin Windows XP'nin görsel stilinde görüntülenip görüntülenmeyeceğini gösterir.

BOOL IsDrawXPTheme() const;

Dönüş Değeri

Görsel stiller destekleniyorsa ve geçerli renk düğmesi Windows XP'nin görsel stilinde görüntüleniyorsa TRUE; aksi takdirde YANLIŞ.

CMFCColorButton::m_bEnabledInCustomizeMode

Özelleştirme moduna bir renk düğmesi ayarlar.

BOOL m_bEnabledInCustomizeMode;

Açıklamalar

Özelleştirme iletişim kutusunun sayfasına renk düğmesi eklemeniz gerekiyorsa (veya özelleştirme sırasında kullanıcının başka bir renk seçimi yapmasına izin vermeniz gerekiyorsa), üyeyi TRUE olarak ayarlayarak düğmeyi m_bEnabledInCustomizeMode etkinleştirin. Varsayılan olarak, bu üye YANLIŞ olarak ayarlanır.

CMFCColorButton::OnDraw

Düğmenin görüntüsünü işlemek için çerçeve tarafından çağrılır.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    UINT uiState);

Parametreler

pDC
[in] Düğmenin görüntüsünü işlemek için kullanılan cihaz bağlamını gösterir.

Rect
[in] Düğmeyi sınırlayan dikdörtgen.

uiState
[in] Düğmenin görsel durumunu belirtir.

Açıklamalar

İşleme işlemini özelleştirmek için bu yöntemi geçersiz kılın.

CMFCColorButton::OnDrawBorder

Düğmenin kenarını görüntülemek için çerçeve tarafından çağrılır.

virtual void OnDrawBorder(
    CDC* pDC,
    CRect& rectClient,
    UINT uiState);

Parametreler

pDC
[in] Kenarlık çizmek için kullanılan cihaz bağlamını gösterir.

rectClient
[in] Çekilecek düğmenin sınırlarını tanımlayan pDC parametresi tarafından belirtilen cihaz bağlamında bir dikdörtgen.

uiState
[in] Düğmenin görsel durumunu belirtir.

Açıklamalar

Renk düğmesinin kenarlık görünümünü özelleştirmek için bu işlevi geçersiz kılın.

CMFCColorButton::OnDrawFocusRect

Düğmenin odağı olduğunda odak dikdörtgenini görüntülemek için çerçeve tarafından çağrılır.

virtual void OnDrawFocusRect(
    CDC* pDC,
    const CRect& rectClient);

Parametreler

pDC
[in] Odak dikdörtgenini çizmek için kullanılan cihaz bağlamını gösterir.

rectClient
[in] Düğmenin sınırlarını tanımlayan pDC parametresi tarafından belirtilen cihaz bağlamında bir dikdörtgen.

Açıklamalar

Odak dikdörtgeninin görünümünü özelleştirmek için bu yöntemi geçersiz kılın.

CMFCColorButton::OnShowColorPopup

Açılan renk çubuğu görüntülenmeden önce çağrılır.

virtual void OnShowColorPopup();

Açıklamalar

CMFCColorButton::RebuildPalette

Korumalı veri üyesini m_pPalette belirtilen palete veya varsayılan sistem paletine başlatır.

void RebuildPalette(CPalette* pPal);

Parametreler

pPal
[in] Mantıksal palet veya NULL işaretçisi. NULL ise, varsayılan sistem paleti kullanılır.

CMFCColorButton::SetColor

Düğmenin rengini belirtir.

void SetColor(COLORREF color);

Parametreler

Renk
[in] RGB değeri.

Açıklamalar

CMFCColorButton::SetColorName

Rengin adını belirtir.

static void SetColorName(
    COLORREF color,
    const CString& strName);

Parametreler

Renk
[in] Rengin RGB değeri.

strName
[in] Rengin adı.

Açıklamalar

Renk adları listesi uygulama başına geneldir. Sonuç olarak, bu yöntem parametrelerini CMFCColorBar::SetColorName'e aktarır.

CMFCColorButton::SetColumnsNumber

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ı tanımlar.

void SetColumnsNumber(int nColumns);

Parametreler

nSütunlar
[in] Sütun sayısını belirtir.

Açıklamalar

Kullanıcı, önceden tanımlanmış renklerden oluşan bir tablo görüntüleyen bir açılır renk çubuğundan bir renk seçebilir. Tablodaki sütun sayısını tanımlamak için bu yöntemi kullanın.

CMFCColorButton::SetDocumentColors

Bir renk kümesini ve kümenin adını belirtir. Renk kümesi bir CMFCColorBar Sınıf nesnesi kullanılarak görüntülenir.

void SetDocumentColors(
    LPCTSTR lpszLabel,
    CList<COLORREF,COLORREF>& lstColors);

Parametreler

lpszLabel
[in] Belge renkleri kümesiyle görüntülenecek etiketi belirtir.

lstColors
[in] RGB değerleri listesine başvuru.

Açıklamalar

Bir CMFCColorButton nesne, CMFCColorBar Sınıf nesnesine aktarılan RGB değerlerinin listesini tutar. Renk çubuğu görüntülendiğinde, bu renkler etiketi lpszLabel parametresiyle belirtilen özel bir bölümde gösterilir.

CMFCColorButton::SetPalette

Açılan renk çubuğunda görüntülenecek standart renkleri belirtir.

void SetPalette(CPalette* pPalette);

Parametreler

pPalette
[in] Renk paleti işaretçisi.

Açıklamalar

CMFCColorButton::SizeToContent

Düğme denetimini metnine ve resmine sığacak şekilde yeniden boyutlandırıyor.

virtual CSize SizeToContent(BOOL bCalcOnly=FALSE);

Parametreler

bCalcOnly
[in] Sıfır değilse, düğme denetiminin yeni boyutu hesaplanır, ancak gerçek boyut değiştirilmez.

Dönüş Değeri

CSize Yeni düğme denetimi boyutunu belirten bir nesne.

Açıklamalar

CMFCColorButton::UpdateColor

Kullanıcı renk düğmesine tıkladığında görüntülenen renk çubuğundan bir renk seçtiğinde çerçeve tarafından çağrılır.

virtual void UpdateColor(COLORREF color);

Parametreler

Renk
[in] Kullanıcı tarafından seçilen bir renk.

Açıklamalar

İşlev, UpdateColor seçili durumdaki düğmenin rengini değiştirir ve BN_CLICKED standart bildirim içeren bir WM_COMMAND iletisi göndererek üst öğeye bildirimde bulunur. Seçilen rengi almak için CMFCColorButton::GetColor yöntemini kullanın.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CMFCButton Sınıfı
CMFCColorBar Sınıfı
CMFCColorButton::OnShowColorPopup
COLORREF
CPalette Sınıfı
CArray Sınıfı
CList Sınıfı
CString