Clipboard.GetText Clipboard.GetText Clipboard.GetText Clipboard.GetText Method

定義

クリップボードからテキスト データを取得します。Retrieves text data from the Clipboard.

オーバーロード

GetText() GetText() GetText() GetText()

オペレーティング システムに応じて、クリップボードから Text 形式または UnicodeText 形式でテキスト データを取得します。Retrieves text data from the Clipboard in the Text or UnicodeText format, depending on the operating system.

GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat)

クリップボードから、指定した TextDataFormat 値で示される形式でテキスト データを取得します。Retrieves text data from the Clipboard in the format indicated by the specified TextDataFormat value.

GetText() GetText() GetText() GetText()

オペレーティング システムに応じて、クリップボードから Text 形式または UnicodeText 形式でテキスト データを取得します。Retrieves text data from the Clipboard in the Text or UnicodeText format, depending on the operating system.

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

戻り値

クリップボードのテキスト データ。オペレーティング システムに応じた Empty 形式または Text 形式のデータがクリップボードに含まれていない場合は UnicodeTextThe Clipboard text data or Empty if the Clipboard does not contain data in the Text or UnicodeText format, depending on the operating system.

例外

クリップボードをクリアできませんでした。The Clipboard could not be cleared. この例外は、通常、クリップボードが別のプロセスで使用されている場合に発生します。This typically occurs when the Clipboard is being used by another process.

現在のスレッドがシングル スレッド アパートメント (STA: Single Thread Apartment) モードになっていません。The current thread is not in single-threaded apartment (STA) mode. アプリケーションの Main メソッドに STAThreadAttribute を追加してください。Add the STAThreadAttribute to your application's Main method.

次の例は、このオーバーロードにGetText似たメソッドのオーバーロードを示しています。The following example demonstrates an overload of the GetText method that is similar to this overload.

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

注釈

このメソッドはUnicodeText 、およびWindows 2000Windows 2000Windows XP Home Edition、Windows XP Professional、Windows Server 2003Windows XP Home Edition, Windows XP Professional, Windows Server 2003形式でテキストデータを返します。This method returns text data in the UnicodeText format on Windows XP Home Edition、Windows XP Professional、Windows Server 2003Windows XP Home Edition, Windows XP Professional, Windows Server 2003 and Windows 2000Windows 2000. それ以外の場合、このメソッドはテキストTextデータを形式で返します。Otherwise, this method returns text data in the Text format.

ContainsTextメソッドを使用して、このメソッドを使用して取得する前に、クリップボードにテキストデータが含まれているかどうかを確認します。Use the ContainsText method to determine whether the Clipboard contains text data before retrieving it with this method.

テキストデータSetTextをクリップボードに追加するには、メソッドを使用します。Use the SetText method to add text data to the Clipboard.

注意

クラスClipboardは、シングルスレッドアパートメント (STA) モードに設定されているスレッドでのみ使用できます。The Clipboard class can only be used in threads set to single thread apartment (STA) mode. このクラスを使用するには、 MainメソッドがSTAThreadAttribute属性でマークされていることを確認します。To use this class, ensure that your Main method is marked with the STAThreadAttribute attribute.

セキュリティ

UIPermission
システムクリップボードへのアクセスを許可します。for access to the system Clipboard. 関連付けられた列挙型:AllClipboardAssociated enumeration: AllClipboard

こちらもご覧ください

GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat)

クリップボードから、指定した TextDataFormat 値で示される形式でテキスト データを取得します。Retrieves text data from the Clipboard in the format indicated by the specified TextDataFormat value.

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

TextDataFormat 値のいずれか 1 つ。One of the TextDataFormat values.

戻り値

クリップボードのテキスト データ。指定した形式のデータがクリップボードに含まれていない場合は EmptyThe Clipboard text data or Empty if the Clipboard does not contain data in the specified format.

例外

クリップボードをクリアできませんでした。The Clipboard could not be cleared. この例外は、通常、クリップボードが別のプロセスで使用されている場合に発生します。This typically occurs when the Clipboard is being used by another process.

現在のスレッドがシングル スレッド アパートメント (STA: Single Thread Apartment) モードになっていません。The current thread is not in single-threaded apartment (STA) mode. アプリケーションの Main メソッドに STAThreadAttribute を追加してください。Add the STAThreadAttribute to your application's Main method.

このメンバーの例を次に示します。The following example demonstrates this member.

// 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メソッドを使用して、このメソッドを使用して取得する前に、クリップボードにテキストデータが含まれているかどうかを確認します。Use the ContainsText method to determine whether the Clipboard contains text data before retrieving it with this method.

テキストデータSetTextをクリップボードに追加するには、メソッドを使用します。Use the SetText method to add text data to the Clipboard.

注意

クラスClipboardは、シングルスレッドアパートメント (STA) モードに設定されているスレッドでのみ使用できます。The Clipboard class can only be used in threads set to single thread apartment (STA) mode. このクラスを使用するには、 MainメソッドがSTAThreadAttribute属性でマークされていることを確認します。To use this class, ensure that your Main method is marked with the STAThreadAttribute attribute.

セキュリティ

UIPermission
システムクリップボードへのアクセスを許可します。for access to the system Clipboard. 関連付けられた列挙型:AllClipboardAssociated enumeration: AllClipboard

こちらもご覧ください

適用対象