Clipboard Třída

  • Reference

Definice

Obor názvů:
System.Windows
Sestavení:
PresentationCore.dll

Poskytuje statické metody, které usnadňují přenos dat do a ze systémové schránky.

public ref class Clipboard abstract sealed
public static class Clipboard
type Clipboard = class
Public Class Clipboard
Dědičnost
Object
Clipboard

Příklady

Následující příklad ukazuje, jak přidat data do systémové schránky.


// For this example, the data to be placed on the clipboard is a simple
// string.
string textData = "I want to put this string on the clipboard.";

// After this call, the data (string) is placed on the clipboard and tagged
// with a data format of "Text".
Clipboard.SetData(DataFormats.Text, (Object)textData);

' For this example, the data to be placed on the clipboard is a simple
' string.
Dim textData As String = "I want to put this string on the clipboard."

' After this call, the data (string) is placed on the clipboard and tagged
' with a data format of "Text".
Clipboard.SetData(DataFormats.Text, CType(textData, Object))

Poznámky

Všechny aplikace pro Windows sdílejí systémovou schránku, takže obsah se může změnit, když přepnete na jinou aplikaci.

Seznam předdefinovaných formátů, které jsou k dispozici pro použití s Clipboard třídou, najdete v DataFormats této třídě.

Výstraha zabezpečení: Z bezpečnostních důvodů je třeba mít na paměti následující body.

  • Operace vložení musí být zahájeny uživatelem (Ctrl-V, nabídka Vložit).

  • Kopírování může být pouze u uživatelem vybraného obsahu.

  • Při kopírování nebo vyjmutí se kód s částečnou důvěryhodností vloží do schránky ve formátu prostého textu a XAML (Extensible Application Markup Language). Prostý text obsahuje text, text Unicode, text OEM (Object Exchange Model) a csv (hodnoty oddělené čárkami).

  • Při vložení se Windows Presentation Foundation (WPF) vloží do xaml (Extensible Application Markup Language), pokud je zdroj tohoto obsahu ze stejně důvěryhodného webu nebo více důvěryhodného webu. Konkrétně se jedná o tyto:

    • Aplikace s částečnou důvěryhodností může vložit jazyk XAML (Extensible Application Markup Language) z aplikace s plnou důvěryhodností.

    • Aplikace s částečnou důvěryhodností může vložit jazyk XAML (Extensible Application Markup Language) z aplikace s částečnou důvěryhodností.

    • Aplikace s plnou důvěryhodností může vkládat XAML jenom z jiné plně důvěryhodné aplikace.

    • Aplikace bez úplného vztahu důvěryhodnosti Windows Presentation Foundation (WPF) může prozkoumat formát ApplicationTrust ve schránce a v případě potřeby definovat XAML.

Metody

Clear()

Vymaže všechna data ze schránky systému.
ContainsAudio()

Dotazuje schránku na přítomnost dat ve WaveAudio formátu dat.
ContainsData(String)

Dotazuje schránku na přítomnost dat v zadaném datovém formátu.
ContainsFileDropList()

Dotazuje schránku na přítomnost dat ve FileDrop formátu dat.
ContainsImage()

Dotazuje schránku na přítomnost dat ve Bitmap formátu dat.
ContainsText()

Dotazuje schránku na přítomnost dat ve UnicodeText formátu.
ContainsText(TextDataFormat)

Dotazuje schránku na přítomnost dat ve formátu textových dat.
Flush()

Trvale přidá data, která jsou na Clipboard kartě, aby byla k dispozici po zavření původní aplikace dat.
GetAudioStream()

Vrátí datový proud dat schránky ve WaveAudio formátu dat.
GetData(String)

Načte data v zadaném formátu ze schránky.
GetDataObject()

Vrátí datový objekt, který představuje celý obsah schránky.
GetFileDropList()

Vrátí kolekci řetězců, která obsahuje seznam vyřazených souborů dostupných ve schránce.
GetImage()

BitmapSource Vrátí objekt ze schránky, který obsahuje data ve Bitmap formátu.
GetText()

Vrátí řetězec obsahující UnicodeText data ve schránce.
GetText(TextDataFormat)

Vrátí řetězec obsahující textová data ve schránce.
IsCurrent(IDataObject)

Porovná zadaný datový objekt s obsahem schránky.
SetAudio(Byte[])

Ukládá zvuková data (WaveAudio formát dat) do schránky. Zvuková data jsou určena jako pole bajtů.
SetAudio(Stream)

Ukládá zvuková data (WaveAudio formát dat) do schránky. Zvuková data se zadává jako datový proud.
SetData(String, Object)

Uloží zadaná data ve schránce v zadaném formátu.
SetDataObject(Object)

Umístí zadaný datový objekt, který není trvalý, do systémové schránky.
SetDataObject(Object, Boolean)

Umístí zadaný datový objekt do systémové schránky a přijme logický parametr, který označuje, zda má být datový objekt ponechán ve schránce při ukončení aplikace.
SetFileDropList(StringCollection)

Ukládá FileDrop data do schránky. Seznam vyřazených souborů je určen jako kolekce řetězců.
SetImage(BitmapSource)

Ukládá Bitmap data do schránky. Data obrázku jsou zadána BitmapSourcejako .
SetText(String)

Ukládá UnicodeText data do schránky.
SetText(String, TextDataFormat)

Ukládá textová data do schránky v zadaném formátu textových dat. Data UnicodeText , která se mají uložit, se zadává jako řetězec.

Platí pro

Viz také