Clipboard Sınıf

Tanım

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

Devralma

Object

Clipboard

Örnekler

Aşağıdaki kod örneği, verileri üzerine yerleştirmek ve sistem Panosu'ndan almak için yöntemleri kullanır Clipboard . Bu kod , , button2textBox1ve öğesinin oluşturulduğunu ve textBox2 forma yerleştirildiğini varsayarbutton1.

yöntemi, button1_Click seçili metni metin kutusundan alıp sistem Panosu'na yerleştirmeyi çağırır SetDataObject .

button2_Click yöntemi, sistem Panosu'ndan veri almak için öğesini çağırırGetDataObject. Kod, döndürülen verileri ayıklamak için ve DataFormats kullanır IDataObject ve içindeki textBox2verileri görüntüler.

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

Açıklamalar

sınıfıyla kullanılacak önceden tanımlanmış biçimlerin Clipboard listesi için sınıfına DataFormats bakın.

Geçerli içeriğini değiştirerek Pano'ya veri koymak için çağrısı SetDataObject . Verilerin kalıcı bir kopyasını Pano'ya yerleştirmek için parametresini copy olarak trueayarlayın.

Pano'dan veri almak için çağrısı GetDataObject . Veriler arabirimini uygulayan IDataObject bir nesne olarak döndürülür. nesnesinden verileri ayıklamak için ve alanları DataFormats tarafından IDataObject belirtilen yöntemleri kullanın. Aldığınız verilerin biçimini bilmiyorsanız, verilerin depolandığı tüm biçimlerin IDataObject listesini almak için arabiriminin yöntemini çağırınGetFormats. Ardından arabiriminin GetData yöntemini çağırın IDataObject ve uygulamanızın kullanabileceği bir biçim belirtin.

.NET Framework 2.0'da Clipboard sınıfı, sistem Panosu ile çalışmayı kolaylaştıran ek yöntemler sağlar. Pano'dan Clear tüm verileri kaldırmak için yöntemini çağırın. Pano'ya belirli bir biçimdeki verileri eklemek için, var olan verileri değiştirerek, gibi SetTextuygun SetFormat yöntemini çağırın veya biçimini belirtmek için yöntemini çağırınSetData. Pano'dan belirli bir biçimin verilerini almak için, önce Pano'nun bu biçimde veri içerip içermediğini belirlemek için uygun ContainsFormat yöntemini (örneğin ContainsText) çağırın ve ardından Panoda veri varsa verileri almak için uygun GetFormat yöntemini (örneğin GetText) çağırın. Bu işlemlerde biçimi belirtmek için bunun yerine ve GetData yöntemlerini çağırınContainsData.

Yöntemler

Şunlara uygulanır

Ayrıca bkz.

• DataObject
• DataFormats
• IDataObject
• Windows Forms'ta Ek Güvenlik Konuları