Clipboard.ContainsText Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Určuje, zda jsou ve schránce textová data.

Přetížení

Name	Description
ContainsText()	Určuje, jestli v závislosti na operačním systému existují data ve schránce nebo TextUnicodeText ve formátu.
ContainsText(TextDataFormat)	Určuje, zda jsou textová data ve schránce ve formátu určeném zadanou TextDataFormat hodnotou.

ContainsText()

Zdroj:

Clipboard.cs

Určuje, jestli v závislosti na operačním systému existují data ve schránce nebo TextUnicodeText ve formátu.

public:
 static bool ContainsText();

public static bool ContainsText();

static member ContainsText : unit -> bool

Public Shared Function ContainsText () As Boolean

Návraty

Boolean

truepokud jsou ve schránce textová data; v opačném případě . false

Výjimky

ExternalException

Schránku nelze vymazat. K tomu obvykle dochází v případě, že schránku používá jiný proces.

ThreadStateException

Aktuální vlákno není v režimu STA (Single-Threaded Apartment). Přidejte metodu STAThreadAttributeMain aplikace.

Příklady

Následující příklad ukazuje přetížení ContainsText metody, která je podobná tomuto přetížení.

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

Poznámky

Tato metoda kontroluje přítomnost dat ve formátu UnicodeText ve formátu Windows XP Home Edition, Windows XP Professional, Windows Server 2003 a Windows 2000. V opačném případě tato metoda zkontroluje přítomnost dat ve Text formátu.

Tuto metodu použijte k určení, zda schránka obsahuje textová data před načtením pomocí GetText metody.

Note

Třída Clipboard lze použít pouze ve vláknech nastavených na režim jednovláknového apartmentu (STA). Chcete-li použít tuto třídu, ujistěte se, že je vaše metoda Main označena atributem STAThreadAttribute.

Viz také

• TextDataFormat
• Text
• UnicodeText
• GetText
• SetText

ContainsText(TextDataFormat)

Zdroj:

Clipboard.cs

Určuje, zda jsou textová data ve schránce ve formátu určeném zadanou TextDataFormat hodnotou.

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

Parametry

format

TextDataFormat

Jedna z TextDataFormat hodnot.

Návraty

Boolean

true pokud jsou ve schránce textová data v hodnotě určené pro format; jinak , false.

Výjimky

ExternalException

Schránku nelze vymazat. K tomu obvykle dochází v případě, že schránku používá jiný proces.

ThreadStateException

Aktuální vlákno není v režimu STA (Single-Threaded Apartment). Přidejte metodu STAThreadAttributeMain aplikace.

InvalidEnumArgumentException

format není platná TextDataFormat hodnota.

Příklady

Následující příklad ukazuje tohoto člena.

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

Poznámky

Tuto metodu použijte k určení, zda schránka obsahuje textová data před načtením pomocí GetText metody.

Note

Třída Clipboard lze použít pouze ve vláknech nastavených na režim jednovláknového apartmentu (STA). Chcete-li použít tuto třídu, ujistěte se, že je vaše metoda Main označena atributem STAThreadAttribute.

Viz také

• TextDataFormat
• GetText
• SetText