Freigeben über


Clipboard Klasse

Definition

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)]
class Clipboard final
/// [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)]
public static class Clipboard
[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

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.

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.

Gilt für:

Weitere Informationen