IDataObject Rozhraní
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje mechanismus nezávislý na formátu pro přenos dat.
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
- Odvozené
- Atributy
Poznámky
Rozhraní IDataObject
je používáno Clipboard třídou a v operacích přetažení.
Při implementaci ve třídě IDataObject umožňují metody uživateli ukládat data ve více formátech v instanci třídy. Ukládání dat ve více než jednom formátu zvyšuje pravděpodobnost, že cílová aplikace, jejíž požadavky na formát možná neznáte, může načíst uložená data. Chcete-li uložit data v instanci IDataObject, zavolejte metodu SetData a zadejte formát dat v parametru format
. Pokud nechcete, aby se uložená data při načítání převedli do jiného formátu, nastavte parametr autoConvert
false
na hodnotu. Vyvolání SetData vícekrát v jedné instanci IDataObject pro ukládání dat ve více než jednom formátu.
Načtete uložená data z IDataObject metody voláním GetData metody a zadáním formátu dat v parametru format
. autoConvert
Nastavte parametr tak, aby false
načítal pouze data uložená v zadaném formátu. Chcete-li převést uložená data do zadaného formátu, nastavte autoConvert
na true
hodnotu nebo nepoužívejte autoConvert
.
K určení formátů dat uložených v souboru IDataObjectpoužijte následující IDataObject metody.
GetFormats Voláním metody načtěte pole všech formátů, ve kterých jsou data k dispozici.
autoConvert
Nastavte parametr tak, abyfalse
získal pouze formáty, ve kterých jsou data uložena. Chcete-li získat všechny formáty, ve kterých jsou data k dispozici, nastavteautoConvert
natrue
hodnotu nebo nepoužívejte tento parametr.Voláním GetDataPresent metody určete, jestli jsou uložená data k dispozici v určitém formátu. Pokud nechcete, aby uložená data byla převedena do zadaného formátu, nastavte
autoConvert
parametr nafalse
.
Podívejte se na DataObject třídu pro implementaci tohoto rozhraní. DataFormats Viz třída pro předdefinované Clipboard formáty dat.
Metody
GetData(String) |
Načte data přidružená k zadanému formátu dat. |
GetData(String, Boolean) |
Načte data přidružená k zadanému formátu dat pomocí logické hodnoty k určení, jestli se mají data převést do formátu. |
GetData(Type) |
Načte data přidružená k zadanému formátu typu třídy. |
GetDataPresent(String) |
Určuje, jestli jsou data uložená v této instanci přidružená nebo lze převést na zadaný formát. |
GetDataPresent(String, Boolean) |
Určuje, zda jsou data uložená v této instanci přidružená k zadanému formátu pomocí logické hodnoty k určení, zda se mají data převést do formátu. |
GetDataPresent(Type) |
Určuje, jestli jsou data uložená v této instanci přidružená nebo lze převést na zadaný formát. |
GetFormats() |
Vrátí seznam všech formátů, ke kterým jsou data uložená v této instanci přidružená nebo lze je převést. |
GetFormats(Boolean) |
Získá seznam všech formátů, ke kterým jsou data uložená v této instanci přidružená nebo lze je převést, pomocí logické hodnoty určit, zda se mají načíst všechny formáty, na které lze data převést, nebo pouze na nativní datové formáty. |
SetData(Object) |
Ukládá zadaná data v této instanci pomocí třídy dat pro formát. |
SetData(String, Boolean, Object) |
Uloží zadaná data a přidružený formát v této instanci pomocí logické hodnoty k určení, zda lze data převést do jiného formátu. |
SetData(String, Object) |
Ukládá zadaná data a jeho přidružený formát v této instanci. |
SetData(Type, Object) |
Ukládá zadaná data a jeho přidružený typ třídy v této instanci. |