Sdílet prostřednictvím

CMFCColorBar – třída

  • Článek

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

Syntaxe

class CMFCColorBar : public CMFCPopupMenuBar

Členové

Chráněné konstruktory

Název Popis
CMFCColorBar::CMFCColorBar CMFCColorBar Vytvoří objekt.

Veřejné metody

Název Popis
CMFCColorBar::ContextToSize Vypočítá svislé a vodorovné okraje, které jsou potřeba k zahrnutí tlačítek v ovládacím prvku panelu barev, a pak upraví umístění těchto tlačítek.
CMFCColorBar::CreateControl Vytvoří okno ovládacího prvku panelu barev, připojí ho k objektu CMFCColorBar a změní velikost ovládacího prvku tak, aby obsahoval zadanou paletu barev.
CMFCColorBar::Create Vytvoří okno ovládacího prvku panelu barev a připojí ho k objektu CMFCColorBar .
CMFCColorBar::EnableAutomaticButton Zobrazí nebo skryje automatické tlačítko.
CMFCColorBar::EnableOtherButton Povolí nebo zakáže zobrazení dialogového okna, které uživateli umožní vybrat více barev.
CMFCColorBar::GetColor Načte aktuálně vybranou barvu.
CMFCColorBar::GetCommandID Načte ID příkazu aktuálního ovládacího prvku panelu barev.
CMFCColorBar::GetHighlightedColor Načte barvu, která označuje, že tlačítko barvy má fokus; to znamená, že tlačítko je horké.
CMFCColorBar::GetHorzMargin Načte vodorovný okraj, což je mezera mezi levou nebo pravou barvou buňky a hranicí klientské oblasti.
CMFCColorBar::GetVertMargin Načte svislý okraj, což je mezera mezi horní nebo dolní barvou buňky a hranicí klientské oblasti.
CMFCColorBar::IsTearOff Určuje, jestli je aktuální barevný pruh dokovatelný.
CMFCColorBar::SetColor Nastaví barvu, která je aktuálně vybraná.
CMFCColorBar::SetColorName Nastaví nový název pro zadanou barvu.
CMFCColorBar::SetCommandID Nastaví nové ID příkazu pro ovládací prvek barevného pruhu.
CMFCColorBar::SetDocumentColors Nastaví seznam barev použitých v aktuálním dokumentu.
CMFCColorBar::SetHorzMargin Nastaví vodorovný okraj, což je mezera mezi levou nebo pravou barvou buňky a hranicí klientské oblasti.
CMFCColorBar::SetVertMargin Nastaví svislý okraj, což je mezera mezi horní nebo dolní barvou buňky a hranicí klientské oblasti.

Chráněné metody

Název Popis
CMFCColorBar::AdjustLocations Upraví pozice barevných tlačítek v ovládacím prvku panelu barev.
CMFCColorBar::AllowChangeTextLabels Určuje, jestli se může změnit textový popisek barevných tlačítek.
CMFCColorBar::AllowShowOnList Určuje, zda se objekt ovládacího prvku panelu barev může během procesu přizpůsobení zobrazit v seznamu panelů nástrojů.
CMFCColorBar::CalcSize Volal ho architektura jako součást procesu výpočtu rozložení.
CMFCColorBar::CreatePalette Inicializuje paletu s barvami v zadaném poli barev.
CMFCColorBar::GetColorGridSize Vypočítá počet řádků a sloupců v mřížce ovládacího prvku barevného pruhu.
CMFCColorBar::GetExtraHeight Vypočítá dodatečnou výšku, kterou aktuální panel barev vyžaduje k zobrazení různých prvků uživatelského rozhraní, jako jsou tlačítko Jiné , barvy dokumentu atd.
CMFCColorBar::InitColors Inicializuje pole barev pomocí barev v zadané paletě nebo výchozí paleta systému.
CMFCColorBar::OnKey Volá se rozhraním, když uživatel stiskne tlačítko klávesnice.
CMFCColorBar::OnSendCommand Volá se rozhraním pro zavření hierarchie automaticky otevíraných ovládacích prvků.
CMFCColorBar::OnUpdateCmdUI Volané rozhraním pro povolení nebo zakázání položky uživatelského rozhraní ovládacího prvku barevného pruhu před zobrazením položky.
CMFCColorBar::OpenColorDialog Otevře dialogové okno barvy.
CMFCColorBar::Rebuild Kompletně překreslí ovládací prvek panelu barev.
CMFCColorBar::SelectPalette Nastaví logickou paletu zadaného kontextu zařízení na paletu nadřazeného tlačítka aktuálního ovládacího prvku panelu barev.
CMFCColorBar::SetPropList m_pWndPropList Nastaví chráněný datový člen na zadaný ukazatel na ovládací prvek mřížky vlastností.
CMFCColorBar::ShowCommandMessageString Požádá o okno rámce, které vlastní ovládací prvek panelu barev, aby aktualizoval řádek zprávy na stavovém řádku.

Chráněné datové členy

Název Popis
m_bInternal Logické pole, které určuje, jestli se zpracovávají události myši. Události myši se obvykle zpracovávají, když je toto pole PRAVDA a režim přizpůsobení je NEPRAVDA.
m_bIsEnabled Logická hodnota označující, jestli je ovládací prvek povolený.
m_bIsTearOff Logická hodnota označující, jestli ovládací prvek barevného pruhu podporuje ukotvení.
m_BoxSize Objekt CSize , který určuje velikost buňky v mřížce barevného pruhu.
m_bShowDocColorsWhenDocked Logická hodnota označující, jestli se mají zobrazit barvy dokumentu při ukotvení panelu barev. Další informace naleznete v tématu CMFCColorBar::SetDocumentColors.
m_bStdColorDlg Logická hodnota, která označuje, zda se má zobrazit standardní dialogové okno systémové barvy nebo CMFCColorDialog dialogové okno. Další informace naleznete v tématu CMFCColorBar::EnableOtherButton.
m_ColorAutomatic A COLORREF , která ukládá aktuální automatickou barvu. Další informace naleznete v tématu CMFCColorBar::EnableOtherButton.
m_ColorNames Objekt CMap , který přidruží sadu barev RGB k jejich názvům.
m_colors A CArray of COLORREF values that contains the colors that are displayed in the color bar control.
m_ColorSelected Hodnota COLORREF , která je barva, kterou uživatel aktuálně vybral z ovládacího prvku panel barev.
m_lstDocColors A CList of COLORREF values that contains the colors that are currently used in a document.
m_nCommandID Celé číslo bez znaménka, které je ID příkazu barevného tlačítka.
m_nHorzMargin Celé číslo, které je vodorovným okrajem mezi barevnými tlačítky v mřížce barev.
m_nHorzOffset Celé číslo, které je vodorovným posunem na střed barevného tlačítka. Tato hodnota je důležitá, pokud tlačítko vedle barvy zobrazuje text nebo obrázek.
m_nNumColumns Celé číslo, které je počtem sloupců v barevném pruhu, řídí mřížku barev.
m_nNumColumnsVert Celé číslo, které je počtem sloupců ve svisle orientované mřížce barev.
m_nNumRowsHorz Celé číslo, které je počtem sloupců v vodorovně orientované mřížce barev.
m_nRowHeight Celé číslo, které je výškou řádku barevných tlačítek v mřížce barev.
m_nVertMargin Celé číslo, které je svislým okrajem mezi barevnými tlačítky v mřížce barev.
m_nVertOffset Celé číslo, které je svislým posunem na střed barevného tlačítka. Tato hodnota je důležitá, pokud tlačítko vedle barvy zobrazuje text nebo obrázek.
m_Palette A CPalette of the colors that are used in the color bar control.
m_pParentBtn Ukazatel na CMFCColorButton objektu, který je nadřazený aktuálním tlačítkem. Tato hodnota je významná, pokud je tlačítko barvy v hierarchii ovládacích prvků panelu nástrojů nebo je v ovládacím prvku mřížky vlastností barev.
m_pParentRibbonBtn Ukazatel na CMFCRibbonColorButton objekt, který je na pásu karet a je nadřazeným tlačítkem aktuálního tlačítka. Tato hodnota je významná, pokud je tlačítko barvy v hierarchii ovládacích prvků panelu nástrojů nebo je v ovládacím prvku mřížky vlastností barev.
m_pWndPropList Ukazatel na OBJEKT CMFCPropertyGridCtrl .
m_strAutoColor Řetězec CString, který je text zobrazený na automatickém tlačítku. Další informace naleznete v tématu CMFCColorBar::EnableAutomaticButton.
m_strDocColors Řetězec CString , který je text zobrazený na tlačítku barvy dokumentu. Další informace naleznete v tématu CMFCColorBar::SetDocumentColors.
m_strOtherColor Řetězec CString , který je text zobrazený na druhém tlačítku. Další informace naleznete v tématu CMFCColorBar::EnableOtherButton.

Poznámky

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

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

CMFCColorBar Začlenění funkcí do aplikace:

  1. Vytvořte běžné tlačítko nabídky a přiřaďte ho jako ID, například ID_CHAR_COLOR.

  2. Ve třídě okna s rámečkem přepište CFrameWndEx::OnShowPopupMenu metoda a nahraďte tlačítko běžné nabídky objektem CMFCColorMenuButton Class (voláním CMFCToolBar::ReplaceButton).

  3. Nastavte všechny styly a povolte nebo zakažte funkce objektu CMFCColorBar během CMFCColorMenuButton – vytvoření třídy . Objekt CMFCColorMenuButton dynamicky vytvoří CMFCColorBar objekt po volání architektury metodu CreatePopupMenu .

Když uživatel klikne na tlačítko ovládacího prvku panelu barev, architektura použije ON_COMMAND makro k upozornění nadřazeného ovládacího prvku panelu barev. Parametr ID příkazu v makre je hodnota, kterou jste přiřadili k ovládacímu tlačítku panelu barev v kroku 1 (ID_CHAR_COLOR v tomto příkladu). Další informace naleznete v CMFCColorMenuButton Třída, CMFCColorButton Třída, CMFCColorPickerCtrl Třída, CFrameWndEx Třídy a CMFCToolBar Třídy.

Příklad

Následující příklad ukazuje, jak nakonfigurovat barevný pruh pomocí různých metod ve CMFCColorBar třídě. Metody nastaví vodorovné a svislé okraje, povolí druhé tlačítko, vytvoří okno ovládacího prvku barevného pruhu a nastaví aktuálně vybranou barvu. Tento příklad je součástí ukázky 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));

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

CWnd

CBasePane

Podokno CPane

CMFCBaseToolBar

CMFCToolBar

CMFCPopupMenuBar

CMFCColorBar

Požadavky

Záhlaví: afxcolorbar.h

CMFCColorBar::AdjustLocations

Upraví pozice barevných tlačítek v ovládacím prvku panelu barev.

virtual void AdjustLocations();

Poznámky

Tato metoda je volána rozhraním během WM_SIZE zpracování zpráv.

CMFCColorBar::AllowChangeTextLabels

Určuje, jestli se může změnit textový popisek barevných tlačítek.

virtual BOOL AllowChangeTextLabels() const;

Návratová hodnota

Vždy NEPRAVDA.

Poznámky

Ve výchozím nastavení tato metoda vždy vrací hodnotu FALSE, což znamená, že textové popisky nelze změnit. Tuto metodu přepište, pokud chcete povolit úpravy textových popisků.

CMFCColorBar::AllowShowOnList

Určuje, zda se objekt ovládacího prvku panelu barev může během procesu přizpůsobení zobrazit v seznamu panelů nástrojů.

virtual BOOL AllowShowOnList() const;

Návratová hodnota

Vždy PRAVDA.

Poznámky

Ve výchozím nastavení tato metoda vždy vrátí hodnotu TRUE, což znamená, že architektura může během procesu přizpůsobení zobrazit ovládací prvek barevného pruhu. Přepište tuto metodu pro implementaci jiného chování.

CMFCColorBar::CalcSize

Volal ho architektura jako součást procesu výpočtu rozložení.

virtual CSize CalcSize(BOOL bVertDock);

Parametry

bVertDock
[v] HODNOTA TRUE určuje, že ovládací prvek barevného pruhu je ukotven svisle; NEPRAVDA určuje, že je ovládací prvek barevného pruhu ukotvený vodorovně.

Návratová hodnota

Velikost pole barevných tlačítek v ovládacím prvku panelu barev.

CMFCColorBar::CMFCColorBar

CMFCColorBar Vytvoří objekt.

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

Parametry

barvy
[v] Pole barev, které architektura zobrazuje v ovládacím prvku panelu barev.

barva
[v] Počáteční vybraná barva.

lpszAutoColor
[v] Textový popisek automatického (výchozího) barevného tlačítka nebo NULL.

Standardní popisek automatického tlačítka je Automatický.

lpszOtherColor
[v] Textový popisek druhého tlačítka, který zobrazuje více možností barev nebo NULL.

Standardní popisek druhého tlačítka je Další barvy....

lpszDocColors
[v] Textový popisek tlačítka barvy dokumentu. Paleta barev dokumentu obsahuje všechny barvy, které dokument aktuálně používá.

lstDocColors
[v] Seznam barev, které dokument aktuálně používá.

nSloupce
[v] Počet sloupců,kteréchch

nRowsDockHorz
[v] Počet řádků, které má barevný pruh při ukotvení vodorovně.

nColDockVert
[v] Počet sloupců, které má barevný pruh při ukotvení svisle.

colorAutomatic
[v] Výchozí barva, kterou architektura použije, když kliknete na automatické tlačítko.

nCommandID
[v] ID příkazu ovládacího prvku panelu barev.

pParentBtn
[v] Ukazatel na nadřazené tlačítko

Src
[v] Existující CMFCColorBar objekt, který se má zkopírovat do nového CMFCColorBar objektu.

uiCommandID
[v] ID příkazu.

CMFCColorBar::ContextToSize

Vypočítá svislé a vodorovné okraje, které jsou potřeba k tomu, aby obsahovaly tlačítka v ovládacím prvku barevný pruh, a upraví umístění těchto tlačítek.

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

Parametry

bSquareButtons
[v] PRAVDA, pokud chcete určit, že tvar tlačítek na ovládacím prvku barevného pruhu jsou čtvercové; jinak NEPRAVDA. Výchozí hodnota je PRAVDA.

bCenterButtons
[v] HODNOTA TRUE určuje, že obsah na tváři ovládacího tlačítka barevného pruhu je zacentrován; jinak NEPRAVDA. Výchozí hodnota je PRAVDA.

Poznámky

CMFCColorBar::Create

Vytvoří okno ovládacího prvku panelu barev a připojí ho k objektu CMFCColorBar .

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

Parametry

pParentWnd
[v] Ukazatel na nadřazené okno

dwStyle
[v] Bitové kombinace (OR) stylů oken.

Nid
[v] ID příkazu.

pPalette
[v] Ukazatel na paletu barev. Výchozí hodnota je NULL.

nSloupce
[v] Počet sloupců v ovládacím prvku panel barev. Výchozí hodnota je 0.

nRowsDockHorz
[v] Počet řádků v ovládacím prvku panelu barev, když je ukotven vodorovně. Výchozí hodnota je 0.

nColDockVert
[v] Počet sloupců v ovládacím prvku barevného pruhu, když je ukotven svisle. Výchozí hodnota je 0.

Návratová hodnota

TRUE, pokud tato metoda je úspěšná; jinak NEPRAVDA.

Poznámky

Chcete-li vytvořit CMFCColorBar objekt, zavolejte konstruktor třídy pak tuto metodu. Metoda Create vytvoří ovládací prvek Windows a inicializuje seznam barev.

CMFCColorBar::CreateControl

Vytvoří okno ovládacího prvku panelu barev, připojí ho k objektu CMFCColorBar a změní velikost ovládacího okna tak, aby obsahovalo zadanou paletu barev.

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

Parametry

pParentWnd
[v] Ukazatel na nadřazené okno Nesmí mít hodnotu NULL.

Rect
[v] Ohraničující obdélník, který určuje, kam se má nakreslit ovládací prvek barevného pruhu.

Nid
[v] ID ovládacího prvku.

nSloupce
[v] Ideální počet sloupců v ovládacím prvku barevný pruh. Tato metoda upraví toto číslo tak, aby odpovídalo zadané paletě barev. Výchozí hodnota je -1, což znamená, že tento parametr není zadán.

pPalette
[v] Ukazatel na paletu barev nebo NULL. Pokud je tento parametr NULL, tato metoda vypočítá velikost ovládacího prvku barevného pruhu, jako by byly zadány 20 barev. Výchozí hodnota je NULL.

Návratová hodnota

TRUE, pokud tato metoda bude úspěšná; jinak NEPRAVDA.

Poznámky

Tato metoda používá parametry rect, nColumns a pPalette k výpočtu příslušného počtu nebo řádků a sloupců v ovládacím prvku panelu barev a potom volá CMFCColorBar::Create metoda.

CMFCColorBar::CreatePalette

Inicializuje paletu s barvami v zadaném poli barev.

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

Parametry

arColors
[v] Pole barev.

paleta
[v] Paleta barev.

Návratová hodnota

TRUE, pokud tato metoda je úspěšná; jinak NEPRAVDA.

CMFCColorBar::EnableAutomaticButton

Zobrazí nebo skryje automatické tlačítko.

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

Parametry

lpszLabel
[v] Textový popisek automatického (výchozího) barevného tlačítka nebo NULL.

Standardní popisek automatického tlačítka je Automatický.

colorAutomatic
[v] Výchozí barva, kterou architektura použije, když kliknete na automatické tlačítko.

bEnable
[v] TRUE pro povolení automatického tlačítka; NEPRAVDA pro zakázání automatického tlačítka. Výchozí hodnota je PRAVDA.

Poznámky

Textový popisek automatického tlačítka je odstraněn, pokud je parametr lpszLabel NULL nebo bEnable parametr je FALSE.

CMFCColorBar::EnableOtherButton

Povolí nebo zakáže zobrazení dialogového okna, které uživateli umožní vybrat více barev.

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

Parametry

lpszLabel
[v] Textový popisek druhého tlačítka, který zobrazuje více možností barev nebo NULL.

Standardní popisek tohoto tlačítka je Další barvy....

bAltColorDlg
[v] TRUE pro zobrazení CMFCColorDialog dialogové okno; FALSE pro zobrazení standardního dialogového okna CColorDialog . Výchozí hodnota je PRAVDA.

bEnable
[v] TRUE pro povolení tlačítka; NEPRAVDA, aby se tlačítko zakázalo. Výchozí hodnota je PRAVDA.

CMFCColorBar::GetColor

Načte aktuálně vybranou barvu.

COLORREF GetColor() const;

Návratová hodnota

Aktuálně vybraná barva.

CMFCColorBar::GetColorGridSize

Vypočítá počet řádků a sloupců v mřížce ovládacího prvku barevného pruhu.

CSize GetColorGridSize(BOOL bVertDock) const;

Parametry

bVertDock
[v] TRUE pro provedení výpočtu pro svisle ukotvený barevný pruh řízení; v opačném případě proveďte výpočet vodorovně ukotveného ovládacího prvku.

Návratová hodnota

Objekt CSize , jehož cx komponenta obsahuje počet sloupců a jehož cy komponenta obsahuje počet řádků.

CMFCColorBar::GetCommandID

Načte ID příkazu aktuálního ovládacího prvku panelu barev.

UINT GetCommandID() const;

Návratová hodnota

ID příkazu.

Poznámky

Když uživatel vybere novou barvu, rozhraní odešle ID příkazu do WM_COMMAND zprávy, která upozorní nadřazeného objektu CMFCColorBar .

CMFCColorBar::GetExtraHeight

Vypočítá dodatečnou výšku, kterou aktuální panel barev vyžaduje k zobrazení různých prvků uživatelského rozhraní, jako je tlačítko Jiné nebo barvy dokumentu.

int GetExtraHeight(int nNumColumns) const;

Parametry

nNumColumns
[v] Pokud ovládací prvek panel barev obsahuje barvy dokumentu, počet sloupců, které se mají zobrazit v mřížce barev dokumentu. V opačném případě se tato hodnota nepoužije.

Návratová hodnota

Vypočítaná dodatečná výška, která se vyžaduje.

CMFCColorBar::GetHighlightedColor

Načte barvu, která označuje, že tlačítko barvy má fokus; to znamená, že tlačítko je horké.

COLORREF GetHighlightedColor() const;

Návratová hodnota

Hodnota RGB.

Poznámky

CMFCColorBar::GetHorzMargin

Načte vodorovný okraj, což je mezera mezi levou nebo pravou barvou buňky a hranicí klientské oblasti.

int GetHorzMargin();

Návratová hodnota

Vodorovný okraj.

CMFCColorBar::GetVertMargin

Načte svislý okraj, což je mezera mezi horní nebo dolní barvou buňky a hranicí klientské oblasti.

int GetVertMargin() const;

Návratová hodnota

Svislý okraj.

CMFCColorBar::InitColors

Inicializuje pole barev pomocí barev v zadané paletě nebo pomocí výchozí systémové palety.

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

Parametry

pPalette
[v] Ukazatel na objekt palety nebo null. Pokud je tento parametr NULL, tato metoda používá výchozí paletu operačního systému.

arColors
[v] Pole barev.

Návratová hodnota

Počet prvků v poli barev.

CMFCColorBar::IsTearOff

Určuje, jestli je aktuální barevný pruh dokovatelný.

BOOL IsTearOff() const;

Návratová hodnota

TRUE, pokud je aktuální ovládací prvek barevného pruhu ukotvený; jinak NEPRAVDA.

Poznámky

Pokud je ovládací prvek panelu barev dokovatelný, může být roztrhaný z řídicího panelu a ukotvený na jiném místě.

CMFCColorBar::OnKey

Volá se rozhraním, když uživatel stiskne tlačítko klávesnice.

virtual BOOL OnKey(UINT nChar);

Parametry

nChar
[v] Kód virtuálního klíče pro klávesu, kterou uživatel stiskl.

Návratová hodnota

TRUE, pokud tato metoda zpracuje zadaný klíč; jinak NEPRAVDA.

CMFCColorBar::OnSendCommand

Volá se rozhraním pro zavření hierarchie automaticky otevíraných ovládacích prvků.

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parametry

pButton
[v] Ukazatel na ovládací prvek, který se nachází na panelu nástrojů.

Návratová hodnota

TRUE, pokud tato metoda je úspěšná; jinak NEPRAVDA.

CMFCColorBar::OnUpdateCmdUI

Volané rozhraním pro povolení nebo zakázání položky uživatelského rozhraní ovládacího prvku barevného pruhu před zobrazením položky.

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

Parametry

pTarget
[v] Ukazatel na okno, které obsahuje položku uživatelského rozhraní, která se má aktualizovat.

bDisableIfNoHndler
[v] TRUE zakázat položku uživatelského rozhraní, pokud není definována žádná obslužná rutina v mapě zpráv; jinak NEPRAVDA.

Poznámky

Když uživatel vaší aplikace klikne na položku uživatelského rozhraní, musí tato položka vědět, jestli se má zobrazit jako povolená nebo zakázaná. Cíl zprávy příkazu poskytuje tyto informace implementací ON_UPDATE_COMMAND_UI obslužné rutiny příkazu. Tuto metodu použijte ke zpracování příkazu. Další informace naleznete v tématu CCmdUI Třída.

CMFCColorBar::OpenColorDialog

Otevře dialogové okno barvy.

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

Parametry

colorDefault
[v] Barva vybraná ve výchozím nastavení při otevření dialogového okna barva.

colorRes
[ven] Barva, kterou uživatel vybral.

Návratová hodnota

TRUE, pokud uživatel vybral barvu; FALSE, pokud uživatel zrušil dialogové okno barev.

Poznámky

CMFCColorBar::Rebuild

Kompletně překreslí ovládací prvek panelu barev.

virtual void Rebuild();

CMFCColorBar::SelectPalette

Nastaví logickou paletu zadaného kontextu zařízení na paletu nadřazeného tlačítka aktuálního ovládacího prvku panelu barev.

CPalette* SelectPalette(CDC* pDC);

Parametry

pDC
[v] Ukazatel na kontext zařízení nadřazeného tlačítka aktuálního ovládacího prvku panelu barev.

Návratová hodnota

Ukazatel na paletu, která je nahrazena paletou nadřazeného tlačítka aktuálního ovládacího prvku panelu barev.

CMFCColorBar::SetColor

Nastaví barvu, která je aktuálně vybraná.

void SetColor(COLORREF color);

Parametry

barva
[v] Hodnota barvy RGB.

CMFCColorBar::SetColorName

Nastaví nový název pro zadanou barvu.

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

Parametry

barva
[v] Hodnota RGB barvy.

strName
[v] Nový název pro zadanou barvu.

Poznámky

Tato metoda změní název zadané barvy ve všech CMFCColorBar objektech v aplikaci.

CMFCColorBar::SetCommandID

Nastaví nové ID příkazu pro ovládací prvek barevného pruhu.

void SetCommandID(UINT nCommandID);

Parametry

nCommandID
[v] ID příkazu.

Poznámky

Voláním této metody můžete upravit ID příkazu ovládacího prvku panelu barev a upozornit nadřazené okno ovládacího prvku, že se ID změnilo.

CMFCColorBar::SetDocumentColors

Nastaví seznam barev použitých v aktuálním dokumentu.

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

Parametry

lpszCaption
[v] Titulek, který se zobrazí, když není ukotvený ovládací prvek panelu barev.

lstDocColors
[v] Seznam barev, které nahradí aktuální barvy dokumentu.

BShowWhenDocked
[v] TRUE zobrazit barvy dokumentu při ukotvení ovládacího prvku panelu barev; jinak NEPRAVDA. Výchozí hodnota je FALSE.

Poznámky

Barvy dokumentu jsou barvy , které se aktuálně používají v dokumentu. Architektura automaticky udržuje seznam barev dokumentu, ale tuto metodu můžete použít k úpravě seznamu.

CMFCColorBar::SetHorzMargin

Nastaví vodorovný okraj, což je mezera mezi levou nebo pravou barvou buňky a hranicí klientské oblasti.

void SetHorzMargin(int nHorzMargin);

Parametry

nHorzMargin
[v] Vodorovný okraj v pixelech.

Poznámky

Ve výchozím nastavení nastaví konstruktor CMFCColorBar::CMFCColorBar vodorovný okraj na 4 pixely.

CMFCColorBar::SetPropList

m_pWndPropList Nastaví chráněný datový člen na zadaný ukazatel na ovládací prvek mřížky vlastností.

void SetPropList(CMFCPropertyGridCtrl* pWndList);

Parametry

pWndList
[v] Ukazatel na objekt ovládacího prvku mřížky vlastností

CMFCColorBar::SetVertMargin

Nastaví svislý okraj, což je mezera mezi horní nebo dolní barvou buňky a hranicí klientské oblasti.

void SetVertMargin(int nVertMargin);

Parametry

nVertMargin
[v] Svislý okraj v pixelech.

Poznámky

Ve výchozím nastavení nastaví konstruktor CMFCColorBar::CMFCColorBar svislý okraj na 4 pixely.

CMFCColorBar::ShowCommandMessageString

Požádá o okno rámce, které vlastní ovládací prvek panelu barev, aby aktualizoval řádek zprávy na stavovém řádku.

virtual void ShowCommandMessageString(UINT uiCmdId);

Parametry

uiCmdId
[v] ID příkazu. (Tento parametr je ignorován.)

Poznámky

Tato metoda odešle WM_SETMESSAGESTRING zprávu vlastníkovi ovládacího prvku panelu barev.

Viz také

Graf hierarchie
Třídy