IDataObject Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona un mecanismo independiente del formato para transferir datos.
public interface class IDataObject[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject[<System.Runtime.InteropServices.ComVisible(true)>]
type IDataObject = interfacePublic Interface IDataObject- Derivado
- Atributos
Comentarios
La IDataObject interfaz la usa la Clipboard clase y en las operaciones de arrastrar y colocar.
Cuando se implementa en una clase, los IDataObject métodos permiten al usuario almacenar datos en varios formatos en una instancia de la clase . Almacenar datos en más de un formato aumenta la posibilidad de que una aplicación de destino, cuyos requisitos de formato no conozca, pueda recuperar los datos almacenados. Para almacenar datos en una instancia de IDataObject, llame al SetData método y especifique el formato de datos en el format parámetro . Establezca el autoConvert parámetro false en si no desea que los datos almacenados se conviertan a otro formato cuando se recupere. Invoque SetData varias veces en una instancia de para almacenar datos en más de IDataObject un formato.
Para recuperar los datos almacenados de un IDataObject , llame al GetData método y especifique el formato de datos en el format parámetro . Establezca el autoConvert parámetro false en para recuperar solo los datos almacenados en el formato especificado. Para convertir los datos almacenados en el formato especificado, establezca en autoConverttrueo no use autoConvert.
Para determinar los formatos de los datos almacenados en , IDataObjectuse los métodos siguientes IDataObject .
Llame al GetFormats método para recuperar una matriz de todos los formatos en los que están disponibles los datos. Establezca el
autoConvertparámetrofalseen para obtener solo los formatos en los que se almacenan los datos. Para obtener todos los formatos en los que están disponibles los datos, establezca enautoConverttrueo no use este parámetro.Llame al GetDataPresent método para determinar si los datos almacenados están disponibles en un formato determinado. Si no desea que los datos almacenados se conviertan en el formato especificado, establezca el
autoConvertparámetrofalseen .
Consulte la DataObject clase para obtener una implementación de esta interfaz. Consulte la DataFormats clase para ver los formatos de datos predefinidos Clipboard .
Métodos
| Nombre | Description |
|---|---|
| GetData(String, Boolean) |
Recupera los datos asociados al formato de datos especificado, utilizando un valor Boolean para determinar si se van a convertir los datos en el formato. |
| GetData(String) |
Recupera los datos asociados al formato de datos especificado. |
| GetData(Type) |
Recupera los datos asociados al formato de tipo de clase especificado. |
| GetDataPresent(String, Boolean) |
Determina si los datos almacenados en esta instancia están asociados con el formato especificado, utilizando un valor booleano para determinar si se van a convertir los datos al formato. |
| GetDataPresent(String) |
Determina si los datos almacenados en esta instancia están asociados o se pueden convertir al formato especificado. |
| GetDataPresent(Type) |
Determina si los datos almacenados en esta instancia están asociados o se pueden convertir al formato especificado. |
| GetFormats() |
Devuelve una lista de todos los formatos a los que se asocian o se pueden convertir los datos almacenados en esta instancia. |
| GetFormats(Boolean) |
Obtiene una lista de todos los formatos a los que se asocian los datos almacenados en esta instancia o se pueden convertir, mediante un valor booleano para determinar si se deben recuperar todos los formatos a los que se pueden convertir los datos a formatos de datos nativos o solo a formatos de datos nativos. |
| SetData(Object) |
Almacena los datos especificados en esta instancia mediante la clase de los datos para el formato. |
| SetData(String, Boolean, Object) |
Almacena los datos especificados y su formato asociado en esta instancia, utilizando un valor booleano para especificar si los datos se pueden convertir a otro formato. |
| SetData(String, Object) |
Almacena los datos especificados y su formato asociado en esta instancia. |
| SetData(Type, Object) |
Almacena los datos especificados y su tipo de clase asociado en esta instancia. |