Classe CMFCPropertyGridCtrl

Para obter mais detalhes, consulte o código-fonte localizado na pasta mfc da instalação do Visual Studio. Por exemplo, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Oferece suporte a um controle de grade de propriedade editável que pode exibir propriedades em ordem alfabética ou hierárquica.

Sintaxe

class CMFCPropertyGridCtrl : public CWnd

Membros

Construtores públicos

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

Métodos públicos

Nome	Descrição
CMFCPropertyGridCtrl::accHitTest	Chamado pela estrutura para recuperar o elemento filho ou o objeto filho em um determinado ponto na tela. (Substitui CWnd::accHitTest.)
CMFCPropertyGridCtrl::accLocation	Chamado pela estrutura para recuperar a localização do objeto especificado na tela atual. (Substitui CWnd::accLocation.)
CMFCPropertyGridCtrl::accSelect	Chamado pela estrutura para modificar a seleção ou mover o foco do teclado do objeto especificado. (Substitui CWnd::accSelect.)
CMFCPropertyGridCtrl::AddProperty	Adiciona uma nova propriedade a um controle de grade de propriedades.
CMFCPropertyGridCtrl::AlwaysShowUserToolTip
CMFCPropertyGridCtrl::CloseColorPopup	Fecha a caixa de diálogo seleção de cores.
CMFCPropertyGridCtrl::Create	Cria um controle de grade de propriedades e o anexa ao objeto do controle de grade de propriedades.
CMFCPropertyGridCtrl::DeleteProperty	Exclui a propriedade especificada do controle de grade de propriedades.
CMFCPropertyGridCtrl::DrawControlBarColors
CMFCPropertyGridCtrl::EnableDescriptionArea	Habilita ou desabilita a área de descrição exibida abaixo da lista de propriedades.
CMFCPropertyGridCtrl::EnableHeaderCtrl	Habilita ou desabilita o controle de cabeçalho na parte superior do controle de grade de propriedades.
CMFCPropertyGridCtrl::EnsureVisible	Rola um controle de grade de propriedades e expande os itens de propriedade até que a propriedade especificada esteja visível.
CMFCPropertyGridCtrl::ExpandAll	Expande ou recolhe todos os nós de controle de grade de propriedades.
CMFCPropertyGridCtrl::FindItemByData	Recupera a propriedade associada a um valor DWORD definido pelo usuário.
CMFCPropertyGridCtrl::get_accChild	Chamado pela estrutura para recuperar o endereço de uma interface IDispatch para o filho especificado. (Substitui CWnd::get_accChild.)
CMFCPropertyGridCtrl::get_accChildCount	Chamado pela estrutura para recuperar o número de filhos que pertencem a esse objeto. (Substitui CWnd::get_accChildCount.)
CMFCPropertyGridCtrl::get_accDefaultAction	Chamado pela estrutura para recuperar uma cadeia de caracteres que descreve a ação padrão do objeto. (Substitui CWnd::get_accDefaultAction.)
CMFCPropertyGridCtrl::get_accDescription	Chamado pela estrutura para recuperar uma cadeia de caracteres que descreve a aparência visual do objeto especificado. (Substitui CWnd::get_accDescription.)
CMFCPropertyGridCtrl::get_accFocus	Chamado pela estrutura para recuperar o objeto que tem o foco do teclado. (Substitui CWnd::get_accFocus.)
CMFCPropertyGridCtrl::get_accHelp	Chamado pela estrutura para recuperar a cadeia de caracteres de propriedade de um objeto Help. (Substitui CWnd::get_accHelp.)
CMFCPropertyGridCtrl::get_accHelpTopic	Chamado pela estrutura para recuperar o caminho completo do arquivo WinHelp associado ao objeto especificado e o identificador do tópico apropriado dentro desse arquivo. (Substitui CWnd::get_accHelpTopic.)
CMFCPropertyGridCtrl::get_accKeyboardShortcut	Chamado pela estrutura para recuperar a tecla de atalho ou a tecla de acesso do objeto especificado. (Substitui CWnd::get_accKeyboardShortcut.)
CMFCPropertyGridCtrl::get_accName	Chamado pela estrutura para recuperar o nome do objeto especificado. (Substitui CWnd::get_accName.)
CMFCPropertyGridCtrl::get_accRole	Chamado pela estrutura para recuperar informações que descrevem a função do objeto especificado. (Substitui CWnd::get_accRole.)
CMFCPropertyGridCtrl::get_accSelection	Chamado pela estrutura para recuperar os filhos selecionados desse objeto. (Substitui CWnd::get_accSelection.)
CMFCPropertyGridCtrl::get_accState	Chamado pela estrutura para recuperar o estado atual do objeto especificado. (Substitui CWnd::get_accState.)
CMFCPropertyGridCtrl::get_accValue	Chamado pela estrutura para recuperar o valor do objeto especificado. (Substitui CWnd::get_accValue.)
CMFCPropertyGridCtrl::GetBkColor	Recupera a cor da tela de fundo do controle de grade de propriedade atual.
CMFCPropertyGridCtrl::GetBoldFont	Recupera a fonte do Windows do texto no controle de grade de propriedades atual em estilo negrito.
CMFCPropertyGridCtrl::GetCurSel	Recupera a propriedade selecionada no momento.
CMFCPropertyGridCtrl::GetCustomColors	Recupera as cores personalizadas definidas atualmente para elementos do controle de grade de propriedades.
CMFCPropertyGridCtrl::GetDescriptionHeight	Recupera a altura da área de descrição localizada na parte inferior do controle de grade de propriedades.
CMFCPropertyGridCtrl::GetDescriptionRows	Recupera o número de linhas na área de descrição do controle de grade de propriedade atual.
CMFCPropertyGridCtrl::GetHeaderCtrl	Recupera o objeto CMFCHeaderCtrl interno que a estrutura usa para exibir o controle de grade de propriedades atual.
CMFCPropertyGridCtrl::GetHeaderHeight	Recupera a altura do cabeçalho do controle de grade de propriedades.
CMFCPropertyGridCtrl::GetLeftColumnWidth	Recupera a largura da coluna esquerda do controle de grade de propriedades atual, a qual contém o nome de cada propriedade.
CMFCPropertyGridCtrl::GetListRect	Recupera o retângulo delimitador do controle de grade de propriedades.
CMFCPropertyGridCtrl::GetProperty	Recupera um ponteiro para o objeto de propriedade que corresponde ao índice especificado de um item do controle de grade de propriedades.
CMFCPropertyGridCtrl::GetPropertyColumnWidth	Recupera a largura atual da coluna que contém valores da propriedade.
CMFCPropertyGridCtrl::GetPropertyCount	Recupera o número de propriedades em um controle de grade de propriedades.
CMFCPropertyGridCtrl::GetRowHeight	Recupera a altura de uma linha no controle de grade de propriedades.
CMFCPropertyGridCtrl::GetScrollBarCtrl	Recupera um ponteiro para o controle de barra de rolagem no controle de grade de propriedades. (Substitui CWnd::GetScrollBarCtrl.)
CMFCPropertyGridCtrl::GetTextColor	Recupera a cor do texto dos itens de propriedade no controle de grade de propriedades atual.
CMFCPropertyGridCtrl::GetThisClass	Usado pela estrutura para obter um ponteiro para o objeto CRuntimeClass associado a esse tipo de classe.
CMFCPropertyGridCtrl::HitTest	Recupera um ponteiro para o objeto de propriedade que corresponde a um item do controle de grade de propriedades, se um ponto especificado estiver no item. Esse método também indica a área no controle de grade de propriedades que contém o ponto.
CMFCPropertyGridCtrl::InitHeader	Inicializa o objeto CMFCHeaderCtrl interno que a estrutura usa para exibir o controle de grade de propriedades atual.
CMFCPropertyGridCtrl::IsAlphabeticMode	Indica se um controle de grade de propriedades está no modo alfabético.
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	Indica se a área da descrição do controle de grade de propriedades é exibida.
CMFCPropertyGridCtrl::IsGroupNameFullWidth	Indica se cada nome do grupo de propriedades é exibido na largura do controle de grade de propriedades atual.
CMFCPropertyGridCtrl::IsHeaderCtrl	Indica se o controle de cabeçalho é exibido.
CMFCPropertyGridCtrl::IsMarkModifiedProperties	Indica como o controle de grade de propriedades exibe as propriedades modificadas.
CMFCPropertyGridCtrl::IsShowDragContext	Indica se a estrutura redesenhará as colunas de nome e de valor do controle de grade de propriedades atual quando um usuário redimensionar as colunas.
CMFCPropertyGridCtrl::IsVSDotNetLook	Indica se a aparência do controle de grade de propriedades está no estilo usado pelo VS .NET.
CMFCPropertyGridCtrl::MarkModifiedProperties	Especifica como exibir propriedades modificadas.
CMFCPropertyGridCtrl::PreTranslateMessage	Usado pela classe CWinApp para converter mensagens de janela antes de serem expedidas para as funções TranslateMessage e DispatchMessage do Windows. (Substitui CWnd::PreTranslateMessage.)
CMFCPropertyGridCtrl::RemoveAll	Remove todos os objetos de propriedade de um controle de grade de propriedades.
CMFCPropertyGridCtrl::ResetOriginalValues	Restaura o valor original de todas as propriedades.
CMFCPropertyGridCtrl::SetAlphabeticMode	Define ou redefine o modo alfabético.
CMFCPropertyGridCtrl::SetBoolLabels	Especifica o texto de rótulos boolianos.
CMFCPropertyGridCtrl::SetCurSel	Seleciona uma propriedade em um controle de grade de propriedades.
CMFCPropertyGridCtrl::SetCustomColors	Especifica cores personalizadas para vários elementos do controle de grade de propriedades.
CMFCPropertyGridCtrl::SetDescriptionRows	Especifica o número de linhas a serem exibidas na seção de descrição do controle de grade de propriedades atual.
CMFCPropertyGridCtrl::SetGroupNameFullWidth	Especifica se deve ser exibida a largura total do nome da categoria para um grupo de propriedades no controle de grade de propriedades atual.
CMFCPropertyGridCtrl::SetListDelimiter	Define um caractere que será usado como um delimitador em uma lista de valores da propriedade.
CMFCPropertyGridCtrl::SetShowDragContext	Especifica se a estrutura redesenhará as colunas de nome e de valor do controle de grade de propriedades atual quando um usuário redimensionar as colunas.
CMFCPropertyGridCtrl::SetVSDotNetLook	Define a aparência do controle de grade de propriedades para o estilo usado no VS .NET.
CMFCPropertyGridCtrl::UpdateColor	Define o valor de cor da propriedade de cores selecionada no momento.

Métodos protegidos

Nome	Descrição
CMFCPropertyGridCtrl::AdjustLayout	Redesenha o controle de grade de propriedades e suas propriedades.
CMFCPropertyGridCtrl::CompareProps	Chamado pelo controle de grade de propriedades para classificar propriedades.
CMFCPropertyGridCtrl::EditItem	Chamado pela estrutura quando o usuário começa a modificar uma propriedade.
CMFCPropertyGridCtrl::EndEditItem	Chamado pela estrutura quando o usuário para de modificar uma propriedade.
CMFCPropertyGridCtrl::Init	Chamado pela estrutura para inicializar um controle de grade de propriedades.
CMFCPropertyGridCtrl::OnChangeSelection	Chamado pela estrutura quando a seleção atual é alterada.
CMFCPropertyGridCtrl::OnClickButton	Chamado pela estrutura quando um botão de propriedade é clicado.
CMFCPropertyGridCtrl::OnDrawBorder	Chamado pela estrutura para desenhar uma borda ao redor de um controle de grade de propriedades.
CMFCPropertyGridCtrl::OnDrawDescription	Chamado pela estrutura para desenhar a área de descrição e exibir o texto da descrição.
CMFCPropertyGridCtrl::OnDrawList	Chamado pela estrutura para exibir a lista de propriedades no controle da grade de propriedades.
CMFCPropertyGridCtrl::OnDrawProperty	Chamado pela estrutura para exibir uma propriedade.
CMFCPropertyGridCtrl::OnPropertyChanged	Chamado pela estrutura quando o valor de uma propriedade é alterado.
CMFCPropertyGridCtrl::OnSelectCombo	Chamado pela estrutura quando uma propriedade que contém um controle de caixa de combinação é selecionada.
CMFCPropertyGridCtrl::ValidateItemData	Chamado pela estrutura para validar os dados da propriedade.

Comentários

A classe CMFCPropertyGridCtrl exibe um controle de grade de propriedades que contém propriedades editáveis derivadas da classe CMFCPropertyGridProperty. Cada propriedade pode representar um tipo e pode conter subitens. O controle de grade de propriedades dá suporte a uma área redimensionável na parte inferior que pode exibir a descrição de uma propriedade selecionada.

Para usar um controle de grade de propriedades, construa um objeto CMFCPropertyGridCtrl e chame o método CMFCPropertyGridCtrl::Create. Use o método CMFCPropertyGridCtrl::AddProperty para adicionar propriedades à lista.

Propriedades de seleção

Em vez de representar um valor, um item de propriedade pode iniciar uma caixa de diálogo que permite ao usuário selecionar uma cor, arquivo ou fonte.

A tabela a seguir lista quatro tipos de propriedade de seleção:

Classe	Descrição
Classe CMFCPropertyGridProperty	Uma propriedade de uso geral que serve para especificar o valor de cadeias de caracteres, boolianos, datas e assim por diante.
Classe CMFCPropertyGridColorProperty	Uma propriedade que é usada para selecionar um valor de cor.
Classe CMFCPropertyGridFileProperty	Uma propriedade que é usada para selecionar um arquivo.
Classe CMFCPropertyGridFontProperty	Uma propriedade que é usada para selecionar uma fonte.

Ilustrações

As ilustrações a seguir retratam um controle de grade de propriedades que exibe propriedades de duas maneiras. A primeira ilustração exibe as propriedades por hierarquia e a segunda exibe as propriedades em ordem alfabética.

Exemplo

O exemplo a seguir demonstra como configurar um objeto de controle de grade de propriedades usando vários métodos na classe CMFCPropertyGridCtrl. O exemplo demonstra como habilitar o controle de cabeçalho, habilitar a área de descrição e definir a aparência do controle de grade de propriedades. O exemplo também mostra como definir o modo alfabético para o controle, em que o controle classifica todas as propriedades que contém pelo nome da propriedade, e como definir as cores personalizadas para variados elementos do controle de grade de propriedades. Este exemplo faz parte da amostra de Novos Controles.

CMFCPropertyGridCtrl m_wndPropList;

m_wndPropList.EnableHeaderCtrl();
m_wndPropList.EnableDescriptionArea();
m_wndPropList.SetVSDotNetLook(m_bDotNetLook);
// BOOL m_bMarkChanged
m_wndPropList.MarkModifiedProperties(m_bMarkChanged);
// BOOL m_bPropListCategorized
m_wndPropList.SetAlphabeticMode(!m_bPropListCategorized);
// BOOL m_bShowDragContext
m_wndPropList.SetShowDragContext(m_bShowDragContext);

// BOOL m_bMarkSortedColumn
m_wndList.EnableMarkSortedColumn(m_bMarkSortedColumn);

// BOOL m_bPropListCustomColors
// set custom colors for various elements of the property grid control
if (m_bPropListCustomColors)
{
   m_wndPropList.SetCustomColors(RGB(228, 243, 254), RGB(46, 70, 165), RGB(200, 236, 209), RGB(33, 102, 49), RGB(255, 229, 216), RGB(128, 0, 0), RGB(159, 159, 255));
}
else
{
   COLORREF c = (COLORREF)-1;
   m_wndPropList.SetCustomColors(c, c, c, c, c, c, c);
}

m_wndPropList.RedrawWindow();

// restore original values of the properties
m_wndPropList.ResetOriginalValues();

Hierarquia de herança

CObject

CCmdTarget

CWnd

CMFCPropertyGridCtrl

Requisitos

Cabeçalho: afxpropertygridctrl.h

CMFCPropertyGridCtrl::accSelect

virtual HRESULT accSelect(
    long flagsSelect,
    VARIANT varChild);

Parâmetros

[in] flagsSelect
[in] varChild\

Valor de retorno

Comentários

CMFCPropertyGridCtrl::AddProperty

Adiciona uma nova propriedade a um controle de grade de propriedades.

int AddProperty(
    CMFCPropertyGridProperty* pProp,
    BOOL bRedraw=TRUE,
    BOOL bAdjustLayout=TRUE);

Parâmetros

pProp
[in] Ponteiro para uma propriedade.

bRedraw
[in] TRUE para redesenhar a propriedade imediatamente, caso contrário, FALSE. O valor padrão é TRUE.

bAdjustLayout
[in] TRUE para recalcular como desenhar o texto e o valor da propriedade e, em seguida, desenhar a propriedade; FALSE para usar os cálculos existentes para desenhar a propriedade. O valor padrão é TRUE.

Valor de retorno

Se esse método for bem-sucedido, será adicionado o índice baseado em zero da posição no controle de grade de propriedades onde está a propriedade; caso contrário, -1.

Comentários

Esse método adiciona um ponteiro à propriedade especificada ao final da lista de propriedades no controle de grade de propriedades. Não destrua as propriedades ou permita que elas saiam do escopo antes que o controle de grade seja destruído. Ao terminar de usar o controle de grade de propriedades, chame CMFCPropertyGridCtrl::RemoveAll para excluir todas as propriedades adicionadas. O método AddProperty falhará se a propriedade especificada já tiver sido adicionada à lista.

CMFCPropertyGridCtrl::AdjustLayout

Redesenha o controle de grade de propriedades e suas propriedades.

virtual void AdjustLayout();

Comentários

Esse método recalcula como desenhar todo o controle de grade de propriedades e suas propriedades, incluindo imagens, fontes e controles.

CMFCPropertyGridCtrl::AlwaysShowUserToolTip

void AlwaysShowUserToolTip(BOOL bShow = TRUE);

Parâmetros

[in] bShow\

Comentários

CMFCPropertyGridCtrl::CloseColorPopup

Fecha a caixa de diálogo seleção de cores.

virtual void CloseColorPopup();

Comentários

Para obter mais informações sobre a caixa de diálogo de seleção de cor, consulte CMFCPropertyGridColorProperty Classe.

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

Constrói um objeto CMFCPropertyGridCtrl.

CMFCPropertyGridCtrl();

Valor de retorno

Comentários

CMFCPropertyGridCtrl::CompareProps

Chamado pelo controle de grade de propriedades para classificar propriedades.

virtual int CompareProps(
    const CMFCPropertyGridProperty* pProp1,
    const CMFCPropertyGridProperty* pProp2) const;

Parâmetros

pProp1
Um ponteiro para uma propriedade.

pProp2
Um ponteiro para uma propriedade.

Valor de retorno

Valor de retorno	Descrição
< 0	O nome do parâmetro pProp1 é menor que o nome do parâmetro pProp2.
0	O nome do parâmetro pProp1 é igual ao nome do parâmetro pProp2.
> 0	O nome do objeto pProp1 é maior que o nome do parâmetro pProp2.

Comentários

Por padrão, esse método usa o método CString::Compare para comparar os membros CMFCPropertyGridProperty::m_strName dos parâmetros especificados.

CMFCPropertyGridCtrl::Create

Cria um controle de grade de propriedades e o anexa ao objeto do controle de grade de propriedades.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parâmetros

dwStyle
[in] Uma combinação bit a bit "or" (|) de estilos de janela.

rect
[in] Um retângulo delimitador que especifica o tamanho e a posição da janela, nas coordenadas de cliente de pParentWnd.

pParentWnd
[in] Ponteiro para a janela pai. Não deve ser NULL.

nID
[in] A ID da janela filho.

Valor de retorno

TRUE se a janela foi criada com êxito; caso contrário, FALSE.

Comentários

Para criar um controle de grade de propriedades, primeiro chame CMFCPropertyGridCtrl::CMFCPropertyGridCtrl para construir um objeto de grade de propriedades. Em seguida, chame CMFCPropertyGridCtrl::Create.

Exemplo

O exemplo a seguir demonstra como usar o método Create na classe CMFCPropertyGridCtrl. Este exemplo faz parte da amostra de Novos Controles.

// CRect rectPropList
// CMFCPropertyGridCtrl m_wndPropList
// The this pointer points to a CPage5 class which extends the CMFCPropertyPage class.
m_wndPropList.Create(WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_BORDER, rectPropList, this, (UINT)-1);

CMFCPropertyGridCtrl::DeleteProperty

Exclui a propriedade especificada do controle de grade de propriedades.

BOOL DeleteProperty(
    CMFCPropertyGridProperty*& pProp,
    BOOL bRedraw=TRUE,
    BOOL bAdjustLayout=TRUE);

Parâmetros

pProp
[in] Ponteiro para uma propriedade.

bRedraw
[in] TRUE para redesenhar o controle de grade de propriedades; caso contrário, FALSE. O valor padrão é TRUE.

bAdjustLayout
[in] TRUE para recalcular como desenhar todo o texto, imagens e itens no controle de grade de propriedades e desenhar o controle; caso contrário, FALSE. O valor padrão é TRUE.

Valor de retorno

TRUE se o método for bem-sucedido. Caso contrário, FALSE.

Comentários

Use esse método para excluir uma propriedade e quaisquer subitens do controle de grade de propriedades.

CMFCPropertyGridCtrl::DrawControlBarColors

BOOL DrawControlBarColors() const;

Valor de retorno

Comentários

CMFCPropertyGridCtrl::EditItem

Chamado pela estrutura quando o usuário começa a modificar uma propriedade.

virtual BOOL EditItem(
    CMFCPropertyGridProperty* pProp,
    LPPOINT lptClick=NULL);

Parâmetros

pProp
[in] Ponteiro para uma propriedade.

lptClick
[in] O ponto no controle de grade de propriedades em que o usuário clicou para iniciar a operação de edição. O ponto está nas coordenadas de cliente do controle. O valor padrão é NULL.

Valor de retorno

TRUE se o método for bem-sucedido; caso contrário, FALSE.

Comentários

CMFCPropertyGridCtrl::EnableDescriptionArea

Habilita ou desabilita a área de descrição exibida abaixo da lista de propriedades no controle de grade de propriedades.

void EnableDescriptionArea(BOOL bEnable=TRUE);

Parâmetros

bEnable
[in] TRUE para habilitar a área de descrição; FALSE para desabilitar a área de descrição. O valor padrão é TRUE.

Comentários

A área de descrição é exibida na parte inferior do controle de grade de propriedades. Por padrão, a área de descrição é desabilitada e não fica visível.

CMFCPropertyGridCtrl::EnableHeaderCtrl

Habilita ou desabilita o controle de cabeçalho na parte superior do controle de grade de propriedades.

void EnableHeaderCtrl(
    BOOL bEnable=TRUE,
    LPCTSTR lpszLeftColumn=_T("Property"),
    LPCTSTR lpszRightColumn=_T("Value"));

Parâmetros

bEnable
[in] TRUE para habilitar o controle de cabeçalho; FALSE para desabilitar o controle de cabeçalho. O valor padrão é TRUE.

lpszLeftColumn
[in] O título da coluna esquerda do controle de cabeçalho. O valor padrão é Property.

lpszRightColumn
[in] O título da coluna direita do controle de cabeçalho. O valor padrão é Value.

CMFCPropertyGridCtrl::EndEditItem

Chamado pela estrutura quando o usuário termina de modificar uma propriedade.

virtual BOOL EndEditItem(BOOL bUpdateData=TRUE);

Parâmetros

bUpdateData
[in] TRUE para especificar se os dados de propriedade modificados devem ser validados quando a operação de edição for concluída; caso contrário, FALSE. O valor padrão é TRUE.

Valor de retorno

TRUE se a operação de edição terminar com êxito; FALSE se os dados de propriedade modificados não forem válidos ou se a operação de edição deve continuar.

Comentários

CMFCPropertyGridCtrl::EnsureVisible

Rola um controle de grade de propriedades e expande os itens de propriedade até que a propriedade especificada esteja visível.

void EnsureVisible(
    CMFCPropertyGridProperty* pProp,
    BOOL bExpandParents=FALSE);

Parâmetros

pProp
[in] Ponteiro para uma propriedade.

bExpandParents
[in] TRUE para expandir os itens pai para tornar visível a propriedade especificada; caso contrário, FALSE. O padrão é FALSE.

Comentários

CMFCPropertyGridCtrl::ExpandAll

Expande ou recolhe todos os nós de controle de grade de propriedades.

void ExpandAll(BOOL bExpand=TRUE);

Parâmetros

bExpand
[in] TRUE para expandir todos os nós; FALSE para recolher todos os nós. O valor padrão é TRUE.

Comentários

CMFCPropertyGridCtrl::FindItemByData

Recupera a propriedade associada a um valor DWORD definido pelo usuário.

CMFCPropertyGridProperty* FindItemByData(
    DWORD_PTR dwData,
    BOOL bSearchSubItems=TRUE) const;

Parâmetros

dwData
[in] Um valor DWORD.

bSearchSubItems
[in] TRUE para pesquisar subitens de propriedade; caso contrário, FALSE. O valor padrão é TRUE.

Valor de retorno

Um ponteiro para o objeto de propriedade associado se esse método for bem-sucedido; caso contrário, NULL.

Comentários

Use o construtor CMFCPropertyGridCtrl::CMFCPropertyGridCtrl ou o método CMFCPropertyGridProperty::SetData para associar um DWORD a uma propriedade.

CMFCPropertyGridCtrl::get_accChildCount

virtual HRESULT get_accChildCount(long* pcountChildren);

Parâmetros

[in] pcountChildren\

Valor de retorno

Comentários

CMFCPropertyGridCtrl::get_accFocus

virtual HRESULT get_accFocus(VARIANT* pvarChild);

Parâmetros

[in] pvarChild\

Valor de retorno

Comentários

CMFCPropertyGridCtrl::get_accHelp

virtual HRESULT get_accHelp(
    VARIANT varChild,
    BSTR* pszHelp);

Parâmetros

[in] varChild
[in] pszHelp\

Valor de retorno

Comentários

CMFCPropertyGridCtrl::get_accHelpTopic

virtual HRESULT get_accHelpTopic(
    BSTR* pszHelpFile,
    VARIANT varChild,
    long* pidTopic);

Parâmetros

[in] pszHelpFile
[in] varChild
[in] pidTopic\

Valor de retorno

Comentários

CMFCPropertyGridCtrl::get_accKeyboardShortcut

virtual HRESULT get_accKeyboardShortcut(
    VARIANT varChild,
    BSTR* pszKeyboardShortcut);

Parâmetros

[in] varChild
[in] pszKeyboardShortcut\

Valor de retorno

Comentários

CMFCPropertyGridCtrl::get_accSelection

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Parâmetros

[in] pvarChildren\

Valor de retorno

Comentários

CMFCPropertyGridCtrl::GetBkColor

Recupera a cor da tela de fundo do controle de grade de propriedade atual.

COLORREF GetBkColor() const;

Valor de retorno

Um valor para a cor RGB.

Comentários

Esse método recupera a cor que a estrutura usa para desenhar a tela de fundo do controle de grade de propriedades atual. O método CMFCPropertyGridCtrl::GetTextColor recupera a cor de primeiro plano.

CMFCPropertyGridCtrl::GetBoldFont

Recupera a fonte do Windows usada para desenhar texto no controle de grade de propriedades atual em estilo negrito.

CFont& GetBoldFont();

Valor de retorno

Uma referência a um objeto CFont que descreve as características de uma fonte em negrito.

CMFCPropertyGridCtrl::GetCurSel

Recupera a propriedade selecionada no momento.

CMFCPropertyGridProperty* GetCurSel() const;

Valor de retorno

Um ponteiro para o objeto de propriedade que corresponde ao item selecionado no controle de grade de propriedade.

Comentários

CMFCPropertyGridCtrl::GetCustomColors

Recupera as cores personalizadas definidas atualmente para elementos do controle de grade de propriedades.

void GetCustomColors(
    COLORREF& clrBackground,
    COLORREF& clrText,
    COLORREF& clrGroupBackground,
    COLORREF& clrGroupText,
    COLORREF& clrDescriptionBackground,
    COLORREF& clrDescriptionText,
    COLORREF& clrLine);

Parâmetros

clrBackground
[out] A cor da tela de fundo dos valores da propriedade.

clrText
[out] A cor dos nomes de propriedade e o texto do valor da propriedade.

clrGroupBackground
[out] A cor da tela de fundo de um grupo de propriedades.

clrGroupText
[out] A cor do texto no grupo de propriedades.

clrDescriptionBackground
[out] A cor da tela de fundo da área de descrição.

clrDescriptionText
[out] A cor do texto na área de descrição.

clrLine
[out] A cor das linhas desenhadas entre propriedades.

Comentários

Use o método CMFCPropertyGridCtrl::SetCustomColors para definir cores personalizadas.

CMFCPropertyGridCtrl::GetDescriptionHeight

Recupera a altura da área de descrição, que está localizada na parte inferior do controle de grade de propriedades.

int GetDescriptionHeight() const;

Valor de retorno

A altura da área de descrição, em pixels.

Comentários

A altura da área de descrição é calculada automaticamente e é definida como 1/4 a altura do controle de grade de propriedades.

Use o método CMFCPropertyGridCtrl::EnableDescriptionArea para exibir ou ocultar a área de descrição. Use o método CMFCPropertyGridCtrl::IsDescriptionArea para determinar se a área de descrição será exibida ou ficará oculta.

CMFCPropertyGridCtrl::GetDescriptionRows

Recupera o número de linhas na área de descrição do controle de grade de propriedade atual.

int GetDescriptionRows() const;

Valor de retorno

O número de linhas na área de descrição do controle de grade de propriedade atual.

Comentários

O construtor CMFCPropertyGridCtrl::CMFCPropertyGridCtrl inicializa a área de descrição para três linhas.

CMFCPropertyGridCtrl::GetHeaderCtrl

Recupera o objeto CMFCHeaderCtrl interno que a estrutura usa para exibir o controle de grade de propriedades atual.

virtual CMFCHeaderCtrl& GetHeaderCtrl();

Valor de retorno

Uma referência a um objeto CMFCHeaderCtrl.

CMFCPropertyGridCtrl::GetHeaderHeight

Recupera a altura do cabeçalho de um controle de grade de propriedades.

int GetHeaderHeight() const;

Valor de retorno

A altura do cabeçalho, em pixels.

Comentários

CMFCPropertyGridCtrl::GetLeftColumnWidth

Recupera a largura da coluna esquerda do controle de grade de propriedades atual, a qual contém o nome de cada propriedade.

int GetLeftColumnWidth() const;

Valor de retorno

A largura da coluna de nome.

Comentários

A coluna direita de um controle de grade de propriedades contém o valor de cada propriedade.

CMFCPropertyGridCtrl::GetListRect

Recupera o retângulo delimitador do controle de grade de propriedades.

CRect GetListRect() const;

Valor de retorno

O retângulo delimitador do controle de grade de propriedades. Esse retângulo não inclui a área de descrição e o cabeçalho.

Comentários

CMFCPropertyGridCtrl::GetProperty

Recupera um ponteiro para o objeto de propriedade que corresponde ao índice especificado de um item em um controle de grade de propriedades.

CMFCPropertyGridProperty* GetProperty(int nIndex) const;

Parâmetros

nIndex
[in] O índice baseado em zero de um item de controle de grade de propriedades.

Esse método declara se o parâmetro nIndex é menor que zero ou maior ou igual ao número de propriedades.

Valor de retorno

Um ponteiro para o objeto de propriedade que corresponde ao índice especificado se esse método for bem-sucedido; caso contrário, NULL.

Comentários

CMFCPropertyGridCtrl::GetPropertyColumnWidth

Recupera a largura atual da coluna que contém valores da propriedade.

int GetPropertyColumnWidth() const;

Valor de retorno

A largura atual da coluna que contém valores da propriedade.

Comentários

A coluna à direita no controle de grade de propriedades contém os valores da propriedade. Um cliente pode usar a caixa de divisão do controle de grade de propriedades para alterar a largura da coluna de valores.

CMFCPropertyGridCtrl::GetPropertyCount

Recupera o número de propriedades em um controle de grade de propriedades.

int GetPropertyCount() const;

Valor de retorno

O número de propriedades.

Comentários

CMFCPropertyGridCtrl::GetRowHeight

Recupera a altura de uma linha no controle de grade de propriedades.

int GetRowHeight() const;

Valor de retorno

A altura de uma linha.

Comentários

A altura de uma linha é igual à altura da fonte atual mais 4 pixels.

CMFCPropertyGridCtrl::GetScrollBarCtrl

Recupera um ponteiro para o controle de barra de rolagem no controle de grade de propriedades.

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

Parâmetros

nBar
[in] A orientação da barra de rolagem, que deve ser SB_VERT.

Valor de retorno

Um ponteiro para um objeto de barra de rolagem ou NULL se não houver barra de rolagem ou a orientação da barra de rolagem for SB_HORZ.

Comentários

Use este método para obter acesso direto ao controle de barra de rolagem vertical.

CMFCPropertyGridCtrl::GetTextColor

Recupera a cor que é usada para desenhar o texto dos itens de propriedade no controle de grade de propriedades atual.

COLORREF GetTextColor() const;

Valor de retorno

Um valor para a cor RGB.

Comentários

Esse método recupera a cor que a estrutura usa para desenhar o primeiro plano do controle de grade de propriedades atual. O método CMFCPropertyGridCtrl::GetBkColor recupera a cor do primeiro plano.

CMFCPropertyGridCtrl::HitTest

Recupera um ponteiro para o objeto de propriedade que corresponde a um item do controle de grade de propriedades, se um ponto especificado estiver no item. Esse método também indica a área no controle de grade de propriedades que contém o ponto.

CMFCPropertyGridProperty* HitTest(
    CPoint pt,
    CMFCPropertyGridProperty::ClickArea* pnArea=NULL,
    BOOL bPropsOnly=FALSE) const;

Parâmetros

pt
[in] Um ponto, nas coordenadas do cliente.

pnArea
[in, out] Um ponteiro para uma variável ClickArea. Quando esse método retorna, a variável indica a área de propriedade que contém o ponto especificado. Para saber mais sobre uma área de propriedade, confira os Comentários.

bPropsOnly
[in] TRUE para testar apenas a área de propriedade; FALSE para testar a área de descrição se o ponto especificado não estiver na área de propriedade. O valor padrão é FALSE. Para saber mais sobre uma área de descrição, confira os Comentários.

Valor de retorno

Se o parâmetro bPropsOnly for TRUE e o ponto especificado estiver em uma área de propriedade, o valor retornado será um ponteiro para o objeto de propriedade correspondente. Além disso, o parâmetro pnArea é definido como a área específica que contém o ponto especificado. Caso contrário, o valor retornado será NULL e o parâmetro pnArea não será modificado.

Se o parâmetro bPropsOnly for FALSE, o valor retornado será sempre NULL. No entanto, se o ponto especificado estiver na área de descrição, o parâmetro pnArea será definido como CMFCPropertyGridProperty::ClickDescription.

Comentários

O termo área de propriedade se refere a qualquer uma das áreas de caixa de expansão, nome ou valor de um item do controle de grade de propriedades. A área de descrição é a zona na parte inferior de um controle de grade de propriedades. Quando você seleciona um item de controle de grade de propriedades, a área de descrição exibe uma descrição da propriedade correspondente.

Esse método define o valor da variável para a qual o parâmetro pnArea aponta. A tabela a seguir lista os valores possíveis e as áreas correspondentes.

Valor	Área
ClickArea::ClickExpandBox	Controle da caixa de expansão de propriedade.
ClickArea::ClickName	Nome da propriedade.
ClickArea::ClickValue	Valor da propriedade.
CMFCPropertyGridProperty::ClickDescription	Área de descrição do controle de grade de propriedades.

CMFCPropertyGridCtrl::Init

Chamado pela estrutura para inicializar um controle de grade de propriedades.

virtual void Init();

Comentários

CMFCPropertyGridCtrl::InitHeader

Inicializa o objeto CMFCHeaderCtrl interno que a estrutura usa para exibir o controle de grade de propriedades atual.

virtual void InitHeader();

CMFCPropertyGridCtrl::IsAlphabeticMode

Indica se um controle de grade de propriedades está no modo alfabético.

BOOL IsAlphabeticMode() const;

Valor de retorno

TRUE se o controle de grade de propriedades estiver no modo alfabético; caso contrário FALSE.

Comentários

Quando o controle de grade de propriedades está no modo alfabético, todas as propriedades são classificadas em ordem alfabética por seus nomes. Caso contrário, as propriedades serão agrupadas sob seus nós pai.

Use o método CMFCPropertyGridCtrl::SetAlphabeticMode para habilitar ou desabilitar o modo alfabético.

CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip

BOOL IsAlwaysShowUserToolTip() const;

Valor de retorno

Comentários

CMFCPropertyGridCtrl::IsDescriptionArea

Indica se a área da descrição do controle de grade de propriedades é exibida.

BOOL IsDescriptionArea() const;

Valor de retorno

TRUE se a área de descrição for exibida; caso contrário, FALSE.

Comentários

Use o método CMFCPropertyGridCtrl::EnableDescriptionArea para ocultar ou exibir a área de descrição.

CMFCPropertyGridCtrl::IsGroupNameFullWidth

Indica se cada nome do grupo de propriedades é exibido na largura do controle de grade de propriedades atual.

BOOL IsGroupNameFullWidth() const;

Valor de retorno

TRUE se os nomes de grupo forem exibidos na largura do controle de grade de propriedade; FALSE se os nomes de grupo forem truncados pela coluna direita (valor) do controle.

Comentários

Um grupo é uma coleção de propriedades relacionadas em um controle de grade de propriedades. Se o controle for exibido hierarquicamente, o nome do grupo será exibido como um título de categoria na linha acima do grupo.

CMFCPropertyGridCtrl::IsHeaderCtrl

Indica se o controle de cabeçalho é exibido.

BOOL IsHeaderCtrl() const;

Valor de retorno

TRUE se o controle for exibido; caso contrário, FALSE.

Comentários

Use o método CMFCPropertyGridCtrl::EnableHeaderCtrl para ocultar ou exibir o controle de cabeçalho.

CMFCPropertyGridCtrl::IsMarkModifiedProperties

Indica como o controle de grade de propriedades exibe as propriedades modificadas.

BOOL IsMarkModifiedProperties() const;

Valor de retorno

TRUE se o estilo em negrito for usado para exibir propriedades modificadas; FALSE se o estilo regular for usado para exibir propriedades modificadas.

Comentários

CMFCPropertyGridCtrl::IsShowDragContext

Indica se a estrutura redesenhará as colunas de nome e de valor do controle de grade de propriedades atual quando um usuário redimensionar as colunas.

BOOL IsShowDragContext() const;

Valor de retorno

TRUE se a estrutura redesenhar as colunas de nome e valor durante uma operação de redimensionamento; FALSE se a estrutura redesenhar as colunas após a conclusão da operação de arrastar.

Comentários

O usuário pode redimensionar as colunas de nome e valor de um controle de grade de propriedades arrastando a barra de divisão que está entre as colunas. Se o contexto de arrastar for exibido, as colunas de nome e valor serão redimensionadas, contanto que o usuário arraste a barra de divisão. Caso contrário, a barra de divisão será movida, mas as colunas não serão redesenhadas até que a operação de arrastar seja concluída.

CMFCPropertyGridCtrl::IsVSDotNetLook

Indica se a aparência do controle de grade de propriedades está no estilo usado pelo Visual Studio .NET.

BOOL IsVSDotNetLook() const;

Valor de retorno

TRUE se o controle de grade de propriedades estiver no estilo do Visual Studio .NET; caso contrário, FALSE.

Comentários

Use o método CMFCPropertyGridCtrl::SetVSDotNetLook para definir o controle de grade de propriedades para o estilo do Visual Studio .NET.

CMFCPropertyGridCtrl::MarkModifiedProperties

Especifica como exibir propriedades modificadas.

void MarkModifiedProperties(
    BOOL bMark=TRUE,
    BOOL bRedraw=TRUE);

Parâmetros

bMark
[in] TRUE para exibir propriedades modificadas em estilo negrito; FALSE para exibir propriedades modificadas em estilo regular. O valor padrão é TRUE.

bRedraw
[in] TRUE para redesenhar imediatamente o controle de grade de propriedades; caso contrário, FALSE. O valor padrão é TRUE.

Comentários

CMFCPropertyGridCtrl::OnChangeSelection

Chamado pela estrutura quando a seleção atual é alterada.

virtual void OnChangeSelection(
    CMFCPropertyGridProperty* pNewSel,
    CMFCPropertyGridProperty* pOldSel);

Parâmetros

pNewSel
[in] Ponteiro para a propriedade recém-selecionada.

pOldSel
[in] Ponteiro para a propriedade selecionada anteriormente.

Comentários

A implementação padrão desse método não faz nada.

CMFCPropertyGridCtrl::OnClickButton

Chamado pela estrutura quando um botão de propriedade é clicado.

virtual void OnClickButton(CPoint point);

Parâmetros

point
[in] Um ponto, nas coordenadas do cliente.

Comentários

Por padrão, esse método atualiza o valor da propriedade atual.

CMFCPropertyGridCtrl::OnDrawBorder

Chamado pela estrutura para desenhar uma borda ao redor de um controle de grade de propriedades.

virtual void OnDrawBorder(CDC* pDC);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

Comentários

CMFCPropertyGridCtrl::OnDrawDescription

Chamado pela estrutura para desenhar a área de descrição e exibir o texto da descrição.

virtual void OnDrawDescription(
    CDC* pDC,
    CRect rect);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] Um retângulo que especifica onde desenhar a área de descrição.

Comentários

Use o método CMFCPropertyGridCtrl::EnableDescriptionArea para exibir a área de descrição.

CMFCPropertyGridCtrl::OnDrawList

Chamado pela estrutura para exibir a lista de propriedades no controle da grade de propriedades.

virtual void OnDrawList(CDC* pDC);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

Comentários

CMFCPropertyGridCtrl::OnDrawProperty

Chamado pela estrutura para exibir uma propriedade.

virtual int OnDrawProperty(
    CDC* pDC,
    CMFCPropertyGridProperty* pProp) const;

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pProp
[in] Um ponteiro para um objeto de propriedade.

Valor de retorno

TRUE se o método for bem-sucedido. Caso contrário, FALSE.

Comentários

CMFCPropertyGridCtrl::OnPropertyChanged

Chamado pela estrutura quando o valor de uma propriedade é alterado.

virtual void OnPropertyChanged(CMFCPropertyGridProperty* pProp) const;

Parâmetros

pProp
[in] Um ponteiro para um objeto de propriedade cujo valor foi alterado.

Comentários

Por padrão, esse método envia a mensagem AFX_WM_PROPERTY_CHANGED para o proprietário do controle de grade de propriedade.

CMFCPropertyGridCtrl::OnSelectCombo

Chamado pela estrutura quando uma propriedade que contém um controle de caixa de combinação é selecionada.

void OnSelectCombo();

Comentários

CMFCPropertyGridCtrl::RemoveAll

Remove todos os objetos de propriedade de um controle de grade de propriedades.

void RemoveAll();

Comentários

CMFCPropertyGridCtrl::ResetOriginalValues

Restaura os valores originais de todas as propriedades.

void ResetOriginalValues(BOOL bRedraw=TRUE);

Parâmetros

bRedraw
[in] TRUE para redesenhar a lista de propriedades; caso contrário, FALSE. O valor padrão é TRUE.

Comentários

CMFCPropertyGridCtrl::SetAlphabeticMode

Define ou redefine o modo alfabético.

void SetAlphabeticMode(BOOL bSet=TRUE);

Parâmetros

bSet
[in] TRUE para definir o modo alfabético; FALSE redefine o modo alfabético. O valor padrão é TRUE.

Comentários

Quando o controle de grade de propriedades está no modo alfabético, o controle classifica todas as propriedades que ele contém pelo nome da propriedade.

CMFCPropertyGridCtrl::SetBoolLabels

Especifica o texto de rótulos boolianos.

void SetBoolLabels(
    LPCTSTR lpszTrue,
    LPCTSTR lpszFalse);

Parâmetros

lpszTrue
[in] A cadeia de caracteres de texto a ser exibida para o valor booliano de true.

lpszFalse
[in] A cadeia de caracteres de texto a ser exibida para o valor booliano de false.

Comentários

CMFCPropertyGridCtrl::SetCurSel

Seleciona uma propriedade em um controle de grade de propriedades.

void SetCurSel(
    CMFCPropertyGridProperty* pProp,
    BOOL bRedraw=TRUE);

Parâmetros

pProp
[in] Um ponteiro para um objeto de propriedade.

bRedraw
[in] TRUE para redesenhar imediatamente o controle de grade de propriedades; caso contrário, FALSE. O valor padrão é TRUE.

Comentários

Use esse método para cancelar a seleção do item atual no controle de grade de propriedades e, em seguida, selecione o item que corresponde à propriedade especificada.

CMFCPropertyGridCtrl::SetCustomColors

Especifica cores personalizadas para variados elementos do controle de grade de propriedades.

void SetCustomColors(
    COLORREF clrBackground,
    COLORREF clrText,
    COLORREF clrGroupBackground,
    COLORREF clrGroupText,
    COLORREF clrDescriptionBackground,
    COLORREF clrDescriptionText,
    COLORREF clrLine);

Parâmetros

clrBackground
[in] A cor da tela de fundo dos valores da propriedade.

clrText
[in] A cor dos nomes de propriedade e o texto do valor da propriedade.

clrGroupBackground
[in] A cor da tela de fundo de um grupo de propriedades.

clrGroupText
[in] A nova cor do texto do grupo de propriedades.

clrDescriptionBackground
[in] A cor da tela de fundo da área de descrição.

clrDescriptionText
[in] A cor do texto na área de descrição.

clrLine
[in] A cor das linhas desenhadas entre propriedades.

Comentários

Para qualquer parâmetro, especifique o valor de cor ((COLORREF)-1) para usar a cor padrão para esse elemento do controle de grade de propriedades.

Para personalizar a aparência de uma propriedade específica, derive uma classe da classe CMFCPropertyGridProperty e, em seguida, substitua os métodos CMFCPropertyGridProperty::OnDrawName, CMFCPropertyGridProperty::OnDrawValue, CMFCPropertyGridProperty::OnDrawExpandBox e CMFCPropertyGridProperty::OnDrawButton.

CMFCPropertyGridCtrl::SetDescriptionRows

Especifica o número de linhas a serem exibidas na seção de descrição do controle de grade de propriedades atual.

void SetDescriptionRows(int nDescRows);

Parâmetros

nDescRows
[in] O número de linhas a serem exibidas na descrição da propriedade.

CMFCPropertyGridCtrl::SetGroupNameFullWidth

Especifica se deve ser exibida a largura total do nome da categoria para um grupo de propriedades no controle de grade de propriedades atual.

void SetGroupNameFullWidth(
    BOOL bGroupNameFullWidth = TRUE,
    BOOL bRedraw = TRUE);

Parâmetros

bGroupNameFullWidth
[in] TRUE para exibir a largura completa do nome da categoria, independentemente da largura da coluna de nome da propriedade. FALSE para limitar a largura do nome da categoria à largura da coluna de nome da propriedade. O valor padrão é TRUE.

bRedraw
[in] TRUE para atualizar o controle de grade de propriedades imediatamente; FALSE para atualizar o controle quando o próximo redesenho de evento ocorrer. O valor padrão é TRUE.

Comentários

O controle de grade de propriedades consiste em uma coluna de nome da propriedade redimensionável e uma coluna de valor da propriedade. O final da coluna de nome também é o início da coluna de valor. Para redimensionar as colunas, arraste a borda entre as colunas.

Os termos nome do grupo e nome da categoria são usados de forma intercambiável neste método. O nome da categoria é exibido em uma linha que encabeça um conjunto de propriedades e valores relacionados. Este método especifica se a largura da coluna de nome da propriedade também especifica a largura do nome da categoria exibida.

CMFCPropertyGridCtrl::SetListDelimiter

Define um caractere que é usado como um delimitador em uma lista de valores da propriedade.

void SetListDelimiter(TCHAR c);

Parâmetros

c
[in] Um caractere para servir como delimitador.

Comentários

Use este método para definir um caractere delimitador em uma lista de valores de propriedade que são usados no construtor CMFCPropertyGridProperty::CMFCPropertyGridProperty. Nesse construtor, defina o parâmetro bIsValueList como TRUE.

Por padrão, o construtor CMFCPropertyGridCtrl::CMFCPropertyGridCtrl define o caractere delimitador como vírgula (',').

CMFCPropertyGridCtrl::SetShowDragContext

Especifica se a estrutura redesenhará as colunas de nome e de valor do controle de grade de propriedades atual quando um usuário redimensionar as colunas.

void SetShowDragContext(BOOL bShowDragContext = TRUE);

Parâmetros

bShowDragContext
[in] TRUE para redesenhar as colunas de nome e valor durante uma operação de redimensionamento; FALSE para redesenhar as colunas após a conclusão da operação de arrastar. O valor padrão é TRUE.

Comentários

O usuário pode redimensionar as colunas de nome e valor de um controle de grade de propriedades arrastando a barra de divisão que está entre as colunas. Se o contexto de arrastar for exibido, as colunas de nome e valor serão redimensionadas, contanto que o usuário arraste a barra de divisão. Caso contrário, a barra de divisão será movida, mas as colunas não serão redesenhadas até que a operação de arrastar seja concluída.

CMFCPropertyGridCtrl::SetVSDotNetLook

Define a aparência do controle de grade de propriedades para o estilo usado no Visual Studio .NET.

void SetVSDotNetLook(BOOL bSet=TRUE);

Parâmetros

bSet
[in] TRUE para definir a aparência do controle de grade de propriedades para o estilo usado no Visual Studio .NET; caso contrário, FALSE. O valor padrão é TRUE.

Comentários

CMFCPropertyGridCtrl::UpdateColor

Define o valor de cor da propriedade de cores selecionada no momento.

virtual void UpdateColor(COLORREF color);

Parâmetros

color
[in] Um valor de cor RGB.

Comentários

Esse método declara no modo de depuração se a propriedade selecionada no momento do controle de grade de propriedades não for uma propriedade de cor.

CMFCPropertyGridCtrl::ValidateItemData

Chamado pela estrutura para validar os dados da propriedade.

virtual BOOL ValidateItemData(CMFCPropertyGridProperty* pProp);

Parâmetros

pProp
[in] Ponteiro para uma propriedade. Esse parâmetro não é usado.

Valor de retorno

Sempre TRUE.

Comentários

O método CMFCPropertyGridCtrl::EndEditItem chama esse método para validar dados. Por padrão, esse método não usa o parâmetro pProp e o valor retornado é sempre TRUE.

Caso você substitua esse método, retorne TRUE se os dados de propriedade especificados forem válidos. Caso contrário, retorne FALSE, assim, a estrutura não atualiza a propriedade.

Confira também

Gráfico da hierarquia
Classes