Klasa CMFCPropertyGridColorPropertyCMFCPropertyGridColorProperty Class

CMFCPropertyGridColorPropertyKlasa obsługuje element formantu listy właściwości, który powoduje otwarcie okna dialogowego wyboru koloru.The CMFCPropertyGridColorProperty class supports a property list control item that opens a color selection dialog box.

SkładniaSyntax

class CMFCPropertyGridColorProperty : public CMFCPropertyGridProperty

Elementy członkowskieMembers

Konstruktory publicznePublic Constructors

NazwaName OpisDescription
CMFCPropertyGridColorProperty::CMFCPropertyGridColorPropertyCMFCPropertyGridColorProperty::CMFCPropertyGridColorProperty Konstruuje CMFCPropertyGridColorProperty obiekt.Constructs a CMFCPropertyGridColorProperty object.
CMFCPropertyGridColorProperty::~CMFCPropertyGridColorProperty Destruktor.Destructor.

Metody publicznePublic Methods

NazwaName OpisDescription
CMFCPropertyGridColorProperty::EnableAutomaticButtonCMFCPropertyGridColorProperty::EnableAutomaticButton Włącza przycisk automatyczny w oknie dialogowym wyboru koloru.Enables the automatic button on the color selection dialog box. (Standardowy przycisk Automatyczny ma etykietę automatyczną).(The standard automatic button is labeled Automatic.)
CMFCPropertyGridColorProperty::EnableOtherButtonCMFCPropertyGridColorProperty::EnableOtherButton Włącza inny przycisk w oknie dialogowym wyboru koloru.Enables the other button on the color selection dialog box. (Inny przycisk standardowy ma etykietę więcej kolorów).(The standard other button is labeled More Colors.)
CMFCPropertyGridColorProperty::FormatProperty Formatuje tekstową reprezentację wartości właściwości.Formats the text representation of a property value. (Przesłania CMFCPropertyGridProperty:: FormatProperty.)(Overrides CMFCPropertyGridProperty::FormatProperty.)
CMFCPropertyGridColorProperty:: GetColorCMFCPropertyGridColorProperty::GetColor Pobiera bieżący kolor właściwości.Gets the current color of the property.
CMFCPropertyGridColorProperty::GetThisClass Używane przez platformę do uzyskania wskaźnika do obiektu CRuntimeClass , który jest skojarzony z tym typem klasy.Used by the framework to obtain a pointer to the CRuntimeClass object that is associated with this class type.
CMFCPropertyGridColorProperty::OnClickButton Wywoływane przez platformę, gdy użytkownik kliknie przycisk znajdujący się w właściwości.Called by the framework when the user clicks a button that is contained in a property. (Przesłania CMFCPropertyGridProperty:: OnClickButton.)(Overrides CMFCPropertyGridProperty::OnClickButton.)
CMFCPropertyGridColorProperty::OnDrawValue Wywoływane przez platformę, aby wyświetlić wartość właściwości.Called by the framework to display the property value. (Przesłania CMFCPropertyGridProperty:: OnDrawValue.)(Overrides CMFCPropertyGridProperty::OnDrawValue.)
CMFCPropertyGridColorProperty::OnEdit Wywoływane przez platformę, gdy użytkownik zamierza zmodyfikować wartość właściwości.Called by the framework when the user is about to modify a property value. (Przesłania CMFCPropertyGridProperty:: onedit).(Overrides CMFCPropertyGridProperty::OnEdit.)
CMFCPropertyGridColorProperty::OnUpdateValue Wywoływane przez platformę, gdy wartość właściwości edytowanej została zmieniona.Called by the framework when the value of an editable property has changed. (Przesłania CMFCPropertyGridProperty:: OnUpdateValue.)(Overrides CMFCPropertyGridProperty::OnUpdateValue.)
CMFCPropertyGridColorProperty:: SetColorCMFCPropertyGridColorProperty::SetColor Ustawia nowy kolor dla właściwości.Sets a new color for the property.
CMFCPropertyGridColorProperty::SetColumnsNumberCMFCPropertyGridColorProperty::SetColumnsNumber Określa liczbę kolumn w bieżącej siatce właściwości koloru.Specifies the number of columns in the current color property grid.
CMFCPropertyGridColorProperty::SetOriginalValueCMFCPropertyGridColorProperty::SetOriginalValue Ustawia oryginalną wartość właściwości, którą można edytować.Sets the original value of an editable property.

UwagiRemarks

CMFCPropertyGridColorPropertyKlasa obsługuje Właściwość koloru, którą można dodać do kontrolki listy właściwości.The CMFCPropertyGridColorProperty class supports a color property that can be added to a property list control. Aby uzyskać więcej informacji, zobacz Klasa CMFCPropertyGridCtrl.For more information, see the CMFCPropertyGridCtrl Class.

PrzykładExample

Poniższy przykład ilustruje sposób konstruowania obiektu CMFCPropertyGridColorProperty klasy i konfigurowania tego obiektu przy użyciu różnych metod CMFCPropertyGridColorProperty klasy.The following example demonstrates how to construct an object of the CMFCPropertyGridColorProperty class and configure this object by using various methods of the CMFCPropertyGridColorProperty class. Kod wyjaśnia, jak włączyć automatyczne i inne przyciski oraz jak ustawić kolor i liczbę kolumn.The code explains how to enable the automatic and other buttons, and how to set the color and the columns number. Ten przykład jest częścią nowych kontrolek.This example is part of the New Controls sample.

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

Hierarchia dziedziczeniaInheritance Hierarchy

CObjectCObject

CMFCPropertyGridPropertyCMFCPropertyGridProperty

CMFCPropertyGridColorPropertyCMFCPropertyGridColorProperty

WymaganiaRequirements

Nagłówek: afxpropertygridctrl. hHeader: afxpropertygridctrl.h

CMFCPropertyGridColorProperty::CMFCPropertyGridColorPropertyCMFCPropertyGridColorProperty::CMFCPropertyGridColorProperty

Konstruuje CMFCPropertyGridColorProperty obiekt.Constructs a CMFCPropertyGridColorProperty object.

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

ParametryParameters

strNamestrName
podczas Nazwa właściwości.[in] The name of the property.

Kolorcolor
podczas Wartość koloru właściwości.[in] The color value of the property.

pPalettepPalette
podczas Wskaźnik do palety kolorów.[in] Pointer to a palette of colors. Wartość domyślna to NULL.The default value is NULL.

lpszDescrlpszDescr
podczas Opis właściwości.[in] The property description. Wartość domyślna to NULL.The default value is NULL.

dwDatadwData
podczas Dane specyficzne dla aplikacji, takie jak liczba całkowita lub wskaźnik do innych danych, które są skojarzone z właściwością.[in] Application-specific data, such as an integer or a pointer to other data that is associated with the property. Wartość domyślna to 0.The default value is 0.

CMFCPropertyGridColorProperty::EnableAutomaticButtonCMFCPropertyGridColorProperty::EnableAutomaticButton

Włącza przycisk automatyczny w oknie dialogowym wyboru koloru.Enables the automatic button on the color selection dialog box. (Standardowy przycisk Automatyczny ma etykietę automatyczną).(The standard automatic button is labeled Automatic.)

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

ParametryParameters

lpszLabellpszLabel
podczas Tekst etykiety przycisku automatycznego.[in] The label text of the automatic button.

colorAutomaticcolorAutomatic
podczas Wartość koloru RGB domyślnego (domyślnego) koloru.[in] The RGB color value of the automatic (default) color.

bEnablebEnable
podczas Wartość TRUE, aby włączyć przycisk Automatyczny; w przeciwnym razie FALSE.[in] TRUE to enable the automatic button; otherwise, FALSE. Wartość domyślna to TRUE.The default value is TRUE.

UwagiRemarks

CMFCPropertyGridColorProperty::EnableOtherButtonCMFCPropertyGridColorProperty::EnableOtherButton

Włącza inny przycisk w oknie dialogowym wyboru koloru.Enables the other button on the color selection dialog box. (Inny przycisk standardowy ma etykietę więcej kolorów).(The standard other button is labeled More Colors.)

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

ParametryParameters

lpszLabellpszLabel
podczas Tekst etykiety drugiego przycisku.[in] The label text of the other button.

bAltColorDlgbAltColorDlg
podczas Wartość TRUE powoduje wyświetlenie okna CMFCColorDialog dialogowego; Wartość FALSE, aby wyświetlić okno dialogowe wyboru koloru standardowego.[in] TRUE to display the CMFCColorDialog dialog box; FALSE to display the standard color selection dialog box. Wartość domyślna to TRUE.The default value is TRUE.

bEnablebEnable
podczas PRAWDA, aby wyświetlić drugi przycisk; w przeciwnym razie FALSE.[in] TRUE to display the other button; otherwise, FALSE. Wartość domyślna to TRUE.The default value is TRUE.

UwagiRemarks

CMFCPropertyGridColorProperty:: GetColorCMFCPropertyGridColorProperty::GetColor

Pobiera bieżący kolor właściwości.Gets the current color of the property.

COLORREF GetColor() const;

Wartość zwracanaReturn Value

Wartość koloru RGB.An RGB color value.

UwagiRemarks

CMFCPropertyGridColorProperty:: SetColorCMFCPropertyGridColorProperty::SetColor

Ustawia nowy kolor dla właściwości.Sets a new color for the property.

void SetColor(COLORREF color);

ParametryParameters

Kolorcolor
podczas Wartość koloru RGB.[in] An RGB color value.

UwagiRemarks

CMFCPropertyGridColorProperty::SetColumnsNumberCMFCPropertyGridColorProperty::SetColumnsNumber

Określa liczbę kolumn w bieżącej siatce właściwości koloru.Specifies the number of columns in the current color property grid.

void SetColumnsNumber(int nColumnsNumber);

ParametryParameters

nColumnsNumbernColumnsNumber
podczas Preferowana liczba kolumn w siatce właściwości koloru.[in] The preferred number of columns in the color property grid.

UwagiRemarks

Ta metoda ustawia wartość m_nColumnsNumber chronionego elementu członkowskiego danych.This method sets the value of the m_nColumnsNumber protected data member.

CMFCPropertyGridColorProperty::SetOriginalValueCMFCPropertyGridColorProperty::SetOriginalValue

Ustawia oryginalną wartość właściwości, którą można edytować.Sets the original value of an editable property.

virtual void SetOriginalValue(const COleVariant& varValue);

ParametryParameters

varValuevarValue
podczas Wartość.[in] A value.

UwagiRemarks

Użyj metody CMFCPropertyGridProperty:: ResetOriginalValue , aby zresetować oryginalną wartość edytowanej właściwości.Use the CMFCPropertyGridProperty::ResetOriginalValue method to reset the original value of an edited property.

Zobacz teżSee also

Wykres hierarchiiHierarchy Chart
KlasyClasses
Klasa CMFCPropertyGridCtrlCMFCPropertyGridCtrl Class
Klasa CMFCPropertyGridPropertyCMFCPropertyGridProperty Class