Condividi tramite


Clipboard Classe

Definizione

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)]
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
Ereditarietà
Object Platform::Object IInspectable Clipboard
Attributi

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.

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.

Si applica a

Vedi anche