Clipboard Klasse

Definition

Namespace:

Windows.ApplicationModel.DataTransfer

Ruft Informationen aus dem Zwischenablageobjekt ab und legt sie fest.

public ref class Clipboard abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Clipboard final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class Clipboard

Public Class Clipboard

Vererbung

Object Platform::Object IInspectable Clipboard

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie Änderungen an der Zwischenablage nachverfolgen. Wenn die Zwischenablage Text enthält, fügt der Code den Text einer HTML-Seite hinzu.

private async void TrackClipboardChanges_EventHandler(object sender, object e)
{
    DataPackageView dataPackageView = Clipboard.GetContent();
    if (dataPackageView.Contains(StandardDataFormats.Text))
    {
        String text = await dataPackageView.GetTextAsync();

        // To output the text from this example, you need a TextBlock control
        // with a name of "TextOutput".
        TextOutput.Text = "Clipboard now contains: " + text;
    }
}

Tipp

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Kopieren und Einfügen.

Öffnen Sie die WinUI 3-Katalog-App, und sehen Sie sich Zwischenablagefeatures in Aktion an.

Die WinUI 3-Katalog-App umfasst interaktive Beispiele für die meisten WinUI 3-Steuerelemente, -Features und -Funktionen. Laden Sie die App aus dem Microsoft Store herunter, oder rufen Sie den Quellcode auf GitHub ab.

Hinweise

Da die Zwischenablageklasse eine statische Klasse ist, müssen Sie keine instance erstellen, um auf ihre Methoden zuzugreifen.

Sie können nur auf die Zwischenablage zugreifen, wenn die aufrufende Anwendung den Fokus auf dem UI-Thread hat (z. B. wenn ihr CoreWindow aktiv ist). Verwenden Sie das CoreWindow.Activated-Ereignis , um den Status der aufrufenden App nachzuverfolgen.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1809	17763	ClearHistory
1809	17763	DeleteItemFromHistory
1809	17763	GetHistoryItemsAsync
1809	17763	HistoryChanged
1809	17763	HistoryEnabledChanged
1809	17763	IsHistoryEnabled
1809	17763	IsRoamingEnabled
1809	17763	RoamingEnabledChanged
1809	17763	SetContentWithOptions
1809	17763	SetHistoryItemAsContent

Methoden

Clear()	Entfernt alle Daten aus der Zwischenablage.
ClearHistory()	Löscht den Zwischenablageverlauf.
DeleteItemFromHistory(ClipboardHistoryItem)	Löscht das angegebene Element aus dem Zwischenablageverlauf.
Flush()	Fügt den Inhalt der Zwischenablage hinzu und gibt das DataPackage-Objekt aus der Quell-App frei. Diese Methode ermöglicht es, dass der Inhalt nach dem Herunterfahren der Anwendung verfügbar bleibt.
GetContent()	Ruft den aktuellen Inhalt ab, der im Zwischenablageobjekt gespeichert ist.
GetHistoryItemsAsync()	Ruft die Liste der Elemente ab, die sich derzeit im Zwischenablageverlauf befinden.
IsHistoryEnabled()	Gibt an, ob der Zwischenablageverlauf (d. h. die Möglichkeit, mehrere Elemente in der Zwischenablage zu speichern) für den aktuellen Benutzer aktiviert ist.
IsRoamingEnabled()	Gibt an, ob die Zwischenablagedaten geräteübergreifend für den aktuellen Benutzer synchronisiert werden sollen.
SetContent(DataPackage)	Legt den aktuellen Inhalt fest, der im Zwischenablageobjekt gespeichert ist.
SetContentWithOptions(DataPackage, ClipboardContentOptions)	Legt den Im Zwischenablageobjekt gespeicherten Inhalt mit Optionen für den Inhalt fest.
SetHistoryItemAsContent(ClipboardHistoryItem)	Legt ein Element im Zwischenablageverlauf als aktuellen Inhalt für die Zwischenablage fest.

Ereignisse

ContentChanged	Tritt auf, wenn sich die in der Zwischenablage gespeicherten Daten ändern.
HistoryChanged	Tritt auf, wenn dem Zwischenablageverlauf ein neues Element hinzugefügt wird.
HistoryEnabledChanged	Tritt auf, wenn die Betriebssystemeinstellung, die steuert, ob der Zwischenablageverlauf für den aktuellen Benutzer aktiviert ist, geändert wird.
RoamingEnabledChanged	Tritt auf, wenn die Betriebssystemeinstellung geändert wird, die steuert, ob Zwischenablagedaten geräteübergreifend für den aktuellen Benutzer synchronisiert werden.

Weitere Informationen

• Zwischenablagebeispiel (Windows 10)