IDataObject Interface
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt een indelingsonafhankelijk mechanisme voor het overdragen van gegevens.
public interface class IDataObject[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject[<System.Runtime.InteropServices.ComVisible(true)>]
type IDataObject = interfacePublic Interface IDataObject- Afgeleid
- Kenmerken
Opmerkingen
De IDataObject interface wordt gebruikt door de Clipboard klasse en in slepen en neerzetten.
Wanneer deze wordt geïmplementeerd in een klasse, kunnen de gebruikers met de IDataObject methoden gegevens opslaan in meerdere indelingen in een exemplaar van de klasse. Als u gegevens opslaat in meer dan één indeling, wordt de kans groter dat een doeltoepassing, waarvan u de indelingsvereisten mogelijk niet kent, de opgeslagen gegevens kan ophalen. Als u gegevens wilt opslaan in een exemplaar van IDataObject, roept u de methode aan SetData en geeft u de gegevensindeling op in de format parameter. Stel de autoConvert parameter in op false als u niet wilt dat opgeslagen gegevens worden geconverteerd naar een andere indeling wanneer deze worden opgehaald. Roep SetData meerdere keren aan op één exemplaar van het opslaan van IDataObject gegevens in meer dan één indeling.
U haalt opgeslagen gegevens op uit een IDataObject door de GetData methode aan te roepen en de gegevensindeling in de format parameter op te geven. Stel de autoConvert parameter in om false alleen gegevens op te halen die zijn opgeslagen in de opgegeven indeling. Als u de opgeslagen gegevens wilt converteren naar de opgegeven indeling, stelt u deze in autoConverttrueof gebruikt autoConvertu deze niet.
Gebruik de volgende IDataObject methoden om de indelingen te bepalen van de gegevens die zijn opgeslagen in eenIDataObject.
Roep de GetFormats methode aan om een matrix op te halen van alle indelingen waarin de gegevens beschikbaar zijn. Stel de
autoConvertparameter in omfalsealleen de indelingen op te halen waarin de gegevens worden opgeslagen. Als u alle indelingen wilt ophalen waarin de gegevens beschikbaar zijn, stelt u deze parameter inautoConverttrueof gebruikt u deze parameter niet.Roep de GetDataPresent methode aan om te bepalen of opgeslagen gegevens beschikbaar zijn in een bepaalde indeling. Als u niet wilt dat opgeslagen gegevens worden geconverteerd naar de opgegeven indeling, stelt u de
autoConvertparameterfalsein op .
Bekijk de DataObject klasse voor een implementatie van deze interface. Bekijk de DataFormats klasse voor de vooraf gedefinieerde Clipboard gegevensindelingen.
Methoden
| Name | Description |
|---|---|
| GetData(String, Boolean) |
Haalt de gegevens op die zijn gekoppeld aan de opgegeven gegevensindeling, met behulp van een Booleaanse waarde om te bepalen of de gegevens naar de indeling moeten worden geconverteerd. |
| GetData(String) |
Haalt de gegevens op die zijn gekoppeld aan de opgegeven gegevensindeling. |
| GetData(Type) |
Haalt de gegevens op die zijn gekoppeld aan de opgegeven indeling van het klassetype. |
| GetDataPresent(String, Boolean) |
Bepaalt of gegevens die zijn opgeslagen in dit exemplaar zijn gekoppeld aan de opgegeven indeling, met behulp van een Booleaanse waarde om te bepalen of de gegevens moeten worden geconverteerd naar de indeling. |
| GetDataPresent(String) |
Bepaalt of gegevens die in dit exemplaar zijn opgeslagen, zijn gekoppeld aan of kunnen worden geconverteerd naar de opgegeven indeling. |
| GetDataPresent(Type) |
Bepaalt of gegevens die in dit exemplaar zijn opgeslagen, zijn gekoppeld aan of kunnen worden geconverteerd naar de opgegeven indeling. |
| GetFormats() |
Retourneert een lijst met alle indelingen waaraan gegevens die in dit exemplaar zijn opgeslagen, zijn gekoppeld aan of kunnen worden geconverteerd naar. |
| GetFormats(Boolean) |
Haalt een lijst op met alle indelingen waaraan gegevens die in dit exemplaar zijn opgeslagen, zijn gekoppeld aan of kunnen worden geconverteerd naar, met behulp van een Booleaanse waarde om te bepalen of alle indelingen moeten worden opgehaald waarnaar de gegevens kunnen worden geconverteerd of alleen systeemeigen gegevensindelingen. |
| SetData(Object) |
Slaat de opgegeven gegevens in dit exemplaar op met behulp van de klasse van de gegevens voor de indeling. |
| SetData(String, Boolean, Object) |
Slaat de opgegeven gegevens en de bijbehorende indeling in dit exemplaar op met behulp van een Booleaanse waarde om op te geven of de gegevens naar een andere indeling kunnen worden geconverteerd. |
| SetData(String, Object) |
Slaat de opgegeven gegevens en de bijbehorende indeling op in dit exemplaar. |
| SetData(Type, Object) |
Slaat de opgegeven gegevens en het bijbehorende klassetype op in dit exemplaar. |