Clipboard Класс

Определение

public ref class Clipboard sealed

public sealed class Clipboard

type Clipboard = class

Public NotInheritable Class Clipboard

Наследование

Object

Clipboard

Примеры

В следующем примере кода используются Clipboard методы для размещения данных и извлечения их из системного буфера обмена. Этот код предполагает button1, button2textBox1и textBox2 был создан и помещен в форму.

Метод button1_Click вызывает SetDataObject выделенный текст из текстового поля и помещать его в системный буфер обмена.

Метод button2_Click вызывает GetDataObject получение данных из системного буфера обмена. Код использует и DataFormats извлекает IDataObject возвращаемые данные и отображает данные в 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 интерфейс. Используйте методы, указанные IDataObject и поля, DataFormats для извлечения данных из объекта. Если вы не знаете формат полученных данных, вызовите GetFormats метод IDataObject интерфейса, чтобы получить список всех форматов, в которые хранятся данные. Затем вызовите GetData метод IDataObject интерфейса и укажите формат, который может использовать приложение.

Класс Clipboard предоставляет дополнительные методы, упрощающие работу с системным буфером обмена. Clear Вызовите метод, чтобы удалить все данные из буфера обмена. Чтобы добавить данные определенного формата в буфер обмена, заменив существующие данные, вызовите соответствующий Set метод Format, например SetTextили вызовите SetData метод, чтобы указать формат. Чтобы получить данные определенного формата из буфера обмена, сначала вызовите соответствующий Contains метод Format (напримерContainsText), чтобы определить, содержит ли буфер обмена данные в этом формате, а затем вызовите соответствующий Get метод Format (напримерGetText), чтобы получить данные, если буфер обмена содержит его. Чтобы указать формат в этих операциях, вызовите ContainsData вместо него методы и GetData методы.

См. также раздел

• DataObject
• DataFormats
• IDataObject
• дополнительные вопросы безопасности в Windows Forms