Classe CMFCPropertyGridCtrl

Artigo
06/10/2015

Este tópico está incluído para integridade. Para obter mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

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

class CMFCPropertyGridCtrl : public CWnd

Membros

Construtores public

Nome	Descrição
CMFCPropertyGridCtrl::CMFCPropertyGridCtrl	Constrói um objeto de 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. Overrides ( CWnd::accHitTest.)
CMFCPropertyGridCtrl::accLocation	Chamado pela estrutura para recuperar o local atual da tela do objeto especificado. Overrides ( CWnd::accLocation.)
CMFCPropertyGridCtrl::accSelect	Chamado pela estrutura para alterar a seleção ou mover o foco do teclado do objeto especificado. Overrides ( CWnd::accSelect.)
CMFCPropertyGridCtrl::AddProperty	Adiciona uma nova propriedade para um controle de grade de propriedade.
CMFCPropertyGridCtrl::AlwaysShowUserToolTip
CMFCPropertyGridCtrl::CloseColorPopup	Fechar a caixa de diálogo de seleção de cor.
CMFCPropertyGridCtrl::Create	Cria um controle de grade de propriedade e anexá-la ao objeto do controle de grade de propriedade.
CMFCPropertyGridCtrl::DeleteProperty	Exclui a propriedade especificada do controle de grade de propriedade.
CMFCPropertyGridCtrl::DrawControlBarColors
CMFCPropertyGridCtrl::EnableDescriptionArea	Habilita ou desabilita a área de descrição que é exibida abaixo da lista de propriedades.
CMFCPropertyGridCtrl::EnableHeaderCtrl	Habilita ou desabilita o controle de cabeçalho na parte superior do controle de grade de propriedade.
CMFCPropertyGridCtrl::EnsureVisible	Colocar um controle de grade de propriedade e expande itens da propriedade até que a propriedade especificada seja visível.
CMFCPropertyGridCtrl::ExpandAll	Expande ou recolhe todos os nós do controle de grade de propriedade.
CMFCPropertyGridCtrl::FindItemByData	Recupera a propriedade que está associada com um valor definido pelo usuário de DWORD .
CMFCPropertyGridCtrl::get_accChild	Chamado pela estrutura para recuperar o endereço de uma interface de IDispatch para o filho especificado. Overrides ( CWnd::get_accChild.)
CMFCPropertyGridCtrl::get_accChildCount	Chamado pela estrutura para recuperar o número de filhos que pertencem a esse objeto. Overrides ( CWnd::get_accChildCount.)
CMFCPropertyGridCtrl::get_accDefaultAction	Chamado pela estrutura para recuperar uma cadeia de caracteres que descreve a ação default do objeto. Overrides ( CWnd::get_accDefaultAction.)
CMFCPropertyGridCtrl::get_accDescription	Chamado pela estrutura para recuperar uma cadeia de caracteres que descreve a aparência visual do objeto especificado. Overrides ( CWnd::get_accDescription.)
CMFCPropertyGridCtrl::get_accFocus	Chamado pela estrutura para recuperar o objeto que tem o foco do teclado. Overrides ( CWnd::get_accFocus.)
CMFCPropertyGridCtrl::get_accHelp	Chamado pela estrutura para recuperar a cadeia de caracteres de propriedade de Help de um objeto. Overrides ( CWnd::get_accHelp.)
CMFCPropertyGridCtrl::get_accHelpTopic	Chamado pela estrutura para recuperar o caminho completo do arquivo de WinHelpassociado ao objeto especificado e o identificador do tópico apropriado dentro de esse arquivo. Overrides ( CWnd::get_accHelpTopic.)
CMFCPropertyGridCtrl::get_accKeyboardShortcut	Chamado pela estrutura para recuperar a chave ou a tecla de acesso de atalho do objeto especificado. Overrides ( CWnd::get_accKeyboardShortcut.)
CMFCPropertyGridCtrl::get_accName	Chamado pela estrutura para recuperar o nome do objeto especificado. Overrides ( CWnd::get_accName.)
CMFCPropertyGridCtrl::get_accRole	Chamado pela estrutura para recuperar informações que descrevem a função do objeto especificado. Overrides ( CWnd::get_accRole.)
CMFCPropertyGridCtrl::get_accSelection	Chamado pela estrutura para recuperar os filhos de este objeto selecionados. Overrides ( CWnd::get_accSelection.)
CMFCPropertyGridCtrl::get_accState	Chamado pela estrutura para recuperar o estado atual do objeto especificado. Overrides ( CWnd::get_accState.)
CMFCPropertyGridCtrl::get_accValue	Chamado pela estrutura para recuperar o valor do objeto especificado. Overrides ( CWnd::get_accValue.)
CMFCPropertyGridCtrl::GetBkColor	Recupera a cor do plano de fundo do controle de grade atual da propriedade.
CMFCPropertyGridCtrl::GetBoldFont	Recupera a fonte do windows que o texto no controle de grade atual da propriedade para o estilo em negrito.
CMFCPropertyGridCtrl::GetCurSel	Recupera a propriedade selecionada.
CMFCPropertyGridCtrl::GetCustomColors	Recupera as cores personalizados que são definidas no momento para elementos de controle de grade de propriedade.
CMFCPropertyGridCtrl::GetDescriptionHeight	Recupera a altura da área de descrição localizada na parte inferior do controle de grade de propriedade.
CMFCPropertyGridCtrl::GetDescriptionRows	Retorna o número de linhas na área de descrição de um controle de grade atual da propriedade.
CMFCPropertyGridCtrl::GetHeaderCtrl	Retorna o objeto interno de CMFCHeaderCtrl que a estrutura usa para exibir o controle de grade atual da propriedade.
CMFCPropertyGridCtrl::GetHeaderHeight	Recupera a altura do cabeçalho do controle de grade de propriedade.
CMFCPropertyGridCtrl::GetLeftColumnWidth	Obtém a largura da coluna esquerda do controle de grade atual da propriedade, que contém o nome de cada propriedade.
CMFCPropertyGridCtrl::GetListRect	Recupera o retângulo delimitador do controle de grade de propriedade.
CMFCPropertyGridCtrl::GetProperty	Recupera um ponteiro para o objeto da propriedade correspondente ao índice especificado de um item do controle de grade de propriedade.
CMFCPropertyGridCtrl::GetPropertyColumnWidth	Obtém a largura atual da coluna que contém valores de propriedade.
CMFCPropertyGridCtrl::GetPropertyCount	Retorna o número de propriedades em um controle de grade de propriedade.
CMFCPropertyGridCtrl::GetRowHeight	Recupera a altura de uma linha no controle de grade de propriedade.
CMFCPropertyGridCtrl::GetScrollBarCtrl	Recupera um ponteiro para o controle de barra de rolagem no controle de grade de propriedade. Overrides ( CWnd::GetScrollBarCtrl.)
CMFCPropertyGridCtrl::GetTextColor	Recupera a cor do texto de itens da propriedade no controle de grade atual da propriedade.
CMFCPropertyGridCtrl::GetThisClass	Usado pela estrutura para obter um ponteiro para o objeto de CRuntimeClass que está associado com esse tipo da classe.
CMFCPropertyGridCtrl::HitTest	Recupera um ponteiro para o objeto de propriedade que corresponde a um item do controle de grade de propriedade se um ponto está especificado no item. Esse método também indica a área no controle de grade de propriedade que contém o ponto.
CMFCPropertyGridCtrl::InitHeader	Inicializa o objeto interno de CMFCHeaderCtrl que a estrutura usa para exibir o controle de grade atual da propriedade.
CMFCPropertyGridCtrl::IsAlphabeticMode	Indica se um controle de grade de propriedade está no modo alfabética.
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	Indica se a área de descrição de um controle de grade de propriedade é exibida.
CMFCPropertyGridCtrl::IsGroupNameFullWidth	Indica se cada nome de grupo de propriedades é exibido pela largura do controle de grade atual da propriedade.
CMFCPropertyGridCtrl::IsHeaderCtrl	Indica se o controle de cabeçalho é exibido.
CMFCPropertyGridCtrl::IsMarkModifiedProperties	Indica como o controle de grade de propriedade exibe propriedades alteradas.
CMFCPropertyGridCtrl::IsShowDragContext	Indica se a estrutura redesenho nome das colunas e o valor do controle de grade atual da propriedade quando um usuário redimensionar colunas.
CMFCPropertyGridCtrl::IsVSDotNetLook	Indica se a aparência do controle de grade de propriedade está no estilo que é usado por CONTRA .NET.
CMFCPropertyGridCtrl::MarkModifiedProperties	Especifica como exibir propriedades alteradas.
CMFCPropertyGridCtrl::PreTranslateMessage	Usado pela classe CWinApp transladar mensagens de janela antes que são distribuídos funções do windows de TranslateMessage e de DispatchMessage . Overrides ( CWnd::PreTranslateMessage.)
CMFCPropertyGridCtrl::RemoveAll	Remove todos os objetos da propriedade de um controle de grade de propriedade.
CMFCPropertyGridCtrl::ResetOriginalValues	Restaura o valor original de todas as propriedades.
CMFCPropertyGridCtrl::SetAlphabeticMode	Define ou alfabético modo de redefinições.
CMFCPropertyGridCtrl::SetBoolLabels	Especifica o texto de rótulos booleanos.
CMFCPropertyGridCtrl::SetCurSel	Seleciona uma propriedade em um controle de grade de propriedade.
CMFCPropertyGridCtrl::SetCustomColors	Especifica cores personalizado para os vários elementos de controle de grade de propriedade.
CMFCPropertyGridCtrl::SetDescriptionRows	Especifica o número de linhas para exibir na seção de descrição de um controle de grade atual da propriedade.
CMFCPropertyGridCtrl::SetGroupNameFullWidth	Especifica se mostrar a largura total de nome de categoria para um grupo de propriedades do controle de grade atual da propriedade.
CMFCPropertyGridCtrl::SetListDelimiter	Define um caractere usado como um delimitador em uma lista de valores de propriedade.
CMFCPropertyGridCtrl::SetShowDragContext	Especifica se a estrutura redesenho nome das colunas e o valor do controle de grade atual da propriedade quando um usuário redimensionar colunas.
CMFCPropertyGridCtrl::SetVSDotNetLook	Define a aparência do controle de grade de propriedade para o estilo que é usado em CONTRA .NET.
CMFCPropertyGridCtrl::UpdateColor	Defina o valor de cor da propriedade de cor selecionada.

Métodos protegidos

Nome	Descrição
CMFCPropertyGridCtrl::AdjustLayout	Redesenho do controle grade de propriedade e suas propriedades.
CMFCPropertyGridCtrl::CompareProps	Chamado pelo controle de grade de propriedades para classificar propriedades.
CMFCPropertyGridCtrl::EditItem	Chamado pela estrutura quando o usuário para alterar uma propriedade.
CMFCPropertyGridCtrl::EndEditItem	Chamado pela estrutura quando o usuário parar de alterar uma propriedade.
CMFCPropertyGridCtrl::Init	Chamado pela estrutura para inicializar um controle de grade de propriedade.
CMFCPropertyGridCtrl::OnChangeSelection	Chamado pela estrutura quando a seleção atual é alterada.
CMFCPropertyGridCtrl::OnClickButton	Chamado pela estrutura de propriedade quando um botão é clicado.
CMFCPropertyGridCtrl::OnDrawBorder	Chamado pela estrutura para desenhar uma borda ao redor de um controle de grade de propriedade.
CMFCPropertyGridCtrl::OnDrawDescription	Chamado pela estrutura para desenhar a área de descrição e para exibir a descrição.
CMFCPropertyGridCtrl::OnDrawList	Chamado pela estrutura para exibir a lista de propriedades do controle de grade de propriedade.
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 caixa de combinação está marcada.
CMFCPropertyGridCtrl::ValidateItemData	Chamado pela estrutura para validar dados da propriedade.

Comentários

Exibe de classe de CMFCPropertyGridCtrl um controle de grade de propriedade que contém as propriedades editáveis derivadas de classes de CMFCPropertyGridProperty . Cada propriedade pode representar um tipo e pode conter sub-itens. O controle de grade de propriedade suporta uma área redimensionável na parte inferior que pode exibir a descrição de uma propriedade selecionada.

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

Propriedades de seleção

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

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

Classe	Descrição
Classe CMFCPropertyGridProperty	Uma propriedade comumente usados que é usada para especificar o valor de cadeias de caracteres, Booleans 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 descrevem um controle de grade de propriedade que exibe as propriedades de duas maneiras. A primeira ilustração exibe as propriedades hierarquicamente e a segunda exibe propriedades em ordem alfabética.

Folha de propriedades de lista de propriedade

Exemplo

O exemplo a seguir demonstra como configurar um objeto do controle de grade de propriedade usando vários métodos na classe de CMFCPropertyGridCtrl . O exemplo demonstra como habilitar o controle de cabeçalho, permite a área de descrição, e define a aparência do controle de grade de propriedade. O exemplo também mostra como definir o modo alfabético para o controle por meio de classes que o controle todas as propriedades que contém pelo nome de propriedade, e como definir as cores personalizado para vários elementos de controle de grade de propriedade. Este exemplo é parte de novo exemplo de 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();