ClipboardProxy Classe
Définition
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 permettant de manipuler le Presse-papiers.
public ref class ClipboardProxypublic class ClipboardProxytype ClipboardProxy = classPublic Class ClipboardProxy- Héritage
-
ClipboardProxy
Exemples
Cet exemple lit le texte du Presse-papiers dans la chaîne textOnClipboard.
Dim textOnClipboard As String = My.Computer.Clipboard.GetText()
Cet exemple échoue s’il n’y a pas de texte dans le Presse-papiers.
Remarques
Les éléments déplacés ou copiés dans le Presse-papiers persistent même après l’arrêt de l’application.
Les données du Presse-papiers peuvent être dans n’importe quel format de données, également appelé format Presse-papiers. Pour obtenir la liste des formats prédéfinis à utiliser avec le Presse-papiers, consultez DataFormats. Lorsqu’un élément est déplacé ou copié dans le Presse-papiers, les éléments dans d’autres formats sont effacés. Pour que d’autres formats persistent, utilisez DataObject, qui copie tout ce qui existe dans le Presse-papiers actuel, y compris les éléments collés à partir d’autres applications. Placez les données dans le Presse-papiers dans plusieurs formats pour optimiser la possibilité qu’une application cible, dont vous ne connaissez peut-être pas les exigences de format, puisse récupérer les données.
Étant donné que toutes les applications Windows partagent le Presse-papiers système, le contenu peut changer lorsque vous basculez vers une autre application.
Une classe doit être sérialisable pour qu’elle soit placée dans le Presse-papiers. Pour plus d’informations, consultez Sérialisation - C# ou Sérialisation - Visual Basic.
Lorsque vous accédez au Presse-papiers à distance, un ThreadStateException est déclenché, sauf si le thread d’accès fonctionne en mode STA (appartement à thread unique). Pour résoudre ce problème, définissez sur ThreadApartmentStateSTA. Pour plus d'informations, consultez STAThreadAttribute.
Pour plus d’informations, consultez Stockage de données dans le Presse-papiers et lecture du Presse-papiers.
Disponibilité par type de projet
| Type de projet | Disponible |
|---|---|
| Application Windows | Oui |
| Bibliothèque de classes | Oui |
| Application console | Oui |
| Bibliothèque de contrôles Windows | Oui |
| Bibliothèque de contrôles web | Non |
| Service Windows | Oui |
| Site web | Non |
Méthodes
| Clear() |
Effacer le Presse-papiers. |
| ContainsAudio() |
Indique si le Presse-papiers contient des données audio. |
| ContainsData(String) |
Indique si le Presse-papiers contient des données au format personnalisé spécifié. |
| ContainsFileDropList() |
Retourne une valeur |
| ContainsImage() |
Retourne une valeur |
| ContainsText() |
Détermine s'il y a du texte dans le Presse-papiers. |
| ContainsText(TextDataFormat) |
Détermine s'il y a du texte dans le Presse-papiers. |
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| GetAudioStream() |
Récupère un flux audio dans le Presse-papiers. |
| GetData(String) |
Récupère des données dans un format personnalisé du Presse-papiers. |
| GetDataObject() |
Récupère des données du Presse-papiers sous la forme de IDataObject. |
| GetFileDropList() |
Récupère une collection de chaînes représentant des noms de fichiers provenant du Presse-papiers. |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetImage() |
Récupère une image du Presse-papiers. |
| GetText() |
Récupère le texte du Presse-papiers. |
| GetText(TextDataFormat) |
Récupère le texte du Presse-papiers. |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| SetAudio(Byte[]) |
Écrit les données audio dans le Presse-papiers. |
| SetAudio(Stream) |
Écrit les données audio dans le Presse-papiers. |
| SetData(String, Object) |
Écrit des données dans un format personnalisé au Presse-papiers. |
| SetDataObject(DataObject) |
Écrit un DataObject dans le Presse-papiers. |
| SetFileDropList(StringCollection) |
Écrit une collection de chaînes représentant des chemins d'accès au Presse-papiers. |
| SetImage(Image) |
Écrit une image dans le Presse-papiers. |
| SetText(String) |
Écrit du texte dans le Presse-papiers. |
| SetText(String, TextDataFormat) |
Écrit du texte dans le Presse-papiers. |
| ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
