CMFCPropertyGridColorProperty-Klasse

  • Artikel
  • 3 Minuten Lesedauer

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 für die Farbauswahl. (Die Standardschaltfläche "Automatisch" lautet "Automatisch".)
CMFCPropertyGridColorProperty::EnableOtherButton Aktiviert die andere Schaltfläche im Dialogfeld für die Farbauswahl. (Die andere Standardschaltfläche hat die Bezeichnung Weitere Farben.)
CMFCPropertyGridColorProperty::FormatProperty Formatiert die Textdarstellung eines Eigenschaftswerts. (Überschreibt 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. (Überschreibt CMFCPropertyGridProperty::OnClickButton.)
CMFCPropertyGridColorProperty::OnDrawValue Wird vom Framework aufgerufen, um die Liste der Eigenschaftenwerte anzuzeigen. (Überschreibt CMFCPropertyGridProperty::OnDrawValue.)
CMFCPropertyGridColorProperty::OnEdit Wird vom Framework aufgerufen, wenn der Benutzer dabei ist, einen Eigenschaftenwert zu bearbeiten. (Überschreibt CMFCPropertyGridProperty::OnEdit.)
CMFCPropertyGridColorProperty::OnUpdateValue Wird vom Framework aufgerufen, wenn der Wert einer änderbaren Eigenschaft geändert wurde. (Überschreibt 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 in 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 Eigenschaftenbeschreibung. 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 für die Farbauswahl. (Die Standardschaltfläche "Automatisch" lautet "Automatisch".)

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

Parameter

lpszLabel
[in] Der Bezeichnungstext 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 für die Farbauswahl. (Die andere Standardschaltfläche hat die Bezeichnung Weitere Farben.)

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

Parameter

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

bAltColorDlg
[in] TRUE, um das CMFCColorDialog Dialogfeld anzuzeigen. FALSE, um das Standarddialogfeld für die Farbauswahl 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 Farbeigenschaftsraster.

Hinweise

Diese Methode legt den Wert des geschützten Datenmitglieds m_nColumnsNumber 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.

Weitere Informationen

Hierarchiediagramm
Klassen
CMFCPropertyGridCtrl-Klasse
CMFCPropertyGridProperty-Klasse