Udostępnij za pośrednictwem


Clipboard Klasa

Definicja

Udostępnia metody statyczne, które ułatwiają przesyłanie danych do i z schowka systemowego.

public ref class Clipboard abstract sealed
public static class Clipboard
type Clipboard = class
Public Class Clipboard
Dziedziczenie
Clipboard

Przykłady

W poniższym przykładzie pokazano, jak dodać dane do schowka systemowego.


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

Uwagi

Wszystkie aplikacje dla systemu Windows współużytkują schowek systemowy, więc zawartość może ulec zmianie po przełączeniu się do innej aplikacji.

Aby uzyskać listę wstępnie zdefiniowanych formatów dostępnych do użycia z klasą Clipboard , zobacz klasę DataFormats .

Alert zabezpieczeń: W celach bezpieczeństwa należy pamiętać o następujących kwestiach.

  • Operacje wklejania muszą być inicjowane przez użytkownika (Ctrl-V, Wklej menu).

  • Kopiowanie może dotyczyć tylko wybranej zawartości użytkownika.

  • Podczas kopiowania lub wycinania kod częściowego zaufania umieszcza w schowku zwykły tekst i extensible Application Markup Language (XAML). Zwykły tekst zawiera tekst, tekst Unicode, tekst OEM (Object Exchange Model) i CSV (wartości rozdzielane przecinkami).

  • W przypadku wklejania Windows Presentation Foundation (WPF) wkleja język XAML (Extensible Application Markup Language), jeśli źródło tej zawartości pochodzi z równie zaufanej lub bardziej zaufanej witryny. W szczególności:

    • Aplikacja z częściowym zaufaniem może wkleić język XAML (Extensible Application Markup Language) z poziomu aplikacji o pełnym zaufaniu.

    • Aplikacja częściowo zaufania może wkleić język XAML (Extensible Application Markup Language) z aplikacji częściowo zaufania.

    • Aplikacja o pełnym zaufaniu może wkleić kod XAML tylko z innej w pełni zaufanej aplikacji.

    • Aplikacja o pełnym zaufaniu nie Windows Presentation Foundation (WPF) może zbadać format ApplicationTrust w schowku i w razie potrzeby odczyścić kod XAML.

Metody

Clear()

Czyści wszystkie dane ze Schowka systemowego.

ContainsAudio()

Wysyła zapytanie do Schowka pod kątem obecności danych w WaveAudio formacie danych.

ContainsData(String)

Wysyła zapytanie do Schowka pod kątem obecności danych w określonym formacie danych.

ContainsFileDropList()

Wysyła zapytanie do Schowka pod kątem obecności danych w FileDrop formacie danych.

ContainsImage()

Wysyła zapytanie do Schowka pod kątem obecności danych w Bitmap formacie danych.

ContainsText()

Wysyła zapytanie do Schowka pod kątem obecności danych w UnicodeText formacie.

ContainsText(TextDataFormat)

Wysyła zapytanie do Schowka pod kątem obecności danych w formacie danych tekstowych.

Flush()

Trwale dodaje dane, które są włączone Clipboard , aby było dostępne po zamknięciu oryginalnej aplikacji danych.

GetAudioStream()

Zwraca strumień danych Schowka w WaveAudio formacie danych.

GetData(String)

Pobiera dane w określonym formacie ze Schowka.

GetDataObject()

Zwraca obiekt danych reprezentujący całą zawartość Schowka.

GetFileDropList()

Zwraca kolekcję ciągów zawierającą listę porzuconych plików dostępnych w Schowku.

GetImage()

BitmapSource Zwraca obiekt ze Schowka, który zawiera dane w Bitmap formacie .

GetText()

Zwraca ciąg zawierający UnicodeText dane w Schowku.

GetText(TextDataFormat)

Zwraca ciąg zawierający dane tekstowe w Schowku.

IsCurrent(IDataObject)

Porównuje określony obiekt danych z zawartością Schowka.

SetAudio(Byte[])

Przechowuje dane audio (WaveAudio format danych) w Schowku. Dane audio są określane jako tablica bajtów.

SetAudio(Stream)

Przechowuje dane audio (WaveAudio format danych) w Schowku. Dane audio są określane jako strumień.

SetData(String, Object)

Przechowuje określone dane w Schowku w określonym formacie.

SetDataObject(Object)

Umieszcza określony obiekt danych nietrwale na schowku systemowym.

SetDataObject(Object, Boolean)

Umieszcza określony obiekt danych w Schowku systemowym i akceptuje parametr logiczny wskazujący, czy obiekt danych powinien pozostać w Schowku po zakończeniu działania aplikacji.

SetFileDropList(StringCollection)

Przechowuje FileDrop dane w Schowku. Lista porzuconych plików jest określana jako kolekcja ciągów.

SetImage(BitmapSource)

Przechowuje Bitmap dane w Schowku. Dane obrazu są określane jako BitmapSource.

SetText(String)

Przechowuje UnicodeText dane w Schowku.

SetText(String, TextDataFormat)

Przechowuje dane tekstowe w Schowku w określonym formacie danych tekstowych. Dane UnicodeText do przechowywania są określane jako ciąg.

Dotyczy

Zobacz też