Clipboard Osztály

Definíció

Névtér:
System.Windows
Szerelvény:
PresentationCore.dll

Statikus módszereket biztosít, amelyek megkönnyítik az adatok átvitelét a vágólapra és a rendszerből.

public ref class Clipboard abstract sealed
public static class Clipboard
type Clipboard = class
Public Class Clipboard
Öröklődés
Object
Clipboard

Példák

Az alábbi példa bemutatja, hogyan adhat hozzá adatokat a rendszer vágólapjára.


// 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))

Megjegyzések

A Windows összes alkalmazása megosztja a rendszer vágólapjának tartalmát, így a tartalom változhat, amikor másik alkalmazásra vált.

Az osztályhoz Clipboard használható előre definiált formátumok listáját az DataFormats osztályban találja.

Biztonsági riasztás: Biztonsági okokból a következő szempontokat kell szem előtt tartani.

  • A beillesztési műveleteket felhasználónak kell kezdeményeznie (Ctrl-V, Beillesztés menü).

  • A másolás csak a felhasználó által kijelölt tartalomra lehet.

  • Másolás vagy kivágás esetén a részleges megbízhatósági kód a vágólapra helyezi az egyszerű szöveg és az XAML (Extensible Application Markup Language) nyelvet. Az egyszerű szöveg tartalmazza a szöveget, a Unicode-szöveget, az OEM-et (Object Exchange Model) és a CSV-t (vesszővel tagolt értékeket).

  • Beillesztéskor a Windows megjelenítési alaprendszer (WPF) beilleszti az XAML(Extensible Application Markup Language, Extensible Application Markup Language, XAML) nyelvbe, ha a tartalom forrása egyenlően megbízható vagy megbízhatóbb webhelyről származik. Ezek konkrétan a következők:

    • A részleges megbízhatósági alkalmazások beilleszthetik az XAML-t (Extensible Application Markup Language, Extensible Application Markup Language, XAML) egy teljes megbízhatósági alkalmazásból.

    • A részleges megbízhatósági alkalmazások beilleszthetik az Extensible Application Markup Language (XAML) nyelvet egy részleges megbízhatósági alkalmazásból.

    • A teljes megbízhatósági alkalmazás csak egy másik teljesen megbízható alkalmazásból illessze be az XAML-t.

    • A nem Windows megjelenítési alaprendszer (WPF) teljes megbízhatósági alkalmazás megvizsgálhatja az ApplicationTrust formátumot a vágólapon, és szükség esetén megtisztíthatja az XAML-t.

Metódusok

Name Description
Clear()

Törli az adatokat a rendszer vágólapjáról.
ContainsAudio()

Lekérdezi a vágólapon az adatok adatformátumban WaveAudio való jelenlétét.
ContainsData(String)

Lekérdezi a vágólapon az adatok adott adatformátumban való jelenlétét.
ContainsFileDropList()

Lekérdezi a vágólapon az adatok adatformátumban FileDrop való jelenlétét.
ContainsImage()

Lekérdezi a vágólapon az adatok adatformátumban Bitmap való jelenlétét.
ContainsText()

Lekérdezi a vágólapon az adatok formátumbeli UnicodeText jelenlétét.
ContainsText(TextDataFormat)

Lekérdezi a vágólapon az adatok szöveges adatformátumban való jelenlétét.
Flush()

Véglegesen hozzáadja a rajta Clipboard lévő adatokat, hogy azok az adatok eredeti alkalmazásának bezárása után is elérhetők legyen.
GetAudioStream()

A vágólap adatainak adatfolyamát adja vissza adatformátumban WaveAudio .
GetData(String)

Megadott formátumban kéri le az adatokat a vágólapról.
GetDataObject()

A vágólap teljes tartalmát képviselő adatobjektumot ad vissza.
GetFileDropList()

Visszaad egy sztringgyűjteményt, amely a vágólapon elérhető elvetett fájlok listáját tartalmazza.
GetImage()

BitmapSource Egy olyan objektumot ad vissza a vágólapról, amely a Bitmap formátumban lévő adatokat tartalmazza.
GetText()

A vágólapon lévő UnicodeText adatokat tartalmazó sztringet ad vissza.
GetText(TextDataFormat)

A vágólapon szöveges adatokat tartalmazó sztringet ad vissza.
IsCurrent(IDataObject)

Egy megadott adatobjektumot hasonlít össze a vágólap tartalmával.
SetAudio(Byte[])

A vágólapon tárolja a hangadatokat (WaveAudio adatformátumot). A hangadatok bájttömbként lesznek megadva.
SetAudio(Stream)

A vágólapon tárolja a hangadatokat (WaveAudio adatformátumot). A hangadatok streamként lesznek megadva.
SetData(String, Object)

A megadott adatokat a vágólapon tárolja a megadott formátumban.
SetDataAsJson<T>(String, T)

Statikus módszereket biztosít, amelyek megkönnyítik az adatok átvitelét a vágólapra és a rendszerből.
SetDataObject(Object, Boolean)

Egy megadott adatobjektumot helyez el a rendszer vágólapján, és elfogad egy logikai paramétert, amely jelzi, hogy az adatobjektumot a vágólapon kell-e hagyni, amikor az alkalmazás kilép.
SetDataObject(Object)

Egy megadott nem állandó adatobjektumot helyez el a rendszer vágólapján.
SetFileDropList(StringCollection)

Adatokat tárol FileDrop a vágólapon. Az elvetett fájllista sztringgyűjteményként van megadva.
SetImage(BitmapSource)

Adatokat tárol Bitmap a vágólapon. A rendszerképadatok a következőként lesznek BitmapSourcemegadva: .
SetText(String, TextDataFormat)

A vágólapon megadott szöveges adatformátumban tárolja a szöveges adatokat. Az UnicodeText tárolandó adatok sztringként lesznek megadva.
SetText(String)

Adatokat tárol UnicodeText a vágólapon.
TryGetData<T>(String, Func<TypeName,Type>, T)

Statikus módszereket biztosít, amelyek megkönnyítik az adatok átvitelét a vágólapra és a rendszerből.
TryGetData<T>(String, T)

Statikus módszereket biztosít, amelyek megkönnyítik az adatok átvitelét a vágólapra és a rendszerből.

A következőre érvényes:

Lásd még