Clipboard Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.DataTransfer

Ottiene e imposta le informazioni dall'oggetto Appunti.

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

Ereditarietà

Object Platform::Object IInspectable Clipboard

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Nell'esempio seguente viene illustrato come tenere traccia delle modifiche apportate agli Appunti. Se gli Appunti contengono testo, il codice aggiunge il testo a una pagina HTML.

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;
    }
}

Suggerimento

Per altre info, linee guida per la progettazione ed esempi di codice, vedi Copiare e incollare.

Aprire l'app Raccolta WinUI 3 e visualizzare le funzionalità degli Appunti in azione.

L'app Raccolta WinUI 3 include esempi interattivi della maggior parte dei controlli, delle funzionalità e delle funzionalità winUI 3. Ottenere l'app da Microsoft Store o ottenere il codice sorgente in GitHub

Commenti

Poiché la classe Appunti è una classe statica, non è necessario crearne un'istanza per accedere ai relativi metodi.

È possibile accedere agli Appunti solo quando l'applicazione chiamante è incentrata sul thread dell'interfaccia utente(ad esempio, quando CoreWindow è attivo). Usare l'evento CoreWindow.Activated per tenere traccia dello stato dell'app chiamante.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
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

Metodi

Clear()	Rimuove tutti i dati dagli Appunti.
ClearHistory()	Cancella la cronologia degli Appunti.
DeleteItemFromHistory(ClipboardHistoryItem)	Elimina l'elemento specificato dalla cronologia degli Appunti.
Flush()	Aggiunge il contenuto agli Appunti e rilascia l'oggetto DataPackage dall'app di origine. Questo metodo consente di mantenere il contenuto disponibile dopo l'arresto dell'applicazione.
GetContent()	Ottiene il contenuto corrente archiviato negli Appunti.
GetHistoryItemsAsync()	Ottiene l'elenco di elementi attualmente presenti nella cronologia degli Appunti.
IsHistoryEnabled()	Indica se la cronologia degli Appunti, ovvero la possibilità di salvare più elementi negli Appunti, è abilitata per l'utente corrente.
IsRoamingEnabled()	Indica se i dati degli Appunti sono impostati per la sincronizzazione tra dispositivi per l'utente corrente.
SetContent(DataPackage)	Imposta il contenuto corrente archiviato negli Appunti.
SetContentWithOptions(DataPackage, ClipboardContentOptions)	Imposta il contenuto archiviato negli Appunti con le opzioni per il contenuto.
SetHistoryItemAsContent(ClipboardHistoryItem)	Imposta un elemento nella cronologia degli Appunti come contenuto corrente per gli Appunti.

Eventi

ContentChanged	Si verifica quando i dati archiviati negli Appunti cambiano.
HistoryChanged	Si verifica quando un nuovo elemento viene aggiunto alla cronologia degli Appunti.
HistoryEnabledChanged	Si verifica quando l'impostazione del sistema operativo che controlla se la cronologia degli Appunti è abilitata per l'utente corrente viene modificata.
RoamingEnabledChanged	Si verifica quando l'impostazione del sistema operativo che controlla se i dati degli Appunti sono impostati per la sincronizzazione tra i dispositivi per l'utente corrente vengono modificati.

Vedi anche

• Esempio degli Appunti (Windows 10)