Clipboard Clipboard Clipboard Clipboard Class

定義

システム クリップボードにデータを貼り付けるメソッド、またはシステム クリップボードのデータを取得するメソッドを提供します。Provides methods to place data on and retrieve data from the system Clipboard. このクラスは継承できません。This class cannot be inherited.

public ref class Clipboard sealed
public sealed class Clipboard
type Clipboard = class
Public NotInheritable Class Clipboard
継承
ClipboardClipboardClipboardClipboard

次のコード例ではClipboardメソッドにデータを配置し、システム クリップボードから取得します。The following code example uses Clipboard methods to place data on and retrieve it from the system Clipboard. 次のコードでbutton1button2textBox1、およびtextBox2作成して、フォーム上に配置します。This code assumes button1, button2, textBox1, and textBox2 have been created and placed on the form.

button1_Clickメソッド呼び出しSetDataObjectをテキスト ボックスから選択したテキストを取得してこれをシステム クリップボードに配置します。The button1_Click method calls SetDataObject to take selected text from the text box and place it on the system Clipboard.

button2_Clickメソッド呼び出しGetDataObjectシステム クリップボードからデータを取得します。The button2_Click method calls GetDataObject to retrieve data from the system Clipboard. コードを使用してIDataObjectDataFormats返されるデータを抽出するのデータを表示およびtextBox2します。The code uses IDataObject and DataFormats to extract the data returned and displays the data in textBox2.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Takes the selected text from a text box and puts it on the clipboard.
      if ( !textBox1->SelectedText->Equals( "" ) )
      {
         Clipboard::SetDataObject( textBox1->SelectedText );
      }
      else
      {
         textBox2->Text = "No text selected in textBox1";
      }
   }

   void button2_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Declares an IDataObject to hold the data returned from the clipboard.
      // Retrieves the data from the clipboard.
      IDataObject^ iData = Clipboard::GetDataObject();
      
      // Determines whether the data is in a format you can use.
      if ( iData->GetDataPresent( DataFormats::Text ) )
      {
         // Yes it is, so display it in a text box.
         textBox2->Text = (String^)(iData->GetData( DataFormats::Text ));
      }
      else
      {
         // No it is not.
         textBox2->Text = "Could not retrieve data off the clipboard.";
      }
   }
private void button1_Click(object sender, System.EventArgs e) {
    // Takes the selected text from a text box and puts it on the clipboard.
    if(textBox1.SelectedText != "")
       Clipboard.SetDataObject(textBox1.SelectedText);
    else
       textBox2.Text = "No text selected in textBox1";
 }
 
 private void button2_Click(object sender, System.EventArgs e) {
    // Declares an IDataObject to hold the data returned from the clipboard.
    // Retrieves the data from the clipboard.
    IDataObject iData = Clipboard.GetDataObject();
 
    // Determines whether the data is in a format you can use.
    if(iData.GetDataPresent(DataFormats.Text)) {
       // Yes it is, so display it in a text box.
       textBox2.Text = (String)iData.GetData(DataFormats.Text); 
    }
    else {
       // No it is not.
       textBox2.Text = "Could not retrieve data off the clipboard.";
    }
 }
 
Private Sub button1_Click(sender As Object, e As System.EventArgs)
    ' Takes the selected text from a text box and puts it on the clipboard.
    If textBox1.SelectedText <> "" Then
        Clipboard.SetDataObject(textBox1.SelectedText)
    Else
        textBox2.Text = "No text selected in textBox1"
    End If
End Sub 'button1_Click
 
Private Sub button2_Click(sender As Object, e As System.EventArgs)
    ' Declares an IDataObject to hold the data returned from the clipboard.
    ' Retrieves the data from the clipboard.
    Dim iData As IDataObject = Clipboard.GetDataObject()
    
    ' Determines whether the data is in a format you can use.
    If iData.GetDataPresent(DataFormats.Text) Then
        ' Yes it is, so display it in a text box.
        textBox2.Text = CType(iData.GetData(DataFormats.Text), String)
    Else
        ' No it is not.
        textBox2.Text = "Could not retrieve data off the clipboard."
    End If
End Sub 'button2_Click

注釈

使用する定義済みの形式の一覧については、Clipboardクラスを参照してください、DataFormatsクラス。For a list of predefined formats to use with the Clipboard class, see the DataFormats class.

呼び出すSetDataObjectにデータをクリップボードに、現在の内容を交換します。Call SetDataObject to put data on the Clipboard, replacing its current contents. クリップボードのデータの永続的なコピーを配置するには、設定、copyパラメーターをtrueします。To place a persistent copy of the data on the Clipboard, set the copy parameter to true.

注意

複数の形式でクリップボードにデータを配置するには使用、DataObjectクラスまたはIDataObject実装します。To place data on the Clipboard in multiple formats, use the DataObject class or an IDataObject implementation. 形式の要件がわからない場合がありますが、ターゲット アプリケーションがデータを正常に取得できます可能性を最大化する複数の形式でクリップボードにデータを配置します。Place data on the Clipboard in multiple formats to maximize the possibility that a target application, whose format requirements you might not know, can successfully retrieve the data.

呼び出すGetDataObjectクリップボードからデータを取得します。Call GetDataObject to retrieve data from the Clipboard. 実装するオブジェクトとしてデータが返されます、IDataObjectインターフェイス。The data is returned as an object that implements the IDataObject interface. 指定されたメソッドを使用してIDataObjectのフィールドとDataFormatsオブジェクトからデータを抽出します。Use the methods specified by IDataObject and fields in DataFormats to extract the data from the object. 取得したデータの形式がわからない場合、GetFormatsのメソッド、IDataObjectにすべての形式の一覧にそのデータを取得するインターフェイスが格納されます。If you do not know the format of the data you retrieved, call the GetFormats method of the IDataObject interface to get a list of all formats that data is stored in. 呼び出して、GetDataのメソッド、IDataObjectインターフェイスし、アプリケーションが使用できる形式を指定します。Then call the GetData method of the IDataObject interface, and specify a format that your application can use.

.NET Framework 2.0.NET Framework 2.0Clipboardクラスは、システムのクリップボードを使用するより簡単にする追加のメソッドを提供します。In .NET Framework 2.0.NET Framework 2.0, the Clipboard class provides additional methods that make it easier to work with the system Clipboard. 呼び出す、Clearクリップボードからすべてのデータを削除する方法。Call the Clear method to remove all data from the Clipboard. 特定の形式のデータをクリップボードに追加するには、適切な呼び出し、既存のデータを置換Set形式メソッドなどSetText、呼び出したり、SetData形式を指定するメソッド。To add data of a particular format to the Clipboard, replacing the existing data, call the appropriate SetFormat method, such as SetText, or call the SetData method to specify the format. 特定の形式のデータをクリップボードから取得する最初に呼び出し、適切なContains形式メソッド (などContainsText) 内のデータがクリップボードに含まれるかどうかを判断するメソッドは、書式設定を呼び出して、適切なGet形式メソッド (などGetText) がクリップボードに含まれる場合は、データを取得します。To retrieve data of a particular format from the Clipboard, first call the appropriate ContainsFormat method (such as ContainsText) method to determine whether the Clipboard contains data in that format, and then call the appropriate GetFormat method (such as GetText) to retrieve the data if the Clipboard contains it. これらの操作で、形式を指定するには、呼び出し、ContainsDataGetDataメソッド代わりにします。To specify the format in these operations, call the ContainsData and GetData methods instead.

注意

すべての Windows ベースのアプリケーションは、別のアプリケーションに切り替えると、内容が変更される可能性は、システム クリップボードを共有します。All Windows-based applications share the system Clipboard, so the contents are subject to change when you switch to another application.

オブジェクトはクリップボードに配置するためにシリアル化可能である必要があります。An object must be serializable for it to be put on the Clipboard. クリップボードのメソッドにシリアル化できないオブジェクトを渡すと、例外をスローせず、メソッドは失敗します。If you pass a non-serializable object to a Clipboard method, the method will fail without throwing an exception. 参照してくださいSystem.Runtime.Serializationシリアル化の詳細についてはします。See System.Runtime.Serialization for more information on serialization. ターゲット アプリケーションには、非常に特定のデータ形式が必要とする場合、シリアル化プロセス内のデータに追加されるヘッダーからデータを認識するアプリケーションを使用できなくなります。If your target application requires a very specific data format, the headers added to the data in the serialization process may prevent the application from recognizing your data. データ形式を保持するために、データを追加、Byte配列をMemoryStreamを渡すと、MemoryStreamSetDataメソッド。To preserve your data format, add your data as a Byte array to a MemoryStream and pass the MemoryStream to the SetData method.

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.

クリップボードをメタファイル形式を使用する場合、特別な考慮事項が必要にあります。Special considerations may be necessary when using the metafile format with the Clipboard. 現在の実装の制限により、DataObjectクラス、.NET Framework で使用されるメタファイル形式を古いメタファイル形式を使用するアプリケーションで認識されない可能性があります。Due to a limitation in the current implementation of the DataObject class, the metafile format used by the .NET Framework may not be recognized by applications that use an older metafile format. この場合、クリップボードの Win32 アプリケーション プログラミング インターフェイス (Api) と相互運用する必要があります。In this case, you must interoperate with the Win32 Clipboard application programming interfaces (APIs).

メソッド

Clear() Clear() Clear() Clear()

すべてのデータをクリップボードから削除します。Removes all data from the Clipboard.

ContainsAudio() ContainsAudio() ContainsAudio() ContainsAudio()

クリップボードに WaveAudio 形式のデータが存在するかどうかを示します。Indicates whether there is data on the Clipboard in the WaveAudio format.

ContainsData(String) ContainsData(String) ContainsData(String) ContainsData(String)

指定した形式のデータ、またはその形式に変換できるデータがクリップボードに存在するかどうかを示します。Indicates whether there is data on the Clipboard that is in the specified format or can be converted to that format.

ContainsFileDropList() ContainsFileDropList() ContainsFileDropList() ContainsFileDropList()

FileDrop 形式のデータ、またはその形式に変換できるデータがクリップボードに存在するかどうかを示します。Indicates whether there is data on the Clipboard that is in the FileDrop format or can be converted to that format.

ContainsImage() ContainsImage() ContainsImage() ContainsImage()

Bitmap 形式のデータ、またはその形式に変換できるデータがクリップボードに存在するかどうかを示します。Indicates whether there is data on the Clipboard that is in the Bitmap format or can be converted to that format.

ContainsText() ContainsText() ContainsText() ContainsText()

オペレーティング システムに応じて、Text 形式または UnicodeText 形式のデータがクリップボードに存在するかどうかを示します。Indicates whether there is data on the Clipboard in the Text or UnicodeText format, depending on the operating system.

ContainsText(TextDataFormat) ContainsText(TextDataFormat) ContainsText(TextDataFormat) ContainsText(TextDataFormat)

指定した TextDataFormat 値で示される形式のテキスト データがクリップボードに存在するかどうかを示します。Indicates whether there is text data on the Clipboard in the format indicated by the specified TextDataFormat value.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetAudioStream() GetAudioStream() GetAudioStream() GetAudioStream()

クリップボードからオーディオ ストリームを取得します。Retrieves an audio stream from the Clipboard.

GetData(String) GetData(String) GetData(String) GetData(String)

クリップボードから指定した形式でデータを取得します。Retrieves data from the Clipboard in the specified format.

GetDataObject() GetDataObject() GetDataObject() GetDataObject()

現在システム クリップボードにあるデータを取得します。Retrieves the data that is currently on the system Clipboard.

GetFileDropList() GetFileDropList() GetFileDropList() GetFileDropList()

ファイル名のコレクションをクリップボードから取得します。Retrieves a collection of file names from the Clipboard.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetImage() GetImage() GetImage() GetImage()

クリップボードからイメージを取得します。Retrieves an image 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.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
SetAudio(Byte[]) SetAudio(Byte[]) SetAudio(Byte[]) SetAudio(Byte[])

クリップボードをクリアし、Byte 配列を WaveAudio に変換してから、Stream 形式で追加します。Clears the Clipboard and then adds a Byte array in the WaveAudio format after converting it to a Stream.

SetAudio(Stream) SetAudio(Stream) SetAudio(Stream) SetAudio(Stream)

クリップボードをクリアし、StreamWaveAudio 形式で追加します。Clears the Clipboard and then adds a Stream in the WaveAudio format.

SetData(String, Object) SetData(String, Object) SetData(String, Object) SetData(String, Object)

クリップボードをクリアし、データを指定した形式で追加します。Clears the Clipboard and then adds data in the specified format.

SetDataObject(Object) SetDataObject(Object) SetDataObject(Object) SetDataObject(Object)

クリップボードをクリアし、データをクリップボードに非永続的に貼り付けます。Clears the Clipboard and then places nonpersistent data on it.

SetDataObject(Object, Boolean) SetDataObject(Object, Boolean) SetDataObject(Object, Boolean) SetDataObject(Object, Boolean)

クリップボードをクリアした後でデータをクリップボードに貼り付け、そのデータをアプリケーションが終了してもクリップボードに残しておくかどうかを指定します。Clears the Clipboard and then places data on it and specifies whether the data should remain after the application exits.

SetDataObject(Object, Boolean, Int32, Int32) SetDataObject(Object, Boolean, Int32, Int32) SetDataObject(Object, Boolean, Int32, Int32) SetDataObject(Object, Boolean, Int32, Int32)

クリップボードをクリアした後、指定した回数、指定した試行間隔でクリップボードにデータの貼り付けを試み、オプションで、アプリケーションが終了したときにクリップボードにデータを残したままにします。Clears the Clipboard and then attempts to place data on it the specified number of times and with the specified delay between attempts, optionally leaving the data on the Clipboard after the application exits.

SetFileDropList(StringCollection) SetFileDropList(StringCollection) SetFileDropList(StringCollection) SetFileDropList(StringCollection)

クリップボードをクリアし、ファイル名のコレクションを FileDrop 形式で追加します。Clears the Clipboard and then adds a collection of file names in the FileDrop format.

SetImage(Image) SetImage(Image) SetImage(Image) SetImage(Image)

クリップボードをクリアし、ImageBitmap 形式で追加します。Clears the Clipboard and then adds an Image in the Bitmap format.

SetText(String) SetText(String) SetText(String) SetText(String)

クリップボードをクリアし、オペレーティング システムに応じて、テキスト データを Text 形式または UnicodeText 形式で追加します。Clears the Clipboard and then adds text data in the Text or UnicodeText format, depending on the operating system.

SetText(String, TextDataFormat) SetText(String, TextDataFormat) SetText(String, TextDataFormat) SetText(String, TextDataFormat)

クリップボードをクリアし、テキスト データを、指定した TextDataFormat 値で示される形式で追加します。Clears the Clipboard and then adds text data in the format indicated by the specified TextDataFormat value.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象

こちらもご覧ください