CMFCColorDialog – třída
Třída CMFCColorDialog představuje dialogové okno pro výběr barvy.
Syntaxe
class CMFCColorDialog : public CDialogEx
Členové
Veřejné konstruktory
| Název | Popis |
|---|---|
| CMFCColorDialog::CMFCColorDialog | CMFCColorDialog Vytvoří objekt. |
CMFCColorDialog::~CMFCColorDialog |
Destruktor. |
Veřejné metody
| Název | Popis |
|---|---|
| CMFCColorDialog::GetColor | Vrátí aktuální vybranou barvu. |
| CMFCColorDialog::GetPalette | Vrátí paletu barev. |
CMFCColorDialog::PreTranslateMessage |
Překládá zprávy okna před odesláním do funkcí TranslateMessage a DispatchMessage systému Windows. Syntaxe a další informace naleznete v tématu CWnd::P reTranslateMessage. (Přepsání CDialogEx::PreTranslateMessage.) |
| CMFCColorDialog::RebuildPalette | Odvozuje paletu ze systémové palety. |
| CMFCColorDialog::SetCurrentColor | Nastaví aktuální vybranou barvu. |
| CMFCColorDialog::SetNewColor | Nastaví barvu, která odpovídá zadané hodnotě RGB. |
| CMFCColorDialog::SetPageOne | Vybere hodnotu RGB pro první stránku vlastností. |
| CMFCColorDialog::SetPageTwo | Vybere hodnotu RGB pro druhou stránku vlastností. |
Chráněné datové členy
| Název | Popis |
|---|---|
m_bIsMyPalette |
TRUE, pokud dialogové okno pro výběr barev používá vlastní paletu barev nebo NEPRAVDA, pokud dialogové okno používá paletu určenou v konstruktoru CMFCColorDialog . |
m_bPickerMode |
TRUE, když uživatel vybírá barvu z dialogového okna výběru; jinak NEPRAVDA. |
m_btnColorSelect |
Barevné tlačítko, které uživatel vybral. |
m_CurrentColor |
Aktuálně vybraná barva. |
m_hcurPicker |
Kurzor, který se používá k výběru barvy. |
m_NewColor |
Potenciální vybraná barva, která může být trvale vybrána nebo vrácena k původní barvě. |
m_pColourSheetOne |
Ukazatel na první stránku vlastností v seznamu vlastností výběru barev. |
m_pColourSheetTwo |
Ukazatel na druhou stránku vlastností seznamu vlastností výběru barev. |
m_pPalette |
Aktuální logická paleta. |
m_pPropSheet |
Ukazatel na seznam vlastností dialogového okna pro výběr barev. |
m_wndColors |
Ovládací objekt ovládacího prvku pro výběr barvy. |
m_wndStaticPlaceHolder |
Statický ovládací prvek, který je zástupný symbol pro seznam vlastností pro výběr barvy. |
Poznámky
Dialogové okno pro výběr barev se zobrazí jako seznam vlastností se dvěma stránkami. Na první stránce vyberete ze systémové palety standardní barvu; na druhé stránce vyberete vlastní barvu.
Můžete vytvořit CMFCColorDialog objekt v zásobníku a potom volat DoModal, předat počáteční barvu jako parametr konstruktoru CMFCColorDialog . Dialogové okno pro výběr barev pak vytvoří několik objektů TŘÍDY CMFCColorPickerCtrl pro zpracování každé palety barev.
Hierarchie dědičnosti
Příklad
Následující příklad ukazuje, jak nakonfigurovat barevné dialogové okno pomocí různých metod ve CMFCColorDialog třídě. Příklad ukazuje, jak nastavit aktuální a nové barvy dialogového okna a jak nastavit červené, zelené a modré součásti vybrané barvy na dvou stránkách vlastností dialogového okna barev. Tento příklad je součástí ukázky Nové ovládací prvky.
// COLORREF m_Color
CMFCColorDialog dlg(m_Color, 0, this);
dlg.SetCurrentColor(RGB(0, 255, 0));
dlg.SetNewColor(RGB(0, 0, 255));
// set the red, green, and blue components of a selected
// color on the two property pages of the color dialog
dlg.SetPageOne(255, 0, 0);
dlg.SetPageTwo(0, 255, 0);
Požadavky
Záhlaví: afxcolordialog.h
CMFCColorDialog::CMFCColorDialog
CMFCColorDialog Vytvoří objekt.
CMFCColorDialog(
COLORREF clrInit=0,
DWORD dwFlags=0,
CWnd* pParentWnd=NULL,
HPALETTE hPal=NULL);
Parametry
clrInit
[v] Výchozí výběr barvy. Pokud není zadána žádná hodnota, výchozí hodnota je RGB(0,0;0) (černá).
dwFlags
[v] Rezervovaný.
pParentWnd
[v] Ukazatel na nadřazené okno nebo okno vlastníka dialogového okna
hPal
[v] Úchyt pro paletu barev.
Návratová hodnota
Poznámky
CMFCColorDialog::GetColor
Načte barvu, kterou uživatel vybere v dialogovém okně barev.
COLORREF GetColor() const;
Návratová hodnota
Hodnota COLORREF, která obsahuje informace RGB pro barvu vybranou v dialogovém okně barva.
Poznámky
Volání této funkce po volání DoModal metody.
CMFCColorDialog::GetPalette
Načte paletu barev, která je dostupná v aktuálním dialogovém okně barev.
CPalette* GetPalette() const;
Návratová hodnota
Ukazatel na CPalette objekt, který byl zadán v konstruktoru CMFCColorDialog .
Poznámky
Paleta barev určuje barvy, které uživatel může zvolit.
CMFCColorDialog::RebuildPalette
Odvozuje paletu ze systémové palety.
void RebuildPalette();
CMFCColorDialog::SetCurrentColor
Nastaví aktuální barvu dialogového okna.
void SetCurrentColor(COLORREF rgb);
Parametry
Rgb
[v] Hodnota barvy RGB
Poznámky
CMFCColorDialog::SetNewColor
Nastaví aktuální barvu na barvu v aktuální paletě, která je nejvíce podobná.
void SetNewColor(COLORREF rgb);
Parametry
Rgb
[v] A COLORREF , která určuje barvu RGB.
Poznámky
CMFCColorDialog::SetPageOne
Explicitně určuje červené, zelené a modré komponenty vybrané barvy na první stránce vlastností dialogového okna barev.
void SetPageOne(
BYTE R,
BYTE G,
BYTE B);
Parametry
R
[v] Určuje červenou komponentu hodnoty RGB.
G
[v] Určuje zelenou komponentu hodnoty RGB.
B
[v] Určuje modrou komponentu hodnoty RGB.
Poznámky
CMFCColorDialog::SetPageTwo
Explicitně určuje červenou, zelenou a modrou část vybrané barvy na druhé stránce vlastností dialogového okna barev.
void SetPageTwo(
BYTE R,
BYTE G,
BYTE B);
Parametry
R
[v] Určuje červenou komponentu hodnoty RGB.
G
[v] Určuje zelenou komponentu hodnoty RGB.
B
[v] Určuje modrou komponentu hodnoty RGB.