Clipboard Класс

Определение

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

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

Object

Clipboard

Примеры

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

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

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

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

Методы

Применяется к

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

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