Třída CMFCColorBar

Článek
03/04/2013

CMFCColorBar Třída představuje dokovací ovládací panel, který můžete vybrat barvy v dokumentu nebo aplikace.

class CMFCColorBar : public CMFCPopupMenuBar

Členy

Chráněné konstruktory

Název	Description
CMFCColorBar::CMFCColorBar	Konstrukce CMFCColorBar objektu.

Veřejné metody

Název	Description
CMFCColorBar::ContextToSize	Vypočítá svislé a vodorovné okraje, které musí obsahovat tlačítka na ovládacím panelu barev a pak upraví umístění těchto tlačítek.
CMFCColorBar::CreateControl	Vytvoří okno Ovládací panel barev, připojí jej ke CMFCColorBar objektu a změní velikost ovládací prvek obsahovat zadaný paletu barev.
CMFCColorBar::Create	Vytvoří okno ovládací pruh barvy a připojí jej CMFCColorBar objektu.
CMFCColorBar::EnableAutomaticButton	Zobrazí nebo skryje tlačítko Automatická.
CMFCColorBar::EnableOtherButton	Povolí nebo zakáže zobrazení dialogového okna, která umožňuje uživateli vybrat více barev.
CMFCColorBar::GetColor	Zkopíruje aktuálně vybranou barvu.
CMFCColorBar::GetCommandID	Načte ID příkazu ovládacího prvku aktuálního pruhu barev.
CMFCColorBar::GetHighlightedColor	Použije barvu, která označuje, že tlačítko Barva má fokus; tlačítko je hot.
CMFCColorBar::GetHorzMargin	Získá vodorovný rozpětí, které je prostor mezi vlevo nebo vpravo barva buňky a hranice oblasti klienta.
CMFCColorBar::GetVertMargin	Načítá svislý okraj je prostor mezi horní nebo dolní barva buňky a ohraničení oblasti klienta.
CMFCColorBar::IsTearOff	Označuje, zda je dokovací aktuálního pruhu barev.
CMFCColorBar::SetColor	Nastaví barvu, která je aktuálně vybrána.
CMFCColorBar::SetColorName	Nastaví nový název pro určitou barvu.
CMFCColorBar::SetCommandID	Nastaví nové ID příkazu pro ovládací panel barvy.
CMFCColorBar::SetDocumentColors	Nastaví seznam barev, které se používají v aktuálním dokumentu.
CMFCColorBar::SetHorzMargin	Nastaví horizontální okraj, je prostor mezi vlevo nebo vpravo barva buňky a hranice oblasti klienta.
CMFCColorBar::SetVertMargin	Nastaví svislé rozpětí, které je prostor mezi horní nebo spodní buňce barva a hranice oblasti klienta.

Chráněné metody

Název	Description
CMFCColorBar::AdjustLocations	Upraví pozice Barevná tlačítka na ovládacím panelu barev.
CMFCColorBar::AllowChangeTextLabels	Označuje, zda lze změnit textový popisek tlačítka Barva.
CMFCColorBar::AllowShowOnList	Určuje, zda objekt ovládacího panelu barvy se mohou objevit v seznamu nástrojů během procesu úprav.
CMFCColorBar::CalcSize	Volat v rámci procesu výpočtu rozložení.
CMFCColorBar::CreatePalette	Initalizes paleta barev v určené pole barev.
CMFCColorBar::GetColorGridSize	Vypočítá počet řádků a sloupců v mřížce ovládací panel barvy.
CMFCColorBar::GetExtraHeight	Vypočítá další výšku, která vyžaduje aktuální barevný pruh zobrazit různé prvky rozhraní, jako ostatní tlačítko, barvy dokumentu a podobně.
CMFCColorBar::InitColors	Inicializuje pole s barvami v zadané palety nebo výchozí systémové palety barev.
CMFCColorBar::OnKey	Po stisknutí tlačítka klávesnice, nazývá rámcem.
CMFCColorBar::OnSendCommand	Volat v rámci hierarchie prvků překryvné okno zavřete.
CMFCColorBar::OnUpdateCmdUI	Volat rozhraní povolit nebo zakázat položky uživatelského rozhraní ovládacího panelu barvy před zobrazením položky.
CMFCColorBar::OpenColorDialog	Otevře dialogové okno Barva.
CMFCColorBar::Rebuild	Zcela překreslí ovládací panel barvy.
CMFCColorBar::SelectPalette	Nastaví logické paletu kontextu zařízení do palety tlačítka nadřazeného ovládacího prvku aktuálního pruhu barev.
CMFCColorBar::SetPropList	Nastaví m_pWndPropList chráněné datový člen určený ukazatel na ovládací prvek vlastnosti mřížky.
CMFCColorBar::ShowCommandMessageString	Rámeček okna, která vlastní ovládací panel barvy aktualizovat ve stavovém řádku zpráva požadavky.

Chráněné členy Data

Název	Description
m_bInternal	Logická pole, která určuje, zda jsou zpracovány události myši.Události myši jsou obvykle zpracovány, pokud je toto pole TRUE a režim úprav je FALSE .
m_bIsEnabled	Logická hodnota označující, zda je ovládací prvek povolen.
m_bIsTearOff	Logická hodnota označující, zda ovládací panel barev podporuje dokovací stanici.
m_BoxSize	A CSize objektu, který určuje velikost buňky v mřížce pruhu barev.
m_bShowDocColorsWhenDocked	Logická hodnota označující, zda zobrazit barvy dokumentu, když ukotvený panel barvy.Další informace naleznete v tématu CMFCColorBar::SetDocumentColors.
m_bStdColorDlg	Logická hodnota označující, zda se má zobrazit dialogové okno standardní systém barev nebo CMFCColorDialog dialogové okno.Další informace naleznete v tématu CMFCColorBar::EnableOtherButton.
m_ColorAutomatic	A COLORREF , ukládá aktuální Automatická barva.Další informace naleznete v tématu CMFCColorBar::EnableOtherButton.
m_ColorNames	CMap objekt, který spojuje sadu RGB barvy s jejich názvy.
m_colors	A CArray z COLORREF hodnoty, které obsahuje barvy, které jsou zobrazeny v ovládacím panelu barev.
m_ColorSelected	A COLORREF hodnotu barvy, který uživatel byl vybrán z ovládacího panelu barev.
m_lstDocColors	A CList z COLORREF hodnoty, které obsahuje barvy, které jsou aktuálně v dokumentu použity.
m_nCommandID	Celé číslo bez znaménka, která je ID příkazového tlačítka Barva.
m_nHorzMargin	Celé je vodorovné okraje mezi tlačítky barev v tabulce barev.
m_nHorzOffset	Celé je vodorovný posun do středu tlačítka Barva.Tato hodnota je významný, pokud toto tlačítko se zobrazí text nebo obraz, kromě barvy.
m_nNumColumns	Celé číslo je číslo sloupce v mřížce ovládání barevného pruhu barev.
m_nNumColumnsVert	Celé číslo je číslo sloupce v mřížce orientovaných barev.
m_nNumRowsHorz	Celé číslo je číslo sloupce v mřížce vodorovně orientovaný barev.
m_nRowHeight	Celé je výška řádku tlačítek barev v tabulce barev.
m_nVertMargin	Celé je svislý okraj mezi tlačítky barev v tabulce barev.
m_nVertOffset	Celé je svislý posun do středu tlačítka Barva.Tato hodnota je významný, pokud toto tlačítko se zobrazí text nebo obraz, kromě barvy.
m_Palette	A CPalette barev, které jsou používány v ovládacím panelu barev.
m_pParentBtn	Ukazatel CMFCColorButton objekt, který je nadřazená aktuální tlačítka.Tato hodnota je významný, pokud tlačítko Barva je v hierarchii prvky z panelu nástrojů nebo v ovládacím prvku Barva vlastnost mřížky.
m_pParentRibbonBtn	Ukazatel CMFCRibbonColorButton objektu na pásu karet, který je tlačítko nadřazené aktuální tlačítka.Tato hodnota je významný, pokud tlačítko Barva je v hierarchii prvky z panelu nástrojů nebo v ovládacím prvku Barva vlastnost mřížky.
m_pWndPropList	Ukazatel CMFCPropertyGridCtrl objektu.
m_strAutoColor	A CString je text, který je zobrazen na Automatické tlačítko.Další informace naleznete v tématu CMFCColorBar::EnableAutomaticButton.
m_strDocColors	A CString je text, který je zobrazen na tlačítku barvy dokumentu.Další informace naleznete v tématu CMFCColorBar::SetDocumentColors.
m_strOtherColor	A CString je text, který je zobrazen na ostatní tlačítko.Další informace naleznete v tématu CMFCColorBar::EnableOtherButton.

Poznámky

Obvykle nevytvoříte CMFCColorBar objekt přímo.Místo toho Třída CMFCColorMenuButton (použitý v nabídkách a panelech nástrojů) nebo Třída CMFCColorButton vytvoří CMFCColorBar objektu.

CMFCColorBar Třída poskytuje následující funkce:

Seznam barev dokumentu se automaticky upraví.
Ukládá a obnovuje stavu s stav dokumentu.
Spravuje tlačítko "Automatické".
Používá Třída CMFCColorPickerCtrl ovládacího prvku vyberte vlastní barvu.
Podporuje stát "odtrhnout" (Pokud je vytvořen pomocí Třída CMFCColorMenuButton).

Začlenit CMFCColorBar funkce do aplikace:

Vytvoření pravidelných menu button a přiřaďte mu ID, například ID_CHAR_COLOR.
Ve své třídě rámeček okna, přepsat CFrameWndEx::OnShowPopupMenu metoda a nahradit pravidelné nabídce tlačítka s Třída CMFCColorMenuButton objektu (voláním CMFCToolBar::ReplaceButton).
Nastavit všechny styly a povolení nebo zakázání funkce CMFCColorBar objektu během Třída CMFCColorMenuButton vytvoření. CMFCColorMenuButton Dynamicky vytvoří objekt CMFCColorBar objektu po volání rámec CreatePopupMenu metoda.

Po klepnutí na tlačítko ovládacího prvku v pruhu barev, používá se v rámci ON_COMMAND makro oznámit nadřazeného ovládacího panelu barev.Parametr ID příkazu v makru, je hodnota přiřazená barevný pruh tlačítko ovládacího prvku v kroku 1 (ID_CHAR_COLOR v tomto příkladu).For more information, see the Třída CMFCColorMenuButton, Třída CMFCColorButton, Třída CMFCColorPickerCtrl, Třída CFrameWndEx, and Třída CMFCToolBar classes.

Příklad

Následující příklad ukazuje, jak nakonfigurovat pomocí různých metod v pruhu barev CMFCColorBar třídy.Metody nastavit vodorovné a svislé okraje, povolit jiné tlačítko, vytvořit okno Ovládací panel barev a nastaví aktuálně vybranou barvu.V tomto příkladu je součástí vzorku nové ovládací prvky.

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