IDataObject
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa interface especifica os métodos que habilitar transferência de dados e notificação de alterações em dados. O formato dos dados transferidos along with a mídia através do qual os dados é a serem transferidas especificar métodos transferir dados.
Opcionalmente, os dados podem ser processados para um dispositivo destino específico. Juntamente com métodos para recuperar e armazenar dados, o IDataObject interface especifica métodos para enumerar disponível formata e gerenciamento de conexões para de consultoria recpetores para manipulação alteração notificações.
O termo objeto de dados é usado para significar qualquer objeto que ofereça suporte a uma implementação das IDataObject interface.
Implementações variam, dependendo o que o objeto de dados é exigido para fazer; Em alguns dados objetos, a implementação de determinados métodos não com suporte, o objeto poderia simplesmente ser o retorno de E_NOTIMPL. Por exemplo, alguns objetos dados não permitem que chamadores para enviá-las dados.
Outros objetos dados não oferecem suporte de consultoria conexões e notificações alteração. No entanto, para esses objetos dados que não suporte alteração notificações, OLE fornece um chamado objeto um reservado informar dados.
Um objeto de dados pode ter múltiplo conexões, cada um com seu próprio conjunto de atributos. Os dados OLE reservado informar simplifica a tarefa de gerenciar essas conexões e enviando o apropriado notificações.
Quando a implementar
Implementar o IDataObject interface se você estiver desenvolvendo um aplicativo contêiner ou servidor que é capaz de transferir dados. De exemplo, se seu aplicativo permite que seus dados a ser colado ou solto outro aplicativo, você deve implementar o IDataObject interface.
Servidores objeto documento composto OLE que suporte objetos que podem ser incorporado ou vinculado deve implementar IDataObject.
OLE fornece implementações em seu manipulador objeto usar como padrão o armazenar em cache.
Quando usar
Qualquer objeto que pode receber dados chama os métodos in a IDataObject interface.
Quando você chamar os métodos transferência de dados o IDataObject interface, você especificar um formato, um meio e, opcionalmente, um dispositivo destino para o qual os dados devem ser processados.
Objetos, como recipientes, que desejar ser notificado por seus informar recpetores quando os dados na objeto de dados altera chamar o IDataObject de consultoria métodos para configurar uma de consultoria conexão através do qual as notificações podem ser enviadas.
Métodos
A seguinte tabela mostra os métodos para esta interface na ordem que o compilador chama os métodos. Como todas as interfaces COM, essa interface herda os métodos para a IUnknown interface.
| Método IUnknown | Descrição |
|---|---|
Retorna os ponteiros para com suporte interfaces. |
|
Contagem de referência incrementos. |
|
Contagem de referência diminui. |
| Método IDataObject | Descrição |
|---|---|
Processa os dados descritos em um FORMATETC estrutura e transfere-lo através de STGMEDIUM estrutura. |
|
Processa os dados descritos em um FORMATETC estrutura e transfere-lo através de STGMEDIUM estrutura alocada pelo chamador. |
|
Determina se o objeto de dados é capaz de processamento de dados descritos na FORMATETC estrutura. |
|
Fornece um potencialmente diferentes, mas logicamente equivalente FORMATETC estrutura. |
|
Fornece o objeto de dados origem com dados descritos por um FORMATETC estrutura e um STGMEDIUM estrutura. |
|
Cria e retorna um ponteiro para um objeto para enumerar o FORMATETC estrutura com suporte pela objeto de dados. |
|
Cria uma conexão entre um objeto de dados e um coletor de avisos para a coletor de avisos pode receber notificações de alterações na objeto de dados. |
|
Destrói uma notificação configurada anteriormente com o DAdvise método. |
|
Cria e retorna um ponteiro para um objeto para enumerar o atual de consultoria conexões. |
Remarks
Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.
Requisitos
| Header | objidl.h, objidl.idl |
| Library | ole32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |