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

ContainsText()	Indica se sono presenti dati negli Appunti nel formato Text o UnicodeText, in base al sistema operativo.
ContainsText(TextDataFormat)	Indica se sono presenti dati di testo negli Appunti nel formato indicato dal valore TextDataFormat specificato.

ContainsText()

Origine:

Clipboard.cs

Indica se sono presenti dati negli Appunti nel formato Text o UnicodeText, in base al sistema operativo.

public:
 static bool ContainsText();

public static bool ContainsText ();

static member ContainsText : unit -> bool

Public Shared Function ContainsText () As Boolean

Restituisce

Boolean

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

Eccezioni

ExternalException

Impossibile cancellare gli Appunti. Ciò si verifica solitamente se un altro processo sta utilizzando gli Appunti.

ThreadStateException

Il thread corrente non è in modalità Single Thread Apartment (STA). Aggiungere la classe STAThreadAttribute al metodo Main dell'applicazione.

Esempio

Nell'esempio ContainsText seguente viene illustrato un overload del 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 in UnicodeText 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.

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

Nota

La Clipboard classe può essere usata solo nei thread impostati sulla modalità single thread apartment (STA). Per usare questa classe, assicurarsi che il Main metodo sia contrassegnato con l'attributo STAThreadAttribute .

Vedi anche

• TextDataFormat
• Text
• UnicodeText
• GetText
• SetText

ContainsText(TextDataFormat)

Origine:

Clipboard.cs

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

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 valori di TextDataFormat.

Restituisce

Boolean

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

Eccezioni

ExternalException

Impossibile cancellare gli Appunti. Ciò si verifica solitamente se un altro processo sta utilizzando gli Appunti.

ThreadStateException

Il thread corrente non è in modalità Single Thread Apartment (STA). Aggiungere la classe STAThreadAttribute al metodo Main dell'applicazione.

InvalidEnumArgumentException

format non è un valore valido di 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

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

Nota

La Clipboard classe può essere usata solo nei thread impostati sulla modalità single thread apartment (STA). Per usare questa classe, assicurarsi che il Main metodo sia contrassegnato con l'attributo STAThreadAttribute .

Vedi anche

• TextDataFormat
• GetText
• SetText