Partilhar via

Classe IDataObjectImpl

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 aula fornece métodos para apoiar a Transferência Uniforme de Dados e gerir ligações.

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 IDataObjectImpl

Parâmetros

T
A sua classe, derivada de IDataObjectImpl.

Membros

Métodos Públicos

Nome Description
IDataObjectImpl::D Advise Estabelece uma ligação entre o objeto de dados e um sumidouro de aconselhamento. Isto permite que o sumidouro de aconselhamento receba notificações de alterações no objeto.
IDataObjectImpl::D Unadvise Termina uma ligação previamente estabelecida através DAdvisede .
IDataObjectImpl::EnumDAdvise Cria um enumerador para iterar pelas conexões de aconselhamento atuais.
IDataObjectImpl::EnumFormatEtc Cria um enumerador para iterar através das FORMATETC estruturas suportadas pelo objeto de dados. A implementação do ATL devolve E_NOTIMPL.
IDataObjectImpl::FireDataChange Envia uma notificação de alteração de volta para cada servidor de aviso.
IDataObjectImpl::GetCanonicalFormatEtc Recupera uma estrutura logicamente equivalente FORMATETC a uma mais complexa. A implementação do ATL devolve E_NOTIMPL.
IDataObjectImpl::GetData Transfere dados do objeto de dados para o cliente. Os dados são descritos numa FORMATETC estrutura e transferidos através de uma STGMEDIUM estrutura.
IDataObjectImpl::GetDataHere Semelhante a GetData, exceto que o cliente deve alocar a STGMEDIUM estrutura. A implementação do ATL devolve E_NOTIMPL.
IDataObjectImpl::QueryGetData Determina se o objeto de dados suporta uma estrutura específica FORMATETC para transferência de dados. A implementação do ATL devolve E_NOTIMPL.
IDataObjectImpl::SetData Transfere dados do cliente para o objeto de dados. A implementação do ATL devolve E_NOTIMPL.

Observações

A interface IDataObject fornece métodos para suportar a Transferência Uniforme de Dados. IDataObject utiliza as estruturas de formato padrão FORMATETC e STGMEDIUM para recuperar e armazenar dados.

IDataObject também gere ligações para aconselhar os sinks a tratar notificações de alterações de dados. Para que o cliente receba notificações de alteração de dados do objeto de dados, o cliente deve implementar a interface IAdviseSink num objeto chamado sumidouro de aconselhamento. Quando o cliente chama IDataObject::DAdviseentão , estabelece-se uma ligação entre o objeto de dados e o sumidouro de aconselhamento.

Class IDataObjectImpl fornece uma implementação padrão de IDataObject e implementa IUnknown enviando informação para o dispositivo de despejo em compilações de depuração.

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

Hierarquia de herança

IDataObject

IDataObjectImpl

Requerimentos

Cabeçalho: atlctl.h

IDataObjectImpl::D Advise

Estabelece uma ligação entre o objeto de dados e um sumidouro de aconselhamento.

HRESULT DAdvise(
    FORMATETC* pformatetc,
    DWORD advf,
    IAdviseSink* pAdvSink,
    DWORD* pdwConnection);

Observações

Isto permite que o sumidouro de aconselhamento receba notificações de alterações no objeto.

Para terminar a ligação, ligue para o DUnadvise.

Consulte IDataObject::D Advise no SDK do Windows.

IDataObjectImpl::D Unadvise

Termina uma ligação previamente estabelecida através do DAdvise.

HRESULT DUnadvise(DWORD dwConnection);

Observações

Veja IDataObject::D Unadvise no SDK do Windows.

IDataObjectImpl::EnumDAdvise

Cria um enumerador para iterar pelas conexões de aconselhamento atuais.

HRESULT DAdvise(
    FORMATETC* pformatetc,
    DWORD advf,
    IAdviseSink* pAdvSink,
    DWORD* pdwConnection);

Observações

Veja IDataObject::EnumDAdvise no SDK do Windows.

IDataObjectImpl::EnumFormatEtc

Cria um enumerador para iterar através das FORMATETC estruturas suportadas pelo objeto de dados.

HRESULT EnumFormatEtc(
    DWORD dwDirection,
    IEnumFORMATETC** ppenumFormatEtc);

Observações

Veja IDataObject::EnumFormatEtc no SDK do Windows.

Valor de retorno

Devolve E_NOTIMPL.

IDataObjectImpl::FireDataChange

Envia uma notificação de alteração de volta para cada servidor de aconselhamento que esteja atualmente a ser gerido.

HRESULT FireDataChange();

Valor de retorno

Um valor HRESULT padrão.

IDataObjectImpl::GetCanonicalFormatEtc

Recupera uma estrutura logicamente equivalente FORMATETC a uma mais complexa.

HRESULT GetCanonicalFormatEtc(FORMATETC* pformatetcIn, FORMATETC* pformatetcOut);

Valor de retorno

Devolve E_NOTIMPL.

Observações

Veja IDataObject::GetCanonicalFormatEtc no SDK do Windows.

IDataObjectImpl::GetData

Transfere dados do objeto de dados para o cliente.

HRESULT GetData(
    FORMATETC* pformatetcIn,
    STGMEDIUM* pmedium);

Observações

O parâmetro pformatetcIn deve especificar um tipo de meio de armazenamento de TYMED_MFPICT.

Veja IDataObject::GetData no SDK do Windows.

IDataObjectImpl::GetDataHere

Semelhante a GetData, exceto que o cliente deve alocar a STGMEDIUM estrutura.

HRESULT GetDataHere(
    FORMATETC* pformatetc,
    STGMEDIUM* pmedium);

Valor de retorno

Devolve E_NOTIMPL.

Observações

Veja IDataObject::GetDataHere no SDK do Windows.

IDataObjectImpl::QueryGetData

Determina se o objeto de dados suporta uma estrutura específica FORMATETC para transferência de dados.

HRESULT QueryGetData(FORMATETC* pformatetc);

Valor de retorno

Devolve E_NOTIMPL.

Observações

Veja IDataObject::QueryGetData no SDK do Windows.

IDataObjectImpl::SetData

Transfere dados do cliente para o objeto de dados.

HRESULT SetData(
    FORMATETC* pformatetc,
    STGMEDIUM* pmedium,
    BOOL fRelease);

Valor de retorno

Devolve E_NOTIMPL.

Observações

Veja IDataObject::SetData no SDK do Windows.

Consulte também

Visão geral da classe

  • Last updated on