Partilhar via

CMFCPropertyGridColorProperty Class

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

A CMFCPropertyGridColorProperty classe suporta um item de controlo 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 Description
CMFCPropertyGradeColorProperty::CMFCPropertyGridColorProperty Constrói um CMFCPropertyGridColorProperty objeto.
CMFCPropertyGridColorProperty::~CMFCPropertyGridColorProperty Destruidor.

Métodos Públicos

Nome Description
CMFCPropertyGradeColorProperty::EnableAutomaticButton Ativa o botão automático na caixa de diálogo de seleção de cor. (O botão automático padrão é rotulado como Automático.)
CMFCPropertyGridColorProperty::EnableOtherButton Ativa o outro botão na caixa de diálogo de seleção de cores. (O outro botão padrão chama-se Mais Cores.)
CMFCPropertyGridColorProperty::FormatProperty Formata a representação textual de um valor de propriedade. (Sobrepõe CMFCPropertyGridProperty::FormatProperty.)
CMFCPropertyGridColorProperty::GetColor Obtém a cor atual da propriedade.
CMFCPropertyGridColorProperty::GetThisClass Usado pelo framework para obter um ponteiro para o objeto CRuntimeClass associado a este tipo de classe.
CMFCPropertyGridColorProperty::OnClickButton Chamado pelo framework quando o utilizador clica num botão contido numa propriedade. (Sobrepõe CMFCPropertyGridProperty::OnClickButton.)
CMFCPropertyGridColorProperty::OnDrawValue Chamado pelo framework para mostrar o valor da propriedade. (Sobrepõe CMFCPropertyGridProperty::OnDrawValue.)
CMFCPropertyGridColorProperty::OnEdit Chamado pelo framework quando o utilizador está prestes a modificar o valor de uma propriedade. (Sobrepõe CMFCPropertyGridProperty::OnEdit.)
CMFCPropertyGridColorProperty::OnUpdateValue Chamado pelo framework quando o valor de uma propriedade editável mudou. (Sobrepõe CMFCPropertyGridProperty::OnUpdateValue.)
CMFCPropertyGradeColorProperty::SetColor Define uma nova cor para a propriedade.
CMFCPropertyGradeColorProperty::SetColumnsNumber Especifica o número de colunas na grelha atual de propriedades de cor.
CMFCPropertyGradeColorProperty::SetOriginalValue Define o valor original de uma propriedade editável.

Observações

A CMFCPropertyGridColorProperty classe suporta uma propriedade de cor que pode ser adicionada a um controlo de lista de propriedades. Para mais informações, consulte a Classe CMFCPropertyGridCtrl.

Example

O exemplo seguinte demonstra como construir um objeto da CMFCPropertyGridColorProperty classe e configurá-lo usando vários métodos da CMFCPropertyGridColorProperty classe. O código explica como ativar os botões automáticos e outros, e como definir a cor e o número das colunas. Este exemplo faz parte do exemplo New Controls.

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

Requerimentos

Cabeçalho: afxpropertygridctrl.h

CMFCPropertyGradeColorProperty::CMFCPropertyGridColorProperty

Constrói um CMFCPropertyGridColorProperty objeto.

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

Parâmetros

strName
[dentro] O nome da propriedade.

cor
[dentro] O valor da cor da propriedade.

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

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

dwData
[dentro] Dados específicos da aplicação, como um inteiro ou um ponteiro para outros dados associados à propriedade. O valor padrão é 0.

CMFCPropertyGradeColorProperty::EnableAutomaticButton

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

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

Parâmetros

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

colorAutomatic
[dentro] O valor da cor RGB da cor automática (por defeito).

bEnable
[dentro] TRUE para ativar o botão automático; caso contrário, FALSO. O valor padrão é VERDADEIRO.

Observações

CMFCPropertyGridColorProperty::EnableOtherButton

Ativa o outro botão na caixa de diálogo de seleção de cores. (O outro botão padrão chama-se Mais Cores.)

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

Parâmetros

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

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

bEnable
[dentro] TRUE para mostrar o outro botão; caso contrário, FALSO. O valor padrão é VERDADEIRO.

Observações

CMFCPropertyGridColorProperty::GetColor

Obtém a cor atual da propriedade.

COLORREF GetColor() const;

Valor de retorno

Um valor de cor RGB.

Observações

CMFCPropertyGradeColorProperty::SetColor

Define uma nova cor para a propriedade.

void SetColor(COLORREF color);

Parâmetros

cor
[dentro] Um valor de cor RGB.

Observações

CMFCPropertyGradeColorProperty::SetColumnsNumber

Especifica o número de colunas na grelha atual de propriedades de cor.

void SetColumnsNumber(int nColumnsNumber);

Parâmetros

nColunasNúmero
[dentro] O número preferido de colunas na grelha de propriedades de cor.

Observações

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

CMFCPropertyGradeColorProperty::SetOriginalValue

Define o valor original de uma propriedade editável.

virtual void SetOriginalValue(const COleVariant& varValue);

Parâmetros

varValue
[dentro] Um valor.

Observações

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

Consulte também

Gráfico de Hierarquia
Classes
Classe CMFCPropertyGridCtrl
CMFCPropertyGridProperty Class

  • Last updated on