Freigeben über

CMFCColorPickerCtrl-Klasse

  • Artikel

Die CMFCColorPickerCtrl Klasse bietet Funktionen für ein Steuerelement, das zum Auswählen von Farben verwendet wird.

Syntax

class CMFCColorPickerCtrl : public CButton

Member

Öffentliche Konstruktoren

Name Beschreibung
CMFCColorPickerCtrl::CMFCColorPickerCtrl Erstellt ein CMFCColorPickerCtrl-Objekt.

Öffentliche Methoden

Name Beschreibung
CMFCColorPickerCtrl::GetColor Ruft die Farbe ab, die der Benutzer auswählt.
CMFCColorPickerCtrl::GetHLS Ruft die Farbton-, Leuchtdichte- und Sättigungswerte der Farbe ab, die der Benutzer auswählt.
CMFCColorPickerCtrl::GetHue Ruft die Farbtonkomponente der Farbe ab, die der Benutzer auswählt.
CMFCColorPickerCtrl::GetLuminance Ruft die Leuchtdichtekomponente der Farbe ab, die der Benutzer auswählt.
CMFCColorPickerCtrl::GetSaturation Ruft die Sättigungskomponente der Farbe ab, die der Benutzer auswählt.
CMFCColorPickerCtrl::SelectCellHexagon Legt die aktuelle Farbe auf die Farbe fest, die durch die angegebenen RGB-Farbkomponenten oder das angegebene Zellsechseck definiert wird.
CMFCColorPickerCtrl::SetColor Legt die aktuelle Farbe auf den angegebenen RGB-Farbwert fest.
CMFCColorPickerCtrl::SetHLS Legt die aktuelle Farbe auf den angegebenen HLS-Farbwert fest.
CMFCColorPickerCtrl::SetHue Ändert die Farbtonkomponente der aktuell ausgewählten Farbe.
CMFCColorPickerCtrl::SetLuminance Ändert die Leuchtdichtekomponente der aktuell ausgewählten Farbe.
CMFCColorPickerCtrl::SetLuminanceBarWidth Legt die Breite der Leuchtdichteleiste im Farbauswahl-Steuerelement fest.
CMFCColorPickerCtrl::SetOriginalColor Legt die ursprüngliche ausgewählte Farbe fest.
CMFCColorPickerCtrl::SetPalette Legt die aktuelle Farbpalette fest.
CMFCColorPickerCtrl::SetSaturation Ändert die Sättigungskomponente der aktuell ausgewählten Farbe.
CMFCColorPickerCtrl::SetType Legt den Typ des anzuzeigenden Farbauswahl-Steuerelements fest.

Geschützte Methoden

Name Beschreibung
CMFCColorPickerCtrl::DrawCursor Wird vom Framework aufgerufen, bevor ein Cursor angezeigt wird, der auf die ausgewählte Farbe zeigt.

Hinweise

Standardfarben werden aus einer sechseckigen Farbpalette ausgewählt, und benutzerdefinierte Farben werden aus einer Leuchtdichteleiste ausgewählt, bei der Farben entweder mit rot/grün/blauer Schreibweise oder farbton/Sättigung/Leuchtdichtenotation angegeben werden.

Die folgende Abbildung zeigt mehrere CMFCColorPickerCtrl Objekte.

CMFCColorPickerCtrl-Dialogfeld.

Die CMFCColorPickerCtrl beiden Formatvorlagenpaare werden unterstützt. Die HEX Formatvorlagen sind HEX_GREYSCALE für die Standardfarbauswahl geeignet. Die PICKER Formatvorlagen sind LUMINANCE für die benutzerdefinierte Farbauswahl geeignet.

Führen Sie die folgenden Schritte aus, um das CMFCColorPickerCtrl Steuerelement in Ihr Dialogfeld zu integrieren:

  1. Wenn Sie den ClassWizard verwenden, fügen Sie ein neues Schaltflächensteuerelement in ihre Dialogfeldvorlage ein (da die CMFCColorPickerCtrl Klasse von der CButton Klasse geerbt wird).

  2. Fügen Sie eine Membervariable ein, die dem neuen Schaltflächensteuerelement zugeordnet ist, in ihre Dialogfeldklasse ein. Ändern Sie dann den Variablentyp von CButton zu CMFCColorPickerCtrl.

  3. Fügen Sie den WM_INITDIALOG Nachrichtenhandler für die Dialogfeldklasse ein. Legen Sie im Handler den Typ, die Palette und die ursprüngliche ausgewählte Farbe des CMFCColorPickerCtrl Steuerelements fest.

Vererbungshierarchie

CObject
CCmdTarget
CWnd
CButton
CMFCColorPickerCtrl

Anforderungen

Header: afxcolorpickerctrl.h

CMFCColorPickerCtrl::CMFCColorPickerCtrl

Erstellt ein CMFCColorPickerCtrl-Objekt.

CMFCColorPickerCtrl();

Rückgabewert

Bemerkungen

CMFCColorPickerCtrl::DrawCursor

Wird vom Framework aufgerufen, bevor ein Cursor angezeigt wird, der auf die ausgewählte Farbe zeigt.

virtual void DrawCursor(
    CDC* pDC,
    const CRect& rect);

Parameter

pDC
[in] Zeiger auf einen Gerätekontext.

rect
[in] Gibt einen rechteckigen Bereich um die ausgewählte Farbe an.

Hinweise

Überschreiben Sie diese Methode, wenn Sie die Form des Cursors ändern müssen, der auf die ausgewählte Farbe zeigt.

CMFCColorPickerCtrl::GetColor

Ruft die Farbe ab, die der Benutzer auswählt.

COLORREF GetColor() const;

Rückgabewert

Der RGB-Wert der ausgewählten Farbe.

Hinweise

CMFCColorPickerCtrl::GetHLS

Ruft die Farbton-, Leuchtdichte- und Sättigungswerte der Farbe ab, die der Benutzer auswählt.

void GetHLS(
    double* hue,
    double* luminance,
    double* saturation);

Parameter

hue
[out] Zeiger auf eine Variable vom Typ Double, die Farbtoninformationen empfängt.

luminance
[out] Zeiger auf eine Variable vom Typ Double, die Leuchtdichteinformationen empfängt.

saturation
[out] Zeiger auf eine Variable vom Typ Double, die Sättigungsinformationen empfängt.

Hinweise

CMFCColorPickerCtrl::GetHue

Ruft die Farbtonkomponente der Farbe ab, die der Benutzer auswählt.

double GetHue() const;

Rückgabewert

Die Farbtonkomponente der ausgewählten Farbe.

Hinweise

CMFCColorPickerCtrl::GetLuminance

Ruft die Leuchtdichtekomponente der Farbe ab, die der Benutzer auswählt.

double GetLuminance() const;

Rückgabewert

Die Leuchtdichtekomponente der ausgewählten Farbe.

Hinweise

CMFCColorPickerCtrl::GetSaturation

Ruft den Sättigungswert der Farbe ab, die der Benutzer auswählt.

double GetSaturation() const;

Rückgabewert

Die Sättigungskomponente der ausgewählten Farbe.

Hinweise

CMFCColorPickerCtrl::SelectCellHexagon

Legt die aktuelle Farbe auf die Farbe fest, die durch die angegebenen RGB-Farbkomponenten oder das angegebene Zellsechseck definiert wird.

void SelectCellHexagon(
    BYTE R,
    BYTE G,
    BYTE B);

BOOL SelectCellHexagon(
    int x,
    int y);

Parameter

R
[in] Die rote Farbkomponente.

G
[in] Die grüne Farbkomponente.

B
[in] Die blaue Farbkomponente.

x
[in] Die x-Koordinate des Cursors, die auf ein Zellsechseck zeigt.

y
[in] Die y-Koordinate des Cursors, die auf ein Zellsechseck zeigt.

Rückgabewert

Die zweite Überladung dieser Methode gibt immer FALSE zurück.

Hinweise

Die erste Überladung dieser Methode legt die aktuelle Farbe auf die Farbe fest, die den angegebenen Rot-, Grün- und Blaufarbenkomponenten des Farbauswahlsteuerelements entspricht.

Die zweite Überladung dieser Methode legt die aktuelle Farbe auf die Farbe des Zellsecks fest, auf das durch die angegebene Cursorposition verwiesen wird.

CMFCColorPickerCtrl::SetColor

Legt die aktuelle Farbe auf den angegebenen RGB-Farbwert fest.

void SetColor(COLORREF Color);

Parameter

Color
[in] Ein RGB-Farbwert.

Hinweise

CMFCColorPickerCtrl::SetHLS

Legt die aktuelle Farbe auf den angegebenen HLS-Farbwert fest.

void SetHLS(
    double hue,
    double luminance,
    double saturation,
    BOOL bInvalidate=TRUE);

Parameter

hue
[in] Ein Farbtonwert.

luminance
[in] Ein Leuchtdichtewert.

saturation
[in] Ein Sättigungswert.

bInvalidate
[in] TRUE um zu erzwingen, dass das Fenster sofort auf die neue Farbe aktualisiert wird; andernfalls . FALSE Der Standardwert ist TRUE.

Hinweise

CMFCColorPickerCtrl::SetHue

Ändert den Farbton der aktuell ausgewählten Farbe.

void SetHue(double Hue);

Parameter

Hue
[in] Ein Farbtonwert.

Hinweise

CMFCColorPickerCtrl::SetLuminance

Ändert die Leuchtdichte der aktuell ausgewählten Farbe.

void SetLuminance(double Luminance);

Parameter

Luminance
[in] Ein Leuchtdichtewert.

Hinweise

CMFCColorPickerCtrl::SetLuminanceBarWidth

Legt die Breite der Leuchtdichteleiste im Farbauswahl-Steuerelement fest.

void SetLuminanceBarWidth(int w);

Parameter

w
[in] Die Breite des Leuchtdichtebalkens in Pixeln.

Hinweise

Verwenden Sie diese Methode, um die Größe der Leuchtdichteleiste zu ändern, die sich auf der Registerkarte "Benutzerdefiniert " des Farbauswahl-Steuerelements befindet. Der w Parameter gibt die neue Breite des Leuchtdichtebalkens an. Der Breiteswert wird ignoriert, wenn er drei Viertel der Clientbereichsbreite überschreitet.

CMFCColorPickerCtrl::SetOriginalColor

Legt die ursprüngliche ausgewählte Farbe fest.

void SetOriginalColor(COLORREF ref);

Parameter

ref
[in] Ein RGB-Farbwert.

Hinweise

Rufen Sie diese Methode auf, wenn das Farbauswahlsteuerelement initialisiert wird.

CMFCColorPickerCtrl::SetPalette

Legt die aktuelle Farbpalette fest.

void SetPalette(CPalette* pPalette);

Parameter

pPalette
[in] Zeiger auf eine Farbpalette.

Hinweise

Die Farbpalette definiert das Array von Farben, die im Farbauswahlsteuerelement dargestellt werden.

CMFCColorPickerCtrl::SetSaturation

Ändert die Sättigung der aktuell ausgewählten Farbe.

void SetSaturation(double Saturation);

Parameter

Saturation
[in] Ein Sättigungswert.

Hinweise

CMFCColorPickerCtrl::SetType

Legt den Typ des anzuzeigenden Farbauswahl-Steuerelements fest.

void SetType(COLORTYPE colorType);

Parameter

colorType
[in] Ein Farbauswahl-Steuerelementtyp.

Die Typen werden durch die CMFCColorPickerCtrl::COLORTYPE Enumeration definiert. Die möglichen Typen sind LUMINANCE, PICKERHEX und HEX_GREYSCALE. Der Standardtyp ist PICKER.

Hinweise

Um einen Farbauswahl-Steuerelementtyp anzugeben, rufen Sie diese Methode auf, bevor das Windows-Steuerelement erstellt wird.

Siehe auch

Hierarchiediagramm
Klassen
CMFCColorDialog Klasse