Partilhar via


RichTextBox.Paste(DataFormats+Format) Método

Definição

Cola o conteúdo da Área de Transferência no formato de Área de Transferência especificado.

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)

Parâmetros

clipFormat
DataFormats.Format

O formato da Área de Transferência no qual os dados devem ser obtidos da Área de Transferência.

Exemplos

O exemplo de código a seguir demonstra como usar o Paste método para colar um bitmap no RichTextBox controle. Depois de abrir um bitmap do arquivo, o exemplo usa o SetDataObject método para copiar o bitmap para a área de transferência Windows. Por fim, o exemplo recupera o formato do Bitmap objeto, verifica se o formato pode ser colado no RichTextBox controle e usa o Paste método para colar os dados.

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

Comentários

Você pode usar esse método para colar dados da área de transferência no controle. Essa versão do Paste método é diferente do TextBoxBase.Paste método, pois permite que você cole apenas texto em um formato de área de transferência especificado. Você pode usar o CanPaste método para determinar se os dados dentro da Área de Transferência estão no formato de área de transferência especificado. Em seguida, você pode chamar essa versão do Paste método para garantir que a operação de colagem seja feita com o formato de dados apropriado.

Aplica-se a

Confira também