CMFCColorBar Sınıfı

sınıfı, CMFCColorBar belgedeki veya uygulamadaki renkleri seçebilen bir yerleştirme denetim çubuğunu temsil eder.

Sözdizimi

class CMFCColorBar : public CMFCPopupMenuBar

Üyeler

Korumalı Oluşturucular

Veri Akışı Adı	Açıklama
CMFCColorBar::CMFCColorBar	Bir CMFCColorBar nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CMFCColorBar::ContextToSize	Renk çubuğu denetimindeki düğmeleri içermesi için gereken dikey ve yatay kenar boşluklarını hesaplar ve ardından bu düğmelerin konumunu ayarlar.
CMFCColorBar::CreateControl	Bir renk çubuğu denetim penceresi oluşturur, nesneye CMFCColorBar ekler ve denetimi belirtilen renk paletini içerecek şekilde yeniden boyutlandırır.
CMFCColorBar::Create	Bir renk çubuğu denetim penceresi oluşturur ve bunu nesneye CMFCColorBar ekler.
CMFCColorBar::EnableAutomaticButton	Otomatik düğmeyi gösterir veya gizler.
CMFCColorBar::EnableOtherButton	Kullanıcının daha fazla renk seçmesine olanak tanıyan bir iletişim kutusunun görüntülenmesini etkinleştirir veya devre dışı bırakır.
CMFCColorBar::GetColor	Seçili olan rengi alır.
CMFCColorBar::GetCommandID	Geçerli renk çubuğu denetiminin komut kimliğini alır.
CMFCColorBar::GetHighlightedColor	Bir renk düğmesinin odağı olduğunu belirten rengi alır; yani düğme sıcaktır.
CMFCColorBar::GetHorzMargin	Sol veya sağ renk hücresi ile istemci alanı sınırı arasındaki boşluk olan yatay kenar boşluğunu alır.
CMFCColorBar::GetVertMargin	Üst veya alt renk hücresi ile istemci alanı sınırı arasındaki boşluk olan dikey kenar boşluğunu alır.
CMFCColorBar::IsTearOff	Geçerli renk çubuğunun sabitlenebilir olup olmadığını gösterir.
CMFCColorBar::SetColor	Seçili olan rengi ayarlar.
CMFCColorBar::SetColorName	Belirtilen renk için yeni bir ad ayarlar.
CMFCColorBar::SetCommandID	Renk çubuğu denetimi için yeni bir komut kimliği ayarlar.
CMFCColorBar::SetDocumentColors	Geçerli belgede kullanılan renklerin listesini ayarlar.
CMFCColorBar::SetHorzMargin	Sol veya sağ renk hücresi ile istemci alanı sınırı arasındaki boşluk olan yatay kenar boşluğunu ayarlar.
CMFCColorBar::SetVertMargin	Üst veya alt renk hücresi ile istemci alanı sınırı arasındaki boşluk olan dikey kenar boşluğunu ayarlar.

Korumalı Yöntemler

Veri Akışı Adı	Açıklama
CMFCColorBar::AdjustLocations	Renk çubuğu denetimindeki renk düğmelerinin konumlarını ayarlar.
CMFCColorBar::AllowChangeTextLabels	Renk düğmelerinin metin etiketinin değişip değişemeyeceğini gösterir.
CMFCColorBar::AllowShowOnList	Özelleştirme işlemi sırasında renk çubuğu denetim nesnesinin araç çubuğu listesinde görünip görünemeyeceğini gösterir.
CMFCColorBar::CalcSize	Düzen hesaplama işleminin bir parçası olarak çerçeve tarafından çağrılır.
CMFCColorBar::CreatePalette	Belirtilen renk dizisindeki renklerle bir palet başlatır.
CMFCColorBar::GetColorGridSize	Renk çubuğu denetiminin kılavuzundaki satır ve sütun sayısını hesaplar.
CMFCColorBar::GetExtraHeight	Geçerli renk çubuğunun Diğer düğmesi, belge renkleri vb. gibi çeşitli kullanıcı arabirimi öğelerini görüntülemek için gereken ek yüksekliği hesaplar.
CMFCColorBar::InitColors	Belirtilen paletteki veya sistem varsayılan paletindeki renklerle bir renk dizisi başlatır.
CMFCColorBar::OnKey	Kullanıcı bir klavye düğmesine bastığında çerçeve tarafından çağrılır.
CMFCColorBar::OnSendCommand	Açılan denetim hiyerarşisini kapatmak için çerçeve tarafından çağrılır.
CMFCColorBar::OnUpdateCmdUI	Öğe görüntülenmeden önce renk çubuğu denetiminin kullanıcı arabirimi öğesini etkinleştirmek veya devre dışı bırakmak için çerçeve tarafından çağrılır.
CMFCColorBar::OpenColorDialog	Bir renk iletişim kutusu açar.
CMFCColorBar::Rebuild	Renk çubuğu denetimini tamamen yeniden çizer.
CMFCColorBar::SelectPalette	Belirtilen cihaz bağlamının mantıksal paletini geçerli renk çubuğu denetiminin üst düğmesinin paletine ayarlar.
CMFCColorBar::SetPropList	Korunan veri üyesini m_pWndPropList belirtilen işaretçiye bir özellik kılavuzu denetimine ayarlar.
CMFCColorBar::ShowCommandMessageString	Durum çubuğundaki ileti satırını güncelleştirmek için renk çubuğu denetiminin sahibi olan çerçeve penceresini istemektedir.

Korumalı Veri Üyeleri

Veri Akışı Adı	Açıklama
m_bInternal	Fare olaylarının işlenip işlenmeyeceğini belirleyen boole alanı. Fare olayları genellikle bu alan DOĞRU ve özelleştirme modu YANLIŞ olduğunda işlenir.
m_bIsEnabled	Denetimin etkinleştirilip etkinleştirilmediğini gösteren Boole değeri.
m_bIsTearOff	Renk çubuğu denetiminin yerleştirmeyi destekleyip desteklemediğini gösteren Boole değeri.
m_BoxSize	Bir renk çubuğu kılavuzundaki hücrenin boyutunu belirten bir CSize nesnesi.
m_bShowDocColorsWhenDocked	Renk çubuğu yerleştirildiğinde belge renklerinin gösterilip gösterilmeyeceğini gösteren Boole değeri. Daha fazla bilgi için bkz . CMFCColorBar::SetDocumentColors.
m_bStdColorDlg	Standart sistem rengi iletişim kutusunun mı yoksa CMFCColorDialog iletişim kutusunun mu gösterilip gösterilmeyeceğini gösteren Boole değeri. Daha fazla bilgi için bkz . CMFCColorBar::EnableOtherButton.
m_ColorAutomatic	Geçerli otomatik rengi depolayan COLORREF. Daha fazla bilgi için bkz . CMFCColorBar::EnableOtherButton.
m_ColorNames	Bir rgb renk kümesini adlarıyla ilişkilendiren bir CMap nesnesi.
m_colors	Renk çubuğu denetiminde görüntülenen renkleri içeren COLORREF değerlerinin CArray değeri.
m_ColorSelected	Kullanıcının renk çubuğu denetiminden o anda seçtiği renk olan COLORREF değeri.
m_lstDocColors	Bir belgede kullanılmakta olan renkleri içeren COLORREF değerlerinin CList'i.
m_nCommandID	Renk düğmesinin komut kimliği olan işaretsiz tamsayı.
m_nHorzMargin	Bir renk kılavuzundaki renk düğmeleri arasındaki yatay kenar boşluğu olan tamsayı.
m_nHorzOffset	Renk düğmesinin ortasına yatay uzaklık olan bir tamsayı. Düğmede renge ek olarak metin veya resim görüntüleniyorsa bu değer önemlidir.
m_nNumColumns	Renk çubuğu denetim kılavuzundaki renklerden oluşan sütun sayısı olan tamsayı.
m_nNumColumnsVert	Dikey olarak yönlendirilmiş bir renk kılavuzundaki sütun sayısı olan tamsayı.
m_nNumRowsHorz	Yatay olarak yönlendirilmiş bir renk kılavuzundaki sütun sayısı olan tamsayı.
m_nRowHeight	Bir renk kılavuzundaki renk düğmeleri satırının yüksekliği olan tamsayı.
m_nVertMargin	Bir renk kılavuzundaki renk düğmeleri arasındaki dikey kenar boşluğu olan tamsayı.
m_nVertOffset	Renk düğmesinin ortasına dikey uzaklık olan bir tamsayı. Düğmede renge ek olarak metin veya resim görüntüleniyorsa bu değer önemlidir.
m_Palette	Renk çubuğu denetiminde kullanılan renklerin CPalette değeri.
m_pParentBtn	Geçerli düğmenin üst öğesi olan CMFCColorButton nesnesinin işaretçisi. Renk düğmesi bir araç çubuğu denetimleri hiyerarşisindeyse veya renk özelliği kılavuz denetimindeyse bu değer önemlidir.
m_pParentRibbonBtn	Şeritte bulunan ve geçerli düğmenin üst düğmesi olan CMFCRibbonColorButton nesnesinin işaretçisi. Renk düğmesi bir araç çubuğu denetimleri hiyerarşisindeyse veya renk özelliği kılavuz denetimindeyse bu değer önemlidir.
m_pWndPropList	CMFCPropertyGridCtrl nesnesinin işaretçisi.
m_strAutoColor	Otomatik düğmesinde görüntülenen metin olan bir CString. Daha fazla bilgi için bkz . CMFCColorBar::EnableAutomaticButton.
m_strDocColors	Belge renkleri düğmesinde görüntülenen metin olan bir CString. Daha fazla bilgi için bkz . CMFCColorBar::SetDocumentColors.
m_strOtherColor	Diğer düğmede görüntülenen metin olan bir CString. Daha fazla bilgi için bkz . CMFCColorBar::EnableOtherButton.

Açıklamalar

Genellikle, doğrudan bir CMFCColorBar nesne oluşturmazsınız. Bunun yerine, CMFCColorMenuButton Sınıfı (menülerde ve araç çubuklarında kullanılır) veya CMFCColorButton Sınıfı nesneyi oluşturur CMFCColorBar .

CMFCColorBar sınıfı aşağıdaki işlevleri sağlar:

• Belge renkleri listesini otomatik olarak ayarlar.

• Belge durumuyla birlikte durumunu kaydeder ve geri yükler.

• "Otomatik" düğmesini yönetir.

• Özel bir renk seçmek için CMFCColorPickerCtrl Sınıfı denetimini kullanır.

• "Yırtılma" durumunu destekler (CMFCColorMenuButton Sınıfı kullanılarak oluşturulduysa).

İşlevselliği uygulamanıza dahil CMFCColorBar etmek için:

1. Normal bir menü düğmesi oluşturun ve buna ID_CHAR_COLOR gibi bir kimlik atayın.

2. Çerçeve penceresi sınıfınızda CFrameWndEx::OnShowPopupMenu yöntemini geçersiz kılın ve normal menü düğmesini CMFCColorMenuButton Sınıf nesnesiyle değiştirin (CMFCToolBar::ReplaceButton çağrısı yaparak).

3. Tüm stilleri ayarlayın ve CMFCColorMenuButton Sınıfı oluşturma sırasında nesnenin CMFCColorBar özelliklerini etkinleştirin veya devre dışı bırakın. nesnesi, CMFCColorMenuButton çerçeve yöntemini çağırdıktan CreatePopupMenu sonra nesneyi dinamik olarak oluştururCMFCColorBar.

Kullanıcı bir renk çubuğu denetimi düğmesine tıkladığında çerçeve, renk çubuğu denetiminin üst öğesini bilgilendirmek için makroyu kullanır ON_COMMAND . Makroda komut kimliği parametresi, 1. adımda renk çubuğu denetim düğmesine atadığınız değerdir (bu örnekte ID_CHAR_COLOR). Daha fazla bilgi için bkz . CMFCColorMenuButton Sınıfı, CMFCColorButton Sınıfı, CMFCColorPickerCtrl Sınıfı, CFrameWndEx Sınıfı ve CMFCToolBar Sınıfı sınıfları.

Örnek

Aşağıdaki örnekte, sınıftaki çeşitli yöntemleri kullanarak bir renk çubuğunun nasıl yapılandırılır gösterilmektedir CMFCColorBar . Yöntemler yatay ve dikey kenar boşluklarını ayarlar, diğer düğmeyi etkinleştirir, bir renk çubuğu denetim penceresi oluşturur ve seçili durumdaki rengi ayarlar. Bu örnek, Yeni Denetimler örneğinin bir parçasıdır.

CMFCColorBar m_wndColorBar;

// set the margins
m_wndColorBar.SetHorzMargin(0);
m_wndColorBar.SetVertMargin(0);
// enable the display of a dialog box that
// lets the user select more colors
m_wndColorBar.EnableOtherButton(_T("Other..."));
// create a color bar control window
m_wndColorBar.CreateControl(this, rectColorBar, IDC_COLORBAR, 5 /* columns */);
// set the currently selected color
m_wndColorBar.SetColor(RGB(255, 0, 0));

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCPopupMenuBar

CMFCColorBar

Gereksinimler

Üst bilgi: afxcolorbar.h

CMFCColorBar::AdjustLocations

Renk çubuğu denetimindeki renk düğmelerinin konumlarını ayarlar.

virtual void AdjustLocations();

Açıklamalar

Bu yöntem, WM_SIZE ileti işleme sırasında çerçeve tarafından çağrılır.

CMFCColorBar::AllowChangeTextLabels

Renk düğmelerinin metin etiketinin değişip değişemeyeceğini gösterir.

virtual BOOL AllowChangeTextLabels() const;

Dönüş Değeri

Her zaman YANLIŞ.

Açıklamalar

Varsayılan olarak, bu yöntem her zaman YANLIŞ döndürür; bu da metin etiketlerinin değiştirilemeyeceği anlamına gelir. Metin etiketlerini değiştirmeyi etkinleştirmek için bu yöntemi geçersiz kılın.

CMFCColorBar::AllowShowOnList

Özelleştirme işlemi sırasında renk çubuğu denetim nesnesinin araç çubuğu listesinde görünip görünemeyeceğini gösterir.

virtual BOOL AllowShowOnList() const;

Dönüş Değeri

Her zaman DOĞRU.

Açıklamalar

Varsayılan olarak, bu yöntem her zaman TRUE döndürür. Bu, çerçevenin özelleştirme işlemi sırasında renk çubuğu denetimini görüntüleyebileceği anlamına gelir. Farklı bir davranış uygulamak için bu yöntemi geçersiz kılın.

CMFCColorBar::CalcSize

Düzen hesaplama işleminin bir parçası olarak çerçeve tarafından çağrılır.

virtual CSize CalcSize(BOOL bVertDock);

Parametreler

bVertDock
[in] Renk çubuğu denetiminin dikey olarak yerleştirildiğini belirtmek için DOĞRU; YANLIŞ, renk çubuğu denetiminin yatay olarak yerleştirildiğini belirtmek için.

Dönüş Değeri

Bir renk çubuğu denetimindeki renk düğmeleri dizisinin boyutu.

CMFCColorBar::CMFCColorBar

Bir CMFCColorBar nesne oluşturur.

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    int nRowsDockHorz,
    int nColDockVert,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCColorButton* pParentBtn);

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCRibbonColorButton* pParentRibbonBtn);

CMFCColorBar(
    CMFCColorBar& src,
    UINT uiCommandID);

Parametreler

Renk
[in] Çerçevenin renk çubuğu denetiminde görüntülediği bir renk dizisi.

Renk
[in] başlangıçta seçilen renk.

lpszAutoColor
[in] Otomatik (varsayılan) renk düğmesinin metin etiketi veya NULL.

Otomatik düğmenin standart etiketi Otomatik'tir.

lpszOtherColor
[in] Diğer düğmenin daha fazla renk seçeneği veya NULL görüntüleyen metin etiketi.

Diğer düğmenin standart etiketi Diğer Renkler....

lpszDocColors
[in] Belge renkleri düğmesinin metin etiketi. Belge renkleri paleti, belgenin o anda kullandığı tüm renkleri listeler.

lstDocColors
[in] Belgenin şu anda kullandığı renklerin listesi.

nSütunlar
[in] Renk dizisinin sahip olduğu sütun sayısı.

nRowsDockHorz
[in] Yatay olarak yerleştirildiğinde renk çubuğunun sahip olduğu satır sayısı.

nColDockVert
[in] Dikey olarak yerleştirildiğinde renk çubuğunun sahip olduğu sütun sayısı.

colorAutomatic
[in] Otomatik düğmeye tıkladığınızda çerçevenin geçerli olduğu varsayılan renk.

nCommandID
[in] Renk çubuğu denetimi komut kimliği.

pParentBtn
[in] Üst düğme işaretçisi.

Src
[in] Yeni CMFCColorBar nesneye kopyalanacak mevcut CMFCColorBar bir nesne.

uiCommandID
[in] Komut kimliği.

CMFCColorBar::ContextToSize

Renk çubuğu denetimindeki düğmeleri içermesi için gereken dikey ve yatay kenar boşluklarını hesaplar ve bu düğmelerin konumunu ayarlar.

void ContextToSize(
    BOOL bSquareButtons = TRUE,
    BOOL bCenterButtons = TRUE);

Parametreler

bSquareButtons
[in] Bir renk çubuğu denetimindeki düğmelerin şeklinin kare olduğunu belirtmek için DOĞRU; aksi takdirde YANLIŞ. Varsayılan değer DOĞRU'dur.

bCenterButtons
[in] Bir renk çubuğu denetim düğmesinin yüzündeki içeriğin ortalandığını belirtmek için DOĞRU; aksi takdirde YANLIŞ. Varsayılan değer DOĞRU'dur.

Açıklamalar

CMFCColorBar::Create

Bir renk çubuğu denetim penceresi oluşturur ve bunu nesneye CMFCColorBar ekler.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle,
    UINT nID,
    CPalette* pPalette=NULL,
    int nColumns=0,
    int nRowsDockHorz=0,
    int nColDockVert=0);

Parametreler

pParentWnd
[in] Üst pencere işaretçisi.

dwStyle
[in] Pencere stillerinin bit düzeyinde birleşimi (VEYA).

Nıd
[in] Komut kimliği.

pPalette
[in] Renk paletinin işaretçisi. Varsayılan değer NULL'tır.

nSütunlar
[in] Renk çubuğu denetimindeki sütun sayısı. Varsayılan değer 0’dır.

nRowsDockHorz
[in] Yatay olarak yerleştirildiğinde renk çubuğu denetimindeki satır sayısı. Varsayılan değer 0’dır.

nColDockVert
[in] Dikey olarak yerleştirildiğinde renk çubuğu denetimindeki sütun sayısı. Varsayılan değer 0’dır.

Dönüş Değeri

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

Açıklamalar

Bir CMFCColorBar nesne oluşturmak için sınıf oluşturucusunun ardından bu yöntemi çağırın. yöntemi, Create Windows denetimini oluşturur ve bir renk listesi başlatır.

CMFCColorBar::CreateControl

Bir renk çubuğu denetim penceresi oluşturur, nesneye CMFCColorBar ekler ve denetim penceresini belirtilen renk paletini içerecek şekilde yeniden boyutlandırır.

virtual BOOL CreateControl(
    CWnd* pParentWnd,
    const CRect& rect,
    UINT nID,
    int nColumns=-1,
    CPalette* pPalette=NULL);

Parametreler

pParentWnd
[in] Üst pencere işaretçisi. NULL olamaz.

Rect
[in] Renk çubuğu denetiminin nereye çizildiğini belirten sınırlayıcı dikdörtgen.

Nıd
[in] Denetim kimliği.

nSütunlar
[in] Renk çubuğu denetimindeki ideal sütun sayısı. Bu yöntem, bu sayıyı belirtilen renk paletine uyacak şekilde değiştirir. Varsayılan değer -1'dir ve bu da bu parametrenin belirtilmediği anlamına gelir.

pPalette
[in] Renk paletinin işaretçisi veya NULL. Bu parametre NULL ise, bu yöntem renk çubuğu denetiminin boyutunu 20 renk belirtilmiş gibi hesaplar. Varsayılan değer NULL'tır.

Dönüş Değeri

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

Açıklamalar

Bu yöntem, renk çubuğu denetimindeki uygun sayı veya satırları ve sütunları hesaplamak için rect, nColumns ve pPalette parametrelerini kullanır ve ardından CMFCColorBar::Create yöntemini çağırır.

CMFCColorBar::CreatePalette

Belirtilen renk dizisindeki renklerle bir palet başlatır.

static BOOL CreatePalette(
    const CArray<COLORREF, COLORREF>& arColors,
    CPalette& palette);

Parametreler

arColors
[in] Bir renk dizisi.

Palet
[in] Renk paleti.

Dönüş Değeri

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

CMFCColorBar::EnableAutomaticButton

Otomatik düğmeyi gösterir veya gizler.

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

Parametreler

lpszLabel
[in] Otomatik (varsayılan) renk düğmesinin metin etiketi veya NULL.

Otomatik düğmenin standart etiketi Otomatik'tir.

colorAutomatic
[in] Otomatik düğmeye tıkladığınızda çerçevenin geçerli olduğu varsayılan renk.

bEnable
[in] Otomatik düğmeyi etkinleştirmek için TRUE; Otomatik düğmeyi devre dışı bırakmak için YANLIŞ. Varsayılan değer DOĞRU'dur.

Açıklamalar

lpszLabel parametresi NULL veya bEnable parametresi YANLIŞ ise otomatik düğmenin metin etiketi silinir.

CMFCColorBar::EnableOtherButton

Kullanıcının daha fazla renk seçmesine olanak tanıyan bir iletişim kutusunun görüntülenmesini etkinleştirir veya devre dışı bırakır.

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

Parametreler

lpszLabel
[in] Diğer düğmenin daha fazla renk seçeneği veya NULL görüntüleyen metin etiketi.

Bu düğmenin standart etiketi Diğer Renkler....

bAltColorDlg
[in] CMFCColorDialog iletişim kutusunu görüntülemek için DOĞRU; STANDART CColorDialog iletişim kutusunu görüntülemek için YANLIŞ. Varsayılan değer DOĞRU'dur.

bEnable
[in] Düğmeyi etkinleştirmek için TRUE; Düğmeyi devre dışı bırakmak için YANLIŞ'ı seçin. Varsayılan değer DOĞRU'dur.

CMFCColorBar::GetColor

Seçili olan rengi alır.

COLORREF GetColor() const;

Dönüş Değeri

Seçili durumdaki renk.

CMFCColorBar::GetColorGridSize

Renk çubuğu denetiminin kılavuzundaki satır ve sütun sayısını hesaplar.

CSize GetColorGridSize(BOOL bVertDock) const;

Parametreler

bVertDock
[in] Dikey olarak yerleştirilmiş bir renk çubuğu denetimi için hesaplamayı gerçekleştirmek için DOĞRU; aksi takdirde, yatay olarak yerleştirilmiş bir denetim için hesaplamayı gerçekleştirin.

Dönüş Değeri

Bileşeni sütun sayısını ve cy bileşeni satır sayısını içeren bir CSize nesnesicx.

CMFCColorBar::GetCommandID

Geçerli renk çubuğu denetiminin komut kimliğini alır.

UINT GetCommandID() const;

Dönüş Değeri

Bir komut kimliği.

Açıklamalar

Kullanıcı yeni bir renk seçtiğinde, çerçeve nesnenin üst öğesini bilgilendirmek için komut kimliğini bir WM_COMMAND iletisinde CMFCColorBar gönderir.

CMFCColorBar::GetExtraHeight

Geçerli renk çubuğunun Diğer düğmesi veya belge renkleri gibi çeşitli kullanıcı arabirimi öğelerini görüntülemek için gereken ek yüksekliği hesaplar.

int GetExtraHeight(int nNumColumns) const;

Parametreler

nNumColumns
[in] Renk çubuğu denetimi belge renkleri içeriyorsa, belge renkleri kılavuzunda görüntülenecek sütun sayısı. Aksi takdirde, bu değer kullanılmaz.

Dönüş Değeri

Gereken hesaplanan ek yükseklik.

CMFCColorBar::GetHighlightedColor

Bir renk düğmesinin odağı olduğunu belirten rengi alır; yani düğme sıcaktır.

COLORREF GetHighlightedColor() const;

Dönüş Değeri

RGB değeri.

Açıklamalar

CMFCColorBar::GetHorzMargin

Sol veya sağ renk hücresi ile istemci alanı sınırı arasındaki boşluk olan yatay kenar boşluğunu alır.

int GetHorzMargin();

Dönüş Değeri

Yatay kenar boşluğu.

CMFCColorBar::GetVertMargin

Üst veya alt renk hücresi ile istemci alanı sınırı arasındaki boşluk olan dikey kenar boşluğunu alır.

int GetVertMargin() const;

Dönüş Değeri

Dikey kenar boşluğu.

CMFCColorBar::InitColors

Belirtilen paletteki renklerle veya sistem varsayılan paletiyle bir renk dizisi başlatır.

static int InitColors(
    CPalette* pPalette,
    CArray<COLORREF, COLORREF>& arColors);

Parametreler

pPalette
[in] Palet nesnesinin işaretçisi veya NULL. Bu parametre NULL ise, bu yöntem işletim sisteminin varsayılan paletini kullanır.

arColors
[in] Bir renk dizisi.

Dönüş Değeri

Renk dizisindeki öğelerin sayısı.

CMFCColorBar::IsTearOff

Geçerli renk çubuğunun sabitlenebilir olup olmadığını gösterir.

BOOL IsTearOff() const;

Dönüş Değeri

Geçerli renk çubuğu denetimi sabitlenebilirse TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Renk çubuğu denetimi sabitlenebilirse, bir denetim çubuğundan yırtılabilir ve başka bir konuma yerleştirilebilir.

CMFCColorBar::OnKey

Kullanıcı bir klavye düğmesine bastığında çerçeve tarafından çağrılır.

virtual BOOL OnKey(UINT nChar);

Parametreler

nChar
[in] Kullanıcının bastığı anahtarın sanal anahtar kodu.

Dönüş Değeri

Bu yöntem belirtilen anahtarı işlerse TRUE; aksi takdirde YANLIŞ.

CMFCColorBar::OnSendCommand

Açılır denetim hiyerarşisini kapatmak için çerçeve tarafından çağrılır.

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parametreler

pButton
[in] Araç çubuğunda bulunan denetimin işaretçisi.

Dönüş Değeri

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

CMFCColorBar::OnUpdateCmdUI

Öğe görüntülenmeden önce renk çubuğu denetiminin kullanıcı arabirimi öğesini etkinleştirmek veya devre dışı bırakmak için çerçeve tarafından çağrılır.

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Parametreler

pTarget
[in] Güncelleştirilecek kullanıcı arabirimi öğesini içeren bir pencerenin 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

Uygulamanızın kullanıcısı bir kullanıcı arabirimi öğesine tıkladığında, öğenin etkin olarak mı yoksa devre dışı olarak mı görüntüleneceğini bilmesi gerekir. Komut iletisinin hedefi, bir ON_UPDATE_COMMAND_UI komut işleyicisi uygulayarak bu bilgileri sağlar. Komutu işlemeye yardımcı olması için bu yöntemi kullanın. Daha fazla bilgi için bkz . CCmdUI Sınıfı.

CMFCColorBar::OpenColorDialog

Bir renk iletişim kutusu açar.

virtual BOOL OpenColorDialog(
    const COLORREF colorDefault,
    COLORREF& colorRes);

Parametreler

colorDefault
[in] Renk iletişim kutusu açıldığında varsayılan olarak seçilen renk.

colorRes
[out] Kullanıcının seçtiği renk.

Dönüş Değeri

Kullanıcı bir renk seçtiyse DOĞRU; Kullanıcı renk iletişim kutusunu iptal ettiyse YANLIŞ.

Açıklamalar

CMFCColorBar::Rebuild

Renk çubuğu denetimini tamamen yeniden çizer.

virtual void Rebuild();

CMFCColorBar::SelectPalette

Belirtilen cihaz bağlamının mantıksal paletini geçerli renk çubuğu denetiminin üst düğmesinin paletine ayarlar.

CPalette* SelectPalette(CDC* pDC);

Parametreler

pDC
[in] Geçerli renk çubuğu denetiminin üst düğmesinin cihaz bağlamı işaretçisi.

Dönüş Değeri

Geçerli renk çubuğu denetiminin üst düğmesinin paleti ile değiştirilen paletin işaretçisi.

CMFCColorBar::SetColor

Seçili olan rengi ayarlar.

void SetColor(COLORREF color);

Parametreler

Renk
[in] RGB renk değeri.

CMFCColorBar::SetColorName

Belirtilen renk için yeni bir ad ayarlar.

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

Parametreler

Renk
[in] Bir rengin RGB değeri.

strName
[in] Belirtilen rengin yeni adı.

Açıklamalar

Bu yöntem, uygulamanızdaki tüm CMFCColorBar nesnelerde belirtilen rengin adını değiştirir.

CMFCColorBar::SetCommandID

Renk çubuğu denetimi için yeni bir komut kimliği ayarlar.

void SetCommandID(UINT nCommandID);

Parametreler

nCommandID
[in] Bir komut kimliği.

Açıklamalar

Bir renk çubuğu denetiminin komut kimliğini değiştirmek ve denetimin üst penceresine kimliğin değiştiğini bildirmek için bu yöntemi çağırın.

CMFCColorBar::SetDocumentColors

Geçerli belgede kullanılan renklerin listesini ayarlar.

void SetDocumentColors(
    LPCTSTR lpszCaption,
    CList<COLORREF,COLORREF>& lstDocColors,
    BOOL bShowWhenDocked=FALSE);

Parametreler

lpszCaption
[in] Renk çubuğu denetimi yerleştirilmediğinde görüntülenen resim yazısı.

lstDocColors
[in] Geçerli belge renklerinin yerini alan renklerin listesi.

bShowWhenDocked
[in] Renk çubuğu denetimi yerleştirildiğinde belge renklerini göstermek için DOĞRU; aksi takdirde YANLIŞ. Varsayılan değer YANLIŞ'tır.

Açıklamalar

Belge renkleri , şu anda belgede kullanılan renklerdir. Çerçeve otomatik olarak belge renklerinin listesini tutar, ancak listeyi değiştirmek için bu yöntemi kullanabilirsiniz.

CMFCColorBar::SetHorzMargin

Sol veya sağ renk hücresi ile istemci alanının sınırı arasındaki boşluk olan yatay kenar boşluğunu ayarlar.

void SetHorzMargin(int nHorzMargin);

Parametreler

nHorzMargin
[in] Yatay kenar boşluğu piksel cinsinden.

Açıklamalar

Varsayılan olarak, CMFCColorBar::CMFCColorBar oluşturucu yatay kenar boşluğunu 4 piksel olarak ayarlar.

CMFCColorBar::SetPropList

Korunan veri üyesini m_pWndPropList belirtilen işaretçiye bir özellik kılavuzu denetimine ayarlar.

void SetPropList(CMFCPropertyGridCtrl* pWndList);

Parametreler

pWndList
[in] Özellik kılavuzu denetim nesnesinin işaretçisi.

CMFCColorBar::SetVertMargin

Üst veya alt renk hücresi ile istemci alanı sınırı arasındaki boşluk olan dikey kenar boşluğunu ayarlar.

void SetVertMargin(int nVertMargin);

Parametreler

nVertMargin
[in] Piksel cinsinden dikey kenar boşluğu.

Açıklamalar

Varsayılan olarak, CMFCColorBar::CMFCColorBar oluşturucu dikey kenar boşluğunu 4 piksel olarak ayarlar.

CMFCColorBar::ShowCommandMessageString

Durum çubuğundaki ileti satırını güncelleştirmek için renk çubuğu denetiminin sahibi olan çerçeve penceresini istemektedir.

virtual void ShowCommandMessageString(UINT uiCmdId);

Parametreler

uiCmdId
[in] Bir komut kimliği. (Bu parametre yoksayılır.)

Açıklamalar

Bu yöntem, WM_SETMESSAGESTRING iletisini renk çubuğu denetiminin sahibine gönderir.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar