Partilhar via


Classe IPerPropertyBrowsingImpl

Observação

A Active Template Library (ATL) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Esta classe implementa IUnknown e permite a um cliente aceder à informação nas páginas de propriedades de um objeto.

Importante

Esta classe e os seus membros não podem ser usados em aplicações que sejam executadas no Windows Runtime.

Sintaxe

template <class T>
class ATL_NO_VTABLE IPerPropertyBrowsingImpl :
    public IPerPropertyBrowsing

Parâmetros

T
A sua classe, derivada de IPerPropertyBrowsingImpl.

Membros

Métodos Públicos

Nome Description
IPerPropertyBrowsingImpl::GetDisplayString Recupera uma cadeia que descreve uma dada propriedade.
IPerPropertyBrowsingImpl::GetPredefinedStrings Recupera um array de cadeias correspondentes aos valores que uma dada propriedade pode aceitar.
IPerPropertyBrowsingImpl::GetPredefinedValue Recupera um VARIANT contendo o valor de uma propriedade identificada por um dado DISPID. O DISPID está associado ao nome da cadeia recuperado de GetPredefinedStrings. A implementação do ATL devolve E_NOTIMPL.
IPerPropertyBrowsingImpl::MapPropertyToPage Recupera o CLSID da página de propriedades associada a uma dada propriedade.

Observações

A interface IPerPropertyBrowsing permite a um cliente aceder à informação nas páginas de propriedades de um objeto. A Class IPerPropertyBrowsingImpl fornece uma implementação padrão desta interface e é IUnknown implementada enviando informação para o dispositivo de despejo em compilações de depuração.

Observação

Se estiver a usar o Microsoft Access como aplicação contentor, deve derivar a sua classe a partir de IPerPropertyBrowsingImpl. Caso contrário, o Access não vai carregar o seu controlo.

Artigos RelacionadosTutorial ATL, Criação de um Projeto ATL

Hierarquia de herança

IPerPropertyBrowsing

IPerPropertyBrowsingImpl

Requerimentos

Cabeçalho: atlctl.h

IPerPropertyBrowsingImpl::GetDisplayString

Recupera uma cadeia que descreve uma dada propriedade.

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

Observações

Veja IPerPropertyBrowsing::GetDisplayString no SDK do Windows.

IPerPropertyBrowsingImpl::GetPredefinedStrings

Preenche cada array com zero itens.

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

Valor de retorno

A implementação do GetPredefinedValue da ATL devolve E_NOTIMPL.

Observações

Veja IPerPropertyBrowsing::GetPredefinedStrings no SDK do Windows.

IPerPropertyBrowsingImpl::GetPredefinedValue

Recupera um VARIANT contendo o valor de uma propriedade identificada por um dado DISPID. O DISPID está associado ao nome da cadeia recuperado de GetPredefinedStrings.

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

Valor de retorno

Devolve E_NOTIMPL.

Observações

A implementação do ATL do GetPredefinedStrings não recupera cadeias correspondentes.

Veja 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);

Observações

O ATL utiliza o mapa de propriedades do objeto para obter esta informação.

Consulte IPerPropertyBrowsing::MapPropertyToPage no SDK do Windows.

Consulte também

Classe IPropertyPageImpl
ISspecificifyPropertyPagesImpl Class
Visão geral da classe