Freigeben über


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

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

CMFCColorDialog

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.

Hinweise

Weitere Informationen

Hierarchiediagramm
Klassen
CMFCColorPickerCtrl-Klasse