Clipboard Classe

Définition

Fournit des méthodes statiques qui facilitent le transfert de données vers et depuis le Presse-papiers système.

public ref class Clipboard abstract sealed
public static class Clipboard
type Clipboard = class
Public Class Clipboard
Héritage
Clipboard

Exemples

L’exemple suivant montre comment ajouter des données au Presse-papiers système.


// For this example, the data to be placed on the clipboard is a simple
// string.
string textData = "I want to put this string on the clipboard.";

// After this call, the data (string) is placed on the clipboard and tagged
// with a data format of "Text".
Clipboard.SetData(DataFormats.Text, (Object)textData);
' For this example, the data to be placed on the clipboard is a simple
' string.
Dim textData As String = "I want to put this string on the clipboard."

' After this call, the data (string) is placed on the clipboard and tagged
' with a data format of "Text".
Clipboard.SetData(DataFormats.Text, CType(textData, Object))

Remarques

Toutes les applications pour Windows partagent le Presse-papiers système, de sorte que le contenu est susceptible de changer lorsque vous basculez vers une autre application.

Pour obtenir la liste des formats prédéfinis à utiliser avec la Clipboard classe, consultez la DataFormats classe.

Alerte de sécurité : À des fins de sécurité, les points suivants doivent être conservés à l’esprit.

  • Les opérations de collage doivent être lancées par l’utilisateur (Ctrl-V, Menu Coller).

  • La copie ne peut être que sur le contenu sélectionné par l’utilisateur.

  • Lors de la copie ou de la coupe, le code d’approbation partielle place le texte en clair et le langage XAML (Extensible Application Markup Language) dans le Presse-papiers. Le texte en clair inclut du texte, du texte Unicode, du texte OEM (Objet Exchange Modèle) et des valeurs CSV (séparées par des virgules).

  • Lors du collage, Windows Presentation Foundation (WPF) collera dans XAML (Extensible Application Markup Language) si la source de ce contenu provient d’un site de confiance ou plus fiable. Plus précisément :

    • Une application d’approbation partielle peut coller le langage XAML (Extensible Application Markup Language) à partir d’une application de confiance totale.

    • Une application d’approbation partielle peut coller le langage XAML (Extensible Application Markup Language) à partir d’une application d’approbation partielle.

    • Une application de confiance totale peut coller XAML uniquement à partir d’une autre application entièrement approuvée.

    • Une application de confiance totale non Windows Presentation Foundation (WPF) peut examiner le format ApplicationTrust dans le Presse-papiers et nettoyer le code XAML le cas échéant.

Méthodes

Nom Description
Clear()

Efface les données du Presse-papiers système.

ContainsAudio()

Interroge le Presse-papiers pour la présence de données au WaveAudio format de données.

ContainsData(String)

Interroge le Presse-papiers pour la présence de données dans un format de données spécifié.

ContainsFileDropList()

Interroge le Presse-papiers pour la présence de données au FileDrop format de données.

ContainsImage()

Interroge le Presse-papiers pour la présence de données au Bitmap format de données.

ContainsText()

Interroge le Presse-papiers pour connaître la présence de données au UnicodeText format.

ContainsText(TextDataFormat)

Interroge le Presse-papiers pour la présence de données dans un format de données texte.

Flush()

Ajoute définitivement les données qui se trouve sur le Clipboard site afin qu’elles soient disponibles après la fermeture de l’application d’origine des données.

GetAudioStream()

Retourne un flux de données presse-papiers au WaveAudio format de données.

GetData(String)

Récupère les données dans un format spécifié dans le Presse-papiers.

GetDataObject()

Retourne un objet de données qui représente l’intégralité du contenu du Presse-papiers.

GetFileDropList()

Retourne une collection de chaînes qui contient une liste de fichiers supprimés disponibles dans le Presse-papiers.

GetImage()

Retourne un BitmapSource objet du Presse-papiers qui contient des données au Bitmap format.

GetText()

Retourne une chaîne contenant les UnicodeText données du Presse-papiers.

GetText(TextDataFormat)

Retourne une chaîne contenant des données de texte dans le Presse-papiers.

IsCurrent(IDataObject)

Compare un objet de données spécifié au contenu du Presse-papiers.

SetAudio(Byte[])

Stocke les données audio (WaveAudio format de données) dans le Presse-papiers. Les données audio sont spécifiées sous forme de tableau d’octets.

SetAudio(Stream)

Stocke les données audio (WaveAudio format de données) dans le Presse-papiers. Les données audio sont spécifiées en tant que flux.

SetData(String, Object)

Stocke les données spécifiées dans le Presse-papiers au format spécifié.

SetDataAsJson<T>(String, T)

Fournit des méthodes statiques qui facilitent le transfert de données vers et depuis le Presse-papiers système.

SetDataObject(Object, Boolean)

Place un objet de données spécifié dans le Presse-papiers système et accepte un paramètre booléen qui indique si l’objet de données doit être laissé dans le Presse-papiers lorsque l’application se ferme.

SetDataObject(Object)

Place un objet de données non persistant spécifié dans le Presse-papiers système.

SetFileDropList(StringCollection)

Stocke les FileDrop données dans le Presse-papiers. La liste des fichiers supprimés est spécifiée sous forme de collection de chaînes.

SetImage(BitmapSource)

Stocke les Bitmap données dans le Presse-papiers. Les données d’image sont spécifiées en tant que BitmapSource.

SetText(String, TextDataFormat)

Stocke les données de texte dans le Presse-papiers dans un format de données de texte spécifié. Les UnicodeText données à stocker sont spécifiées sous forme de chaîne.

SetText(String)

Stocke les UnicodeText données dans le Presse-papiers.

TryGetData<T>(String, Func<TypeName,Type>, T)

Fournit des méthodes statiques qui facilitent le transfert de données vers et depuis le Presse-papiers système.

TryGetData<T>(String, T)

Fournit des méthodes statiques qui facilitent le transfert de données vers et depuis le Presse-papiers système.

S’applique à

Voir aussi