Classe de CMFCPropertyGridProperty

Artigo
02/25/2013

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 de 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();