IDataObject Interface

Definição

Fornece um mecanismo independente de formato para a transferência de dados.Provides a format-independent mechanism for transferring data.

public interface class IDataObject
public interface IDataObject
[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject
type IDataObject = interface
Public Interface IDataObject
Derivado
Atributos

Comentários

A interface IDataObject é usada pela classe Clipboard e nas operações de arrastar e soltar.The IDataObject interface is used by the Clipboard class and in drag-and-drop operations.

Quando implementada em uma classe, os métodos de IDataObject permitem que o usuário armazene dados em vários formatos em uma instância da classe.When implemented in a class, the IDataObject methods allow the user to store data in multiple formats in an instance of the class. O armazenamento de dados em mais de um formato aumenta a chance de que um aplicativo de destino, cujos requisitos de formato você talvez não conheça, possa recuperar os dados armazenados.Storing data in more than one format increases the chance that a target application, whose format requirements you might not know, can retrieve the stored data. Para armazenar dados em uma instância do IDataObject, chame o método SetData e especifique o formato de dados no parâmetro format.To store data in an instance of IDataObject, call the SetData method and specify the data format in the format parameter. Defina o parâmetro autoConvert como false se você não quiser que os dados armazenados sejam convertidos em outro formato quando ele for recuperado.Set the autoConvert parameter to false if you do not want stored data to be converted to another format when it is retrieved. Invocar SetData várias vezes em uma instância de IDataObject para armazenar dados em mais de um formato.Invoke SetData multiple times on one instance of IDataObject to store data in more than one format.

Você recupera dados armazenados de um IDataObject chamando o método GetData e especificando o formato de dados no parâmetro format.You retrieve stored data from an IDataObject by calling the GetData method and specifying the data format in the format parameter. Defina o parâmetro autoConvert como false para recuperar somente os dados que foram armazenados no formato especificado.Set the autoConvert parameter to false to retrieve only data that was stored in the specified format. Para converter os dados armazenados no formato especificado, defina autoConvert como trueou não use autoConvert.To convert the stored data to the specified format, set autoConvert to true, or do not use autoConvert.

Para determinar os formatos dos dados armazenados em um IDataObject, use os seguintes métodos de IDataObject.To determine the formats of the data stored in an IDataObject, use the following IDataObject methods.

  • Chame o método GetFormats para recuperar uma matriz de todos os formatos nos quais os dados estão disponíveis.Call the GetFormats method to retrieve an array of all the formats in which the data is available. Defina o parâmetro autoConvert como false para obter apenas os formatos nos quais os dados são armazenados.Set the autoConvert parameter to false to get only the formats in which the data is stored. Para obter todos os formatos nos quais os dados estão disponíveis, defina autoConvert como trueou não use esse parâmetro.To get all the formats in which the data is available, set autoConvert to true, or do not use this parameter.

  • Chame o método GetDataPresent para determinar se os dados armazenados estão disponíveis em um determinado formato.Call the GetDataPresent method to determine whether stored data is available in a certain format. Se você não quiser que os dados armazenados sejam convertidos no formato especificado, defina o parâmetro autoConvert como false.If you do not want stored data to be converted to the specified format, set the autoConvert parameter to false.

Consulte a classe DataObject para uma implementação dessa interface.See the DataObject class for an implementation of this interface. Consulte a classe DataFormats para os formatos de dados predefinidos Clipboard.See the DataFormats class for the predefined Clipboard data formats.

Métodos

GetData(String)

Recupera os dados associados ao formato de dados especificado.Retrieves the data associated with the specified data format.

GetData(String, Boolean)

Recupera os dados associados com o formato de dados especificado, usando um valor booliano para determinar se os dados devem ou não ser convertidos para o formato.Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

GetData(Type)

Recupera os dados associados ao formato do tipo de classe especificado.Retrieves the data associated with the specified class type format.

GetDataPresent(String)

Determina se os dados armazenados nesta instância estão associados ao formato especificado ou podem ser convertidos para ele.Determines whether data stored in this instance is associated with, or can be converted to, the specified format.

GetDataPresent(String, Boolean)

Determina se os dados armazenados nesta instância são associados ao formato especificado, usando um valor booliano para determinar se deve converter os dados para o formato.Determines whether data stored in this instance is associated with the specified format, using a Boolean value to determine whether to convert the data to the format.

GetDataPresent(Type)

Determina se os dados armazenados nesta instância estão associados ao formato especificado ou podem ser convertidos para ele.Determines whether data stored in this instance is associated with, or can be converted to, the specified format.

GetFormats()

Retorna uma lista de todos os formatos aos quais os dados armazenados nessa instância estão associados ou nos quais eles podem ser convertidos.Returns a list of all formats that data stored in this instance is associated with or can be converted to.

GetFormats(Boolean)

Obtém uma lista de todos os formatos aos quais os dados armazenados nesta instância estão associados ou nos quais eles podem ser convertidos, usando um valor booliano para determinar se deve-se recuperar todos os formatos nos quais os dados podem ser convertidos ou somente os formatos de dados nativos.Gets a list of all formats that data stored in this instance is associated with or can be converted to, using a Boolean value to determine whether to retrieve all formats that the data can be converted to or only native data formats.

SetData(Object)

Armazena os dados especificados nesta instância, usando a classe dos dados para o formato.Stores the specified data in this instance, using the class of the data for the format.

SetData(String, Boolean, Object)

Armazena os dados especificados e seu formato associado nesta instância, usando um valor booliano para especificar se os dados podem ser convertidos para outro formato.Stores the specified data and its associated format in this instance, using a Boolean value to specify whether the data can be converted to another format.

SetData(String, Object)

Armazena os dados especificados e seu formato associado nesta instância.Stores the specified data and its associated format in this instance.

SetData(Type, Object)

Armazena os dados especificados e seu tipo de classe associado nesta instância.Stores the specified data and its associated class type in this instance.

Aplica-se a

Veja também