Clipboard.GetText メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クリップボードからテキスト データを取得します。
オーバーロード
| 名前 | 説明 |
|---|---|
| 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 属性でマークされていることを確認します。