Clipboard Classe

Définition

Espace de noms:

Windows.ApplicationModel.DataTransfer

Obtient et définit les informations de l’objet presse-papiers.

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

Héritage

Object Platform::Object IInspectable Clipboard

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

L’exemple suivant montre comment suivre les modifications apportées au Presse-papiers. Si le Presse-papiers contient du texte, le code ajoute le texte à une page 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;
    }
}

Conseil

Pour plus d’informations, des conseils de conception et des exemples de code, consultez Copier et coller.

Ouvrez l’application WinUI 3 Gallery et consultez fonctionnalités du Presse-papiers en action.

L’application WinUI 3 Gallery comprend des exemples interactifs de la plupart des contrôles et des fonctionnalités WinUI 3. Procurez-vous l’application sur le Microsoft Store ou le code source sur GitHub.

Remarques

Étant donné que la classe Presse-papiers est une classe statique, vous n’avez pas besoin de créer une instance de celle-ci pour accéder à ses méthodes.

Vous ne pouvez accéder au Presse-papiers que lorsque l’application appelante est en focus sur le thread d’interface utilisateur (par exemple, lorsque son CoreWindow est actif). Utilisez l’événement CoreWindow.Activated pour suivre l’état de l’application appelante.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
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

Méthodes

Clear()	Supprime toutes les données du Presse-papiers.
ClearHistory()	Efface l’historique du Presse-papiers.
DeleteItemFromHistory(ClipboardHistoryItem)	Supprime l’élément spécifié de l’historique du Presse-papiers.
Flush()	Ajoute le contenu au Presse-papiers et libère l’objet DataPackage de l’application source. Cette méthode permet au contenu de rester disponible après l’arrêt de l’application.
GetContent()	Obtient le contenu actuel stocké dans l’objet presse-papiers.
GetHistoryItemsAsync()	Obtient la liste des éléments actuellement dans l’historique du Presse-papiers.
IsHistoryEnabled()	Indique si l’historique du Presse-papiers (autrement dit, la possibilité d’enregistrer plusieurs éléments dans le Presse-papiers) est activé pour l’utilisateur actuel.
IsRoamingEnabled()	Indique si les données du Presse-papiers sont configurées pour être synchronisées entre les appareils pour l’utilisateur actuel.
SetContent(DataPackage)	Définit le contenu actuel stocké dans l’objet presse-papiers.
SetContentWithOptions(DataPackage, ClipboardContentOptions)	Définit le contenu stocké dans l’objet Presse-papiers avec des options pour le contenu.
SetHistoryItemAsContent(ClipboardHistoryItem)	Définit un élément dans l’historique du Presse-papiers comme contenu actuel du Presse-papiers.

Événements

ContentChanged	Se produit lorsque les données stockées dans le Presse-papiers changent.
HistoryChanged	Se produit lorsqu’un nouvel élément est ajouté à l’historique du Presse-papiers.
HistoryEnabledChanged	Se produit lorsque le paramètre du système d’exploitation qui contrôle si l’historique du Presse-papiers est activé pour l’utilisateur actuel est modifié.
RoamingEnabledChanged	Se produit lorsque le paramètre du système d’exploitation qui contrôle si les données du Presse-papiers sont définies pour être synchronisées entre les appareils pour l’utilisateur actuel est modifié.

Voir aussi

• Exemple de Presse-papiers (Windows 10)