Partilhar via

Classe IPersistPropertyBagImpl

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 que um objeto guarde as suas propriedades num property bag fornecido pelo cliente.

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 IPersistPropertyBagImpl : public IPersistPropertyBag

Parâmetros

T
A sua classe, derivada de IPersistPropertyBagImpl.

Membros

Métodos Públicos

Nome Description
IPersistPropertyBagImpl::GetClassID Recupera o CLSID do objeto.
IPersistPropertyBagImpl::InitNew Inicializa um objeto recém-criado. A implementação do ATL devolve S_OK.
IPersistPropertyBagImpl::Load Carrega as propriedades do objeto a partir de um saco de propriedades fornecido pelo cliente.
IPersistPropertyBagImpl::Save Guarda as propriedades do objeto num saco de propriedades fornecido pelo cliente.

Observações

A interface IPersistPropertyBag permite que um objeto guarde as suas propriedades num property bag fornecido pelo cliente. A Class IPersistPropertyBagImpl 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.

IPersistPropertyBag funciona em conjunto com o IPropertyBag e o IErrorLog. Estas duas últimas interfaces devem ser implementadas pelo cliente. Através IPropertyBagde , o cliente guarda e carrega as propriedades individuais do objeto. Através IErrorLogde , tanto o objeto como o cliente podem reportar quaisquer erros encontrados.

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

Hierarquia de herança

IPersistPropertyBag

IPersistPropertyBagImpl

Requerimentos

Cabeçalho: atlcom.h

IPersistPropertyBagImpl::GetClassID

Recupera o CLSID do objeto.

STDMETHOD(GetClassID)(CLSID* pClassID);

Observações

Veja IPersist::GetClassID no SDK do Windows.

IPersistPropertyBagImpl::InitNew

Inicializa um objeto recém-criado.

STDMETHOD(InitNew)();

Valor de retorno

Devolve S_OK.

Observações

Veja IPersistPropertyBag::InitNew no SDK do Windows.

IPersistPropertyBagImpl::Load

Carrega as propriedades do objeto a partir de um saco de propriedades fornecido pelo cliente.

STDMETHOD(Load)(LPPROPERTYBAG pPropBag, LPERRORLOG pErrorLog);

Observações

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

Veja IPersistPropertyBag::Load no SDK do Windows.

IPersistPropertyBagImpl::Save

Guarda as propriedades do objeto num saco de propriedades fornecido pelo cliente.

STDMETHOD(Save)(
    LPPROPERTYBAG pPropBag,
    BOOL fClearDirty,
    BOOL fSaveAllProperties);

Observações

O ATL utiliza o mapa de propriedades do objeto para armazenar esta informação. Por defeito, este método guarda todas as propriedades, independentemente do valor de fSaveAllProperties.

Veja IPersistPropertyBag::Save no SDK do Windows.

Consulte também

BEGIN_PROP_MAP
Visão geral da classe

  • Last updated on