Udostępnij za pośrednictwem


IDataObject Interfejs

Definicja

Zapewnia niezależny od formatu mechanizm przesyłania danych.

public interface class IDataObject
[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject
public interface IDataObject
[<System.Runtime.InteropServices.ComVisible(true)>]
type IDataObject = interface
type IDataObject = interface
Public 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 , autoConvert aby false uzyskać tylko formaty, w których są przechowywane dane. Aby pobrać wszystkie formaty, w których są dostępne dane, ustaw wartość autoConvert truelub 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 autoConvert falsewartość .

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.

Dotyczy

Zobacz też