CColorDialog – třída
Umožňuje začlenit do aplikace dialogové okno pro výběr barev.
Syntaxe
class CColorDialog : public CCommonDialog
Členové
Veřejné konstruktory
| Jméno | popis |
|---|---|
| CColorDialog::CColorDialog | CColorDialog Vytvoří objekt. |
Veřejné metody
| Jméno | popis |
|---|---|
| CColorDialog::D oModal | Zobrazí dialogové okno barvy a umožní uživateli provést výběr. |
| CColorDialog::GetColor | COLORREF Vrátí strukturu obsahující hodnoty vybrané barvy. |
| CColorDialog::GetSavedCustomColors | Načte vlastní barvy vytvořené uživatelem. |
| CColorDialog::SetCurrentColor | Vynutí aktuální výběr barvy na zadanou barvu. |
Chráněné metody
| Jméno | popis |
|---|---|
| CColorDialog::OnColorOK | Přepsání ověřte barvu zadaná do dialogového okna. |
Veřejné datové členy
| Jméno | popis |
|---|---|
| CColorDialog::m_cc | Struktura použitá k přizpůsobení nastavení dialogového okna. |
Poznámky
Objekt CColorDialog je dialogové okno se seznamem barev definovaných pro systém zobrazení. Uživatel může ze seznamu vybrat nebo vytvořit určitou barvu, která se pak při ukončení dialogového okna zobrazí zpět do aplikace.
Chcete-li vytvořit CColorDialog objekt, použijte zadaný konstruktor nebo odvození nové třídy a použijte vlastní konstruktor.
Po vytvoření dialogového okna můžete nastavit nebo upravit jakékoli hodnoty ve struktuře m_cc tak, aby inicializovaly hodnoty ovládacích prvků dialogového okna. Struktura m_cc je typu CHOOSECOLOR.
Po inicializaci ovládacích prvků dialogového okna zavolejte DoModal členskou funkci, aby zobrazila dialogové okno a povolila uživateli vybrat barvu. DoModal vrátí výběr uživatele tlačítka OK (IDOK) dialogového okna nebo zrušit (IDCANCEL).
Pokud DoModal vrátí idOK, můžete k načtení informací zadaných uživatelem použít některou z CColorDialogčlenských funkcí.
Pomocí funkce CommDlgExtendedError systému Windows můžete určit, jestli během inicializace dialogového okna došlo k chybě, a získat další informace o chybě.
CColorDialog spoléhá na soubor COMMDLG.DLL, který je dodáván s Windows verze 3.1 a novější.
Chcete-li přizpůsobit dialogové okno, odvodit třídu z CColorDialog, poskytnout vlastní šablonu dialogového okna a přidat mapu zpráv pro zpracování zpráv z rozšířených ovládacích prvků. Všechny nezpracované zprávy by měly být předány do základní třídy.
Přizpůsobení funkce háku se nevyžaduje.
Poznámka
V některých instalacích CColorDialog se objekt nezobrazí se šedým pozadím, pokud jste použili architekturu k tomu, aby ostatní CDialog objekty byly šedé.
Další informace o použití CColorDialognaleznete v tématu Běžné třídy dialogových oken
Hierarchie dědičnosti
CColorDialog
Požadavky
Hlavička: afxdlgs.h
CColorDialog::CColorDialog
CColorDialog Vytvoří objekt.
CColorDialog(
COLORREF clrInit = 0,
DWORD dwFlags = 0,
CWnd* pParentWnd = NULL);
Parametry
clrInit
Výchozí výběr barvy. Pokud není zadána žádná hodnota, výchozí hodnota je RGB(0,0;0) (černá).
dwFlags
Sada příznaků, které přizpůsobují funkci a vzhled dialogového okna. Další informace naleznete ve struktuře CHOOSECOLOR v sadě Windows SDK.
pParentWnd
Ukazatel na nadřazené okno nebo okno vlastníka dialogového okna
Příklad
// Show the Color dialog with all the default settings.
CColorDialog dlg1;
dlg1.DoModal();
// Show the fully opened Color dialog with red as the selected color.
CColorDialog dlg2(RGB(255, 0, 0), CC_FULLOPEN);
dlg2.DoModal();
CColorDialog::D oModal
Voláním této funkce zobrazíte dialogové okno Společné barvy Systému Windows a umožníte uživateli vybrat barvu.
virtual INT_PTR DoModal();
Vrácená hodnota
IDOK nebo IDCANCEL. Pokud je vrácena funkce IDCANCEL, zavolejte funkci CommDlgExtendedError systému Windows, abyste zjistili, zda došlo k chybě.
IDOK a IDCANCEL jsou konstanty, které označují, zda uživatel vybral tlačítko OK nebo Zrušit.
Poznámky
Pokud chcete inicializovat různé možnosti barevného dialogového okna nastavením členů struktury m_cc , měli byste to udělat před voláním DoModal , ale po vytvoření objektu dialogového okna.
Po volání můžete zavolat DoModaldalší členské funkce, které načtou nastavení nebo informace zadané uživatelem do dialogového okna.
Příklad
Podívejte se na příklad pro CColorDialog::CColorDialog.
CColorDialog::GetColor
Voláním této funkce načtěte DoModal informace o barvě vybraném uživatelem.
COLORREF GetColor() const;
Vrácená hodnota
Hodnota COLORREF, která obsahuje informace RGB pro barvu vybranou v dialogovém okně barva.
Příklad
// Get the selected color from the CColorDialog.
CColorDialog dlg;
if (dlg.DoModal() == IDOK)
{
COLORREF color = dlg.GetColor();
TRACE(_T("RGB value of the selected color - red = %u, ")
_T("green = %u, blue = %u\n"),
GetRValue(color), GetGValue(color), GetBValue(color));
}
CColorDialog::GetSavedCustomColors
CColorDialog objekty umožňují uživateli kromě výběru barev definovat až 16 vlastních barev.
static COLORREF* PASCAL GetSavedCustomColors();
Vrácená hodnota
Ukazatel na pole 16 barevných hodnot RGB, které ukládají vlastní barvy vytvořené uživatelem.
Poznámky
Členová GetSavedCustomColors funkce poskytuje přístup k těmto barvám. Tyto barvy lze načíst po vrácení idOK doModal .
Každá z 16 hodnot RGB ve vrácené matici se inicializuje na RGB(255 255 255) (bílá). Vlastní barvy vybrané uživatelem se ukládají pouze mezi vyvoláním dialogového okna v aplikaci. Pokud chcete tyto barvy uložit mezi vyvoláním aplikace, musíte je uložit jiným způsobem, například inicializací (). INI) soubor.
Příklad
// Get a pointer to an array of 16 RGB color values that stores
// custom colors created by the user from CColorDialog.
CColorDialog dlg;
if (dlg.DoModal() == IDOK)
{
COLORREF *ccolor = dlg.GetSavedCustomColors();
for (int i = 0; i < 16; i++)
{
TRACE(_T("RGB value of the selected color - red = %u, ")
_T("green = %u, blue = %u\n"),
GetRValue(ccolor[i]),
GetGValue(ccolor[i]),
GetBValue(ccolor[i]));
}
}
CColorDialog::m_cc
Struktura typu CHOOSECOLOR, jejíž členové ukládají vlastnosti a hodnoty dialogového okna.
CHOOSECOLOR m_cc;
Poznámky
Po vytvoření objektu CColorDialog můžete pomocí m_cc nastavit různé aspekty dialogového okna před voláním členské funkce DoModal .
Příklad
// The code below uses CColorDialog::m_cc data member to
// customize the settings of CColorDialog. The CColorDialog will
// be shown as full open and with red as the selected color.
CColorDialog dlg;
dlg.m_cc.Flags |= CC_FULLOPEN | CC_RGBINIT;
dlg.m_cc.rgbResult = RGB(255, 0, 0);
dlg.DoModal();
CColorDialog::OnColorOK
Přepsání ověřte barvu zadaná do dialogového okna.
virtual BOOL OnColorOK();
Vrácená hodnota
Nenulové, pokud by dialogové okno nemělo být zamítnuto; jinak 0 přijměte zadaná barva.
Poznámky
Tuto funkci přepište pouze v případě, že chcete zadat vlastní ověření barvy, kterou uživatel vybere v dialogovém okně barev.
Uživatel může vybrat barvu pomocí jedné z následujících dvou metod:
Klikněte na barvu na paletě barev. Hodnoty RGB vybrané barvy se pak projeví v příslušných polích pro úpravy RGB.
Zadávání hodnot do polí pro úpravy RGB
Přepsání OnColorOK umožňuje odmítnout barvu, kterou uživatel zadá do běžného barevného dialogového okna z jakéhokoli důvodu specifického pro aplikaci.
Za normálních okolností tuto funkci nemusíte používat, protože architektura poskytuje výchozí ověřování barev a zobrazí okno se zprávou, pokud je zadána neplatná barva.
Můžete volat SetCurrentColor z uvnitř OnColorOK vynutit výběr barvy. Jakmile OnColorOK se aktivuje (to znamená, že uživatel klikne na OK a přijme změnu barvy), můžete volat GetColor a získat hodnotu RGB nové barvy.
Příklad
// Override OnColorOK to validate the color entered to the
// Red, Green, and Blue edit controls. If the color
// is BLACK (i.e. RGB(0, 0,0)), then force the current color
// selection to be the color initially selected when the
// dialog box is created. The color dialog won't close so
// user can enter a new color.
BOOL CMyColorDlg::OnColorOK()
{
// Value in Red edit control.
COLORREF clrref = GetColor();
if (RGB(0, 0, 0) == clrref)
{
AfxMessageBox(_T("BLACK is not an acceptable color. ")
_T("Please enter a color again"));
// GetColor() returns initially selected color.
SetCurrentColor(GetColor());
// Won't dismiss color dialog.
return TRUE;
}
// OK to dismiss color dialog.
return FALSE;
}
CColorDialog::SetCurrentColor
Voláním této funkce vynutíte DoModal aktuální výběr barvy na hodnotu barvy zadanou v clr.
void SetCurrentColor(COLORREF clr);
Parametry
Clr
Hodnota barvy RGB.
Poznámky
Tato funkce je volána z obslužné rutiny zprávy nebo OnColorOK. Dialogové okno automaticky aktualizuje výběr uživatele na základě hodnoty parametru clr .
Příklad
Podívejte se na příklad pro CColorDialog::OnColorOK.
Viz také
MFC – ukázka MDI
MFC – ukázka DRAWCLI
CCommonDialog – třída
Graf hierarchie
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro