Clipboard クラス

定義

public ref class Clipboard sealed

public ref class Clipboard abstract sealed

public sealed class Clipboard

public static class Clipboard

type Clipboard = class

Public NotInheritable Class Clipboard

Public Class Clipboard

継承

Object

Clipboard

例

次のコード例では、 メソッドを使用 Clipboard してデータを配置し、システムクリップボードから取得します。 このコードは、button1、、textBox1button2、 textBox2 が作成され、フォームに配置されていることを前提としています。

メソッドは button1_Click を呼び出 SetDataObject して、テキスト ボックスから選択したテキストを取得し、システムクリップボードに配置します。

メソッドは button2_Click を呼び出 GetDataObject して、システムクリップボードからデータを取得します。 コードでは、 と DataFormats を使用IDataObjectして返されたデータを抽出し、 に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
 
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

注釈

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

を呼び出 SetDataObject してクリップボードにデータを配置し、現在の内容を置き換えます。 クリップボードにデータの永続的なコピーを配置するには、 パラメーターを copy に true設定します。

を呼び出 GetDataObject して、クリップボードからデータを取得します。 データは、 インターフェイスを実装 IDataObject するオブジェクトとして返されます。 および フィールドでIDataObjectDataFormats指定されたメソッドを使用して、 オブジェクトからデータを抽出します。 取得したデータの形式がわからない場合は、 インターフェイスの メソッドIDataObjectをGetFormats呼び出して、データが格納されているすべての形式の一覧を取得します。 次に、 GetData インターフェイスの メソッドを IDataObject 呼び出し、アプリケーションで使用できる形式を指定します。

.NET Framework 2.0 では、 クラスには、Clipboardシステムクリップボードの操作を容易にする追加のメソッドが用意されています。 メソッドを Clear 呼び出して、クリップボードからすべてのデータを削除します。 クリップボードに特定の形式のデータを追加するには、既存のデータを置き換え、適切な SetFormat メソッド (など SetText) を呼び出すか、 メソッドを SetData 呼び出して形式を指定します。 クリップボードから特定の形式のデータを取得するには、最初に適切な ContainsFormat メソッド (など ContainsText) を呼び出して、クリップボードにその形式のデータが含まれているかどうかを判断してから、適切な GetFormat メソッド (など GetText) を呼び出して、クリップボードにデータが含まれている場合にデータを取得します。 これらの操作で形式を指定するには、代わりに メソッドと GetData メソッドを呼び出ContainsDataします。

メソッド

適用対象

こちらもご覧ください

• DataObject
• DataFormats
• IDataObject
• Windows フォームのセキュリティに関するその他の考慮事項