Classe CMFCPropertyGridCtrl
Isso Zoom, Para Cima e Ampliar está em construção.
Oferece suporte a um controle de grade de propriedade editável que pode Propriedades de Vídeo em ordem alfabético ou hierárquica.
class CMFCPropertyGridCtrl : public CWnd
Membros
Construtores públicos
Nome |
Descrição |
|---|---|
Constrói um CMFCPropertyGridCtrl objeto. |
|
CMFCPropertyGridCtrl::~CMFCPropertyGridCtrl |
Destruidor. |
Métodos públicos
Nome |
Descrição |
|---|---|
CMFCPropertyGridCtrl::accHitTest |
Chamado pela estrutura para recuperar o elemento filho ou objeto filho em um determinado ponto na tela.(Substitui CWnd::accHitTest.) |
CMFCPropertyGridCtrl::accLocation |
Chamado pela estrutura para recuperar o local de tela corrente do objeto especificado.(Substitui CWnd::accLocation.) |
Chamado pela estrutura para modificar a seleção ou mover o foco do teclado do objeto especificado.(Substitui CWnd::accSelect.) |
|
Adiciona uma nova propriedade a um controle de grade de propriedade. |
|
|
|
Fecha a caixa de diálogo de seleção de cor. |
|
Cria um controle de grade de propriedade e a anexa ao objeto de controle de grade de propriedade. |
|
Exclui a propriedade especificada do controle de grade propriedade. |
|
|
|
Ativa ou desativa a área de descrição é exibida abaixo da lista de propriedades. |
|
Ativa ou desativa o controle de cabeçalho na parte superior do controle de grade de propriedade. |
|
Rola um controle de grade de propriedade e expande a propriedade itens até que a propriedade especificada esteja visível. |
|
Expande ou recolhe todos os nós de controle de grade de propriedade. |
|
Recupera a propriedade que está associada um definido pelo usuário DWORD valor. |
|
CMFCPropertyGridCtrl::get_accChild |
Chamada pela estrutura para recuperar o endereço de um IDispatch interface para o filho especificado. (Substitui CWnd::get_accChild.) |
Chamado pela estrutura para recuperar o número de filhos que pertencem a este objeto.(Substitui CWnd::get_accChildCount.) |
|
CMFCPropertyGridCtrl::get_accDefaultAction |
Chamado pela estrutura para recuperar a cadeia de caracteres que descreve a ação padrão do objeto.(Substitui CWnd::get_accDefaultAction.) |
CMFCPropertyGridCtrl::get_accDescription |
Chamado pela estrutura para recuperar a cadeia de caracteres que descreve a aparência visual do objeto especificado.(Substitui CWnd::get_accDescription.) |
Chamado pela estrutura para recuperar o objeto que tem o foco do teclado.(Substitui CWnd::get_accFocus.) |
|
Chamada pela estrutura para recuperar Help seqüência da propriedade. (Substitui CWnd::get_accHelp.) |
|
Chamado pela estrutura para recuperar o caminho completo do WinHelparquivo associado ao objeto especificado e o identificador do tópico apropriado dentro desse arquivo. (Substitui CWnd::get_accHelpTopic.) |
|
Chamado pela estrutura para recuperar a tecla de atalho do objeto especificado ou tecla de acesso.(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 descreve a função do objeto especificado.(Substitui CWnd::get_accRole.) |
Chamado pela estrutura para recuperar os filhos desse objeto selecionados.(Substitui CWnd::get_accSelection.) |
|
CMFCPropertyGridCtrl::get_accState |
Chamado pela estrutura para recuperar o estado corrente do objeto especificado.(Substitui CWnd::get_accState.) |
CMFCPropertyGridCtrl::get_accValue |
Chamado pela estrutura para recuperar o valor do objeto especificado.(Substitui CWnd::get_accValue.) |
Recupera a cor do plano de fundo do controle de grade de propriedade corrente. |
|
Recupera a fonte do Windows que controlar no estilo negrito do texto na grade de propriedades corrente. |
|
Recupera a propriedade atualmente selecionada. |
|
Recupera as cores personalizadas que estão atualmente definidas 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. |
|
Recupera o número de linhas na área de descrição do controle de grade de propriedade corrente. |
|
Recupera o interno CMFCHeaderCtrl objeto que usa a estrutura para exibir o controle de grade de propriedade corrente. |
|
Recupera a altura do cabeçalho de controle de grade de propriedade. |
|
Recupera a largura da coluna à esquerda da propriedade grade controle corrente, 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 de propriedade que corresponde ao índice especificado de um item de controle de grade de propriedade. |
|
Recupera a largura corrente da coluna que contém valores de propriedade. |
|
Recupera 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 BAR de rolar controle no controle de grade de propriedade.(Substitui CWnd::GetScrollBarCtrl.) |
|
Recupera a cor do texto de itens de propriedade no controle de grade de propriedade corrente. |
|
CMFCPropertyGridCtrl::GetThisClass |
Usado pela estrutura para obter um ponteiro para o CRuntimeClass objeto que está associado a este tipo de classe. |
Recupera um ponteiro para o objeto de propriedade que corresponde a um item de controle de grade de propriedade, se um ponto especificado estiver no item.Esse método também indica a área no controle de grade de propriedade que contém o ponto. |
|
Inicializa o interno CMFCHeaderCtrl objeto que usa a estrutura para exibir o controle de grade de propriedade corrente. |
|
Indica se um controle de grade de propriedade no modo alfabético. |
|
|
|
Indica se a área de descrição do controle de grade de propriedade é exibida. |
|
Indica se cada nome de agrupar de propriedade é exibida pela largura do controle de grade de propriedade corrente. |
|
Indica se o controle de cabeçalho é exibido. |
|
Indica como o controle de grade de propriedades exibe propriedades modificadas. |
|
Indica se a estrutura redesenha as colunas nome e valor do controle de grade de propriedade corrente quando um usuário redimensionar as colunas. |
|
Indica se a aparência do controle de grade de propriedade no estilo que é usado pelo VS .NET. |
|
Especifica como exibir propriedades modificadas. |
|
CMFCPropertyGridCtrl::PreTranslateMessage |
Usado por classe CWinApp para traduzir as mensagens de janela antes que eles são expedidos para o TranslateMessage and DispatchMessage Funções do Windows.(Substitui CWnd::PreTranslateMessage.) |
Remove todos os objetos de propriedade de um controle de grade de propriedade. |
|
Restaura o valor original de todas as propriedades. |
|
Define ou redefine o modo em ordem alfabético. |
|
Especifica o texto dos rótulos booliano. |
|
Seleciona uma propriedade em um controle de grade de propriedade. |
|
Especifica as cores personalizadas para vários elementos de controle de grade de propriedade. |
|
Especifica o número de linhas a serem exibidas na seção Descrição do controle de grade de propriedade corrente. |
|
Especifica se deve exibir a largura total do nome da categoria de um agrupar de propriedades no controle de grade de propriedade corrente. |
|
Define um caractere que será usado sistema autônomo um delimitador em uma lista de valores de propriedade. |
|
Especifica se a estrutura redesenha as colunas nome e valor do controle de grade de propriedade corrente quando um usuário redimensionar as colunas. |
|
Define a aparência do controle de grade de propriedade para o estilo usado no VS .NET. |
|
Define o valor de cor da propriedade cor selecionada atualmente. |
Métodos protegidos
Nome |
Descrição |
|---|---|
Redesenha o controle de grade de propriedade e suas propriedades. |
|
Chamado pelo controle de grade de propriedade para classificar propriedades. |
|
Chamado pela estrutura quando o usuário iniciar modificar uma propriedade. |
|
Chamado pela estrutura quando o usuário pára de modificar uma propriedade. |
|
Chamado pela estrutura para inicializar um controle de grade de propriedade. |
|
Chamado pela estrutura quando a seleção corrente é alterada. |
|
Chamado pela estrutura quando uma botão de propriedade é clicada. |
|
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 exibir o texto de descrição. |
|
Chamado pela estrutura para exibir a lista de propriedades no 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 de caixa de combinação está selecionada. |
|
Chamado pela estrutura para validar os dados de propriedade. |
Comentários
The CMFCPropertyGridCtrl classe exibe um controle de grade de propriedade que contém propriedades editáveis derivadas de CMFCPropertyGridProperty classe.Cada propriedade pode representar um tipo e pode conter subitens.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 CMFCPropertyGridCtrl objeto e, em seguida, chamamos o CMFCPropertyGridCtrl::criar método. Use o CMFCPropertyGridCtrl::AddProperty método para adicionar propriedades à lista.
Propriedades da seleção
Em vez de representar um valor, um propriedade item pode iniciar uma caixa de diálogo que permite ao usuário selecionar uma cor, o arquivo ou a fonte.
A tabela a seguir lista os quatro tipos de propriedade de seleção:
Classe |
Descrição |
|---|---|
Uma propriedade de finalidade geral que é usada para especificar o valor de seqüências de caracteres, booleanos, 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 propriedades de duas maneiras.Primeira ilustração exibe propriedades hierarquicamente e o segundo exibe as propriedades em ordem alfabética.
.png)
Exemplo
O exemplo a seguir demonstra como configurar um objeto de controle de grade de propriedade usando vários métodos no CMFCPropertyGridCtrl classe. O exemplo demonstra como ativar o controle de cabeçalho, habilitar a área de descrição e conjunto a aparência de controle de grade de propriedade.O exemplo também mostra como conjunto o modo alfabético para o controle no qual o controle classifica todas as propriedades que ele contém pelo nome de propriedade e como conjunto as cores personalizadas para diversos elementos de controle de grade de propriedade.Este exemplo faz parte o Exemplo do NewControls: Aplicativo de demonstração de controles MFC.
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