IDataObject Interfaccia
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce un meccanismo indipendente dal formato per il trasferimento dei dati.
public interface class IDataObject[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject[<System.Runtime.InteropServices.ComVisible(true)>]
type IDataObject = interfacePublic Interface IDataObject- Derivato
- Attributi
Commenti
L'interfaccia IDataObjectClipboard viene usata dalla classe e nelle operazioni di trascinamento della selezione.
Se implementato in una classe, i IDataObject metodi consentono all'utente di archiviare i dati in più formati in un'istanza della classe . L'archiviazione dei dati in più formati aumenta la possibilità che un'applicazione di destinazione, i cui requisiti di formato non si conoscono, possa recuperare i dati archiviati. Per archiviare i dati in un'istanza di IDataObject, chiamare il SetData metodo e specificare il formato dei dati nel format parametro . Impostare il autoConvert parametro su false se non si desidera che i dati archiviati vengano convertiti in un altro formato quando vengono recuperati. Richiamare SetData più volte in un'istanza di IDataObject per archiviare i dati in più formati.
È possibile recuperare i dati archiviati da un oggetto IDataObject chiamando il GetData metodo e specificando il formato dei dati nel format parametro . Impostare il autoConvert parametro su false per recuperare solo i dati archiviati nel formato specificato. Per convertire i dati archiviati nel formato specificato, impostare su autoConverttrueo non utilizzare autoConvert.
Per determinare i formati dei dati archiviati in un IDataObjectoggetto , usare i metodi seguenti IDataObject .
Chiamare il GetFormats metodo per recuperare una matrice di tutti i formati in cui sono disponibili i dati. Impostare il
autoConvertparametro sufalseper ottenere solo i formati in cui vengono archiviati i dati. Per ottenere tutti i formati in cui sono disponibili i dati, impostare suautoConverttrueo non usare questo parametro.Chiamare il GetDataPresent metodo per determinare se i dati archiviati sono disponibili in un determinato formato. Se non si desidera convertire i dati archiviati nel formato specificato, impostare il
autoConvertparametro sufalse.
Vedere la DataObject classe per un'implementazione di questa interfaccia. Vedere la DataFormats classe per i formati di dati predefiniti Clipboard .
Metodi
| Nome | Descrizione |
|---|---|
| GetData(String, Boolean) |
Recupera i dati associati al formato di dati specificato, utilizzando un valore Boolean per determinare se convertire i dati nel formato. |
| GetData(String) |
Recupera i dati associati al formato di dati specificato. |
| GetData(Type) |
Recupera i dati associati al formato del tipo di classe specificato. |
| GetDataPresent(String, Boolean) |
Determina se i dati archiviati in questa istanza sono associati al formato specificato, utilizzando un valore booleano per determinare se convertire i dati nel formato. |
| GetDataPresent(String) |
Determina se i dati archiviati in questa istanza sono associati o possono essere convertiti nel formato specificato. |
| GetDataPresent(Type) |
Determina se i dati archiviati in questa istanza sono associati o possono essere convertiti nel formato specificato. |
| GetFormats() |
Restituisce un elenco di tutti i formati in cui i dati archiviati in questa istanza sono associati o possono essere convertiti. |
| GetFormats(Boolean) |
Ottiene un elenco di tutti i formati a cui i dati archiviati in questa istanza sono associati o possono essere convertiti utilizzando un valore booleano per determinare se recuperare tutti i formati che i dati possono essere convertiti in o solo in formati di dati nativi. |
| SetData(Object) |
Archivia i dati specificati in questa istanza usando la classe dei dati per il formato. |
| SetData(String, Boolean, Object) |
Archivia i dati specificati e il relativo formato associato in questa istanza, utilizzando un valore booleano per specificare se i dati possono essere convertiti in un altro formato. |
| SetData(String, Object) |
Archivia i dati specificati e il relativo formato associato in questa istanza. |
| SetData(Type, Object) |
Archivia i dati specificati e il tipo di classe associato in questa istanza. |