Clipboard Kelas

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll
Sumber:
Clipboard.cs
Sumber:
Clipboard.cs
Sumber:
Clipboard.cs
Sumber:
Clipboard.cs
Sumber:
Clipboard.cs

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

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
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 button1_Click memanggil SetDataObject 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 menempatkan data pada Clipboard, menggantikan isinya saat ini. Untuk menempatkan salinan data persisten di Clipboard, atur parameter ke copytrue.

Note

Untuk menempatkan data di Clipboard dalam beberapa format, gunakan DataObject kelas atau IDataObject implementasi. Tempatkan data di Clipboard dalam beberapa format untuk memaksimalkan kemungkinan 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.

Kelas ini Clipboard menyediakan metode tambahan yang memudahkan untuk bekerja dengan sistem Clipboard. Clear Panggil metode untuk menghapus semua data dari Clipboard. Untuk menambahkan data format tertentu ke Clipboard, ganti data yang ada, panggil metode Set yang sesuai, seperti SetText, atau panggil SetData metode untuk menentukan format. Untuk mengambil data format tertentu dari Clipboard, pertama-tama panggil metode Contains yang sesuai (seperti ContainsText) untuk menentukan apakah Clipboard berisi data dalam format tersebut, lalu panggil metode Get yang sesuai (seperti GetText) untuk mengambil data jika Clipboard berisinya. Untuk menentukan format dalam operasi ini, panggil ContainsData metode dan GetData sebagai gantinya.

Note

Semua aplikasi berbasis Windows berbagi sistem Clipboard, sehingga konten dapat berubah saat 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 disetel ke mode apartemen utas tunggal (STA). Untuk menggunakan kelas ini, pastikan bahwa metode Main Anda ditandai dengan atribut STAThreadAttribute.

Pertimbangan khusus mungkin diperlukan saat menggunakan format metafile dengan Clipboard. Karena keterbatasan dalam implementasi kelas DataObject 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 (API) Win32 Clipboard.

Metode

Nama Deskripsi
Clear()

Menghapus semua data dari Clipboard.
ContainsAudio()

Menunjukkan apakah ada data di 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 di 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)
Kedaluwarsa.

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 ke Stream.
SetAudio(Stream)

Bersihkan Papan Klip lalu tambahkan Stream dalam WaveAudio format .
SetData(String, Object)

Menghapus Clipboard lalu menambahkan data dalam format yang ditentukan.
SetDataAsJson<T>(String, T)

Menyediakan metode untuk menempatkan data dan mengambil data dari Clipboard sistem. Kelas ini tidak dapat diwariskan.
SetDataObject(Object, Boolean, Int32, Int32)

Menghapus Clipboard lalu mencoba menempatkan data di dalamnya berapa kali dan dengan penundaan yang ditentukan antara upaya, secara opsional meninggalkan data di Clipboard setelah aplikasi keluar.
SetDataObject(Object, Boolean)

Menghapus Clipboard lalu menempatkan data di dalamnya dan menentukan apakah data harus tetap ada setelah aplikasi keluar.
SetDataObject(Object)

Menghapus Clipboard lalu menempatkan data yang tidak konsisten di dalamnya.
SetFileDropList(StringCollection)

Menghapus Clipboard lalu menambahkan kumpulan nama file dalam FileDrop format.
SetImage(Image)

Bersihkan Papan Klip lalu tambahkan Image dalam Bitmap format.
SetText(String, TextDataFormat)

Menghapus Clipboard lalu menambahkan data teks dalam format yang ditunjukkan oleh nilai yang ditentukan TextDataFormat .
SetText(String)

Menghapus Clipboard lalu menambahkan data teks dalam Text format atau UnicodeText , tergantung pada sistem operasi.
TryGetData<T>(String, Func<TypeName,Type>, T)

Menyediakan metode untuk menempatkan data dan mengambil data dari Clipboard sistem. Kelas ini tidak dapat diwariskan.
TryGetData<T>(String, T)

Menyediakan metode untuk menempatkan data dan mengambil data dari Clipboard sistem. Kelas ini tidak dapat diwariskan.
TryGetData<T>(T)

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

Berlaku untuk

Lihat juga