Share via

Klasse CMFCColorPickerCtrl

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

De CMFCColorPickerCtrl klasse biedt functionaliteit voor een besturingselement dat wordt gebruikt om kleuren te selecteren.

Syntaxis

class CMFCColorPickerCtrl : public CButton

Leden

Openbare constructors

Naam Description
CMFCColorPickerCtrl::CMFCColorPickerCtrl Maakt een CMFCColorPickerCtrl object.

Openbare methoden

Naam Description
CMFCColorPickerCtrl::GetColor Hiermee haalt u de kleur op die de gebruiker selecteert.
CMFCColorPickerCtrl::GetHLS Haalt de tint-, luminantie- en verzadigingswaarden op van de kleur die de gebruiker selecteert.
CMFCColorPickerCtrl::GetHue Hiermee haalt u het tintonderdeel op van de kleur die de gebruiker selecteert.
CMFCColorPickerCtrl::GetLuminance Hiermee haalt u het luminantieonderdeel op van de kleur die de gebruiker selecteert.
CMFCColorPickerCtrl::GetSaturation Hiermee wordt het verzadigingsonderdeel opgehaald van de kleur die de gebruiker selecteert.
CMFCColorPickerCtrl::SelectCellHexagon Hiermee stelt u de huidige kleur in op de kleur die is gedefinieerd door de opgegeven RGB-kleuronderdelen of de opgegeven celhexagon.
CMFCColorPickerCtrl::SetColor Hiermee stelt u de huidige kleur in op de opgegeven RGB-kleurwaarde.
CMFCColorPickerCtrl::SetHLS Hiermee stelt u de huidige kleur in op de opgegeven HLS-kleurwaarde.
CMFCColorPickerCtrl::SetHue Hiermee wijzigt u het tintonderdeel van de geselecteerde kleur.
CMFCColorPickerCtrl::SetLuminance Hiermee wijzigt u het luminantieonderdeel van de geselecteerde kleur.
CMFCColorPickerCtrl::SetLuminanceBarWidth Hiermee stelt u de breedte van de luminantiebalk in het besturingselement kleurkiezer in.
CMFCColorPickerCtrl::SetOriginalColor Hiermee stelt u de oorspronkelijke geselecteerde kleur in.
CMFCColorPickerCtrl::SetPalette Hiermee stelt u het huidige kleurenpalet in.
CMFCColorPickerCtrl::SetSaturation Hiermee wijzigt u het verzadigingsonderdeel van de geselecteerde kleur.
CMFCColorPickerCtrl::SetType Hiermee stelt u het type besturingselement voor kleurkiezer in om weer te geven.

Beveiligde methoden

Naam Description
CMFCColorPickerCtrl::DrawCursor Aangeroepen door het framework voordat een cursor die verwijst naar de geselecteerde kleur wordt weergegeven.

Opmerkingen

Standaardkleuren worden geselecteerd in een hexagonaal kleurenpalet en aangepaste kleuren worden geselecteerd op een luminantiebalk waarin kleuren worden opgegeven met behulp van rode/groene/blauwe notatie of tint/verzadiging/luminantienotatie.

In de volgende afbeelding ziet u verschillende CMFCColorPickerCtrl objecten.

Het dialoogvenster CMFCColorPickerCtrl.

De CMFCColorPickerCtrl functie ondersteunt twee paren stijlen. De HEX stijlen en HEX_GREYSCALE stijlen zijn geschikt voor standaardkleurselectie. De PICKER stijlen en LUMINANCE stijlen zijn geschikt voor aangepaste kleurselectie.

Voer de volgende stappen uit om het besturingselement op te nemen in het CMFCColorPickerCtrl dialoogvenster:

  1. Als u de ClassWizard gebruikt, voegt u een nieuw knop besturingselement in uw dialoogvenstersjabloon in (omdat de CMFCColorPickerCtrl klasse wordt overgenomen van de CButton klasse).

  2. Voeg een lidvariabele in die is gekoppeld aan het nieuwe knop besturingselement in de dialoogvensterklasse. Wijzig vervolgens het variabeletype van CButton in CMFCColorPickerCtrl.

  3. Voeg de WM_INITDIALOG berichthandler voor de dialoogvensterklasse in. Stel in de handler het type, palet en de oorspronkelijke geselecteerde kleur van het CMFCColorPickerCtrl besturingselement in.

Overnamehiërarchie

CObject
CCmdTarget
CWnd
CButton
CMFCColorPickerCtrl

Requirements

Rubriek:afxcolorpickerctrl.h

CMFCColorPickerCtrl::CMFCColorPickerCtrl

Maakt een CMFCColorPickerCtrl object.

CMFCColorPickerCtrl();

Retourwaarde

Opmerkingen

CMFCColorPickerCtrl::DrawCursor

Aangeroepen door het framework voordat een cursor die verwijst naar de geselecteerde kleur wordt weergegeven.

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

Parameterwaarden

pDC
[in] Aanwijzer naar een apparaatcontext.

rect
[in] Hiermee geeft u een rechthoekig gebied rond de geselecteerde kleur.

Opmerkingen

Overschrijf deze methode wanneer u de vorm van de cursor wilt wijzigen die verwijst naar de geselecteerde kleur.

CMFCColorPickerCtrl::GetColor

Hiermee haalt u de kleur op die de gebruiker selecteert.

COLORREF GetColor() const;

Retourwaarde

De RGB-waarde van de geselecteerde kleur.

Opmerkingen

CMFCColorPickerCtrl::GetHLS

Haalt de tint-, luminantie- en verzadigingswaarden op van de kleur die de gebruiker selecteert.

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

Parameterwaarden

hue
[uit] Wijs een variabele van het type double aan die tintinformatie ontvangt.

luminance
[uit] Wijs een variabele van het type double aan die luminantie-informatie ontvangt.

saturation
[uit] Aanwijzer naar een variabele van het type double die verzadigingsinformatie ontvangt.

Opmerkingen

CMFCColorPickerCtrl::GetHue

Hiermee haalt u het tintonderdeel op van de kleur die de gebruiker selecteert.

double GetHue() const;

Retourwaarde

Het tintgedeelte van de geselecteerde kleur.

Opmerkingen

CMFCColorPickerCtrl::GetLuminance

Hiermee haalt u het luminantieonderdeel op van de kleur die de gebruiker selecteert.

double GetLuminance() const;

Retourwaarde

Het luminantieonderdeel van de geselecteerde kleur.

Opmerkingen

CMFCColorPickerCtrl::GetSaturation

Haalt de verzadigingswaarde op van de kleur die de gebruiker selecteert.

double GetSaturation() const;

Retourwaarde

Het verzadigingsonderdeel van de geselecteerde kleur.

Opmerkingen

CMFCColorPickerCtrl::SelectCellHexagon

Hiermee stelt u de huidige kleur in op de kleur die is gedefinieerd door de opgegeven RGB-kleuronderdelen of de opgegeven celhexagon.

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

BOOL SelectCellHexagon(
    int x,
    int y);

Parameterwaarden

R
[in] Het rode kleuronderdeel.

G
[in] Het groene kleuronderdeel.

B
[in] Het blauwe kleuronderdeel.

x
[in] De x-coördinaat van de cursor, die verwijst naar een celhexagon.

y
[in] De y-coördinaat van de cursor, die verwijst naar een celhexagon.

Retourwaarde

De tweede overbelasting van deze methode retourneert altijd FALSE.

Opmerkingen

Met de eerste overbelasting van deze methode wordt de huidige kleur ingesteld op de kleur die overeenkomt met de opgegeven rode, groene en blauwe kleuronderdelen van het besturingselement voor kleurselectie.

Met de tweede overbelasting van deze methode wordt de huidige kleur ingesteld op de kleur van de zeshoek van de cel waarnaar wordt verwezen door de opgegeven cursorlocatie.

CMFCColorPickerCtrl::SetColor

Hiermee stelt u de huidige kleur in op de opgegeven RGB-kleurwaarde.

void SetColor(COLORREF Color);

Parameterwaarden

Color
[in] Een RGB-kleurwaarde.

Opmerkingen

CMFCColorPickerCtrl::SetHLS

Hiermee stelt u de huidige kleur in op de opgegeven HLS-kleurwaarde.

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

Parameterwaarden

hue
[in] Een tintwaarde.

luminance
[in] Een luminantiewaarde.

saturation
[in] Een verzadigingswaarde.

bInvalidate
[in] TRUE om te forceren dat het venster onmiddellijk wordt bijgewerkt naar de nieuwe kleur; anders, FALSE. De standaardwaarde is TRUE.

Opmerkingen

CMFCColorPickerCtrl::SetHue

Hiermee wijzigt u de tint van de geselecteerde kleur.

void SetHue(double Hue);

Parameterwaarden

Hue
[in] Een tintwaarde.

Opmerkingen

CMFCColorPickerCtrl::SetLuminance

Hiermee wijzigt u de helderheid van de geselecteerde kleur.

void SetLuminance(double Luminance);

Parameterwaarden

Luminance
[in] Een luminantiewaarde.

Opmerkingen

CMFCColorPickerCtrl::SetLuminanceBarWidth

Hiermee stelt u de breedte van de luminantiebalk in het besturingselement kleurkiezer in.

void SetLuminanceBarWidth(int w);

Parameterwaarden

w
[in] De breedte van de luminantiebalk gemeten in pixels.

Opmerkingen

Gebruik deze methode om het formaat van de luminantiebalk te wijzigen, die zich op het tabblad Aangepast van het besturingselement kleurkiezer bevindt. De w parameter geeft de nieuwe breedte van de luminantiebalk aan. De breedtewaarde wordt genegeerd als deze groter is dan drie vierde van de breedte van het clientgebied.

CMFCColorPickerCtrl::SetOriginalColor

Hiermee stelt u de oorspronkelijke geselecteerde kleur in.

void SetOriginalColor(COLORREF ref);

Parameterwaarden

ref
[in] Een RGB-kleurwaarde.

Opmerkingen

Roep deze methode aan wanneer het besturingselement kleurkiezer wordt geïnitialiseerd.

CMFCColorPickerCtrl::SetPalette

Hiermee stelt u het huidige kleurenpalet in.

void SetPalette(CPalette* pPalette);

Parameterwaarden

pPalette
[in] Wijs een kleurenpalet aan.

Opmerkingen

Het kleurenpalet definieert de matrix met kleuren die in het besturingselement kleurkiezer wordt weergegeven.

CMFCColorPickerCtrl::SetSaturation

Hiermee wijzigt u de verzadiging van de geselecteerde kleur.

void SetSaturation(double Saturation);

Parameterwaarden

Saturation
[in] Een verzadigingswaarde.

Opmerkingen

CMFCColorPickerCtrl::SetType

Hiermee stelt u het type besturingselement voor kleurkiezer in om weer te geven.

void SetType(COLORTYPE colorType);

Parameterwaarden

colorType
[in] Een besturingselementtype kleurkiezer.

De typen worden gedefinieerd door de CMFCColorPickerCtrl::COLORTYPE opsomming. De mogelijke typen zijn LUMINANCE, PICKERen HEXHEX_GREYSCALE. Het standaardtype is PICKER.

Opmerkingen

Als u een besturingselementtype voor een kleurkiezer wilt opgeven, roept u deze methode aan voordat het Windows-besturingselement wordt gemaakt.

Zie ook

Hiërarchiegrafiek
Klassen
CMFCColorDialog klasse

  • Last updated on