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