Clipboard Classe

Référence

Définition

Espace de noms:: System.Windows

Assembly:: PresentationCore.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

public ref class Clipboard abstract sealed

public static class Clipboard

type Clipboard = class

Public Class Clipboard

Héritage: Object
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 d’être modifié lorsque vous basculez vers une autre application.

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

Alerte de sécurité : Pour des raisons de sécurité, les points suivants doivent être gardés à l’esprit.

Les opérations de collage doivent être initié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 coupure, le code de confiance partielle place le texte en clair et le langage XAML (Extensible Application Markup Language) dans le Presse-papiers. Le texte en clair inclut le texte, le texte Unicode, le texte OEM (modèle d’échange d’objets) et le csv (valeurs séparées par des virgules).
Lors du collage, Windows Presentation Foundation (WPF) collera en 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 de confiance partielle peut coller xaml (Extensible Application Markup Language) à partir d’une application de confiance totale.
- Une application d’approbation partielle peut coller xaml (Extensible Application Markup Language) à partir d’une application de confiance partielle.
- Une application de confiance totale peut coller du code 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

Clear()	Efface toutes les données du Presse-papiers système.
ContainsAudio()	Interroge le Presse-papiers sur la présence de données au format WaveAudio.
ContainsData(String)	Interroge le Presse-papiers sur la présence de données au format de données spécifié.
ContainsFileDropList()	Interroge le Presse-papiers sur la présence de données au format FileDrop.
ContainsImage()	Interroge le Presse-papiers sur la présence de données au format Bitmap.
ContainsText()	Interroge le Presse-papiers sur la présence de données au format UnicodeText.
ContainsText(TextDataFormat)	Interroge le Presse-papiers sur la présence de données au format de données texte.
Flush()	Ajoute définitivement les données qui sont dans le Clipboard afin qu'elles soient disponibles après la fermeture de leur application d'origine.
GetAudioStream()	Retourne un flux de données du Presse-papiers au format WaveAudio.
GetData(String)	Récupère des données dans un format spécifié à partir du Presse-papiers.
GetDataObject()	Retourne un objet de données qui représente le contenu complet du Presse-papiers.
GetFileDropList()	Retourne un ensemble de chaînes qui contient une liste de fichiers effacés disponible sur le Presse-papiers.
GetImage()	Retourne un objet BitmapSource du Presse-papiers qui contient des données dans le format Bitmap.
GetText()	Retourne une chaîne contenant les données UnicodeText sur le Presse-papiers.
GetText(TextDataFormat)	Retourne une chaîne qui contient les données texte sur le Presse-papiers.
IsCurrent(IDataObject)	Compare un objet de données spécifié avec le contenu du Presse-papiers.
SetAudio(Byte[])	Stocke les données audio (format de données WaveAudio) sur le Presse-papiers. Les données audio sont spécifiées en tant que tableau d'octets.
SetAudio(Stream)	Stocke les données audio (format de données WaveAudio) sur le Presse-papiers. Les données audio sont spécifiées en tant que flux de données.
SetData(String, Object)	Stocke les données spécifiées sur le Presse-papiers au format spécifié.
SetDataObject(Object)	Place un objet de données non persistant spécifié sur le Presse-papiers système.
SetDataObject(Object, Boolean)	Place un objet de données spécifié sur le Presse-papiers système et accepte un paramètre booléen qui indique si l'objet de données doit être laissé sur le Presse-papiers lors de la fermeture de l'application.
SetFileDropList(StringCollection)	Stocke les données FileDrop sur le Presse-papiers. La liste des fichiers effacés est spécifiée comme un ensemble de chaînes.
SetImage(BitmapSource)	Stocke les données Bitmap sur le Presse-papiers. La donnée image est spécifiée en tant que BitmapSource.
SetText(String)	Stocke les données UnicodeText sur le Presse-papiers.
SetText(String, TextDataFormat)	Stocke des données texte sur le Presse-papiers dans un format de données texte spécifié. Les données UnicodeText à stocker sont spécifiées comme une chaîne.

S’applique à

Partager via