Clipboard.GetText メソッド

定義

クリップボードからテキスト データを取得します。

オーバーロード

名前 説明
GetText()

オペレーティング システムに応じて、 Text または UnicodeText 形式でクリップボードからテキスト データを取得します。

GetText(TextDataFormat)

指定した TextDataFormat 値で示される形式でクリップボードからテキスト データを取得します。

GetText()

オペレーティング システムに応じて、 Text または UnicodeText 形式でクリップボードからテキスト データを取得します。

public:
 static System::String ^ GetText();
public static string GetText();
static member GetText : unit -> string
Public Shared Function GetText () As String

返品

クリップボードのテキスト データ。または、オペレーティング システムに応じて、クリップボードにTextまたはUnicodeText形式のデータが含まれていない場合にEmptyされます。

例外

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

現在のスレッドがシングル スレッド アパートメント (STA) モードではありません。 アプリケーションの Main メソッドにSTAThreadAttributeを追加します。

次の例では、このオーバーロードに似た GetText メソッドのオーバーロードを示します。

// 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 形式のテキスト データを返します。

このメソッドを使用して取得する前に、 ContainsText メソッドを使用して、クリップボードにテキスト データが含まれているかどうかを確認します。

SetText メソッドを使用して、テキスト データをクリップボードに追加します。

Note

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

こちらもご覧ください

適用対象

GetText(TextDataFormat)

指定した TextDataFormat 値で示される形式でクリップボードからテキスト データを取得します。

public:
 static System::String ^ GetText(System::Windows::Forms::TextDataFormat format);
public static string GetText(System.Windows.Forms.TextDataFormat format);
static member GetText : System.Windows.Forms.TextDataFormat -> string
Public Shared Function GetText (format As TextDataFormat) As String

パラメーター

format
TextDataFormat

TextDataFormat値の 1 つ。

返品

クリップボードのテキスト データ、またはクリップボードに指定した形式のデータが含まれていない場合に Empty

例外

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

現在のスレッドがシングル スレッド アパートメント (STA) モードではありません。 アプリケーションの 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

注釈

このメソッドを使用して取得する前に、 ContainsText メソッドを使用して、クリップボードにテキスト データが含まれているかどうかを確認します。

SetText メソッドを使用して、テキスト データをクリップボードに追加します。

Note

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

こちらもご覧ください

適用対象