Clipboard.ContainsText メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

クリップボードにテキスト データがあるかどうかを示します。

オーバーロード

名前	説明
ContainsText()	オペレーティング システムに応じて、クリップボードに Text または UnicodeText 形式のデータがあるかどうかを示します。
ContainsText(TextDataFormat)	指定した TextDataFormat 値で示される形式のテキスト データがクリップボードに存在するかどうかを示します。

ContainsText()

ソース:

Clipboard.cs

オペレーティング システムに応じて、クリップボードに 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

現在のスレッドがシングル スレッド アパートメント (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 メソッドを使用して取得する前に、クリップボードにテキスト データが含まれているかどうかを確認するには、このメソッドを使用します。

Note

Clipboard クラスは、単一スレッド アパートメント (STA) モードに設定されたスレッドでのみ使用できます。 このクラスを使用するには、 Main メソッドが STAThreadAttribute 属性でマークされていることを確認します。

こちらもご覧ください

• TextDataFormat
• Text
• UnicodeText
• GetText
• SetText

ContainsText(TextDataFormat)

ソース:

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値の 1 つ。

返品

Boolean

に指定された値にクリップボードにテキスト データがある場合は a0/&。それ以外の場合は。

例外

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 クラスは、単一スレッド アパートメント (STA) モードに設定されたスレッドでのみ使用できます。 このクラスを使用するには、 Main メソッドが STAThreadAttribute 属性でマークされていることを確認します。

こちらもご覧ください

• TextDataFormat
• GetText
• SetText