CMFCColorPickerCtrl-Klasse

Artikel
02/26/2013

Die Klasse stellt CMFCColorPickerCtrl-Funktionalität für ein Steuerelement, das verwendet wird, um Farben auszuwählen.

class CMFCColorPickerCtrl : public CButton

Mitglieder

Öffentliche Konstruktoren

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

Öffentliche Methoden

Name	Description
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 zur Farbe fest, die von der angegebenen RGB-Farbanteile oder das angegebene Zellenhexagon definiert ist.
CMFCColorPickerCtrl::SetColor	Legt die aktuelle Farbe am angegebenen RGB-Farbwert fest.
CMFCColorPickerCtrl::SetHLS	Legt die aktuelle Farbe am angegebenen HLS-Farbwert fest.
CMFCColorPickerCtrl::SetHue	Ändert die Farbtonkomponente der ausgewählten Farbe.
CMFCColorPickerCtrl::SetLuminance	Ändert die Leuchtdichtekomponente der ausgewählten Farbe.
CMFCColorPickerCtrl::SetLuminanceBarWidth	Gibt die Breite der Leuchtdichteleiste im Farben-Auswahlsteuerelement 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 ausgewählten Farbe.
CMFCColorPickerCtrl::SetType	Legt den Typ des Farben-Auswahlsteuerelements fest, um anzuzeigen.

Geschützte Methoden

Name	Description
CMFCColorPickerCtrl::DrawCursor	Aufgerufen vom Framework vor einem Cursor, der die ausgewählte Farbe zeigt, wird angezeigt.

Hinweise

Standardfarben werden von einer sechseckigen Farbpalette ausgewählt, und benutzerdefinierte Farben werden von einer Leuchtdichteleiste ausgewählt, in der Farben entweder mit roten/von Grün/der blauen Notation oder der Farbton-/satuarations-/Leuchtdichtenotation angegeben werden.

Die folgende Abbildung stellt einige CMFCColorPickerCtrl-Objekte dar.

CMFCColorPickerCtrl-Dialogfeld

CMFCColorPickerCtrl unterstützt zwei Paare Stile.Die HEXADEZIMAL- und HEX_GREYSCALE-Formate sind für Standardfarben-Auswahl geeignet.Die AUSWAHL- und LEUCHTDICHTEformate sind für benutzerdefinierte Farbauswahl geeignet.

Führen Sie die folgenden Schritte aus, um das CMFCColorPickerCtrl-Steuerelement in ein Dialogfeld zu enthalten:

Wenn Sie ClassWizard verwenden, fügen Sie ein neues Schaltflächensteuerelement in die Dialogfeldvorlage ein (da die CMFCColorPickerCtrl-Klasse von der Klasse geerbt wird CButton ).
Fügen Sie eine Membervariable ein, die mit dem neuen Schaltflächensteuerelement in die Dialogfeldklasse zugeordnet ist.Ändern Sie dann den Variablentyp von CButton zu CMFCColorPickerCtrl.
Fügen Sie den WM_INITDIALOG Meldungshandler für die Dialogfeldklasse ein.Legen Sie im Handler den Typ, die Palette und die ursprüngliche ausgewählte Farbe CMFCColorPickerCtrl des Steuerelements fest.

Beispiel

Das folgende Beispiel zeigt, wie ein Objekt CMFCColorPickerCtrl konfiguriert, indem verschiedene Methoden in der CMFCColorPickerCtrl-Klasse angewendet wird.Das Beispiel zeigt, wie der Typ des Auswahlsteuerelements festgelegt wird und wie Farbe, Farbton, Leuchtdichte und Sättigung festgelegt wird.Das Beispiel ist Teil Neue Kontrollprobe.

    CMFCColorPickerCtrl m_wndLum;


...


    // CPalette m_palSys
    // set the type of the color picker control
    m_wndLum.SetType(CMFCColorPickerCtrl::LUMINANCE);
    m_wndLum.SetPalette(&m_palSys);
    // set the color, hue, luminance and saturation of the color picker control
    m_wndLum.SetColor(RGB(0, 255, 0));
    m_wndLum.SetHue(0.5);
    m_wndLum.SetLuminance(2.5);
    m_wndLum.SetLuminanceBarWidth(10);
    m_wndLum.SetSaturation(0.5);