Clipboard Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

Clipboard.cs

Metódusokat biztosít a rendszer vágólapján lévő adatok elhelyezésére és lekérésére. Ez az osztály nem örökölhető.

public ref class Clipboard abstract sealed

public static class Clipboard

type Clipboard = class

Public Class Clipboard

Öröklődés

Object

Clipboard

Példák

Az alábbi kódpéldában metódusok segítségével Clipboard helyezhetők el az adatok, és lekérhetők a rendszer vágólapjáról. Ez a kód feltételezibutton1, button2textBox1hogy a rendszer létrehozta és textBox2 elhelyezte az űrlapon.

A button1_Click metódus meghívja SetDataObject a kijelölt szöveg beviteli mezőből való felvételét és a rendszer vágólapra helyezését.

A button2_Click metódus meghívja GetDataObject az adatokat a rendszer vágólapjáról való lekérésére. A kód a visszaadott adatokat használja IDataObject és DataFormats kinyeri, és megjeleníti az adatokat a következőben 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

Megjegyzések

Az osztályhoz Clipboard használandó előre definiált formátumok listáját az DataFormats osztályban találja.

Hívás SetDataObject adatok vágólapra helyezésére az aktuális tartalmának lecserélésével. Ha az adatok állandó másolatát a vágólapra szeretné helyezni, állítsa a paramétert a copy következőre true: .

Note

Ha több formátumban szeretné elhelyezni az adatokat a vágólapon, használja az osztályt vagy egy DataObject implementációt IDataObject . Helyezze az adatokat a vágólapra több formátumban, hogy maximalizálja annak a lehetőségét, hogy egy célalkalmazás, amelynek formátumkövetelményei esetleg nem ismertek, sikeresen lekérheti az adatokat.

Hívás GetDataObject adatok lekéréséhez a vágólapról. Az adatok az interfészt megvalósító objektumként lesznek IDataObject visszaadva. Az objektum adatainak kinyeréséhez használja a megadott IDataObject metódusokat és mezőket DataFormats . Ha nem ismeri a lekért adatok formátumát, hívja meg a GetFormatsIDataObject felület metódusát, hogy lekérje az összes olyan formátum listáját, amelyben az adatok találhatók. Ezután hívja meg a GetDataIDataObject felület metódusát, és adja meg az alkalmazás által használható formátumot.

Az Clipboard osztály további módszereket biztosít, amelyek megkönnyítik a rendszer vágólapjának használatát. Hívja meg a metódust, Clear hogy távolítsa el az összes adatot a vágólapról. Ha egy adott formátumú adatot szeretne hozzáadni a vágólaphoz, cserélje le a meglévő adatokat, hívja meg a megfelelő SetFormátum metódust, például SetTexthívja meg a SetData metódust a formátum megadásához. Ha egy adott formátumú adatot szeretne lekérni a vágólapról, először hívja meg a megfelelő ContainsFormátum metódust (például ContainsText) annak megállapításához, hogy a vágólap tartalmaz-e ilyen formátumú adatokat, majd hívja meg a megfelelő GetFormátum metódust (például GetText) az adatok lekéréséhez, ha a vágólap tartalmazza. A műveletek formátumának megadásához hívja meg inkább a metódusokat és ContainsData a GetData metódusokat.

Note

Minden Windows-alapú alkalmazás osztozik a vágólapon, így a tartalom változhat, amikor másik alkalmazásra vált.

Egy objektumnak szerializálhatónak kell lennie ahhoz, hogy a vágólapra kerüljön. Ha nem szerializálható objektumot ad át egy vágólap metódusnak, a metódus kivétel nélkül meghiúsul. További System.Runtime.Serialization információ a szerializálásról. Ha a célalkalmazás nagyon specifikus adatformátumot igényel, a szerializálási folyamat során az adatokhoz hozzáadott fejlécek megakadályozhatják, hogy az alkalmazás felismerje az adatokat. Az adatformátum megőrzéséhez adja hozzá az adatokat tömbként Byte , MemoryStream és adja át a MemoryStream metódusnak SetData .

A Clipboard osztály csak olyan szálakban használható, amelyek egyszálas szálapartman (STA) módra vannak beállítva. Az osztály használatához győződjön meg arról, hogy a Main metódus STAThreadAttribute attribútummal van megjelölve.

A vágólapon a metafájl formátumának használatakor különleges szempontokra lehet szükség. A DataObject osztály jelenlegi implementációjának korlátozása miatt előfordulhat, hogy a .NET-keretrendszer által használt metafájl-formátumot nem ismerik fel a régebbi metafájlformátumot használó alkalmazások. Ebben az esetben a Win32 vágólap alkalmazásprogramozási felületeivel (API-kkal) kell együttműködnie.

Metódusok

Name	Description
Clear()	Eltávolítja az összes adatot a vágólapról.
ContainsAudio()	Azt jelzi, hogy vannak-e adatok a vágólapon a WaveAudio formátumban.
ContainsData(String)	Azt jelzi, hogy a vágólapon vannak-e olyan adatok, amelyek a megadott formátumban vannak, vagy konvertálhatók erre a formátumra.
ContainsFileDropList()	Azt jelzi, hogy a vágólapon vannak-e olyan adatok, amelyek formátuma szerepel, vagy konvertálhatók erre a FileDrop formátumra.
ContainsImage()	Azt jelzi, hogy a vágólapon vannak-e olyan adatok, amelyek formátuma szerepel, vagy konvertálhatók erre a Bitmap formátumra.
ContainsText()	Azt jelzi, hogy a vágólapon vannak-e adatok az Text operációs rendszertől függően vagy UnicodeText formátumban.
ContainsText(TextDataFormat)	Azt jelzi, hogy vannak-e szöveges adatok a vágólapon a megadott TextDataFormat érték által jelzett formátumban.
GetAudioStream()	Lekéri a hangstreamet a vágólapról.
GetData(String)	Elavult. Adatokat kér le a vágólapról a megadott formátumban.
GetDataObject()	Lekéri a rendszer vágólapján jelenleg található adatokat.
GetFileDropList()	Fájlnevek gyűjteményét kéri le a vágólapról.
GetImage()	Kép lekérése a vágólapról.
GetText()	Az operációs rendszertől függően szöveges adatokat kér le a vágólapról Text az UnicodeText operációs rendszertől függően.
GetText(TextDataFormat)	Szöveges adatokat kér le a vágólapról a megadott TextDataFormat érték által jelzett formátumban.
SetAudio(Byte[])	Törli a vágólapot, majd hozzáad egy Byte tömböt a formátumhoz, WaveAudio miután átalakította azt egy Stream.
SetAudio(Stream)	Törli a vágólapot, majd hozzáad egy Stream formátumot WaveAudio .
SetData(String, Object)	Törli a vágólapot, majd a megadott formátumban adja hozzá az adatokat.
SetDataAsJson<T>(String, T)	Metódusokat biztosít a rendszer vágólapján lévő adatok elhelyezésére és lekérésére. Ez az osztály nem örökölhető.
SetDataObject(Object, Boolean, Int32, Int32)	Törli a vágólapot, majd megkísérli az adatokat a megadott számú alkalommal és a próbálkozások közötti késleltetéssel elhelyezni, és az alkalmazás kilépése után is meghagyja az adatokat a vágólapon.
SetDataObject(Object, Boolean)	Törli a vágólapot, majd adatokat helyez el rajta, és megadja, hogy az adatok megmaradjanak-e az alkalmazás kilépése után.
SetDataObject(Object)	Törli a vágólapot, majd nem állandó adatokat helyez el rajta.
SetFileDropList(StringCollection)	Törli a vágólapot, majd fájlnévgyűjteményt ad hozzá a FileDrop formátumhoz.
SetImage(Image)	Törli a vágólapot, majd hozzáad egy Image formátumot Bitmap .
SetText(String, TextDataFormat)	Törli a vágólapot, majd a megadott TextDataFormat érték által jelzett formátumban adja hozzá a szöveges adatokat.
SetText(String)	Törli a vágólapot, majd az operációs rendszertől függően szöveges adatokat Text ad hozzá vagy UnicodeText formáz.
TryGetData<T>(String, Func<TypeName,Type>, T)	Metódusokat biztosít a rendszer vágólapján lévő adatok elhelyezésére és lekérésére. Ez az osztály nem örökölhető.
TryGetData<T>(String, T)	Metódusokat biztosít a rendszer vágólapján lévő adatok elhelyezésére és lekérésére. Ez az osztály nem örökölhető.
TryGetData<T>(T)	Metódusokat biztosít a rendszer vágólapján lévő adatok elhelyezésére és lekérésére. Ez az osztály nem örökölhető.

Lásd még

• DataObject
• DataFormats
• IDataObject
• További biztonsági szempontok a Windows Forms