Condividi tramite


Classe CMFCPropertyGridColorProperty

Annotazioni

La libreria Microsoft Foundation Classes (MFC) continua a essere supportata. Tuttavia, non aggiungiamo più funzionalità né aggiorniamo la documentazione.

La classe CMFCPropertyGridColorProperty supporta un elemento controllo elenco delle proprietà che apre una finestra di dialogo di selezione colore.

Sintassi

class CMFCPropertyGridColorProperty : public CMFCPropertyGridProperty

Membri

Costruttori pubblici

Nome Descrizione
CMFCPropertyGridColorProperty::CMFCPropertyGridColorProperty Costruisce un oggetto CMFCPropertyGridColorProperty.
CMFCPropertyGridColorProperty::~CMFCPropertyGridColorProperty Distruttore.

Metodi pubblici

Nome Descrizione
CMFCPropertyGridColorProperty::EnableAutomaticButton Abilita il pulsante automatico nella finestra di dialogo di selezione del colore. (Il pulsante automatico standard è etichettato Automatico.
CMFCPropertyGridColorProperty::EnableOtherButton Abilita l'altro pulsante nella finestra di dialogo di selezione dei colori. (l'altro pulsante standard è etichettato Altri colori.
CMFCPropertyGridColorProperty::FormatProperty Formatta la rappresentazione di testo di un valore della proprietà. (sostituzioni )CMFCPropertyGridProperty::FormatProperty.)
CMFCPropertyGridColorProperty::GetColor Ottiene il colore corrente della proprietà.
CMFCPropertyGridColorProperty::GetThisClass Usato dal framework per ottenere un puntatore all'oggetto CRuntimeClass associato a questo tipo di classe.
CMFCPropertyGridColorProperty::OnClickButton Chiamato dal framework quando l'utente fa clic su un pulsante contenuto in una proprietà. (sostituzioni )CMFCPropertyGridProperty::OnClickButton.
CMFCPropertyGridColorProperty::OnDrawValue Chiamato dal framework per visualizzare il valore della proprietà. (sostituzioni )CMFCPropertyGridProperty::OnDrawValue.
CMFCPropertyGridColorProperty::OnEdit Chiamato dal framework quando l'utente sta per modificare il valore di una proprietà. (sostituzioni )CMFCPropertyGridProperty::OnEdit.)
CMFCPropertyGridColorProperty::OnUpdateValue Chiamato dal framework quando viene modificato il valore di una proprietà modificabile. (sostituzioni )CMFCPropertyGridProperty::OnUpdateValue.
CMFCPropertyGridColorProperty::SetColor Imposta un nuovo colore per la proprietà.
CMFCPropertyGridColorProperty::SetColumnsNumber Specifica il numero di colonne nella griglia delle proprietà del colore corrente.
CMFCPropertyGridColorProperty::SetOriginalValue Imposta il valore originale di una proprietà modificabile.

Osservazioni:

La classe CMFCPropertyGridColorProperty supporta una proprietà Color che è possibile aggiungere a un controllo elenco delle proprietà. Per altre informazioni, vedere la classe CMFCPropertyGridCtrl.

Esempio

L'esempio seguente illustra come costruire un oggetto della classe CMFCPropertyGridColorProperty e configurare tale oggetto usando diversi metodi della classe CMFCPropertyGridColorProperty. Il codice illustra come abilitare i pulsanti "automatico" (Automatic) e "altro" (Other) e come impostare il colore e il numero di colonne. Questo esempio fa parte dell'esempio New Controls.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);

Gerarchia di ereditarietà

CObject

CMFCPropertyGridProperty

CMFCPropertyGridColorProperty

Requisiti

Intestazione: afxpropertygridctrl.h

CMFCPropertyGridColorProperty::CMFCPropertyGridColorProperty

Costruisce un oggetto CMFCPropertyGridColorProperty.

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

Parametri

strName
[in] Nome della proprietà.

color
[in] Valore del colore della proprietà.

pPalette
[in] Puntatore a una tavolozza di colori. Il valore predefinito è NULL.

lpszDescr
[in] Descrizione della proprietà. Il valore predefinito è NULL.

dwData
[in] Dati specifici dell'applicazione, ad esempio un numero intero o un puntatore ad altri dati associati alla proprietà . Il valore predefinito è 0.

CMFCPropertyGridColorProperty::EnableAutomaticButton

Abilita il pulsante automatico nella finestra di dialogo di selezione del colore. (Il pulsante automatico standard è etichettato Automatico.

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

Parametri

lpszLabel
[in] Testo dell'etichetta del pulsante automatico.

colorAutomatic
[in] Valore del colore RGB del colore automatico (impostazione predefinita).

bEnable
[in] TRUE per abilitare il pulsante automatico; in caso contrario, FALSE. Il valore predefinito è TRUE.

Osservazioni:

CMFCPropertyGridColorProperty::EnableOtherButton

Abilita l'altro pulsante nella finestra di dialogo di selezione dei colori. (l'altro pulsante standard è etichettato Altri colori.

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

Parametri

lpszLabel
[in] Testo dell'etichetta dell'altro pulsante.

bAltColorDlg
[in] TRUE per visualizzare la CMFCColorDialog finestra di dialogo; FALSE per visualizzare la finestra di dialogo di selezione dei colori standard. Il valore predefinito è TRUE.

bEnable
[in] TRUE per visualizzare l'altro pulsante; in caso contrario, FALSE. Il valore predefinito è TRUE.

Osservazioni:

CMFCPropertyGridColorProperty::GetColor

Ottiene il colore corrente della proprietà.

COLORREF GetColor() const;

Valore restituito

Valore di colore RGB.

Osservazioni:

CMFCPropertyGridColorProperty::SetColor

Imposta un nuovo colore per la proprietà.

void SetColor(COLORREF color);

Parametri

color
[in] Valore di colore RGB.

Osservazioni:

CMFCPropertyGridColorProperty::SetColumnsNumber

Specifica il numero di colonne nella griglia delle proprietà del colore corrente.

void SetColumnsNumber(int nColumnsNumber);

Parametri

nColumnsNumber
[in] Numero preferito di colonne nella griglia delle proprietà del colore.

Osservazioni:

Questo metodo imposta il valore del m_nColumnsNumber membro dati protetto.

CMFCPropertyGridColorProperty::SetOriginalValue

Imposta il valore originale di una proprietà modificabile.

virtual void SetOriginalValue(const COleVariant& varValue);

Parametri

varValue
[in] Valore .

Osservazioni:

Utilizzare il metodo CMFCPropertyGridProperty::ResetOriginalValue per reimpostare il valore originale di una proprietà modificata.

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCPropertyGridCtrl
Classe CMFCPropertyGridProperty