Partilhar via

RichTextBox.CanPaste(DataFormats+Format) Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Determina se você pode colar informações da Área de Transferência no formato de dados especificado.

public:
 bool CanPaste(System::Windows::Forms::DataFormats::Format ^ clipFormat);
public bool CanPaste (System.Windows.Forms.DataFormats.Format clipFormat);
member this.CanPaste : System.Windows.Forms.DataFormats.Format -> bool
Public Function CanPaste (clipFormat As DataFormats.Format) As Boolean

Parâmetros

clipFormat
DataFormats.Format

Um dos valores de DataFormats.Format.

Retornos

Boolean

true se você puder colar dados da Área de Transferência no formato de dados especificado. Caso contrário, false.

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 do Windows. Por fim, o exemplo recupera o formato do Bitmap objeto, usa o CanPaste método para verificar 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 determinar se o conteúdo atual da Área de Transferência está em um formato de dados da Área de Transferência especificado antes de permitir que o usuário cole as informações no RichTextBox controle. Por exemplo, você pode criar um manipulador de eventos para um Popup evento de um comando MenuItem de colagem e usar esse método para determinar se a colagem MenuItem deve ser habilitada com base no tipo de dados na Área de Transferência.

Aplica-se a

Confira também