IDataObject Interfejs
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zapewnia niezależny od formatu mechanizm przesyłania danych.
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- Pochodne
- Atrybuty
Uwagi
Interfejs IDataObject jest używany przez klasę Clipboard i w operacjach przeciągania i upuszczania.
Po zaimplementowaniu w klasie IDataObject metody umożliwiają użytkownikowi przechowywanie danych w wielu formatach w wystąpieniu klasy. Przechowywanie danych w więcej niż jednym formacie zwiększa prawdopodobieństwo, że aplikacja docelowa, której wymagania dotyczące formatu mogą nie być znane, mogą pobrać przechowywane dane. Aby przechowywać dane w wystąpieniu IDataObjectklasy , wywołaj metodę SetData i określ format danych w parametrze format . Ustaw parametr na autoConvert false wartość , jeśli nie chcesz, aby przechowywane dane zostały przekonwertowane na inny format podczas pobierania. Wywołaj SetData wiele razy w jednym wystąpieniu programu IDataObject , aby przechowywać dane w więcej niż jednym formacie.
Przechowywane dane są pobierane z obiektu IDataObject przez wywołanie GetData metody i określenie formatu danych w parametrze format . Ustaw parametr na autoConvert wartość , aby false pobrać tylko dane przechowywane w określonym formacie. Aby przekonwertować przechowywane dane do określonego formatu, ustaw wartość autoConvert truena , lub nie używaj wartości autoConvert.
Aby określić formaty danych przechowywanych w obiekcie IDataObject, użyj następujących IDataObject metod.
Wywołaj metodę , GetFormats aby pobrać tablicę wszystkich formatów, w których dane są dostępne. Ustaw parametr ,
autoConvertabyfalseuzyskać tylko formaty, w których są przechowywane dane. Aby pobrać wszystkie formaty, w których są dostępne dane, ustaw wartośćautoConverttruelub nie używaj tego parametru.Wywołaj metodę , GetDataPresent aby określić, czy przechowywane dane są dostępne w określonym formacie. Jeśli nie chcesz, aby przechowywane dane zostały przekonwertowane na określony format, ustaw parametr na
autoConvertfalsewartość .
Zobacz klasę DataObject , aby zapoznać się z implementacją tego interfejsu. Zobacz klasę DataFormats dla wstępnie zdefiniowanych Clipboard formatów danych.
Metody
| GetData(String) |
Pobiera dane skojarzone z określonym formatem danych. |
| GetData(String, Boolean) |
Pobiera dane skojarzone z określonym formatem danych przy użyciu wartości logicznej w celu określenia, czy dane mają być konwertowane na format. |
| GetData(Type) |
Pobiera dane skojarzone z określonym formatem typu klasy. |
| GetDataPresent(String) |
Określa, czy dane przechowywane w tym wystąpieniu są skojarzone z określonym formatem lub można je przekonwertować na. |
| GetDataPresent(String, Boolean) |
Określa, czy dane przechowywane w tym wystąpieniu są skojarzone z określonym formatem, używając wartości logicznej w celu określenia, czy dane mają być konwertowane na format. |
| GetDataPresent(Type) |
Określa, czy dane przechowywane w tym wystąpieniu są skojarzone z określonym formatem lub można je przekonwertować na. |
| GetFormats() |
Zwraca listę wszystkich formatów, z którymi są skojarzone dane przechowywane w tym wystąpieniu lub do których można je przekonwertować. |
| GetFormats(Boolean) |
Pobiera listę wszystkich formatów, z którymi dane przechowywane w tym wystąpieniu są skojarzone lub można je przekonwertować przy użyciu wartości logicznej w celu określenia, czy pobrać wszystkie formaty, które można przekonwertować na lub tylko natywne formaty danych. |
| SetData(Object) |
Przechowuje określone dane w tym wystąpieniu przy użyciu klasy danych dla formatu. |
| SetData(String, Boolean, Object) |
Przechowuje określone dane i skojarzony z nim format w tym wystąpieniu, używając wartości logicznej w celu określenia, czy dane można przekonwertować na inny format. |
| SetData(String, Object) |
Przechowuje określone dane i skojarzony z nim format w tym wystąpieniu. |
| SetData(Type, Object) |
Przechowuje określone dane i skojarzony typ klasy w tym wystąpieniu. |