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