Clipboard.ContainsText Metodo

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Indica se sono presenti dati di testo negli Appunti.

Overload

Nome Descrizione
ContainsText()

Indica se sono presenti dati negli Appunti nel Text formato o UnicodeText , a seconda del sistema operativo.
ContainsText(TextDataFormat)

Indica se negli Appunti sono presenti dati di testo nel formato indicato dal valore specificato TextDataFormat .

ContainsText()

Origine:
Clipboard.cs
Origine:
Clipboard.cs
Origine:
Clipboard.cs
Origine:
Clipboard.cs
Origine:
Clipboard.cs

Indica se sono presenti dati negli Appunti nel Text formato o UnicodeText , a seconda del sistema operativo.

public:
 static bool ContainsText();
public static bool ContainsText();
static member ContainsText : unit -> bool
Public Shared Function ContainsText () As Boolean

Valori restituiti

Boolean

true se negli Appunti sono presenti dati di testo; in caso contrario, false.

Eccezioni

ExternalException

Impossibile cancellare gli Appunti. Ciò si verifica in genere quando gli Appunti vengono usati da un altro processo.

ThreadStateException

Il thread corrente non è in modalità apartment a thread singolo (STA). Aggiungere l'oggetto STAThreadAttribute al metodo dell'applicazione Main .

Esempio

Nell'esempio seguente viene illustrato un overload del ContainsText metodo simile a questo overload.

// 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

Commenti

Questo metodo verifica la presenza di dati nel formato UnicodeText in Windows XP Home Edition, Windows XP Professional, Windows Server 2003 e Windows 2000. In caso contrario, questo metodo verifica la presenza di dati nel Text formato .

Utilizzare questo metodo per determinare se gli Appunti contengono dati di testo prima di recuperarli con il GetText metodo .

Note

La classe Clipboard può essere utilizzata solo nei thread impostati sulla modalità STA (Single Thread Apartment), a thread singolo. Per usare questa classe, assicurarsi che il metodo Main sia contrassegnato con l'attributo STAThreadAttribute.

Vedi anche

Si applica a

ContainsText(TextDataFormat)

Origine:
Clipboard.cs
Origine:
Clipboard.cs
Origine:
Clipboard.cs
Origine:
Clipboard.cs
Origine:
Clipboard.cs

Indica se negli Appunti sono presenti dati di testo nel formato indicato dal valore specificato 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

Parametri

format
TextDataFormat

Uno dei TextDataFormat valori.

Valori restituiti

Boolean

true se negli Appunti sono presenti dati di testo nel valore specificato per format; in caso contrario, false.

Eccezioni

ExternalException

Impossibile cancellare gli Appunti. Ciò si verifica in genere quando gli Appunti vengono usati da un altro processo.

ThreadStateException

Il thread corrente non è in modalità apartment a thread singolo (STA). Aggiungere l'oggetto STAThreadAttribute al metodo dell'applicazione Main .

InvalidEnumArgumentException

format non è un valore valido TextDataFormat .

Esempio

Nell'esempio seguente viene illustrato questo membro.

// 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

Commenti

Utilizzare questo metodo per determinare se gli Appunti contengono dati di testo prima di recuperarli con il GetText metodo .

Note

La classe Clipboard può essere utilizzata solo nei thread impostati sulla modalità STA (Single Thread Apartment), a thread singolo. Per usare questa classe, assicurarsi che il metodo Main sia contrassegnato con l'attributo STAThreadAttribute.

Vedi anche

Si applica a