Clipboard.ContainsText Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

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

Přetížení

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

ContainsText()

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

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í, když je schránka používána jiným procesem.

ThreadStateException

Aktuální vlákno není v režimu STA (single-threaded apartment). Přidejte metodu STAThreadAttribute Main 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 UnicodeText formátu 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 metody GetText .

Poznámka

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

Viz také

• TextDataFormat
• Text
• UnicodeText
• GetText
• SetText

ContainsText(TextDataFormat)

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 textová data ve schránce v hodnotě zadané pro format; v opačném případě false.

Výjimky

ExternalException

Schránku nelze vymazat. K tomu obvykle dochází, když je schránka používána jiným procesem.

ThreadStateException

Aktuální vlákno není v režimu STA (single-threaded apartment). Přidejte metodu STAThreadAttribute Main 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 metody GetText .

Poznámka

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

Viz také

• TextDataFormat
• GetText
• SetText