次の方法で共有


Clipboard.ContainsText メソッド

定義

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

オーバーロード

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

戻り値

テキスト データがクリップボードに存在する場合は true。それ以外の場合は false

例外

クリップボードをクリアできませんでした。 この例外は、通常、クリップボードが別のプロセスで使用されている場合に発生します。

現在のスレッドがシングル スレッド アパートメント (STA: Single Thread Apartment) モードになっていません。 アプリケーションの Main メソッドに STAThreadAttribute を追加してください。

次の例では、このオーバーロードに似た メソッドの 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 クラスは、STA (シングル スレッド アパートメント) モードに設定されたスレッドでのみ使用できます。 このクラスを使用するには、お使いの Main メソッドが STAThreadAttribute 属性でマークされているようにします。

こちらもご覧ください

適用対象

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 値のいずれか 1 つ。

戻り値

format で指定された値のテキスト データがクリップボードに存在する場合は true。それ以外の場合はfalse

例外

クリップボードをクリアできませんでした。 この例外は、通常、クリップボードが別のプロセスで使用されている場合に発生します。

現在のスレッドがシングル スレッド アパートメント (STA: Single Thread Apartment) モードになっていません。 アプリケーションの Main メソッドに STAThreadAttribute を追加してください。

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 属性でマークされているようにします。

こちらもご覧ください

適用対象