Classe de CMFCColorButton

Article
03/12/2013

CMFCColorButton et les classes de Classe de CMFCColorBar sont utilisés ensemble pour implémenter un contrôle de sélecteur de couleurs.

class CMFCColorButton : public CMFCButton

Membres

Constructeurs publics

Nom	Description
CMFCColorButton::CMFCColorButton	Construit un nouvel objet CMFCColorButton.

Méthodes publiques

Nom	Description
CMFCColorButton::EnableAutomaticButton	Active et désactive un bouton « automatique » qui est positionnée au-dessus de les boutons normaux de couleur.(Le bouton automatique du système standard est étiqueté Automatique.)
CMFCColorButton::EnableOtherButton	Active et désactive un « autre » bouton qui est positionné sous les boutons normaux de couleur.(Le système standard « autre » bouton est étiqueté Plus les couleurs….)
CMFCColorButton::GetAutomaticColor	Extrait la couleur automatique actuelle.
CMFCColorButton::GetColor	Extrait la couleur d'un bouton.
CMFCColorButton::SetColor	Définit la couleur d'un bouton.
CMFCColorButton::SetColorName	Définit un nom de couleur.
CMFCColorButton::SetColumnsNumber	Définit le nombre de colonnes dans la boîte de dialogue du sélecteur de couleurs.
CMFCColorButton::SetDocumentColors	Spécifie une liste de couleurs de document spécifique qui s'affichent dans la boîte de dialogue du sélecteur de couleurs.
CMFCColorButton::SetPalette	Spécifie une palette de couleurs de l'affichage standard.
CMFCColorButton::SizeToContent	Modifie la taille du contrôle bouton, selon son texte et sa taille de l'image.

Méthodes protégées

Nom	Description
CMFCColorButton::IsDrawXPTheme	Indique si le bouton en cours de couleur est affiché dans le style de Windows XP.
CMFCColorButton::OnDraw	Appelé par l'infrastructure pour afficher une image du bouton.
CMFCColorButton::OnDrawBorder	Appelé par l'infrastructure pour afficher la bordure du bouton.
CMFCColorButton::OnDrawFocusRect	Appelé par l'infrastructure pour afficher un rectangle de focus lorsque le bouton a le focus.
CMFCColorButton::OnShowColorPopup	Appelé par l'infrastructure lorsque la boîte de dialogue du sélecteur de couleurs est sur le point d'être affiché.
CMFCColorButton::RebuildPalette	Initialise le membre protégée par m_pPalette à la palette spécifiée ou à la palette système par défaut.
CMFCColorButton::UpdateColor	Appelé par l'infrastructure lorsque l'utilisateur sélectionne une couleur dans la palette de la boîte de dialogue du sélecteur de couleurs.

Membres de données

Nom	Description
m_bAltColorDlg	Valeur booléenne.Si TRUE, l'infrastructure affiche la boîte de dialogue de couleur de CMFCColorDialog lorsque l'autre utilisateur clique sur, ou si FALSE, la boîte de dialogue de couleur système.La valeur par défaut est TRUE.Pour plus d'informations, consultez CMFCColorButton::EnableOtherButton.
m_bAutoSetFocus	Valeur booléenne.Si TRUE, l'infrastructure place le focus dans le menu de couleur lorsque le menu s'affiche, ou si FALSE, ne modifie pas le focus.La valeur par défaut est TRUE.
CMFCColorButton::m_bEnabledInCustomizeMode	Indique si le mode de personnalisation est activé pour le bouton de couleur.
m_Color	Une valeur de COLORREF .Contient la couleur sélectionnée.
m_ColorAutomatic	Une valeur de COLORREF .Contient la couleur par défaut sélectionnée.
m_Colors	CArray des valeurs de COLORREF .Contient les couleurs disponibles.
m_lstDocColors	CList des valeurs de COLORREF .Contient les couleurs du document actif.
m_nColumns	Entier.Contient le nombre de colonnes à afficher dans la grille de couleurs dans un menu de sélection de couleurs.
m_pPalette	Un pointeur vers CPalette.Contient les couleurs disponibles dans le menu actuel de sélection de couleurs.
m_pPopup	Un pointeur vers un objet de Classe de CMFCColorPopupMenu .Le menu de sélection de couleurs qui s'affiche lorsque vous cliquez sur le bouton de couleur.
m_strAutoColorText	une chaîne ;L'étiquette du bouton « automatique » dans un menu de sélection de couleurs.
m_strDocColorsText	une chaîne ;L'étiquette du bouton dans un menu de sélection de couleurs qui affiche le document couleurs.
m_strOtherText	une chaîne ;L'étiquette de la « nouvelle » bouton dans un menu de sélection de couleurs.

Notes

Par défaut, la classe d' CMFCColorButton se comporte comme un bouton de commande qui ouvre une boîte de dialogue du sélecteur de couleurs.La boîte de dialogue du sélecteur de couleurs contient un tableau de petits boutons de couleur et d'un « autre » bouton qui affiche un sélecteur de couleurs personnalisé.(Le système standard « autre » bouton est étiqueté Plus les couleurs….) Lorsqu'un utilisateur sélectionne une nouvelle couleur, l'objet d' CMFCColorButton reflète la modification et affiche la couleur sélectionnée.

Créez un contrôle bouton de couleur directement dans votre code, ou en utilisant l'outil ClassWizard et d'un modèle de boîte de dialogue.Si vous créez un contrôle bouton de couleur directement, ajoutez une variable d' CMFCColorButton à votre application, puis appelez le constructeur et les méthodes d' Create d' CMFCColorButton objet.Si vous utilisez ClassWizard, ajoutez une variable d' CButton à votre application, puis modifiez le type de la variable d' CButton par CMFCColorButton.

La boîte de dialogue du sélecteur de couleurs (Classe de CMFCColorBar) est affichée par la méthode d' CMFCColorButton::OnShowColorPopup lorsque l'infrastructure appelle le gestionnaire d'événements d' OnLButtonDown .La méthode d' CMFCColorButton::OnShowColorPopup peut être substituée pour prendre en charge la sélection de couleurs personnalisée.

l'objet d' CMFCColorButton informe son parent qu'une couleur change en l'envoyant une notification d' WM_COMMAND | BN_CLICKED .Le parent utilise la méthode de CMFCColorButton::GetColor pour récupérer la couleur actuelle.

Exemple

L'exemple suivant montre comment configurer un bouton de couleur en utilisant différentes méthodes dans la classe d' CMFCColorButton .Les méthodes fixent la couleur du bouton de couleur et de son nombre de colonnes, et permettent les boutons automatiques et autres.Cet exemple est extrait d' Exemple de démonstration de barre d'état.

    CMFCColorButton m_wndTextColor;


...


    m_wndTextColor.EnableAutomaticButton (_T("Default"), afxGlobalData.clrBtnText);
    m_wndTextColor.EnableOtherButton (_T("Other..."));
    m_wndTextColor.SetColor ((COLORREF)-1);
    m_wndTextColor.SetColorName((COLORREF)-1, "Default Color");
    m_wndTextColor.SetColumnsNumber(3);