Clipboard クラス

定義

名前空間:
System.Windows
アセンブリ:
PresentationCore.dll

システム クリップボードとの間でのデータ転送を容易にする静的メソッドを提供します。

public ref class Clipboard abstract sealed
public static class Clipboard
type Clipboard = class
Public Class Clipboard
継承
Object
Clipboard

例

次の例は、システム クリップボードにデータを追加する方法を示しています。


// For this example, the data to be placed on the clipboard is a simple
// string.
string textData = "I want to put this string on the clipboard.";

// After this call, the data (string) is placed on the clipboard and tagged
// with a data format of "Text".
Clipboard.SetData(DataFormats.Text, (Object)textData);

' For this example, the data to be placed on the clipboard is a simple
' string.
Dim textData As String = "I want to put this string on the clipboard."

' After this call, the data (string) is placed on the clipboard and tagged
' with a data format of "Text".
Clipboard.SetData(DataFormats.Text, CType(textData, Object))

注釈

Windowsのすべてのアプリケーションはシステム クリップボードを共有するため、別のアプリケーションに切り替えると内容が変更される可能性があります。

Clipboard クラスで使用できる定義済みの形式の一覧については、DataFormats クラスを参照してください。

セキュリティ アラート: セキュリティ上の理由から、次の点に留意する必要があります。

  • 貼り付け操作は、ユーザーが開始する必要があります (Ctrl + V、貼り付けメニュー)。

  • コピーは、ユーザーが選択したコンテンツにのみ適用できます。

  • コピーまたは切り取り時に、部分信頼コードはプレーンテキストと拡張可能なアプリケーション マークアップ言語 (XAML) をクリップボードに配置します。 プレーンテキストには、テキスト、Unicode テキスト、OEM (オブジェクト Exchange モデル) テキスト、CSV (コンマ区切り値) が含まれます。

  • 貼り付け時に、Windows Presentation Foundation (WPF) は、そのコンテンツのソースが等しく信頼されているサイトまたは信頼されたサイトからの場合に、Extensible Application Markup Language (XAML) に貼り付けます。 Specifically:

    • 部分信頼アプリケーションでは、完全信頼アプリケーションから Extensible Application Markup Language (XAML) を貼り付けることができます。

    • 部分信頼アプリケーションでは、部分信頼アプリケーションから Extensible Application Markup Language (XAML) を貼り付けることができます。

    • 完全信頼アプリケーションは、完全に信頼された別のアプリケーションからのみ XAML を貼り付けることができます。

    • 非Windows Presentation Foundation (WPF) 完全信頼アプリケーションは、クリップボードの ApplicationTrust 形式を調べ、必要に応じて XAML をサニタイズできます。

メソッド

名前 説明
Clear()

システム クリップボードからデータをクリアします。
ContainsAudio()

WaveAudio データ形式のデータが存在する場合は、クリップボードにクエリを実行します。
ContainsData(String)

指定したデータ形式のデータが存在する場合は、クリップボードにクエリを実行します。
ContainsFileDropList()

FileDrop データ形式のデータが存在する場合は、クリップボードにクエリを実行します。
ContainsImage()

Bitmap データ形式のデータが存在する場合は、クリップボードにクエリを実行します。
ContainsText()

UnicodeText形式のデータが存在する場合は、クリップボードにクエリを実行します。
ContainsText(TextDataFormat)

テキスト データ形式のデータが存在する場合は、クリップボードにクエリを実行します。
Flush()

データの元のアプリケーションが閉じた後に使用できるように、 Clipboard 上にあるデータを永続的に追加します。
GetAudioStream()

WaveAudio データ形式のクリップボード データのストリームを返します。
GetData(String)

クリップボードから指定した形式のデータを取得します。
GetDataObject()

クリップボードの内容全体を表すデータ オブジェクトを返します。
GetFileDropList()

クリップボードで使用できる削除されたファイルの一覧を含む文字列コレクションを返します。
GetImage()

BitmapSource形式のデータを含むBitmap オブジェクトをクリップボードから返します。
GetText()

クリップボードの UnicodeText データを含む文字列を返します。
GetText(TextDataFormat)

クリップボードのテキスト データを含む文字列を返します。
IsCurrent(IDataObject)

指定したデータ オブジェクトをクリップボードの内容と比較します。
SetAudio(Byte[])

オーディオ データ (WaveAudio データ形式) をクリップボードに格納します。 オーディオ データはバイト配列として指定されます。
SetAudio(Stream)

オーディオ データ (WaveAudio データ形式) をクリップボードに格納します。 オーディオ データはストリームとして指定されます。
SetData(String, Object)

指定したデータを指定した形式でクリップボードに格納します。
SetDataAsJson<T>(String, T)

システム クリップボードとの間でのデータ転送を容易にする静的メソッドを提供します。
SetDataObject(Object, Boolean)

指定したデータ オブジェクトをシステム クリップボードに配置し、アプリケーションの終了時にデータ オブジェクトをクリップボードに残すかどうかを示すブール型パラメーターを受け取ります。
SetDataObject(Object)

指定した非永続的データ オブジェクトをシステム クリップボードに配置します。
SetFileDropList(StringCollection)

FileDropデータをクリップボードに格納します。 ドロップされたファイル リストは、文字列コレクションとして指定されます。
SetImage(BitmapSource)

Bitmapデータをクリップボードに格納します。 イメージ データは、 BitmapSourceとして指定されます。
SetText(String, TextDataFormat)

指定したテキスト データ形式でクリップボードにテキスト データを格納します。 格納する UnicodeText データは文字列として指定されます。
SetText(String)

UnicodeTextデータをクリップボードに格納します。
TryGetData<T>(String, Func<TypeName,Type>, T)

システム クリップボードとの間でのデータ転送を容易にする静的メソッドを提供します。
TryGetData<T>(String, T)

システム クリップボードとの間でのデータ転送を容易にする静的メソッドを提供します。

適用対象

こちらもご覧ください