Compartilhar via


Classe CMFCPropertyGridProperty

Um objeto de CMFCPropertyGridProperty representa um item de lista em um controle de lista de propriedades.

class CMFCPropertyGridProperty : public CObject

Membros

Construtores public

Nome

Descrição

CMFCPropertyGridProperty::CMFCPropertyGridProperty

Constrói um objeto de CMFCPropertyGridProperty .

CMFCPropertyGridProperty::~CMFCPropertyGridProperty

Destruidor.

Métodos públicos

Nome

Descrição

CMFCPropertyGridProperty::AddOption

Adicionar um novo item de lista para um controle de lista de propriedades.

CMFCPropertyGridProperty::AddSubItem

Adiciona um item filho a uma propriedade.

CMFCPropertyGridProperty::AdjustButtonRect

Chamado pelo controle pai da lista de propriedades para dizer uma propriedade para redimensionar o retângulo delimitador de um botão inserido.

CMFCPropertyGridProperty::AdjustInPlaceEditRect

Recupera os limites da caixa de texto e opcional de controle de botão de rotação que são usados para definir um valor de propriedade.

CMFCPropertyGridProperty::AllowEdit

Faz uma propriedade somente leitura ou editável.

CMFCPropertyGridProperty::CreateInPlaceEdit

Chamado pela estrutura para criar um controle editável para uma propriedade.

CMFCPropertyGridProperty::CreateSpinControl

Chamado pela estrutura para criar um controle editável do botão de rotação.

CMFCPropertyGridProperty::Enable

Habilita ou desabilita uma propriedade.

CMFCPropertyGridProperty::EnableSpinControl

Habilita ou desabilita um controle de botão de rotação que é usado para alterar um valor de propriedade.

CMFCPropertyGridProperty::Expand

Expande ou recolhe uma propriedade que contém sub-propriedades.

CMFCPropertyGridProperty::FormatProperty

Formata a representação de texto de um valor de propriedade.

CMFCPropertyGridProperty::GetData

Recupera um valor de DWORD que está associado com uma propriedade.

CMFCPropertyGridProperty::GetDescription

Recupera uma descrição da propriedade.

CMFCPropertyGridProperty::GetExpandedSubItems

Retorna o número de sub-elementos expandidos.

CMFCPropertyGridProperty::GetHierarchyLevel

Retorna o índice com base zero do nível da hierarquia da propriedade.

CMFCPropertyGridProperty::GetName

Recupera o nome da propriedade.

CMFCPropertyGridProperty::GetNameTooltip

Chamado pela estrutura para exibir o nome da propriedade em uma dica de ferramenta.

CMFCPropertyGridProperty::GetOption

Recupera o texto de opção que é especificado por um índice.

CMFCPropertyGridProperty::GetOptionCount

Retorna o número de opções que pertencem a uma propriedade.

CMFCPropertyGridProperty::GetOriginalValue

Recupera o valor inicial da propriedade atual.

CMFCPropertyGridProperty::GetParent

Recupera um ponteiro para uma propriedade pai.

CMFCPropertyGridProperty::GetRect

Recupera o retângulo delimitador de uma propriedade.

CMFCPropertyGridProperty::GetSubItem

Recupera uma sub-propriedade identificada por um índice com base zero.

CMFCPropertyGridProperty::GetSubItemsCount

Retorna o número de sub-elementos.

CMFCPropertyGridProperty::GetThisClass

Usado pela estrutura para obter um ponteiro para o objeto de CRuntimeClass que está associado com esse tipo da classe.

CMFCPropertyGridProperty::GetValue

Recupera um valor de propriedade.

CMFCPropertyGridProperty::GetValueTooltip

Chamado pela estrutura para recuperar a representação de texto do valor da propriedade que é exibido em uma dica de ferramenta.

CMFCPropertyGridProperty::HitTest

Os pontos à propriedade do objeto que corresponde ao item da lista de propriedades que corresponde a um ponto.

CMFCPropertyGridProperty::IsAllowEdit

Indica se uma propriedade é editável.

CMFCPropertyGridProperty::IsEnabled

Indica se uma propriedade é ativado ou desativado.

CMFCPropertyGridProperty::IsExpanded

Indica se uma propriedade é expandida ou recolhida.

CMFCPropertyGridProperty::IsGroup

Indica se a propriedade atual representa um grupo.

CMFCPropertyGridProperty::IsInPlaceEditing

Indica se a propriedade atual é editável.

CMFCPropertyGridProperty::IsModified

Indica se a propriedade atual é modificada.

CMFCPropertyGridProperty::IsParentExpanded

Indica se os pais da propriedade atual são expandidos.

CMFCPropertyGridProperty::IsSelected

Indica se a propriedade atual está selecionada.

CMFCPropertyGridProperty::IsVisible

Indica se a propriedade atual é visível.

CMFCPropertyGridProperty::OnClickButton

Chamado pela estrutura quando o usuário clica em um botão que está contido em uma propriedade.

CMFCPropertyGridProperty::OnClickName

Chamado por um controle pai da lista de propriedades quando um usuário clica no campo de nome de uma propriedade.

CMFCPropertyGridProperty::OnClickValue

Chamado por um controle pai da lista de propriedades quando um usuário clica no campo de valor de uma propriedade.

CMFCPropertyGridProperty::OnCloseCombo

Chamado pela estrutura quando uma caixa de combinação que está contida em uma propriedade é fechada.

CMFCPropertyGridProperty::OnDblClk

Chamado pela estrutura quando o usuário clique duas vezes em uma propriedade.

CMFCPropertyGridProperty::OnDrawButton

Chamado pela estrutura para desenhar um botão que está contido em uma propriedade.

CMFCPropertyGridProperty::OnDrawDescription

Chamado pela estrutura para exibir a descrição da propriedade.

CMFCPropertyGridProperty::OnDrawExpandBox

Chamado pela estrutura para desenhar um controle de caixa de expandir por uma propriedade que contém sub-propriedades.

CMFCPropertyGridProperty::OnDrawName

Chamado pela estrutura para exibir o nome da propriedade.

CMFCPropertyGridProperty::OnDrawValue

Chamado pela estrutura para exibir o valor da propriedade.

CMFCPropertyGridProperty::OnEdit

Chamado pela estrutura quando o usuário está a ponto de alterar um valor de propriedade.

CMFCPropertyGridProperty::OnEndEdit

Chamado pela estrutura quando o usuário tiver terminado de altera o valor de uma propriedade.

CMFCPropertyGridProperty::OnKillSelection

 

CMFCPropertyGridProperty::OnPosSizeChanged

 

CMFCPropertyGridProperty::OnRClickName

Chamado pela estrutura quando o usuário clica no botão direito do mouse na área do nome da propriedade.

CMFCPropertyGridProperty::OnRClickValue

Chamado pela estrutura quando o usuário clica no botão direito do mouse na área de valor de propriedade.

CMFCPropertyGridProperty::OnSelectCombo

Chamado pela estrutura quando o usuário seleciona um item da caixa de combinação editável.

CMFCPropertyGridProperty::OnSetCursor

Chamado pela estrutura quando o ponteiro do mouse mover para um item da propriedade.

CMFCPropertyGridProperty::OnSetSelection

 

CMFCPropertyGridProperty::OnUpdateValue

Chamado pela estrutura quando o valor de uma propriedade editável alterar.

CMFCPropertyGridProperty::PushChar

Chamado de controle de lista de propriedades quando a propriedade é selecionada e de usuário insere um novo caractere.

CMFCPropertyGridProperty::Redraw

Redesenha a propriedade.

CMFCPropertyGridProperty::RemoveAllOptions

Remove todas as opções (itens) de uma propriedade.

CMFCPropertyGridProperty::RemoveSubItem

Remove o sub-elemento especificado.

CMFCPropertyGridProperty::ResetOriginalValue

Restaura o valor original de uma propriedade editada.

CMFCPropertyGridProperty::SetData

Associa um valor de DWORD com uma propriedade.

CMFCPropertyGridProperty::SetDescription

Especifica o texto que descreve a propriedade atual.

CMFCPropertyGridProperty::SetName

Define o nome de uma propriedade.

CMFCPropertyGridProperty::SetOriginalValue

Defina o valor original de uma propriedade editável.

CMFCPropertyGridProperty::SetValue

Defina o valor de uma propriedade da grade de propriedade.

CMFCPropertyGridProperty::Show

Mostra ou oculta uma propriedade.

Métodos protegidos

Nome

Descrição

CMFCPropertyGridProperty::CreateCombo

Chamado pela estrutura para adicionar uma caixa de combinação a uma propriedade.

CMFCPropertyGridProperty::HasButton

Indica se uma propriedade contém um botão.

CMFCPropertyGridProperty::Init

Chamado pela estrutura para inicializar um objeto da propriedade.

CMFCPropertyGridProperty::IsSubItem

Indica se a propriedade especificada é um sub-elemento da propriedade atual.

CMFCPropertyGridProperty::IsValueChanged

Indica se o valor da propriedade atual foi alterado.

CMFCPropertyGridProperty::OnCtlColor

Quando chamado pela estrutura deve recuperar um pincel para preencher a cor do plano de fundo de uma propriedade.

CMFCPropertyGridProperty::OnDestroyWindow

Chamado pela estrutura quando uma propriedade é destruída ou editando quando terminar.

CMFCPropertyGridProperty::OnKillFocus

Chamado pela estrutura quando a propriedade perde o foco de entrada.

Membros de dados

Nome

Descrição

CMFCPropertyGridProperty::m_strFormatDouble

Cadeia de caracteres de formato para um valor double do tipo.

CMFCPropertyGridProperty::m_strFormatFloat

Cadeia de caracteres de formato para um valor de flutuante de tipo.

CMFCPropertyGridProperty::m_strFormatLong

Formatar a cadeia de caracteres para um valor de tipo long.

CMFCPropertyGridProperty::m_strFormatShort

Formatar a cadeia de caracteres para um valor de tipo curta.

Comentários

Use um objeto de CMFCPropertyGridProperty para representar uma propriedade, que você adicionar a um controle de lista de propriedades. Para mais informações, consulte Classe CMFCPropertyGridCtrl.

Um objeto de propriedade pode representar tipos de dados como cadeias de caracteres, datas, e valores booleanos ou inteiro. Pode conter propriedades filhas, ou pode conter um controle como uma caixa de combinação ou um controle de botão.

Exemplo

O exemplo a seguir demonstra como criar um objeto de CMFCPropertyGridProperty . O exemplo também demonstra como usar vários métodos na classe de CMFCPropertyGridProperty para adicionar uma opção, para adicionar um sub-elemento, para ativar uma propriedade, e para mostrar uma propriedade. Este exemplo é parte de novo exemplo de controles.

   CMFCPropertyGridProperty* pGroup1 = new CMFCPropertyGridProperty(_T("Appearance"));

    // construct a COleVariant object. 
    COleVariant var3DLook((short)VARIANT_FALSE, VT_BOOL);

    pGroup1->AddSubItem(new CMFCPropertyGridProperty(_T("3D Look"), var3DLook, 
        _T("Specifies the dialog's font will be nonbold and controls will have a 3D border")));

    CMFCPropertyGridProperty* pProp = new CMFCPropertyGridProperty(_T("Border"),
        _T("Dialog Frame"), _T("One of: None, Thin, Resizable, or Dialog Frame"));
    pProp->AddOption(_T("None"));
    pProp->AddOption(_T("Thin"));
    pProp->AddOption(_T("Resizable"));
    pProp->AddOption(_T("Dialog Frame"));
    pProp->AllowEdit(FALSE);

    pGroup1->AddSubItem(pProp);
    pGroup1->AddSubItem(new CMFCPropertyGridProperty(_T("Caption"), (COleVariant) _T("About NewControlsDemo"), _T("Specifies the text that will be displayed in the dialog's title bar")));
    pGroup1->AdjustButtonRect();
    pGroup1->AllowEdit();
    pGroup1->Enable();
    pGroup1->Show();
    pGroup1->Redraw();

Hierarquia de herança

CObject

   CMFCPropertyGridProperty

Requisitos

Cabeçalho: afxpropertygridctrl.h

Consulte também

Referência

Gráfico da hierarquia

Classe CMFCPropertyGridCtrl

Outros recursos

Classes MFC