ClipboardProxy クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クリップボードを操作するためのメソッドを提供します。
public ref class ClipboardProxypublic class ClipboardProxytype ClipboardProxy = classPublic Class ClipboardProxy- 継承
-
ClipboardProxy
例
次の使用例は、クリップボードから文字列 textOnClipboardにテキストを読み取ります。
Dim textOnClipboard As String = My.Computer.Clipboard.GetText()
クリップボードにテキストがない場合、この例は失敗します。
注釈
クリップボードに移動またはコピーされたアイテムは、アプリケーションがシャットダウンされた後も保持されます。
クリップボード上のデータは、クリップボード形式とも呼ばれる任意のデータ形式にすることができます。 クリップボードで使用する定義済みの形式の一覧については、「 DataFormats」を参照してください。 アイテムがクリップボードに移動またはコピーされると、他の形式のアイテムはクリアされます。 他の形式を保持するには、他のアプリケーションから貼り付けた項目を含め、現在のクリップボードに存在するすべてのものをコピーする DataObjectを使用します。 クリップボードに複数の形式でデータを配置して、形式要件がわからないターゲット アプリケーションがデータを正常に取得できる可能性を最大化します。
Windowsアプリケーションはすべてシステム クリップボードを共有するため、別のアプリケーションに切り替えると内容が変更される可能性があります。
クラスをクリップボードに配置するには、クラスをシリアル化できる必要があります。 詳細については、「Serialization - C# または Serialization - Visual Basicを参照してください。
クリップボードにリモートでアクセスすると、アクセスするスレッドが STA (シングル スレッド アパートメント) モードで動作しない限り、 ThreadStateException がスローされます。 この問題を解決するには、 ThreadApartmentState を STA に設定します。 詳細については、STAThreadAttributeを参照してください。
詳細については、「 クリップボードへのデータの格納とクリップボードからの読み取り」を参照してください。
プロジェクトの種類別の可用性
| プロジェクト タイプ | 在庫有り |
|---|---|
| Windows アプリケーション | Yes |
| クラス ライブラリ | Yes |
| コンソール アプリケーション | Yes |
| Windows コントロール ライブラリ | Yes |
| Web コントロール ライブラリ | いいえ |
| Windows サービス | Yes |
| ウェブサイト | いいえ |
メソッド
| 名前 | 説明 |
|---|---|
| Clear() |
クリップボードをクリアします。 |
| ContainsAudio() |
クリップボードにオーディオ データが含まれているかどうかを示します。 |
| ContainsData(String) |
クリップボードに、指定したカスタム形式のデータが含まれているかどうかを示します。 |
| ContainsFileDropList() |
クリップボードにファイル ドロップ リストが含まれているかどうかを示す |
| ContainsImage() |
画像がクリップボードに保存されているかどうかを示す |
| ContainsText() |
クリップボードにテキストがあるかどうかを判断します。 |
| ContainsText(TextDataFormat) |
クリップボードにテキストがあるかどうかを判断します。 |
| Equals(Object) |
指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| GetAudioStream() |
クリップボードからオーディオ ストリームを取得します。 |
| GetData(String) |
クリップボードからカスタム形式のデータを取得します。 |
| GetDataObject() |
クリップボードから IDataObjectとしてデータを取得します。 |
| GetFileDropList() |
クリップボードからファイル名を表す文字列のコレクションを取得します。 |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetImage() |
クリップボードからイメージを取得します。 |
| GetText() |
クリップボードからテキストを取得します。 |
| GetText(TextDataFormat) |
クリップボードからテキストを取得します。 |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| SetAudio(Byte[]) |
オーディオ データをクリップボードに書き込みます。 |
| SetAudio(Stream) |
オーディオ データをクリップボードに書き込みます。 |
| SetData(String, Object) |
カスタム形式のデータをクリップボードに書き込みます。 |
| SetDataObject(DataObject) |
DataObjectをクリップボードに書き込みます。 |
| SetFileDropList(StringCollection) |
ファイル パスを表す文字列のコレクションをクリップボードに書き込みます。 |
| SetImage(Image) |
イメージをクリップボードに書き込みます。 |
| SetText(String, TextDataFormat) |
クリップボードにテキストを書き込みます。 |
| SetText(String) |
クリップボードにテキストを書き込みます。 |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |