Classe CMFCPropertyGridColorProperty

  • Artigo

A classe CMFCPropertyGridColorProperty dá suporte a um item de controle de lista de propriedades que abre uma caixa de diálogo de seleção de cores.

Sintaxe

class CMFCPropertyGridColorProperty : public CMFCPropertyGridProperty

Membros

Construtores públicos

Nome Descrição
CMFCPropertyGridColorProperty::CMFCPropertyGridColorProperty Constrói um objeto CMFCPropertyGridColorProperty.
CMFCPropertyGridColorProperty::~CMFCPropertyGridColorProperty Destruidor.

Métodos públicos

Nome Descrição
CMFCPropertyGridColorProperty::EnableAutomaticButton Habilita o botão automático na caixa de diálogo seleção de cores. (O botão automático padrão é rotulado como Automático.)
CMFCPropertyGridColorProperty::EnableOtherButton Habilita o botão outro na caixa de diálogo seleção de cores. (O botão outro padrão é rotulado como Mais Cores.)
CMFCPropertyGridColorProperty::FormatProperty Formata a representação de texto de um valor da propriedade. (Substitui CMFCPropertyGridProperty::FormatProperty.)
CMFCPropertyGridColorProperty::GetColor Obtém o valor de cor atual da propriedade.
CMFCPropertyGridColorProperty::GetThisClass Usado pela estrutura para obter um ponteiro para o objeto CRuntimeClass associado a esse tipo de classe.
CMFCPropertyGridColorProperty::OnClickButton Chamado pela estrutura quando o usuário clica em um botão contido em uma propriedade. (Substitui CMFCPropertyGridProperty::OnClickButton.)
CMFCPropertyGridColorProperty::OnDrawValue Chamado pela estrutura para exibir o valor da propriedade. (Substitui CMFCPropertyGridProperty::OnDrawValue.)
CMFCPropertyGridColorProperty::OnEdit Chamado pela estrutura quando o usuário está prestes a modificar um valor da propriedade. (Substitui CMFCPropertyGridProperty::OnEdit.)
CMFCPropertyGridColorProperty::OnUpdateValue Chamado pela estrutura quando o valor de uma propriedade editável foi alterado. (Substitui CMFCPropertyGridProperty::OnUpdateValue.)
CMFCPropertyGridColorProperty::SetColor Define uma nova cor para a propriedade.
CMFCPropertyGridColorProperty::SetColumnsNumber Especifica o número de colunas na grade de propriedades de cores atual.
CMFCPropertyGridColorProperty::SetOriginalValue Define o valor original de uma propriedade editável.

Comentários

A classe CMFCPropertyGridColorProperty dá suporte a uma propriedade de cor que pode ser adicionada a um controle de lista de propriedades. Para mais informações, confira a Classe CMFCPropertyGridCtrl.

Exemplo

O exemplo a seguir demonstra como construir um objeto da classe CMFCPropertyGridColorProperty e configurar esse objeto usando vários métodos da classe CMFCPropertyGridColorProperty. O código explica como habilitar os botões automáticos e outros e como definir a cor e o número das colunas. Este exemplo faz parte da amostra de Novos Controles.

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

Hierarquia de herança

CObject

CMFCPropertyGridProperty

CMFCPropertyGridColorProperty

Requisitos

Cabeçalho: afxpropertygridctrl.h

CMFCPropertyGridColorProperty::CMFCPropertyGridColorProperty

Constrói um objeto CMFCPropertyGridColorProperty.

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

Parâmetros

strName
[in] O nome da propriedade.

color
[in] O valor de cor da propriedade.

pPalette
[in] Ponteiro para uma paleta de cores. O valor padrão é NULL.

lpszDescr
[in] A descrição da propriedade. O valor padrão é NULL.

dwData
[in] Dados específicos do aplicativo, como um inteiro ou um ponteiro para outros dados associados à propriedade. O valor padrão é 0.

CMFCPropertyGridColorProperty::EnableAutomaticButton

Habilita o botão automático na caixa de diálogo seleção de cores. (O botão automático padrão é rotulado como Automático.)

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

Parâmetros

lpszLabel
[in] O texto da etiqueta do botão automático.

colorAutomatic
[in] O valor de cor RGB da cor automática (padrão).

bEnable
[in] TRUE para habilitar o botão automático; caso contrário, FALSE. O valor padrão é TRUE.

Comentários

CMFCPropertyGridColorProperty::EnableOtherButton

Habilita o botão outro na caixa de diálogo seleção de cores. (O botão outro padrão é rotulado como Mais Cores.)

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

Parâmetros

lpszLabel
[in] O texto da etiqueta do outro botão.

bAltColorDlg
[in] TRUE para exibir a caixa de diálogo CMFCColorDialog; FALSE para exibir a caixa de diálogo de seleção de cores padrão. O valor padrão é TRUE.

bEnable
[in] TRUE para exibir o outro botão; caso contrário, FALSE. O valor padrão é TRUE.

Comentários

CMFCPropertyGridColorProperty::GetColor

Obtém o valor de cor atual da propriedade.

COLORREF GetColor() const;

Valor de retorno

Um valor para a cor RGB.

Comentários

CMFCPropertyGridColorProperty::SetColor

Define uma nova cor para a propriedade.

void SetColor(COLORREF color);

Parâmetros

color
[in] Um valor de cor RGB.

Comentários

CMFCPropertyGridColorProperty::SetColumnsNumber

Especifica o número de colunas na grade de propriedades de cores atual.

void SetColumnsNumber(int nColumnsNumber);

Parâmetros

nColumnsNumber
[in] O número preferencial de colunas na grade de propriedades de cores.

Comentários

Esse método define o valor do membro de dados m_nColumnsNumber protegido.

CMFCPropertyGridColorProperty::SetOriginalValue

Define o valor original de uma propriedade editável.

virtual void SetOriginalValue(const COleVariant& varValue);

Parâmetros

varValue
[in] Um valor.

Comentários

Use o método CMFCPropertyGridProperty::ResetOriginalValue para redefinir o valor original de uma propriedade editada.

Confira também

Gráfico da hierarquia
Classes
Classe CMFCPropertyGridCtrl
Classe CMFCPropertyGridProperty