Clipboard Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menyediakan metode untuk menempatkan data dan mengambil data dari Clipboard sistem. Kelas ini tidak dapat diwariskan.

public ref class Clipboard abstract sealed

public static class Clipboard

type Clipboard = class

Public Class Clipboard

Warisan

Object

Clipboard

Contoh

Contoh kode berikut menggunakan Clipboard metode untuk menempatkan data dan mengambilnya dari Clipboard sistem. Kode ini mengasumsikan button1, button2, textBox1, dan textBox2 telah dibuat dan ditempatkan pada formulir.

Metode memanggil button1_ClickSetDataObject untuk mengambil teks yang dipilih dari kotak teks dan menempatkannya di Clipboard sistem.

Metode ini button2_Click memanggil GetDataObject untuk mengambil data dari Clipboard sistem. Kode menggunakan IDataObject dan DataFormats untuk mengekstrak data yang dikembalikan dan menampilkan data di 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

Keterangan

Untuk daftar format yang telah ditentukan sebelumnya untuk digunakan dengan Clipboard kelas , lihat DataFormats kelas .

Panggil SetDataObject untuk meletakkan data pada Papan klip, menggantikan isinya saat ini. Untuk menempatkan salinan data persisten di Clipboard, atur parameter ke copytrue.

Catatan

Untuk menempatkan data di Clipboard dalam beberapa format, gunakan DataObject kelas atau IDataObject implementasi. Tempatkan data di Clipboard dalam beberapa format untuk memaksimalkan kemungkinan bahwa aplikasi target, yang persyaratan formatnya mungkin tidak Anda ketahui, dapat berhasil mengambil data.

Panggil GetDataObject untuk mengambil data dari Clipboard. Data dikembalikan sebagai objek yang mengimplementasikan IDataObject antarmuka. Gunakan metode yang ditentukan oleh IDataObject dan bidang di DataFormats untuk mengekstrak data dari objek . Jika Anda tidak tahu format data yang Anda ambil, panggil GetFormats metode IDataObject antarmuka untuk mendapatkan daftar semua format tempat data disimpan. Kemudian panggil GetData metode IDataObject antarmuka, dan tentukan format yang dapat digunakan aplikasi Anda.

Dalam .NET Framework 2.0, Clipboard kelas menyediakan metode tambahan yang membuatnya lebih mudah untuk bekerja dengan sistem Clipboard. Clear Panggil metode untuk menghapus semua data dari Clipboard. Untuk menambahkan data dari format tertentu ke Clipboard, mengganti data yang ada, panggil metode Format yang sesuaiSet, seperti SetText, atau panggil SetData metode untuk menentukan format. Untuk mengambil data format tertentu dari Clipboard, pertama-tama panggil metode Format yang sesuai Contains (seperti ContainsText) metode untuk menentukan apakah Clipboard berisi data dalam format tersebut, lalu panggil metode Format yang sesuai Get (seperti GetText) untuk mengambil data jika Clipboard berisinya. Untuk menentukan format dalam operasi ini, panggil ContainsData metode dan GetData sebagai gantinya.

Catatan

Semua aplikasi berbasis Windows berbagi Clipboard sistem, sehingga isi dapat berubah ketika Anda beralih ke aplikasi lain.

Objek harus dapat diserialisasikan agar diletakkan di Papan Klip. Jika Anda meneruskan objek yang tidak dapat diserialisasikan ke metode Clipboard, metode akan gagal tanpa melemparkan pengecualian. Lihat System.Runtime.Serialization untuk informasi selengkapnya tentang serialisasi. Jika aplikasi target Anda memerlukan format data yang sangat spesifik, header yang ditambahkan ke data dalam proses serialisasi dapat mencegah aplikasi mengenali data Anda. Untuk mempertahankan format data Anda, tambahkan data Anda sebagai Byte array ke MemoryStream dan teruskan MemoryStream ke SetData metode .

Kelas Clipboard hanya dapat digunakan dalam utas yang diatur ke mode apartemen rangkaian tunggal (STA). Untuk menggunakan kelas ini, pastikan metode Anda Main ditandai dengan STAThreadAttribute atribut .

Pertimbangan khusus mungkin diperlukan saat menggunakan format metafile dengan Clipboard. Karena keterbatasan dalam implementasi DataObject kelas saat ini, format metafile yang digunakan oleh .NET Framework mungkin tidak dikenali oleh aplikasi yang menggunakan format metafile yang lebih lama. Dalam hal ini, Anda harus beroperasi dengan antarmuka pemrograman aplikasi Win32 Clipboard (API).

Metode

Clear()	Menghapus semua data dari Clipboard.
ContainsAudio()	Menunjukkan apakah ada data pada Clipboard dalam WaveAudio format .
ContainsData(String)	Menunjukkan apakah ada data di Clipboard yang dalam format yang ditentukan atau dapat dikonversi ke format tersebut.
ContainsFileDropList()	Menunjukkan apakah ada data di Clipboard yang dalam format atau dapat dikonversi ke format tersebut FileDrop .
ContainsImage()	Menunjukkan apakah ada data di Clipboard yang dalam format atau dapat dikonversi ke format tersebut Bitmap .
ContainsText()	Menunjukkan apakah ada data pada Clipboard dalam Text format atau UnicodeText , tergantung pada sistem operasi.
ContainsText(TextDataFormat)	Menunjukkan apakah ada data teks pada Clipboard dalam format yang ditunjukkan oleh nilai yang ditentukan TextDataFormat .
GetAudioStream()	Mengambil aliran audio dari Clipboard.
GetData(String)	Mengambil data dari Clipboard dalam format yang ditentukan.
GetDataObject()	Mengambil data yang saat ini ada di Clipboard sistem.
GetFileDropList()	Mengambil kumpulan nama file dari Clipboard.
GetImage()	Mengambil gambar dari Clipboard.
GetText()	Mengambil data teks dari Clipboard dalam Text format atau UnicodeText , tergantung pada sistem operasi.
GetText(TextDataFormat)	Mengambil data teks dari Clipboard dalam format yang ditunjukkan oleh nilai yang ditentukan TextDataFormat .
SetAudio(Byte[])	Menghapus Clipboard lalu menambahkan Byte array dalam WaveAudio format setelah mengonversinya menjadi Stream.
SetAudio(Stream)	Bersihkan Papan klip lalu tambahkan Stream dalam WaveAudio format.
SetData(String, Object)	Menghapus Clipboard lalu menambahkan data dalam format yang ditentukan.
SetDataObject(Object)	Menghapus Clipboard lalu menempatkan data yang tidak konsisten di dalamnya.
SetDataObject(Object, Boolean)	Menghapus Clipboard lalu menempatkan data di atasnya dan menentukan apakah data harus tetap ada setelah aplikasi keluar.
SetDataObject(Object, Boolean, Int32, Int32)	Menghapus Clipboard dan kemudian mencoba menempatkan data di atasnya beberapa kali dan dengan penundaan yang ditentukan antara upaya, secara opsional meninggalkan data di Clipboard setelah aplikasi keluar.
SetFileDropList(StringCollection)	Bersihkan Papan klip lalu tambahkan kumpulan nama file dalam FileDrop format.
SetImage(Image)	Bersihkan Papan Klip lalu tambahkan Image dalam Bitmap format.
SetText(String)	Menghapus Clipboard lalu menambahkan data teks dalam Text format atau UnicodeText , tergantung pada sistem operasi.
SetText(String, TextDataFormat)	Menghapus Clipboard lalu menambahkan data teks dalam format yang ditunjukkan oleh nilai yang ditentukan TextDataFormat .

Lihat juga

• DataObject
• DataFormats
• IDataObject
• Pertimbangan Keamanan Tambahan dalam Formulir Windows