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 para transferir datos que es independiente del formato.
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
Comentarios
La IDataObject clase usa la Clipboard interfaz 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 recuperen. Invoque SetData varias veces en una instancia de para almacenar datos en más de IDataObject un formato.
Para recuperar los datos almacenados de , IDataObject llame al GetData método y especifique el formato de datos en el format parámetro . Establezca el autoConvert parámetro en false para recuperar solo los datos almacenados en el formato especificado. Para convertir los datos almacenados en el formato especificado, establezca autoConverttrueen o 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ámetro enfalsepara obtener solo los formatos en los que se almacenan los datos. Para obtener todos los formatos en los que están disponibles los datos, establezcaautoConverttrueen o 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 al formato especificado, establezca el
autoConvertparámetrofalseen .
Consulte la DataObject clase para obtener una implementación de esta interfaz. Consulte la DataFormats clase para conocer los formatos de datos predefinidos Clipboard .
Métodos
| GetData(String) |
Recupera los datos asociados al formato de datos especificado. |
| GetData(String, Boolean) |
Recupera los datos asociados al formato de datos especificado, usando un tipo booleano para determinar si se deben convertir a dicho formato los datos. |
| GetData(Type) |
Recupera los datos asociados al formato de tipo de clase especificado. |
| GetDataPresent(String) |
Determina si los datos almacenados en esta instancia están asociados al formato especificado o pueden convertirse al formato especificado. |
| GetDataPresent(String, Boolean) |
Determina si los datos almacenados en esta instancia están asociados al formato especificado, usando un valor de tipo booleano para establecer si se deben convertir a ese formato. |
| GetDataPresent(Type) |
Determina si los datos almacenados en esta instancia están asociados al formato especificado o pueden convertirse al formato especificado. |
| GetFormats() |
Devuelve una lista de todos los formatos a los que se asocian o a los que pueden convertirse los datos almacenados en esta instancia. |
| GetFormats(Boolean) |
Obtiene una lista con todos los formatos a los que están asociados o se pueden convertir los datos almacenados en esta instancia, usando un valor de tipo booleano para determinar si se recuperarán sólo los formatos de datos nativos o todos los formatos a los que pueden convertirse los datos. |
| SetData(Object) |
Almacena los datos especificados en esta instancia utilizando la clase de los datos para el formato. |
| SetData(String, Boolean, Object) |
Almacena los datos especificados y el formato que tienen asociado en esta instancia, usando un valor de tipo booleano para indicar si pueden convertirse los datos a otro formato. |
| SetData(String, Object) |
Almacena en esta instancia los datos especificados y el formato asociado a estos datos. |
| SetData(Type, Object) |
Almacena en esta instancia los datos especificados y el tipo de clase asociado a estos datos. |
