CMFCColorPickerCtrl, classe

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

Méthodes publiques

Méthodes protégées

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 luminosité où les couleurs sont spécifiées à l’aide de notation rouge/vert/bleu ou teinte/saturation/luminance.

L’illustration suivante illustre plusieurs CMFCColorPickerCtrl objets.

Les CMFCColorPickerCtrl deux paires de styles sont pris en charge. Les HEX styles et HEX_GREYSCALE les styles sont appropriés pour la sélection de couleur standard. Les PICKER styles et LUMINANCE les styles 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.

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::DrawCursor

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

hue
[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

Color
[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

hue
[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. Par défaut, il s’agit de TRUE.

Notes

CMFCColorPickerCtrl::SetHue

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

void SetHue(double Hue);

Paramètres

Hue
[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 w paramètre 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, PICKERHEX 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