Share via

CMFCColorPickerCtrl, classe

  • Article

La CMFCColorPickerCtrl classe fournit des fonctionnalités pour un contrôle utilisé pour sélectionner des couleurs.

Syntaxe

class CMFCColorPickerCtrl : public CButton

Membres

Constructeurs publics

Nom Description
CMFCColorPickerCtrl ::CMFCColorPickerCtrl Construit un objet CMFCColorPickerCtrl.

Méthodes publiques

Nom Description
CMFCColorPickerCtrl ::GetColor Récupère la couleur sélectionnée par l’utilisateur.
CMFCColorPickerCtrl ::GetHLS Récupère les valeurs de teinte, de luminosité et de saturation de la couleur sélectionnée par l’utilisateur.
CMFCColorPickerCtrl ::GetHue Récupère le composant de teinte de la couleur sélectionnée par l’utilisateur.
CMFCColorPickerCtrl ::GetLuminance Récupère le composant luminance de la couleur sélectionnée par l’utilisateur.
CMFCColorPickerCtrl ::GetSaturation Récupère le composant de saturation de la couleur sélectionnée par l’utilisateur.
CMFCColorPickerCtrl ::SelectCellHexagon Définit la couleur actuelle sur la couleur définie par les composants de couleur RVB spécifiés ou l’hexagone de cellule spécifié.
CMFCColorPickerCtrl ::SetColor Définit la couleur actuelle sur la valeur de couleur RVB spécifiée.
CMFCColorPickerCtrl ::SetHLS Définit la couleur actuelle sur la valeur de couleur HLS spécifiée.
CMFCColorPickerCtrl ::SetHue Modifie le composant de teinte de la couleur actuellement sélectionnée.
CMFCColorPickerCtrl ::SetLuminance Modifie le composant de luminosité de la couleur actuellement sélectionnée.
CMFCColorPickerCtrl ::SetLuminanceBarWidth Définit la largeur de la barre de luminance dans le contrôle sélecteur de couleurs.
CMFCColorPickerCtrl ::SetOriginalColor Définit la couleur initiale sélectionnée.
CMFCColorPickerCtrl ::SetPalette Définit la palette de couleurs actuelle.
CMFCColorPickerCtrl ::SetSaturation Modifie le composant de saturation de la couleur actuellement sélectionnée.
CMFCColorPickerCtrl ::SetType Définit le type de contrôle sélecteur de couleurs à afficher.

Méthodes protégées

Nom Description
CMFCColorPickerCtrl ::D rawCursor Appelé par l’infrastructure avant qu’un curseur pointant vers la couleur sélectionnée s’affiche.

Notes

Les couleurs standard sont sélectionnées à partir d’une palette de couleurs hexagonales, et les couleurs personnalisées sont sélectionnées à partir d’une barre de luminance où les couleurs sont spécifiées à l’aide de notation rouge/vert/bleu ou teinte/satuaration/luminance.

L’illustration suivante illustre plusieurs CMFCColorPickerCtrl objets.

CMFCColorPickerCtrl dialog box.

Les CMFCColorPickerCtrl deux paires de styles sont pris en charge. Les styles HEX et HEX_GREYSCALE conviennent à la sélection de couleur standard. Les styles PICKER et LUMINANCE sont appropriés pour la sélection de couleurs personnalisée.

Procédez comme suit pour incorporer le CMFCColorPickerCtrl contrôle dans votre boîte de dialogue :

  1. Si vous utilisez ClassWizard, insérez un nouveau contrôle bouton dans votre modèle de boîte de dialogue (car la CMFCColorPickerCtrl classe est héritée de la CButton classe).

  2. Insérez une variable membre associée au nouveau contrôle bouton dans votre classe de boîte de dialogue. Ensuite, remplacez le type de CButton variable par CMFCColorPickerCtrl.

  3. Insérez le WM_INITDIALOG gestionnaire de messages pour la classe de boîte de dialogue. Dans le gestionnaire, définissez le type, la palette et la couleur initiale sélectionnée du CMFCColorPickerCtrl contrôle.

Exemple

L’exemple suivant montre comment configurer un CMFCColorPickerCtrl objet à l’aide de différentes méthodes dans la CMFCColorPickerCtrl classe. L’exemple montre comment définir le type du contrôle sélecteur et comment définir sa couleur, sa teinte, sa luminosité et sa saturation. L’exemple fait partie de l’exemple New Controls.

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);

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CButton

CMFCColorPickerCtrl

Spécifications

En-tête : afxcolorpickerctrl.h

CMFCColorPickerCtrl ::CMFCColorPickerCtrl

Construit un objet CMFCColorPickerCtrl.

CMFCColorPickerCtrl();

Valeur de retour

Notes

CMFCColorPickerCtrl ::D rawCursor

Appelé par l’infrastructure avant qu’un curseur pointant vers la couleur sélectionnée s’affiche.

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

Paramètres

pDC
[in] Pointeur vers un contexte d’appareil.

Rect
[in] Spécifie une zone rectangulaire autour de la couleur sélectionnée.

Notes

Remplacez cette méthode lorsque vous devez modifier la forme du curseur qui pointe vers la couleur sélectionnée.

CMFCColorPickerCtrl ::GetColor

Récupère la couleur sélectionnée par l’utilisateur.

COLORREF GetColor() const;

Valeur de retour

Valeur RVB de la couleur sélectionnée.

Notes

CMFCColorPickerCtrl ::GetHLS

Récupère les valeurs de teinte, de luminosité et de saturation de la couleur sélectionnée par l’utilisateur.

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

Paramètres

Teinte
[out] Pointeur vers une variable de type double qui reçoit des informations de teinte.

Luminance
[out] Pointeur vers une variable de type double qui reçoit des informations de luminosité.

Saturation
[out] Pointeur vers une variable de type double qui reçoit des informations de saturation.

Notes

CMFCColorPickerCtrl ::GetHue

Récupère le composant de teinte de la couleur sélectionnée par l’utilisateur.

double GetHue() const;

Valeur de retour

Composant de teinte de la couleur sélectionnée.

Notes

CMFCColorPickerCtrl ::GetLuminance

Récupère le composant luminance de la couleur sélectionnée par l’utilisateur.

double GetLuminance() const;

Valeur de retour

Composant de luminosité de la couleur sélectionnée.

Notes

CMFCColorPickerCtrl ::GetSaturation

Récupère la valeur de saturation de la couleur sélectionnée par l’utilisateur.

double GetSaturation() const;

Valeur de retour

Composant de saturation de la couleur sélectionnée.

Notes

CMFCColorPickerCtrl ::SelectCellHexagon

Définit la couleur actuelle sur la couleur définie par les composants de couleur RVB spécifiés ou l’hexagone de cellule spécifié.

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

BOOL SelectCellHexagon(
    int x,
    int y);

Paramètres

R
[in] Composant de couleur rouge.

G
[in] Composant couleur verte.

B
[in] Composant couleur bleue.

x
[in] Coordonnée x du curseur, qui pointe vers un hexagone de cellule.

y
[in] Coordonnée y du curseur, qui pointe vers un hexagone de cellule.

Valeur de retour

La deuxième surcharge de cette méthode retourne toujours FALSE.

Notes

La première surcharge de cette méthode définit la couleur actuelle sur la couleur qui correspond aux composants de couleur spécifiés par le contrôle de sélection de couleur rouge, vert et bleu.

La deuxième surcharge de cette méthode définit la couleur actuelle sur la couleur de l’hexagone de cellule pointée par l’emplacement du curseur spécifié.

CMFCColorPickerCtrl ::SetColor

Définit la couleur actuelle sur la valeur de couleur RVB spécifiée.

void SetColor(COLORREF Color);

Paramètres

Couleur
[in] Valeur de couleur RVB.

Notes

CMFCColorPickerCtrl ::SetHLS

Définit la couleur actuelle sur la valeur de couleur HLS spécifiée.

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

Paramètres

Teinte
[in] Valeur de teinte.

Luminance
[in] Valeur de luminance.

Saturation
[in] Valeur de saturation.

bInvalidate
[in] TRUE pour forcer la fenêtre à mettre immédiatement à jour la nouvelle couleur ; sinon, FALSE. La valeur par défaut est TRUE.

Notes

CMFCColorPickerCtrl ::SetHue

Modifie la teinte de la couleur actuellement sélectionnée.

void SetHue(double Hue);

Paramètres

Teinte
[in] Valeur de teinte.

Notes

CMFCColorPickerCtrl ::SetLuminance

Modifie la luminosité de la couleur actuellement sélectionnée.

void SetLuminance(double Luminance);

Paramètres

Luminance
[in] Valeur de luminance.

Notes

CMFCColorPickerCtrl ::SetLuminanceBarWidth

Définit la largeur de la barre de luminance dans le contrôle sélecteur de couleurs.

void SetLuminanceBarWidth(int w);

Paramètres

w
[in] Largeur de la barre de luminance mesurée en pixels.

Notes

Utilisez cette méthode pour redimensionner la barre de luminance, qui se trouve sous l’onglet Personnalisé du contrôle sélecteur de couleurs. Le paramètre w spécifie la nouvelle largeur de la barre de luminance. La valeur de largeur est ignorée si elle dépasse les trois quarts de la largeur de la zone cliente.

CMFCColorPickerCtrl ::SetOriginalColor

Définit la couleur initiale sélectionnée.

void SetOriginalColor(COLORREF ref);

Paramètres

ref
[in] Valeur de couleur RVB.

Notes

Appelez cette méthode lorsque le contrôle sélecteur de couleurs est initialisé.

CMFCColorPickerCtrl ::SetPalette

Définit la palette de couleurs actuelle.

void SetPalette(CPalette* pPalette);

Paramètres

pPalette
[in] Pointeur vers une palette de couleurs.

Notes

La palette de couleurs définit le tableau de couleurs présenté dans le contrôle sélecteur de couleurs.

CMFCColorPickerCtrl ::SetSaturation

Modifie la saturation de la couleur actuellement sélectionnée.

void SetSaturation(double Saturation);

Paramètres

Saturation
[in] Valeur de saturation.

Notes

CMFCColorPickerCtrl ::SetType

Définit le type de contrôle sélecteur de couleurs à afficher.

void SetType(COLORTYPE colorType);

Paramètres

Colortype
[in] Type de contrôle sélecteur de couleurs.

Les types sont définis par l’énumération CMFCColorPickerCtrl::COLORTYPE . Les types possibles sont LUMINANCE, PICKER, HEX et HEX_GREYSCALE. Le type par défaut est PICKER.

Notes

Pour spécifier un type de contrôle sélecteur de couleurs, appelez cette méthode avant la création du contrôle Windows.

Voir aussi

Graphique hiérarchique
Classes
CMFCColorDialog, classe