Clipboard.ContainsText Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Indique s’il existe des données de texte dans le Presse-papiers.

Surcharges

Nom	Description
ContainsText()	Indique s’il existe des données dans le TextUnicodeText Presse-papiers ou au format, selon le système d’exploitation.
ContainsText(TextDataFormat)	Indique s’il existe des données de texte dans le Presse-papiers au format indiqué par la valeur spécifiée TextDataFormat .

ContainsText()

Source:

Clipboard.cs

Indique s’il existe des données dans le TextUnicodeText Presse-papiers ou au format, selon le système d’exploitation.

public:
 static bool ContainsText();

public static bool ContainsText();

static member ContainsText : unit -> bool

Public Shared Function ContainsText () As Boolean

Retours

Boolean

true s’il existe des données de texte dans le Presse-papiers ; sinon, false.

Exceptions

ExternalException

Le Presse-papiers n’a pas pu être effacé. Cela se produit généralement lorsque le Presse-papiers est utilisé par un autre processus.

ThreadStateException

Le thread actuel n’est pas en mode STA (Single-Threaded Apartment). Ajoutez la STAThreadAttribute méthode de Main votre application.

Exemples

L’exemple suivant illustre une surcharge de la ContainsText méthode similaire à cette surcharge.

// Demonstrates SetText, ContainsText, and GetText.
public String SwapClipboardHtmlText(String replacementHtmlText)
{
    String returnHtmlText = null;
    if (Clipboard.ContainsText(TextDataFormat.Html))
    {
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html);
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html);
    }
    return returnHtmlText;
}

' Demonstrates SetText, ContainsText, and GetText.
Public Function SwapClipboardHtmlText( _
    ByVal replacementHtmlText As String) As String

    Dim returnHtmlText As String = Nothing

    If (Clipboard.ContainsText(TextDataFormat.Html)) Then
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html)
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html)
    End If

    Return returnHtmlText

End Function

Remarques

Cette méthode vérifie la présence de données au format UnicodeText au format Windows XP Home Edition, Windows XP Professional, Windows Server 2003 et Windows 2000. Dans le cas contraire, cette méthode vérifie la présence de données au Text format.

Utilisez cette méthode pour déterminer si le Presse-papiers contient des données texte avant de les récupérer avec la GetText méthode.

Note

La Clipboard classe ne peut être utilisée que dans les threads définis en mode STA (Single Thread Apartment). Pour utiliser cette classe, vérifiez que votre Main méthode est marquée avec l’attribut STAThreadAttribute .

Voir aussi

• TextDataFormat
• Text
• UnicodeText
• GetText
• SetText

ContainsText(TextDataFormat)

Source:

Clipboard.cs

Indique s’il existe des données de texte dans le Presse-papiers au format indiqué par la valeur spécifiée TextDataFormat .

public:
 static bool ContainsText(System::Windows::Forms::TextDataFormat format);

public static bool ContainsText(System.Windows.Forms.TextDataFormat format);

static member ContainsText : System.Windows.Forms.TextDataFormat -> bool

Public Shared Function ContainsText (format As TextDataFormat) As Boolean

Paramètres

format

TextDataFormat

Une des TextDataFormat valeurs.

Retours

Boolean

true s’il existe des données de texte dans le Presse-papiers dans la valeur spécifiée pour format; sinon, false.

Exceptions

ExternalException

Le Presse-papiers n’a pas pu être effacé. Cela se produit généralement lorsque le Presse-papiers est utilisé par un autre processus.

ThreadStateException

Le thread actuel n’est pas en mode STA (Single-Threaded Apartment). Ajoutez la STAThreadAttribute méthode de Main votre application.

InvalidEnumArgumentException

format n’est pas une valeur valide TextDataFormat .

Exemples

L’exemple suivant illustre ce membre.

// Demonstrates SetText, ContainsText, and GetText.
public String SwapClipboardHtmlText(String replacementHtmlText)
{
    String returnHtmlText = null;
    if (Clipboard.ContainsText(TextDataFormat.Html))
    {
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html);
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html);
    }
    return returnHtmlText;
}

' Demonstrates SetText, ContainsText, and GetText.
Public Function SwapClipboardHtmlText( _
    ByVal replacementHtmlText As String) As String

    Dim returnHtmlText As String = Nothing

    If (Clipboard.ContainsText(TextDataFormat.Html)) Then
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html)
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html)
    End If

    Return returnHtmlText

End Function

Remarques

Utilisez cette méthode pour déterminer si le Presse-papiers contient des données texte avant de les récupérer avec la GetText méthode.

Note

La Clipboard classe ne peut être utilisée que dans les threads définis en mode STA (Single Thread Apartment). Pour utiliser cette classe, vérifiez que votre Main méthode est marquée avec l’attribut STAThreadAttribute .

Voir aussi

• TextDataFormat
• GetText
• SetText