Compartilhar via

Classe IPerPropertyBrowsingImpl

  • Artigo

Essa classe implementa IUnknown e permite que um cliente acesse as informações nas páginas de propriedades de um objeto.

Importante

Essa classe e os respectivos membros não podem ser usados em aplicativos executados no Windows Runtime.

Sintaxe

template <class T>
class ATL_NO_VTABLE IPerPropertyBrowsingImpl :
    public IPerPropertyBrowsing

Parâmetros

T
Sua classe, derivada de IPerPropertyBrowsingImpl.

Membros

Métodos públicos

Nome Descrição
IPerPropertyBrowsingImpl::GetDisplayString Recupera uma cadeia de caracteres que descreve uma determinada propriedade.
IPerPropertyBrowsingImpl::GetPredefinedStrings Recupera uma matriz de cadeias de caracteres correspondentes aos valores que uma determinada propriedade pode aceitar.
IPerPropertyBrowsingImpl::GetPredefinedValue Recupera uma VARIANT que contém o valor de uma propriedade identificada por um determinado DISPID. O DISPID está associado ao nome da cadeia de caracteres recuperado de GetPredefinedStrings. A implementação da ATL retorna E_NOTIMPL.
IPerPropertyBrowsingImpl::MapPropertyToPage Recupera o CLSID da página de propriedades associada a uma determinada propriedade.

Comentários

A interface IPerPropertyBrowsing permite que um cliente acesse as informações nas páginas de propriedades de um objeto. A classe IPerPropertyBrowsingImpl fornece uma implementação padrão dessas interfaces e implementa IUnknown enviando informações para o dispositivo de despejo em builds de depuração.

Observação

Se você estiver usando o Microsoft Access como o aplicativo de contêiner, deverá derivar sua classe de IPerPropertyBrowsingImpl. Caso contrário, o Access não carregará seu controle.

Artigos relacionados Tutorial da ATL, criando um projeto da ATL

Hierarquia de herança

IPerPropertyBrowsing

IPerPropertyBrowsingImpl

Requisitos

Cabeçalho: atlctl.h

IPerPropertyBrowsingImpl::GetDisplayString

Recupera uma cadeia de caracteres que descreve uma determinada propriedade.

STDMETHOD(GetDisplayString)(
    DISPID dispID,
    BSTR* pBstr);

Comentários

Confira IPerPropertyBrowsing::GetDisplayString no SDK do Windows.

IPerPropertyBrowsingImpl::GetPredefinedStrings

Preenche cada matriz com zero itens.

STDMETHOD(GetPredefinedStrings)(
    DISPID dispID,
    CALPOLESTR* pCaStringsOut,
    CADWORD* pCaCookiesOut);

Valor de retorno

A implementação de GetPredefinedValue pela ATL retorna E_NOTIMPL.

Comentários

Confira IPerPropertyBrowsing::GetPredefinedStrings no SDK do Windows.

IPerPropertyBrowsingImpl::GetPredefinedValue

Recupera uma VARIANT que contém o valor de uma propriedade identificada por um determinado DISPID. O DISPID está associado ao nome da cadeia de caracteres recuperado de GetPredefinedStrings.

STDMETHOD(GetPredefinedValue)(
    DISPID dispID,
    DWORD dwCookie,
    VARIANT* pVarOut);

Valor de retorno

Retorna E_NOTIMPL.

Comentários

A implementação de GetPredefinedStrings pela ATL não recupera cadeias de caracteres correspondentes.

Confira IPerPropertyBrowsing::GetPredefinedValue no SDK do Windows.

IPerPropertyBrowsingImpl::MapPropertyToPage

Recupera o CLSID da página de propriedades associada à propriedade especificada.

STDMETHOD(MapPropertyToPage)(
    DISPID dispID,
    CLSID* pClsid);

Comentários

A ATL usa o mapa de propriedades do objeto para obter essas informações.

Confira IPerPropertyBrowsing::MapPropertyToPage no SDK do Windows.

Confira também

Classe IPropertyPageImpl
Classe ISpecifyPropertyPagesImpl
Visão geral da aula