CMFCColorButton-Klasse

Artikel
06/10/2015

CMFCColorButton und die CMFCColorBar-Klasse-Klassen werden zusammen verwendet, um ein Farben-Auswahlsteuerelement zu implementieren.

class CMFCColorButton : public CMFCButton

Mitglieder

Öffentliche Konstruktoren

Name	Description
CMFCColorButton::CMFCColorButton	Erstellt ein neues CMFCColorButton-Objekt.

Öffentliche Methoden

Name	Description
CMFCColorButton::EnableAutomaticButton	Aktiviert und deaktiviert eine "auto" Schaltfläche, die über den regulären Farbenschaltflächen positioniert wird. (Die automatische Schaltfläche des Standardsystems wird Automatisch bezeichnet).
CMFCColorButton::EnableOtherButton	Aktiviert und deaktiviert eine "eine andere" Schaltfläche, die den regulären Farbenschaltflächen positioniert wird. (Das Standardsystem "andere" Schaltfläche wird Weitere Farben... bezeichnet).
CMFCColorButton::GetAutomaticColor	Ruft die aktuelle automatische Farbe ab.
CMFCColorButton::GetColor	Ruft die Farbe einer Schaltfläche ab.
CMFCColorButton::SetColor	Legt die Farbe einer Schaltfläche fest.
CMFCColorButton::SetColorName	Legt einen Farbnamen fest.
CMFCColorButton::SetColumnsNumber	Legt die Anzahl der Spalten im Farben-Auswahldialogfeld fest.
CMFCColorButton::SetDocumentColors	Gibt eine Liste von Dokumentbesondere Farben, die auf dem Farben-Auswahldialogfeld angezeigt werden.
CMFCColorButton::SetPalette	Gibt eine Palette von Standardanzeigenfarben an.
CMFCColorButton::SizeToContent	Ändert die Größe des Button-Steuerelements, je nach Text und Imagegröße.

Geschützte Methoden

Name	Description
CMFCColorButton::IsDrawXPTheme	Gibt an, ob die aktuelle Farbenschaltfläche im Stil von Windows XP angezeigt wird.
CMFCColorButton::OnDraw	Aufgerufen vom Framework, um ein Bild der Schaltfläche anzuzeigen.
CMFCColorButton::OnDrawBorder	Aufgerufen vom Framework, um den Rahmen der Schaltfläche anzuzeigen.
CMFCColorButton::OnDrawFocusRect	Aufgerufen vom Framework, um ein Fokusrechteck anzuzeigen, wenn die Schaltfläche ein den Fokus besitzt.
CMFCColorButton::OnShowColorPopup	Aufgerufen vom Framework, wenn das Farben-Auswahldialogfeld im Begriff ist angezeigt werden.
CMFCColorButton::RebuildPalette	Initialisiert den m_pPalette geschützten Datenmember der angegebenen Palette oder auf die Systempalette.
CMFCColorButton::UpdateColor	Aufgerufen vom Framework, wenn der Benutzer eine Farbe aus der Palette des Farben-Auswahldialogfelds auswählt.

Datenmember

Name	Description
m_bAltColorDlg	Ein boolescher Wert. Wenn TRUE, das Framework CMFCColorDialog Dialogfeld anzeigt, wenn andere auf die Schaltfläche geklickt wird, oder wenn FALSE, das Systemfarbendialogfeld. Der Standardwert ist TRUE. Weitere Informationen finden Sie unter CMFCColorButton::EnableOtherButton.
m_bAutoSetFocus	Ein boolescher Wert. Wenn TRUE, das Framework den Fokus auf das Farbenmenü festlegt, wenn das Menü angezeigt wird, oder wenn FALSE, ändert nicht den Fokus. Der Standardwert ist TRUE.
CMFCColorButton::m_bEnabledInCustomizeMode	Gibt an, ob Anpassungsmodus für die Farbenschaltfläche aktiviert ist.
m_Color	Ein COLORREF-Wert. Enthält die aktuell ausgewählte Farbe.
m_ColorAutomatic	Ein COLORREF-Wert. Enthält die aktuell ausgewählte Standardfarbe.
m_Colors	CArray von COLORREF-Werten. Enthält die zur Zeit verfügbaren Farben.
m_lstDocColors	CList von COLORREF-Werten. Enthält die Farben des aktuellen Dokuments.
m_nColumns	Eine ganze Zahl. Enthält die Anzahl der Spalten, um im Raster von Farben in einem Farben-Auswahlmenü anzuzeigen.
m_pPalette	Ein Zeiger auf CPalette. Enthält die Farben, die im aktuellen Farben-Auswahlmenü verfügbar sind.
m_pPopup	Ein Zeiger auf ein Objekt CMFCColorPopupMenu-Klasse. Das Farben-Auswahlmenü, das angezeigt wird, wenn Sie auf die Farbenschaltfläche klicken.
m_strAutoColorText	Eine Zeichenfolge. Die Bezeichnung "der automatischen" Schaltfläche in einem Farben-Auswahlmenü.
m_strDocColorsText	Eine Zeichenfolge. Die Bezeichnung der Schaltfläche in einem Farben-Auswahlmenü, das das Dokument anzeigt, Farbe.
m_strOtherText	Eine Zeichenfolge. Die Bezeichnung "von der anderen" Schaltfläche in einem Farben-Auswahlmenü.

Hinweise

Standardmäßig verhält sich die CMFCColorButton-Klasse als Schaltfläche, die ein Farben-Auswahldialogfeld öffnet. Das Farben-Auswahldialogfeld enthält ein Array von kleinen Farbenschaltflächen und von "einer anderen" Schaltfläche, die eine benutzerdefinierte Farbauswahl anzeigt. (Das Standardsystem "andere" Schaltfläche wird Weitere Farben... bezeichnet). Wenn ein Benutzer eine neue Farbe auswählen, gibt das CMFCColorButton-Objekt die Änderung und zeigt die ausgewählte Farbe an.

Erstellen Sie ein Farbenschaltflächen-steuerelement entweder direkt im Code oder das Tool ClassWizard und eine Dialogfeldvorlage verwenden. Wenn Sie ein Farbenschaltflächen-steuerelement direkt erstellen, fügen Sie eine CMFCColorButton-Variable der Anwendung hinzu, und rufen Sie dann den Konstruktor auf und Create-Methoden CMFCColorButton ein Objekt. Wenn Sie ClassWizard verwenden, fügen Sie eine CButton-Variable der Anwendung hinzu, und ändern Sie dann den Typ der Variablen von CButton zu CMFCColorButton.

Das Farben-Auswahldialogfeld (CMFCColorBar-Klasse) wird durch die CMFCColorButton::OnShowColorPopup-Methode angezeigt, wenn das Framework den OnLButtonDown-Ereignishandler aufruft. Die CMFCColorButton::OnShowColorPopup-Methode kann überschrieben werden, um benutzerdefinierte Farbauswahl zu unterstützen.

Das Objekt CMFCColorButton benachrichtigt das übergeordnete Element, dass eine Farbe ändert, indem es eine WM_COMMAND | BN_CLICKED Benachrichtigung sendet. Das übergeordnete Element verwendet die CMFCColorButton::GetColor-Methode, um die aktuelle Farbe abzurufen.

Beispiel

Das folgende Beispiel zeigt, wie eine Farbenschaltfläche konfiguriert, indem verschiedene Methoden in der CMFCColorButton-Klasse angewendet wird. Die Methoden legen die Farbe der Farbenschaltfläche und der Anzahl von Spalten fest und aktivieren die automatischen und anderen Schaltflächen. Dieses Beispiel ist Teil Statusleisten-Demobeispiel.

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