RichTextBox.Paste(DataFormats+Format) RichTextBox.Paste(DataFormats+Format) RichTextBox.Paste(DataFormats+Format) RichTextBox.Paste(DataFormats+Format) Method

Définition

Colle le contenu du Presse-papiers dans le format de Presse-papiers spécifié.Pastes the contents of the Clipboard in the specified Clipboard format.

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)

Paramètres

clipFormat
DataFormats.Format DataFormats.Format DataFormats.Format DataFormats.Format

Format de Presse-papiers dans lequel les données doivent être obtenues du Presse-papiers.The Clipboard format in which the data should be obtained from the Clipboard.

Exemples

L’exemple de code suivant montre comment utiliser la Paste méthode pour coller une image bitmap dans RichTextBox le contrôle.The following code example demonstrates how to use the Paste method to paste a bitmap into the RichTextBox control. Après avoir ouvert une image bitmap à partir d’un fichier SetDataObject , l’exemple utilise la méthode pour copier l’image bitmap dans le presse-papiers Windows.After opening a bitmap from file, the example uses the SetDataObject method to copy the bitmap to the Windows clipboard. Enfin, l’exemple récupère le format de l' Bitmap objet, vérifie que le format peut être collé dans le RichTextBox contrôle et utilise la Paste méthode pour coller les données.Finally, the example retrieves the format for the Bitmap object, verifies that the format can be pasted into the RichTextBox control, and uses the Paste method to paste the data.

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

Remarques

Vous pouvez utiliser cette méthode pour coller des données du presse-papiers dans le contrôle.You can use this method to paste data from the clipboard into the control. Cette version de la Paste méthode est différente de la TextBoxBase.Paste méthode, car elle vous permet de coller uniquement du texte dans un format de presse-papiers spécifié.This version of the Paste method is different from the TextBoxBase.Paste method as it enables you to paste only text in a specified Clipboard format. Vous pouvez utiliser la CanPaste méthode pour déterminer si les données dans le presse-papiers sont dans le format de presse-papiers spécifié.You can use the CanPaste method to determine whether the data within the Clipboard is in the specified Clipboard format. Vous pouvez ensuite appeler cette version de la Paste méthode pour vous assurer que l’opération de collage est effectuée avec le format de données approprié.You can then call this version of the Paste method to ensure that the paste operation is made with the appropriate data format.

Sécurité

UIPermission
pour la lecture à partir du presse-papiers.for reading from the Clipboard. Énumération associée : AllClipboard valeur de UIPermissionClipboard.Associated enumeration: the AllClipboard value of UIPermissionClipboard.

S’applique à

Voir aussi