CMFCPropertyGridColorProperty-Klasse

Die CMFCPropertyGridColorProperty-Klasse unterstützt ein Eigenschaftslisten-Steuerelement, über das ein Farbauswahl-Dialogfeld geöffnet werden kann.

Syntax

class CMFCPropertyGridColorProperty : public CMFCPropertyGridProperty

Member

Öffentliche Konstruktoren

Name	Beschreibung
CMFCPropertyGridColorProperty::CMFCPropertyGridColorProperty	Erstellt ein CMFCPropertyGridColorProperty-Objekt.
CMFCPropertyGridColorProperty::~CMFCPropertyGridColorProperty	Destruktor.

Öffentliche Methoden

Name	Beschreibung
CMFCPropertyGridColorProperty::EnableAutomaticButton	Aktiviert die automatische Schaltfläche im Dialogfeld "Farbauswahl". (Die standardmäßige automatische Schaltfläche ist mit bezeichnungen Automatisch.)
CMFCPropertyGridColorProperty::EnableOtherButton	Aktiviert die andere Schaltfläche im Dialogfeld "Farbauswahl". (Die andere Standardschaltfläche ist beschriftet Weitere Farben.)
CMFCPropertyGridColorProperty::FormatProperty	Formatiert die Textdarstellung eines Eigenschaftswerts. (Außerkraftsetzungen CMFCPropertyGridProperty::FormatProperty.)
CMFCPropertyGridColorProperty::GetColor	Ruft die aktuelle Farbe der Eigenschaft ab.
CMFCPropertyGridColorProperty::GetThisClass	Wird vom Framework verwendet, um einen Zeiger auf das CRuntimeClass -Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CMFCPropertyGridColorProperty::OnClickButton	Wird vom Framework aufgerufen, wenn der Benutzer auf eine Schaltfläche klickt, die in einer Eigenschaft enthalten ist. (Außerkraftsetzungen CMFCPropertyGridProperty::OnClickButton.)
CMFCPropertyGridColorProperty::OnDrawValue	Wird vom Framework aufgerufen, um die Liste der Eigenschaftenwerte anzuzeigen. (Außerkraftsetzungen CMFCPropertyGridProperty::OnDrawValue.)
CMFCPropertyGridColorProperty::OnEdit	Wird vom Framework aufgerufen, wenn der Benutzer dabei ist, einen Eigenschaftenwert zu bearbeiten. (Außerkraftsetzungen CMFCPropertyGridProperty::OnEdit.)
CMFCPropertyGridColorProperty::OnUpdateValue	Wird vom Framework aufgerufen, wenn der Wert einer änderbaren Eigenschaft geändert wurde. (Außerkraftsetzungen CMFCPropertyGridProperty::OnUpdateValue.)
CMFCPropertyGridColorProperty::SetColor	Legt eine neue Farbe für die Eigenschaft fest.
CMFCPropertyGridColorProperty::SetColumnsNumber	Gibt die Anzahl der Spalten in der aktuellen Farbe des Eigenschaftenrasters an.
CMFCPropertyGridColorProperty::SetOriginalValue	Legt den ursprünglichen Wert einer bearbeitbaren Eigenschaft fest.

Hinweise

Die CMFCPropertyGridColorProperty -Klasse unterstützt eine Farbeigenschaft, die zu einem Eigenschaftenlisten-Steuerelement hinzugefügt werden kann. Weitere Informationen finden Sie unter der CMFCPropertyGridCtrl-Klasse.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie ein Objekt CMFCPropertyGridColorProperty- Klasse erstellt und mithilfe der verschiedenen Methoden der CMFCPropertyGridColorProperty-Klasse konfiguriert wird. Der Code erläutert, wie die Schaltflächen „automatisch“ und „sonstige“ aktiviert werden und wie die Farbe und die Spaltenanzahl festgelegt wird. Dieses Beispiel ist Teil des Beispiels "Neue Steuerelemente".

CMFCPropertyGridColorProperty *pColorProp = new CMFCPropertyGridColorProperty(_T("Window Color"), RGB(210, 192, 254), NULL, _T("Specifies the default dialog color"));
pColorProp->EnableOtherButton(_T("Other..."));
pColorProp->EnableAutomaticButton(_T("Default"), ::GetSysColor(COLOR_3DFACE));
pColorProp->SetColor(RGB(255, 0, 0));
pColorProp->SetColumnsNumber(3);

Vererbungshierarchie

CObject

CMFCPropertyGridProperty

CMFCPropertyGridColorProperty

Anforderungen

Header: afxpropertygridctrl.h

CMFCPropertyGridColorProperty::CMFCPropertyGridColorProperty

Erstellt ein CMFCPropertyGridColorProperty-Objekt.

CMFCPropertyGridColorProperty(
    const CString& strName,
    const COLORREF& color,
    CPalette* pPalette = NULL,
    LPCTSTR lpszDescr = NULL,
    DWORD_PTR dwData = 0);

Parameter

Strname
[in] Der Name der Eigenschaft.

color
[in] Der Farbwert der Eigenschaft.

pPalette
[in] Zeiger auf eine Palette von Farben. Der Standardwert ist NULL.

lpszDescr
[in] Die Eigenschaftsbeschreibung. Der Standardwert ist NULL.

dwData
[in] Anwendungsspezifische Daten, z. B. eine ganze Zahl oder ein Zeiger auf andere Daten, die der Eigenschaft zugeordnet sind. Der Standardwert ist 0.

CMFCPropertyGridColorProperty::EnableAutomaticButton

Aktiviert die automatische Schaltfläche im Dialogfeld "Farbauswahl". (Die standardmäßige automatische Schaltfläche ist mit bezeichnungen Automatisch.)

void EnableAutomaticButton(
    LPCTSTR lpszLabel,
    COLORREF colorAutomatic,
    BOOL bEnable=TRUE);

Parameter

lpszLabel
[in] Der Beschriftungstext der automatischen Schaltfläche.

colorAutomatic
[in] Der RGB-Farbwert der automatischen Farbe (Standardfarbe).

bEnable
[in] TRUE, um die automatische Schaltfläche zu aktivieren; andernfalls FALSE. Der Standardwert ist TRUE.

Hinweise

CMFCPropertyGridColorProperty::EnableOtherButton

Aktiviert die andere Schaltfläche im Dialogfeld "Farbauswahl". (Die andere Standardschaltfläche ist beschriftet Weitere Farben.)

void EnableOtherButton(
    LPCTSTR lpszLabel,
    BOOL bAltColorDlg = TRUE,
    BOOL bEnable = TRUE);

Parameter

lpszLabel
[in] Der Beschriftungstext der anderen Schaltfläche.

bAltColorDlg
[in] TRUE zum Anzeigen des CMFCColorDialog Dialogfelds; FALSE, um das Dialogfeld für die Standardfarbauswahl anzuzeigen. Der Standardwert ist TRUE.

bEnable
[in] TRUE, um die andere Schaltfläche anzuzeigen; andernfalls FALSE. Der Standardwert ist TRUE.

Hinweise

CMFCPropertyGridColorProperty::GetColor

Ruft die aktuelle Farbe der Eigenschaft ab.

COLORREF GetColor() const;

Rückgabewert

Ein RGB-Farbwert.

Hinweise

CMFCPropertyGridColorProperty::SetColor

Legt eine neue Farbe für die Eigenschaft fest.

void SetColor(COLORREF color);

Parameter

color
[in] Ein RGB-Farbwert.

Hinweise

CMFCPropertyGridColorProperty::SetColumnsNumber

Gibt die Anzahl der Spalten in der aktuellen Farbe des Eigenschaftenrasters an.

void SetColumnsNumber(int nColumnsNumber);

Parameter

nColumnsNumber
[in] Die bevorzugte Anzahl von Spalten im Farbeigenschaftenraster.

Hinweise

Diese Methode legt den Wert des m_nColumnsNumber geschützten Datenelements fest.

CMFCPropertyGridColorProperty::SetOriginalValue

Legt den ursprünglichen Wert einer bearbeitbaren Eigenschaft fest.

virtual void SetOriginalValue(const COleVariant& varValue);

Parameter

varValue
[in] Ein Wert.

Hinweise

Verwenden Sie die CMFCPropertyGridProperty::ResetOriginalValue-Methode , um den ursprünglichen Wert einer bearbeiteten Eigenschaft zurückzusetzen.

Siehe auch

Hierarchiediagramm
Klassen
CMFCPropertyGridCtrl-Klasse
CMFCPropertyGridProperty-Klasse