Clipboard.ContainsText メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クリップボードにテキスト データが存在するかどうかを示します。
オーバーロード
| ContainsText() |
オペレーティング システムに応じて、Text 形式または UnicodeText 形式のデータがクリップボードに存在するかどうかを示します。 |
| ContainsText(TextDataFormat) |
指定した TextDataFormat 値で示される形式のテキスト データがクリップボードに存在するかどうかを示します。 |
ContainsText()
オペレーティング システムに応じて、Text 形式または UnicodeText 形式のデータがクリップボードに存在するかどうかを示します。
public:
static bool ContainsText();public static bool ContainsText ();static member ContainsText : unit -> boolPublic 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 -> boolPublic 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 属性でマークされているようにします。
こちらもご覧ください
適用対象
.NET