Partager via


CMFCColorDialog, classe

La CMFCColorDialog classe représente une boîte de dialogue de sélection de couleurs.

Syntaxe

class CMFCColorDialog : public CDialogEx

Membres

Constructeurs publics

Nom Description
CMFCColorDialog ::CMFCColorDialog Construit un objet CMFCColorDialog.
CMFCColorDialog::~CMFCColorDialog Destructeur.

Méthodes publiques

Nom Description
CMFCColorDialog ::GetColor Retourne la couleur sélectionnée actuelle.
CMFCColorDialog ::GetPalette Retourne la palette de la couleur.
CMFCColorDialog::PreTranslateMessage Traduit les messages de fenêtre avant qu’ils ne soient distribués aux fonctions Windows TranslateMessage et DispatchMessage . Pour plus d’informations, consultez CWnd ::P reTranslateMessage. (Substitue CDialogEx::PreTranslateMessage.)
CMFCColorDialog ::RebuildPalette Dérive une palette de la palette système.
CMFCColorDialog ::SetCurrentColor Définit la couleur sélectionnée actuelle.
CMFCColorDialog ::SetNewColor Définit la couleur la plus équivalente à une valeur RVB spécifiée.
CMFCColorDialog ::SetPageOne Sélectionne une valeur RVB pour la première page de propriétés.
CMFCColorDialog ::SetPageTwo Sélectionne une valeur RVB pour la deuxième page de propriétés.

Membres de données protégés

Nom Description
m_bIsMyPalette TRUE si la boîte de dialogue de sélection de couleurs utilise sa propre palette de couleurs, ou FALSE si la boîte de dialogue utilise une palette spécifiée dans le CMFCColorDialog constructeur.
m_bPickerMode TRUE pendant que l’utilisateur sélectionne une couleur dans la boîte de dialogue de sélection ; sinon, FALSE.
m_btnColorSelect Bouton couleur sélectionné par l’utilisateur.
m_CurrentColor Couleur actuellement sélectionnée.
m_hcurPicker Curseur utilisé pour choisir une couleur.
m_NewColor Couleur sélectionnée potentielle, qui peut être sélectionnée définitivement ou rétablie à la couleur d’origine.
m_pColourSheetOne Pointeur vers la première page de propriétés de la feuille de propriétés de sélection de couleurs.
m_pColourSheetTwo Pointeur vers la deuxième page de propriétés de la feuille de propriétés de sélection de couleurs.
m_pPalette Palette logique actuelle.
m_pPropSheet Pointeur vers la feuille de propriétés de la boîte de dialogue de sélection de couleur.
m_wndColors Objet de contrôle du sélecteur de couleurs.
m_wndStaticPlaceHolder Contrôle statique qui est un espace réservé pour la feuille de propriétés du sélecteur de couleurs.

Notes

La boîte de dialogue sélection de couleur s’affiche sous forme de feuille de propriétés avec deux pages. Dans la première page, vous sélectionnez une couleur standard dans la palette système ; sur la deuxième page, vous sélectionnez une couleur personnalisée.

Vous pouvez construire un CMFCColorDialog objet sur la pile, puis appeler DoModal, en passant la couleur initiale en tant que paramètre au CMFCColorDialog constructeur. La boîte de dialogue sélection de couleurs crée ensuite plusieurs objets CMFCColorPickerCtrl Class pour gérer chaque palette de couleurs.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

CMFCColorDialog

Exemple

L’exemple suivant montre comment configurer une boîte de dialogue couleur à l’aide de différentes méthodes dans la CMFCColorDialog classe. L’exemple montre comment définir les couleurs actuelles et nouvelles de la boîte de dialogue et comment définir les composants rouge, vert et bleu d’une couleur sélectionnée sur les deux pages de propriétés de la boîte de dialogue de couleur. Cet exemple fait partie de l’exemple New Controls.

// COLORREF m_Color
CMFCColorDialog dlg(m_Color, 0, this);
dlg.SetCurrentColor(RGB(0, 255, 0));
dlg.SetNewColor(RGB(0, 0, 255));
// set the red, green, and blue components of a selected
// color on the two property pages of the color dialog
dlg.SetPageOne(255, 0, 0);
dlg.SetPageTwo(0, 255, 0);

Spécifications

En-tête : afxcolordialog.h

CMFCColorDialog ::CMFCColorDialog

Construit un objet CMFCColorDialog.

CMFCColorDialog(
    COLORREF clrInit=0,
    DWORD dwFlags=0,
    CWnd* pParentWnd=NULL,
    HPALETTE hPal=NULL);

Paramètres

clrInit
[in] Sélection de couleur par défaut. Si aucune valeur n’est spécifiée, la valeur par défaut est RVB(0,0,0) (noir).

dwFlags
[in] Réservée.

pParentWnd
[in] Pointeur vers la fenêtre parent ou propriétaire de la boîte de dialogue.

hPal
[in] Poignée d’une palette de couleurs.

Valeur de retour

Notes

CMFCColorDialog ::GetColor

Récupère la couleur que l’utilisateur sélectionne dans la boîte de dialogue couleur.

COLORREF GetColor() const;

Valeur de retour

Valeur COLORREF qui contient les informations RVB de la couleur sélectionnée dans la boîte de dialogue couleur.

Notes

Appelez cette fonction après avoir appelé la DoModal méthode.

CMFCColorDialog ::GetPalette

Récupère la palette de couleurs disponible dans la boîte de dialogue de couleur actuelle.

CPalette* GetPalette() const;

Valeur de retour

Pointeur vers l’objet CPalette spécifié dans le CMFCColorDialog constructeur.

Notes

La palette de couleurs spécifie les couleurs que l’utilisateur peut choisir.

CMFCColorDialog ::RebuildPalette

Dérive une palette de la palette système.

void RebuildPalette();

CMFCColorDialog ::SetCurrentColor

Définit la couleur actuelle de la boîte de dialogue.

void SetCurrentColor(COLORREF rgb);

Paramètres

RVB
[in] Valeur de couleur RVB

Notes

CMFCColorDialog ::SetNewColor

Définit la couleur actuelle sur la couleur dans la palette actuelle qui est la plus similaire.

void SetNewColor(COLORREF rgb);

Paramètres

RVB
[in] COLORREF qui spécifie une couleur RVB.

Notes

CMFCColorDialog ::SetPageOne

Spécifie explicitement les composants rouge, vert et bleu d’une couleur sélectionnée dans la première page de propriétés d’une boîte de dialogue de couleur.

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

Paramètres

R
[in] Spécifie le composant rouge de la valeur RVB.

G
[in] Spécifie le composant vert de la valeur RVB.

B
[in] Spécifie le composant bleu de la valeur RVB.

Notes

CMFCColorDialog ::SetPageTwo

Spécifie explicitement les composants rouge, vert et bleu d’une couleur sélectionnée dans la deuxième page de propriétés d’une boîte de dialogue de couleur.

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

Paramètres

R
[in] Spécifie un composant rouge de la valeur RVB

G
[in] Spécifie un composant vert d’une valeur RVB

B
[in] Spécifie un composant bleu d’une valeur RVB

Notes

Voir aussi

Graphique hiérarchique
Classes
CMFCColorPickerCtrl, classe