Clipboard.ContainsText 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

指出剪貼簿上是否有文字資料。

多載

ContainsText()	指出剪貼簿上是否有 Text 或 UnicodeText 格式的資料，格式依作業系統而定。
ContainsText(TextDataFormat)	指出剪貼簿上是否有由所指定 TextDataFormat 值代表之格式的文字資料。

ContainsText()

指出剪貼簿上是否有 Text 或 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

目前執行緒 (Thread) 不是在單一執行緒 Apartment (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 和 Windows 2000 上是否有資料 UnicodeText 。 否則，此方法會檢查格式的資料是否存在 Text 。

使用這個方法來判斷剪貼簿是否包含文字資料，然後再使用 GetText 方法擷取。

注意

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

另請參閱

• TextDataFormat
• Text
• UnicodeText
• GetText
• SetText

ContainsText(TextDataFormat)

指出剪貼簿上是否有由所指定 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

如果剪貼簿上有為 format 所指定值的文字資料，則為 true，否則為 false。

例外狀況

ExternalException

無法清除剪貼簿。 這通常在剪貼簿由另一個處理序使用時發生。

ThreadStateException

目前執行緒 (Thread) 不是在單一執行緒 Apartment (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 方法擷取它。

注意

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

另請參閱

• TextDataFormat
• GetText
• SetText