Clipboard Třída

Definice

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

Dědičnost

Object

Clipboard

Příklady

Následující příklad kódu používá Clipboard metody k umístění dat a jejich načtení ze systémové schránky. Tento kód předpokládá button1, , button2textBox1a byly vytvořeny a textBox2 umístěny ve formuláři.

Volání button1_Click metody, SetDataObject která vezme vybraný text z textového pole a umístí ho do systémové schránky.

Metoda button2_Click volá GetDataObject načtení dat ze systémové schránky. Kód používá IDataObject a DataFormats extrahuje vrácená data a zobrazí data v 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

Poznámky

Seznam předdefinovaných formátů, které se mají použít s Clipboard třídou, najdete v DataFormats této třídě.

Volání SetDataObject pro vložení dat do schránky a nahrazení jejího aktuálního obsahu Chcete-li umístit trvalou kopii dat do schránky, nastavte copy parametr na true.

Volání GetDataObject pro načtení dat ze schránky Data se vrátí jako objekt, který implementuje IDataObject rozhraní. Pomocí metod určených podle IDataObject polí DataFormats extrahujte data z objektu. Pokud neznáte formát načtených dat, zavolejte GetFormats metodu IDataObject rozhraní a získejte seznam všech formátů, ve kterých jsou data uložená. Potom zavolejte GetData metodu IDataObject rozhraní a zadejte formát, který může vaše aplikace použít.

Třída Clipboard poskytuje další metody, které usnadňují práci se systémovou schránkou. Clear Voláním metody odeberte všechna data ze schránky. Chcete-li do schránky přidat data určitého formátu, nahraďte stávající data voláním příslušné Set metody Format, například SetTextnebo voláním SetData metody určit formát. Chcete-li načíst data určitého formátu ze schránky, nejprve zavolejte příslušnou Contains metodu Format (napříkladContainsText) k určení, zda schránka obsahuje data v tomto formátu, a potom zavolejte příslušnou Get metodu Format (napříkladGetText) pro načtení dat, pokud je schránka obsahuje. Chcete-li zadat formát v těchto operacích, volejte ContainsData místo toho metody a GetData metody.

Viz také

• DataObject
• DataFormats
• IDataObject
• další aspekty zabezpečení ve model Windows Forms