IDataObject Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece um mecanismo independente de formato para a transferência de dados.
public interface class IDataObject[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObjectpublic interface IDataObject[<System.Runtime.InteropServices.ComVisible(true)>]
type IDataObject = interfacetype IDataObject = interfacePublic Interface IDataObject- Derivado
- Atributos
Comentários
A IDataObject interface é usada pela Clipboard classe e em operações de arrastar e soltar.
Quando implementados em uma classe, os IDataObject métodos permitem que o usuário armazene dados em vários formatos em uma instância da classe. Armazenar dados em mais de um formato aumenta a chance de um aplicativo de destino, cujos requisitos de formato talvez você não conheça, possa recuperar os dados armazenados. Para armazenar dados em uma instância de IDataObject, chame o SetData método e especifique o formato de dados no format parâmetro. Defina o autoConvert parâmetro como false se você não quiser que os dados armazenados sejam convertidos em outro formato quando forem recuperados. Invoque SetData várias vezes em uma instância para IDataObject armazenar dados em mais de um formato.
Você recupera dados armazenados de um IDataObject chamando o GetData método e especificando o formato de dados no format parâmetro. Defina o autoConvert parâmetro para false recuperar apenas os dados armazenados no formato especificado. Para converter os dados armazenados no formato especificado, defina autoConvert como true, ou não use autoConvert.
Para determinar os formatos dos dados armazenados em um IDataObject, use os métodos a seguir IDataObject .
Chame o GetFormats método para recuperar uma matriz de todos os formatos nos quais os dados estão disponíveis. Defina o
autoConvertparâmetro parafalseobter apenas os formatos nos quais os dados são armazenados. Para obter todos os formatos nos quais os dados estão disponíveis, definaautoConvertcomotrueou não use esse parâmetro.Chame o método para determinar se os GetDataPresent dados armazenados estão disponíveis em um determinado formato. Se você não quiser que os dados armazenados sejam convertidos no formato especificado, defina o
autoConvertparâmetro comofalse.
Consulte a DataObject classe para obter uma implementação dessa interface. Consulte a DataFormats classe para obter os formatos de dados predefinidos Clipboard .
Métodos
| GetData(String) |
Recupera os dados associados ao formato de dados especificado. |
| 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. |
| GetData(Type) |
Recupera os dados associados ao formato do tipo de classe especificado. |
| GetDataPresent(String) |
Determina se os dados armazenados nesta instância estão associados ao formato especificado ou podem ser convertidos para ele. |
| 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. |
| GetDataPresent(Type) |
Determina se os dados armazenados nesta instância estão associados ao formato especificado ou podem ser convertidos para ele. |
| 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. |
| 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. |
| SetData(Object) |
Armazena os dados especificados nesta instância, usando a classe dos dados para o formato. |
| 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. |
| SetData(String, Object) |
Armazena os dados especificados e seu formato associado nesta instância. |
| SetData(Type, Object) |
Armazena os dados especificados e seu tipo de classe associado nesta instância. |