RichTextBox.Paste(DataFormats+Format) Metoda

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vloží obsah schránky do zadaného formátu schránky.

public:
 void Paste(System::Windows::Forms::DataFormats::Format ^ clipFormat);

public void Paste (System.Windows.Forms.DataFormats.Format clipFormat);

override this.Paste : System.Windows.Forms.DataFormats.Format -> unit

Public Sub Paste (clipFormat As DataFormats.Format)

Parametry

clipFormat: DataFormats.Format

Formát schránky, ve kterém mají být data získána ze schránky.

Příklady

Následující příklad kódu ukazuje, jak pomocí Paste metody vložit rastrový obrázek do RichTextBox ovládacího prvku. Po otevření rastrového obrázku ze souboru použije SetDataObject příklad metodu ke zkopírování rastrového obrázku do Windows schránky. Nakonec příklad načte formát objektu Bitmap , ověří, že formát lze vložit do RichTextBox ovládacího prvku a použije metodu Paste k vložení dat.

private:
   bool pasteMyBitmap( String^ fileName )
   {
      // Open an bitmap from file and copy it to the clipboard.
      Bitmap^ myBitmap = gcnew Bitmap( fileName );

      // Copy the bitmap to the clipboard.
      Clipboard::SetDataObject( myBitmap );

      // Get the format for the object type.
      DataFormats::Format^ myFormat = DataFormats::GetFormat( DataFormats::Bitmap );

      // After verifying that the data can be pasted, paste it.
      if ( richTextBox1->CanPaste( myFormat ) )
      {
         richTextBox1->Paste( myFormat );
         return true;
      }
      else
      {
         MessageBox::Show( "The data format that you attempted to paste is not supported by this control." );
         return false;
      }
   }

private bool pasteMyBitmap(string fileName)
{

    // Open an bitmap from file and copy it to the clipboard.
    Bitmap myBitmap = new Bitmap(fileName);
            
    // Copy the bitmap to the clipboard.
    Clipboard.SetDataObject(myBitmap);

    // Get the format for the object type.
    DataFormats.Format myFormat = DataFormats.GetFormat(DataFormats.Bitmap);

    // After verifying that the data can be pasted, paste it.
    if(richTextBox1.CanPaste(myFormat))
    {
        richTextBox1.Paste(myFormat);
        return true;
    }
    else
    {
        MessageBox.Show("The data format that you attempted to paste is not supported by this control.");
        return false;
    }
}

Private Function PasteMyBitmap(ByVal Filename As String) As Boolean

    'Open an bitmap from file and copy it to the clipboard.
    Dim MyBitmap As Bitmap
    MyBitmap = Bitmap.FromFile(Filename)

    ' Copy the bitmap to the clipboard.
    Clipboard.SetDataObject(MyBitmap)

    ' Get the format for the object type.
    Dim MyFormat As DataFormats.Format = DataFormats.GetFormat(DataFormats.Bitmap)

    ' After verifying that the data can be pasted, paste it.
    If RichTextBox1.CanPaste(MyFormat) Then

        RichTextBox1.Paste(MyFormat)
        PasteMyBitmap = True

    Else

        MessageBox.Show("The data format that you attempted to paste is not supported by this control.")
        PasteMyBitmap = False

    End If


End Function

Poznámky

Tuto metodu můžete použít k vložení dat ze schránky do ovládacího prvku. Tato verze Paste metody se liší od TextBoxBase.Paste metody, protože umožňuje vložit pouze text v zadaném formátu schránky. Pomocí této metody můžete CanPaste určit, jestli jsou data ve schránce v zadaném formátu schránky. Tuto verzi metody pak můžete volat, abyste měli jistotu Paste , že je operace vložení provedena s odpovídajícím formátem dat.

Platí pro