語言

Clipboard.ContainsText 方法

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll

顯示剪貼簿上是否有文字資料。

多載

名稱 Description
ContainsText()

顯示剪貼板 Text 上是否有 OR UnicodeText 格式的資料，視作業系統而定。
ContainsText(TextDataFormat)

表示剪貼簿上是否有指定值所示格式 TextDataFormat 的文字資料。

ContainsText()

來源:
Clipboard.cs
來源:
Clipboard.cs
來源:
Clipboard.cs
來源:
Clipboard.cs
來源:
Clipboard.cs

顯示剪貼板 Text 上是否有 OR UnicodeText 格式的資料，視作業系統而定。

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

傳回

Boolean

true如果剪貼簿上有文字資料;否則，。 false

例外狀況

ExternalException

夾板無法清理。 這通常發生在夾板被其他程序使用時。

ThreadStateException

目前執行緒並非處於單執行緒公寓（STA）模式。 把STAThreadAttribute它Main加入你的申請方法。

範例

以下範例展示了方法中類似此過載的過載 ContainsText 。

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

備註

此方法檢查 Windows XP Home Edition、Windows XP Professional、Windows Server 2003 及 2000 Windows 2000 中是否存在 UnicodeText 格式的資料。 否則，此方法會檢查格式中 Text 是否有資料。

使用此方法判斷剪貼簿是否包含文字資料，再用該 GetText 方法擷取。

Note

Clipboard 類別只能在設定為單一執行緒 Apartment (STA) 模式的執行緒中使用。 若要使用此類別，請確定您的 Main 方法已標示為 STAThreadAttribute 屬性。

另請參閱

適用於

ContainsText(TextDataFormat)

來源:
Clipboard.cs
來源:
Clipboard.cs
來源:
Clipboard.cs
來源:
Clipboard.cs
來源:
Clipboard.cs

表示剪貼簿上是否有指定值所示格式 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

參數

format
TextDataFormat

這是其中一項 TextDataFormat 價值。

傳回

Boolean

true如果剪貼板上有指定的format值中的文字資料;否則，。 false

例外狀況

ExternalException

夾板無法清理。 這通常發生在夾板被其他程序使用時。

ThreadStateException

目前執行緒並非處於單執行緒公寓（STA）模式。 把STAThreadAttribute它Main加入你的申請方法。

InvalidEnumArgumentException

format 不是一個有效的 TextDataFormat 值。

範例

以下範例展示了此成員。

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

備註

使用此方法判斷剪貼簿是否包含文字資料，再用該 GetText 方法擷取。

Note

Clipboard 類別只能在設定為單一執行緒 Apartment (STA) 模式的執行緒中使用。 若要使用此類別，請確定您的 Main 方法已標示為 STAThreadAttribute 屬性。

另請參閱

適用於