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 、 button2 、 textBox1 和 textBox2 已建立並放在表單上。

方法 button1_Click 會呼叫 SetDataObject 以從文字方塊取得選取的文字，並將它放在系統剪貼簿上。

方法 button2_Click 會呼叫 GetDataObject 以從系統剪貼簿擷取資料。 程式碼會使用 IDataObject 和 DataFormats 來擷取傳回的資料，並在 中 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 介面的物件的形式傳回。 使用 中的 DataFormats 和 欄位所指定 IDataObject 的方法，從 物件擷取資料。 如果您不知道所擷取的資料格式，請呼叫 GetFormats 介面的 IDataObject 方法，以取得儲存資料的所有格式清單。 然後呼叫 GetData 介面的 IDataObject 方法，並指定您的應用程式可以使用的格式。

在 .NET Framework 2.0 中，類別 Clipboard 提供其他方法，讓您更輕鬆地使用系統剪貼簿。 Clear呼叫 方法，從剪貼簿中移除所有資料。 若要將特定格式的資料新增至剪貼簿，請取代現有的資料、呼叫適當的 SetFormat方法，例如 SetText ，或呼叫 SetData 方法來指定格式。 若要從剪貼簿擷取特定格式的資料，請先呼叫適當的 ContainsFormat方法 (例如 ContainsText) 方法，以判斷剪貼簿是否包含該格式的資料，然後呼叫適當的 GetFormat方法 (，例如 GetText) ，以在剪貼簿包含資料時擷取資料。 若要在這些作業中指定格式，請改為呼叫 ContainsData 和 GetData 方法。

方法

適用於

另請參閱

• DataObject
• DataFormats
• IDataObject
• Windows Form 中的其他安全性考量