CMFCColorBar sınıfı

Makale
02/26/2013

CMFCColorBar Sınıfı, bir belge veya uygulama renkleri seçebilirsiniz takma bir denetim çubuğu temsil eder.

class CMFCColorBar : public CMFCPopupMenuBar

Üyeler

Korumalı oluşturucular

Ad	Description
CMFCColorBar::CMFCColorBar	Yapıları bir CMFCColorBar nesnesi.

Public yöntemler

Ad	Description
CMFCColorBar::ContextToSize	Renk çubuğu denetimi düğmeleri içermeleri gerekir ve bu düğmeleri konumunu ayarlar dikey ve yatay kenar hesaplar.
CMFCColorBar::CreateControl	Renk çubuğu denetimi penceresi oluşturur, ekleninceye CMFCColorBar nesnesini ve belirtilen renk paletini içeren denetimi yeniden boyutlandırır.
CMFCColorBar::Create	Renk çubuğu denetimi penceresi oluşturur ve ekler CMFCColorBar nesnesi.
CMFCColorBar::EnableAutomaticButton	Gösterir veya Otomatik düğmesini gizler.
CMFCColorBar::EnableOtherButton	Etkinleştirir veya daha fazla renk seçmesine olanak sağlayan bir iletişim kutusunun görüntülenmesini devre dışı bırakır.
CMFCColorBar::GetColor	Şu anda seçili olan rengi alır.
CMFCColorBar::GetCommandID	Geçerli renk çubuğu denetimi komut kimliği alır.
CMFCColorBar::GetHighlightedColor	Renk düğmesi odağa sahip olduğunu belirten renk alır; diğer bir deyişle düğmedir hot.
CMFCColorBar::GetHorzMargin	Soldaki veya sağdaki renk hücre ve istemci alanı sınırı arasındaki boşluğu yatay kenar alır.
CMFCColorBar::GetVertMargin	Üst veya alt renk hücre ve istemci alanı sınırı arasındaki boşluğu dikey kenar alır.
CMFCColorBar::IsTearOff	Geçerli renk çubuğunu yuvalanabilir olup olmadığını gösterir.
CMFCColorBar::SetColor	Şu anda seçili olan rengi ayarlar.
CMFCColorBar::SetColorName	Belirli bir renk için yeni bir ad belirler.
CMFCColorBar::SetCommandID	Renk çubuğu denetimi için yeni bir komut kimlik belirler.
CMFCColorBar::SetDocumentColors	Geçerli belgede kullanılan renklerin listesini ayarlar.
CMFCColorBar::SetHorzMargin	Soldaki veya sağdaki renk hücre ve istemci alanı sınırı arasındaki boşluğu ise yatay kenar boşluğunu ayarlar.
CMFCColorBar::SetVertMargin	Üst veya alt renk hücrelerini ve istemci alanı sınırı arasındaki boşluğu ise dikey kenar boşluğunu ayarlar.

Korumalı yöntemleri

Ad	Description
CMFCColorBar::AdjustLocations	Renk çubuğu denetimi renk düğmelerinin konumlarını ayarlar.
CMFCColorBar::AllowChangeTextLabels	Renk düğmeleri metin etiketi değiştirip değiştiremeyeceklerini belirtir.
CMFCColorBar::AllowShowOnList	Renk çubuğu denetim nesnesi özelleştirme işlemi sırasında araç çubuğu listesinde görüntülenip görüntülenmeyeceğini gösterir.
CMFCColorBar::CalcSize	Çerçeve Mizanpaj hesaplama işleminin bir parçası olarak tarafından çağrıldı.
CMFCColorBar::CreatePalette	Initalizes ile belirtilen bir dizi renk renkler paleti.
CMFCColorBar::GetColorGridSize	Satırlar ve sütunlar renk çubuğu denetim kılavuzunda sayısını hesaplar.
CMFCColorBar::GetExtraHeight	Geçerli renk çubuğu gibi çeşitli kullanıcı arabirimi öğeleri görüntülemek için gereken ek yüksekliği hesaplar diğer düğmesi, belge renklerini ve böyle devam eder.
CMFCColorBar::InitColors	Belirtilen paleti veya sistem varsayılan palet renklerini renklerle dizisini başlatır.
CMFCColorBar::OnKey	Kullanıcı klavye düğmesine bastığında çerçevesi tarafından çağrıldı.
CMFCColorBar::OnSendCommand	Açılan denetimleri hiyerarşisini kapatmak için çerçevesi tarafından çağrıldı.
CMFCColorBar::OnUpdateCmdUI	Öğe görüntülenmeden önce bir kullanıcı arabirimi öğesi renk çubuğu denetimi devre dışı bırakılır çerçevesi tarafından çağrıldı.
CMFCColorBar::OpenColorDialog	Renk iletişim kutusu açılır.
CMFCColorBar::Rebuild	Tam renk çubuğu denetimi yeniden çizer.
CMFCColorBar::SelectPalette	Belirtilen aygıt içeriği mantıksal paletini geçerli renk çubuğunu denetimin üst düğmesini paleti için ayarlar.
CMFCColorBar::SetPropList	Ayarlar m_pWndPropList belirtilen fare işaretçisini özelliği kılavuz denetimi için veri üyesi korumalı.
CMFCColorBar::ShowCommandMessageString	Durum çubuğundaki ileti satırı güncelleştirmek için renk çubuğu denetim sahibi olan çerçeve penceresi ister.

Korumalı veri üyeleri

Ad	Description
m_bInternal	Bir Boole alanı fare olayları işlenip işlenmediğini belirler.Bu alan genellikle fare olayları işlenen TRUE ve özelleştirme mod FALSE.
m_bIsEnabled	Bir denetimin etkin olup olmadığını gösteren bir Boole değeri.
m_bIsTearOff	Renk çubuğu denetimi yerleştirmeyi destekleyip desteklemediğini gösteren bir Boole değeri.
m_BoxSize	A CSize renk çubuğunu kılavuzunda bir hücre boyutunu belirtir nesnesi.
m_bShowDocColorsWhenDocked	Belge renklerini renk çubuğunu yerleştirildiğinde gösterilip gösterilmeyeceğini gösterir bir Boole değeri.Daha fazla bilgi için bkz. CMFCColorBar::SetDocumentColors.
m_bStdColorDlg	Standart sistem renk iletişim kutusu görüntülenip görüntülenmeyeceğini gösteren bir Boole değeri veya CMFCColorDialog iletişim kutusu.Daha fazla bilgi için bkz. CMFCColorBar::EnableOtherButton.
m_ColorAutomatic	A colorref , geçerli otomatik renk depolar.Daha fazla bilgi için bkz. CMFCColorBar::EnableOtherButton.
m_ColorNames	Bir CMap rgb kümesi ilişkilendirir nesnesi adlarını renkler.
m_colors	A CArray , colorref renk çubuğunu denetiminde görüntülenen renkleri içeren değer.
m_ColorSelected	A colorref değeri kullanıcı renk çubuğunu denetimden şu anda seçili rengi.
m_lstDocColors	A CList , colorref şu anda bir belge içinde kullanılan renkleri içeren değer.
m_nCommandID	Renk düğmesi komut kimliğidir imzalanmamış bir tamsayı.
m_nHorzMargin	Yatay kenar boşluğu kılavuzunun renk renk düğmeleri arasında bir tamsayı.
m_nHorzOffset	Yatay Uzaklık rengi düğmesinin ortasına bir tamsayı.Bu değer, metin veya görüntü renk yanı sıra düğme görüntülüyorsa, önemlidir.
m_nNumColumns	Renkleri bir renk çubuğu denetim kılavuzunda sütun sayısı bir tamsayı.
m_nNumColumnsVert	Renkler, dikey olarak yönlendirilmiş ızgaradaki sütunların sayısı bir tamsayı.
m_nNumRowsHorz	Renkler, yatay olarak yönlendirilmiş ızgaradaki sütunların sayısı bir tamsayı.
m_nRowHeight	Kılavuz renkleri renk düğmelerinin bir satırın yüksekliğini bir tamsayı.
m_nVertMargin	Dikey kenar boşluğu kılavuzunun renk renk düğmeleri arasında bir tamsayı.
m_nVertOffset	Renk düğmesi ortasına dikey uzaklık bir tamsayı.Bu değer, metin veya görüntü renk yanı sıra düğme görüntülüyorsa, önemlidir.
m_Palette	A CPalette renk çubuğunun denetiminde kullanılan renk.
m_pParentBtn	Bir işaretçi bir CMFCColorButton geçerli düğme üst nesne.Renk düğmesi araç çubuğu denetimleri hiyerarşisinde ya renk özelliği kılavuz denetiminde yoksa bu önemli bir değerdir.
m_pParentRibbonBtn	Bir işaretçi bir CMFCRibbonColorButton Şerit'te ve geçerli düğme üst düğmesi olan nesne.Renk düğmesi araç çubuğu denetimleri hiyerarşisinde ya renk özelliği kılavuz denetiminde yoksa bu önemli bir değerdir.
m_pWndPropList	Bir işaretçi bir CMFCPropertyGridCtrl nesnesi.
m_strAutoColor	A CString yani üzerinde görüntülenen metni Otomatik düğme.Daha fazla bilgi için bkz. CMFCColorBar::EnableAutomaticButton.
m_strDocColors	A CString yani belge renkleri düğmesinde görüntülenen metin.Daha fazla bilgi için bkz. CMFCColorBar::SetDocumentColors.
m_strOtherColor	A CString yani üzerinde görüntülenen metni diğer düğme.Daha fazla bilgi için bkz. CMFCColorBar::EnableOtherButton.

Notlar

Genellikle, değil oluşturduğunuz bir CMFCColorBar doğrudan nesne.Bunun yerine, CMFCColorMenuButton sınıfı (menüler ve araç çubukları kullanılır) veya CMFCColorButton sınıfı oluşturur CMFCColorBar nesnesi.

CMFCColorBar Sınıfı, aşağıdaki işlevselliği sağlar:

Belge renklerini listesini otomatik olarak ayarlar.
Kaydeder ve belge durumu ile birlikte durumuna geri yükler.
"Otomatik" düğmesi yönetir.
Kullandığı CMFCColorPickerCtrl sınıfı özel bir renk seçmek için denetim.
"Etiketleri" durumu destekler (kullanılarak oluşturulur, CMFCColorMenuButton sınıfı).

Birleştirmek için CMFCColorBar uygulamanıza işlevleri:

Normal menü düğmesi oluşturun ve kimliği, örneğin ID_CHAR_COLOR atayın.
Çerçeve penceresi sınıfta geçersiz CFrameWndEx::OnShowPopupMenu yöntemi ve normal menü Değiştir düğmesi ile bir CMFCColorMenuButton sınıfı nesne (çağırarak CMFCToolBar::ReplaceButton).
Tüm stilleri ayarlama ve etkinleştirme veya özelliklerini devre dışı CMFCColorBar sırasında nesne CMFCColorMenuButton sınıfı oluşturma.CMFCColorMenuButton Nesne dinamik olarak CMFCColorBar nesne çerçevesi aramalar sonrasında CreatePopupMenu yöntemi.

Kullanıcı bir renk çubuğu denetimi düğmesini tıklattığında framework kullanan ON_COMMAND renk çubuğunu denetimin üst bildirmek için makro.Makro komutu kimliği parametresi adım 1 (Bu örnekte ID_CHAR_COLOR) renk çubuğu denetimi düğmeye atanan değerdir.For more information, see the CMFCColorMenuButton sınıfı, CMFCColorButton sınıfı, CMFCColorPickerCtrl sınıfı, CFrameWndEx sınıfı, and CMFCToolBar sınıfı classes.

Örnek

Aşağıdaki örnekte çeşitli yöntemler kullanarak renk çubuğunu yapılandırma gösterilmiştir CMFCColorBar sınıfı.Yöntemleri yatay ve dikey kenar boşluklarını ayarlama diğer düğmesini etkinleştirmek, renk çubuğunun denetimi penceresi oluşturmak ve şu anda seçili olan rengi ayarlar.Bu örnek bir parçası olan Yeni denetimlere örnek.

    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));