IDataObject Interface
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece um mecanismo independente do formato para transferência de dados.
public interface class IDataObject[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject[<System.Runtime.InteropServices.ComVisible(true)>]
type IDataObject = interfacePublic Interface IDataObject- Derivado
- Atributos
Observações
A IDataObject interface é usada pela Clipboard classe e em operações de arrastar e largar.
Quando implementados numa classe, os IDataObject métodos permitem ao utilizador armazenar dados em múltiplos formatos numa instância da classe. Armazenar dados em mais do que um formato aumenta a probabilidade de uma aplicação-alvo, cujos requisitos de formato pode não conhecer, conseguir recuperar os dados armazenados. Para armazenar dados numa instância de IDataObject, chame o SetData método e especifique o formato dos dados no format parâmetro. Defina o autoConvert parâmetro para false se não quiser que os dados armazenados sejam convertidos para outro formato quando forem recuperados. Invoca SetData várias vezes numa única instância IDataObject para armazenar dados em mais do que um formato.
Recupera os dados armazenados de um IDataObject chamando o GetData método e especificando o formato dos 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 para o formato especificado, defina autoConvert para true, ou não use autoConvert.
Para determinar os formatos dos dados armazenados num IDataObject, utilize os seguintes IDataObject métodos.
Chame o GetFormats método para recuperar um array de todos os formatos em que os dados estão disponíveis. Defina o
autoConvertparâmetro parafalseobter apenas os formatos em que os dados estão armazenados. Para obter todos os formatos em que os dados estão disponíveis, definaautoConvertparatrue, ou não use este parâmetro.Chame o GetDataPresent método para determinar se os dados armazenados estão disponíveis num determinado formato. Se não quiser que os dados armazenados sejam convertidos para o formato especificado, defina o
autoConvertparâmetro parafalse.
Consulte a DataObject classe para uma implementação desta interface. Consulte a DataFormats classe para os formatos de dados predefinidos Clipboard .
Métodos
| Name | Description |
|---|---|
| GetData(String, Boolean) |
Recupera os dados associados ao formato especificado, usando um Booleano para determinar se deve converter os dados para o formato. |
| GetData(String) |
Recupera os dados associados ao formato de dados especificado. |
| GetData(Type) |
Recupera os dados associados ao formato de tipo de classe especificado. |
| GetDataPresent(String, Boolean) |
Determina se os dados armazenados nesta instância estão associados ao formato especificado, usando um valor booleano para determinar se os dados devem ser convertidos para o formato. |
| GetDataPresent(String) |
Determina se os dados armazenados nesta instância estão associados ou podem ser convertidos para, o formato especificado. |
| GetDataPresent(Type) |
Determina se os dados armazenados nesta instância estão associados ou podem ser convertidos para, o formato especificado. |
| GetFormats() |
Devolve uma lista de todos os formatos a que os dados armazenados nesta instância estão associados ou para os quais podem ser convertidos. |
| GetFormats(Boolean) |
Obtém uma lista de todos os formatos a que os dados armazenados nesta instância estão associados ou para os quais podem ser convertidos, usando um valor booleano para determinar se recuperar todos os formatos para os quais os dados podem ser convertidos ou apenas formatos nativos. |
| SetData(Object) |
Armazena os dados especificados neste caso, usando a classe dos dados para o formato. |
| SetData(String, Boolean, Object) |
Armazena os dados especificados e o seu formato associado neste caso, usando um valor booleano para especificar se os dados podem ser convertidos para outro formato. |
| SetData(String, Object) |
Armazena os dados especificados e o seu formato associado neste caso. |
| SetData(Type, Object) |
Armazena os dados especificados e o seu tipo de classe associado neste caso. |