CMFCColorDialog-Klasse
Die CMFCColorDialog Klasse stellt ein Dialogfeld für die Farbauswahl dar.
Syntax
class CMFCColorDialog : public CDialogEx
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CMFCColorDialog::CMFCColorDialog | Erstellt ein CMFCColorDialog-Objekt. |
CMFCColorDialog::~CMFCColorDialog |
Destruktor. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CMFCColorDialog::GetColor | Gibt die aktuelle ausgewählte Farbe zurück. |
| CMFCColorDialog::GetPalette | Gibt die Palette der Farbe zurück. |
CMFCColorDialog::PreTranslateMessage |
Übersetzt Fensternachrichten, bevor sie an die Windows-Funktionen TranslateMessage und DispatchMessage verteilt werden. Syntax und weitere Informationen finden Sie unter "CWnd::P reTranslateMessage". (Überschreibt CDialogEx::PreTranslateMessage.) |
| CMFCColorDialog::RebuildPalette | Leitet eine Palette von der Systempalette ab. |
| CMFCColorDialog::SetCurrentColor | Legt die aktuelle ausgewählte Farbe fest. |
| CMFCColorDialog::SetNewColor | Legt die Farbe fest, die einem angegebenen RGB-Wert am ehesten entspricht. |
| CMFCColorDialog::SetPageOne | Wählt einen RGB-Wert für die erste Eigenschaftenseite aus. |
| CMFCColorDialog::SetPageTwo | Wählt einen RGB-Wert für die zweite Eigenschaftenseite aus. |
Geschützte Datenmember
| Name | Beschreibung |
|---|---|
m_bIsMyPalette |
TRUE, wenn das Dialogfeld für die Farbauswahl eine eigene Farbpalette verwendet, oder FALSE, wenn im Dialogfeld eine Palette verwendet wird, die CMFCColorDialog im Konstruktor angegeben ist. |
m_bPickerMode |
TRUE, während der Benutzer im Auswahldialogfeld eine Farbe auswählt; andernfalls FALSE. |
m_btnColorSelect |
Die Farbschaltfläche, die der Benutzer ausgewählt hat. |
m_CurrentColor |
Die aktuell ausgewählte Farbe. |
m_hcurPicker |
Der Cursor, der zum Auswählen einer Farbe verwendet wird. |
m_NewColor |
Die potenzielle ausgewählte Farbe, die dauerhaft ausgewählt oder auf die Originalfarbe zurückgesetzt werden kann. |
m_pColourSheetOne |
Ein Zeiger auf die erste Eigenschaftenseite des Eigenschaftenblatts für die Farbauswahl. |
m_pColourSheetTwo |
Ein Zeiger auf die zweite Eigenschaftenseite des Eigenschaftenblatts für die Farbauswahl. |
m_pPalette |
Die aktuelle logische Palette. |
m_pPropSheet |
Ein Zeiger auf das Eigenschaftenblatt für das Dialogfeld für die Farbauswahl. |
m_wndColors |
Ein Steuerelementobjekt für die Farbauswahl. |
m_wndStaticPlaceHolder |
Ein statisches Steuerelement, das ein Platzhalter für das Eigenschaftenblatt der Farbauswahl ist. |
Hinweise
Das Dialogfeld "Farbauswahl" wird als Eigenschaftenblatt mit zwei Seiten angezeigt. Auf der ersten Seite wählen Sie eine Standardfarbe aus der Systempalette aus. auf der zweiten Seite wählen Sie eine benutzerdefinierte Farbe aus.
Sie können ein CMFCColorDialog Objekt auf dem Stapel erstellen und dann aufrufen DoModalund dann die ursprüngliche Farbe als Parameter an den CMFCColorDialog Konstruktor übergeben. Anschließend erstellt das Dialogfeld "Farbauswahl" mehrere CMFCColorPickerCtrl-Klassenobjekte , um jede Farbpalette zu behandeln.
Vererbungshierarchie
Beispiel
Im folgenden Beispiel wird das Konfigurieren eines Farbdialogfelds mithilfe verschiedener Methoden in der CMFCColorDialog Klasse veranschaulicht. Das Beispiel zeigt, wie die aktuellen und die neuen Farben des Dialogfelds festgelegt werden und wie die roten, grünen und blauen Komponenten einer ausgewählten Farbe auf den beiden Eigenschaftenseiten des Farbdialogfelds festgelegt werden. Dieses Beispiel ist Teil des Beispiels "Neue Steuerelemente".
// 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);
Anforderungen
Kopfzeile: afxcolordialog.h
CMFCColorDialog::CMFCColorDialog
Erstellt ein CMFCColorDialog-Objekt.
CMFCColorDialog(
COLORREF clrInit=0,
DWORD dwFlags=0,
CWnd* pParentWnd=NULL,
HPALETTE hPal=NULL);
Parameter
clrInit
[in] Die Standardfarbauswahl. Wenn kein Wert angegeben ist, ist der Standardwert RGB(0,0,0) (schwarz).
dwFlags
[in]: Reserviert
pParentWnd
[in] Ein Zeiger auf das übergeordnete Oder Besitzerfenster des Dialogfelds.
hPal
[in] Ein Handle für eine Farbpalette.
Rückgabewert
Bemerkungen
CMFCColorDialog::GetColor
Ruft die Farbe ab, die der Benutzer aus dem Farbdialogfeld auswählt.
COLORREF GetColor() const;
Rückgabewert
Ein COLORREF-Wert , der die RGB-Informationen für die im Farbdialogfeld ausgewählte Farbe enthält.
Hinweise
Rufen Sie diese Funktion nach dem Aufrufen der DoModal Methode auf.
CMFCColorDialog::GetPalette
Ruft die Farbpalette ab, die im aktuellen Farbdialogfeld verfügbar ist.
CPalette* GetPalette() const;
Rückgabewert
Ein Zeiger auf das CPalette Objekt, das im CMFCColorDialog Konstruktor angegeben wurde.
Hinweise
Die Farbpalette gibt die Farben an, die der Benutzer auswählen kann.
CMFCColorDialog::RebuildPalette
Leitet eine Palette von der Systempalette ab.
void RebuildPalette();
CMFCColorDialog::SetCurrentColor
Legt die aktuelle Farbe des Dialogfelds fest.
void SetCurrentColor(COLORREF rgb);
Parameter
RGB
[in] Ein RGB-Farbwert
Hinweise
CMFCColorDialog::SetNewColor
Legt die aktuelle Farbe auf die Farbe in der aktuellen Palette fest, die am ähnlichsten ist.
void SetNewColor(COLORREF rgb);
Parameter
RGB
[in] EIN COLORREF , das eine RGB-Farbe angibt.
Hinweise
CMFCColorDialog::SetPageOne
Gibt explizit die roten, grünen und blauen Komponenten einer ausgewählten Farbe auf der ersten Eigenschaftenseite eines Farbdialogfelds an.
void SetPageOne(
BYTE R,
BYTE G,
BYTE B);
Parameter
R
[in] Gibt die rote Komponente des RGB-Werts an.
G
[in] Gibt die grüne Komponente des RGB-Werts an.
B
[in] Gibt die blaue Komponente des RGB-Werts an.
Hinweise
CMFCColorDialog::SetPageTwo
Gibt explizit die roten, grünen und blauen Komponenten einer ausgewählten Farbe auf der zweiten Eigenschaftenseite eines Farbdialogfelds an.
void SetPageTwo(
BYTE R,
BYTE G,
BYTE B);
Parameter
R
[in] Gibt eine rote Komponente des RGB-Werts an.
G
[in] Gibt eine grüne Komponente eines RGB-Werts an.
B
[in] Gibt eine blaue Komponente eines RGB-Werts an.