Clipboard Classe

  • Référence

Définition

Espace de noms:
Windows.ApplicationModel.DataTransfer
Modifier

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)]
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
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é.

S’applique à

Voir aussi