Partager via


RichTextBox.CanPaste(DataFormats+Format) Méthode

Définition

Détermine si vous pouvez coller des informations du Presse-papiers dans le format de données spécifié.

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

Paramètres

clipFormat
DataFormats.Format

Une des valeurs de l'objet DataFormats.Format.

Retours

true si vous pouvez coller des données provenant du Presse-papiers dans le format de données spécifié ; sinon, false.

Exemples

L’exemple de code suivant montre comment utiliser la Paste méthode pour coller une bitmap dans le RichTextBox contrôle . Après avoir ouvert une bitmap à partir d’un fichier, l’exemple utilise la SetDataObject méthode pour copier la bitmap dans le Presse-papiers Windows. Enfin, l’exemple récupère le format de l’objet Bitmap , utilise la CanPaste méthode pour vérifier que le format peut être collé dans le RichTextBox contrôle, puis utilise la Paste méthode pour coller les données.

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 déterminer si le contenu actuel du Presse-papiers est dans un format de données du Presse-papiers spécifié avant de permettre à l’utilisateur de coller les informations dans le RichTextBox contrôle. Par exemple, vous pouvez créer un gestionnaire d’événements pour un Popup événement d’une commande MenuItem paste et utiliser cette méthode pour déterminer si le collage MenuItem doit être activé en fonction du type de données dans le Presse-papiers.

S’applique à

Voir aussi