Classe de CMFCPropertyGridCtrl
Este tópico está incluído para fins de 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
.gif "Bb983759.collapse_all(pt-br,VS.110).gif")
Construtores public
Nome |
Descrição |
|---|---|
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.) |
Chamado pela estrutura para alterar a seleção ou mover o foco do teclado do objeto especificado.Overrides ( CWnd::accSelect.) |
|
Adiciona uma nova propriedade para um controle de grade de propriedade. |
|
|
|
Fechar a caixa de diálogo de seleção de cor. |
|
Cria um controle de grade de propriedade e anexá-la ao objeto do controle de grade de propriedade. |
|
Exclui a propriedade especificada do controle de grade de propriedade. |
|
|
|
Habilita ou desabilita a área de descrição que é exibida abaixo da lista de propriedades. |
|
Habilita ou desabilita o controle de cabeçalho na parte superior do controle de grade de propriedade. |
|
Colocar um controle de grade de propriedade e expande itens da propriedade até que a propriedade especificada seja visível. |
|
Expande ou recolhe todos os nós do controle de grade de propriedade. |
|
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.) |
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.) |
Chamado pela estrutura para recuperar o objeto que tem o foco do teclado.Overrides ( CWnd::get_accFocus.) |
|
Chamado pela estrutura para recuperar a cadeia de caracteres de propriedade de Help de um objeto.Overrides ( CWnd::get_accHelp.) |
|
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.) |
|
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.) |
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.) |
Recupera a cor do plano de fundo do controle de grade atual da propriedade. |
|
Recupera a fonte do windows que o texto no controle de grade atual da propriedade para o estilo em negrito. |
|
Recupera a propriedade selecionada. |
|
Recupera as cores personalizados que são definidas no momento para elementos de controle de grade de propriedade. |
|
Recupera a altura da área de descrição localizada na parte inferior do controle de grade de propriedade. |
|
Retorna o número de linhas na área de descrição de um controle de grade atual da propriedade. |
|
Retorna o objeto interno de CMFCHeaderCtrl que a estrutura usa para exibir o controle de grade atual da propriedade. |
|
Recupera a altura do cabeçalho do controle de grade de propriedade. |
|
Obtém a largura da coluna esquerda do controle de grade atual da propriedade, que contém o nome de cada propriedade. |
|
Recupera o retângulo delimitador do controle de grade de propriedade. |
|
Recupera um ponteiro para o objeto da propriedade correspondente ao índice especificado de um item do controle de grade de propriedade. |
|
Obtém a largura atual da coluna que contém valores de propriedade. |
|
Retorna o número de propriedades em um controle de grade de propriedade. |
|
Recupera a altura de uma linha no controle de grade de propriedade. |
|
Recupera um ponteiro para o controle de barra de rolagem no controle de grade de propriedade.Overrides ( CWnd::GetScrollBarCtrl.) |
|
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. |
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. |
|
Inicializa o objeto interno de CMFCHeaderCtrl que a estrutura usa para exibir o controle de grade atual da propriedade. |
|
Indica se um controle de grade de propriedade está no modo alfabética. |
|
|
|
Indica se a área de descrição de um controle de grade de propriedade é exibida. |
|
Indica se cada nome de grupo de propriedades é exibido pela largura do controle de grade atual da propriedade. |
|
Indica se o controle de cabeçalho é exibido. |
|
Indica como o controle de grade de propriedade exibe propriedades alteradas. |
|
Indica se a estrutura redesenho nome das colunas e o valor do controle de grade atual da propriedade quando um usuário redimensionar colunas. |
|
Indica se a aparência do controle de grade de propriedade está no estilo que é usado por CONTRA .NET. |
|
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.) |
Remove todos os objetos da propriedade de um controle de grade de propriedade. |
|
Restaura o valor original de todas as propriedades. |
|
Define ou alfabético modo de redefinições. |
|
Especifica o texto de rótulos booleanos. |
|
Seleciona uma propriedade em um controle de grade de propriedade. |
|
Especifica cores personalizado para os vários elementos de controle de grade de propriedade. |
|
Especifica o número de linhas para exibir na seção de descrição de um controle de grade atual da propriedade. |
|
Especifica se mostrar a largura total de nome de categoria para um grupo de propriedades do controle de grade atual da propriedade. |
|
Define um caractere usado como um delimitador em uma lista de valores de propriedade. |
|
Especifica se a estrutura redesenho nome das colunas e o valor do controle de grade atual da propriedade quando um usuário redimensionar colunas. |
|
Define a aparência do controle de grade de propriedade para o estilo que é usado em CONTRA .NET. |
|
Defina o valor de cor da propriedade de cor selecionada. |
Métodos protegidos
Nome |
Descrição |
|---|---|
Redesenho do controle grade de propriedade e suas propriedades. |
|
Chamado pelo controle de grade de propriedades para classificar propriedades. |
|
Chamado pela estrutura quando o usuário para alterar uma propriedade. |
|
Chamado pela estrutura quando o usuário parar de alterar uma propriedade. |
|
Chamado pela estrutura para inicializar um controle de grade de propriedade. |
|
Chamado pela estrutura quando a seleção atual é alterada. |
|
Chamado pela estrutura de propriedade quando um botão é clicado. |
|
Chamado pela estrutura para desenhar uma borda ao redor de um controle de grade de propriedade. |
|
Chamado pela estrutura para desenhar a área de descrição e para exibir a descrição. |
|
Chamado pela estrutura para exibir a lista de propriedades do controle de grade de propriedade. |
|
Chamado pela estrutura para exibir uma propriedade. |
|
Chamado pela estrutura quando o valor de uma propriedade é alterado. |
|
Chamado pela estrutura quando uma propriedade que contém um controle caixa de combinação está marcada. |
|
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 |
|---|---|
Uma propriedade comumente usados que é usada para especificar o valor de cadeias de caracteres, Booleans datas, e assim por diante. |
|
Uma propriedade que é usada para selecionar um valor de cor. |
|
Uma propriedade que é usada para selecionar um arquivo. |
|
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.
.png "PropertySheet de lista")
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();
Hierarquia de herança
Requisitos
Cabeçalho: afxpropertygridctrl.h