RichTextBox.CanPaste(DataFormats+Format) Methode

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

Parameters

Retouren

true als u gegevens van het Klembord in de opgegeven gegevensindeling kunt plakken; anders, false.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de Paste methode gebruikt om een bitmap in het RichTextBox besturingselement te plakken. Nadat u een bitmap uit het bestand hebt geopend, wordt in het voorbeeld de methode SetDataObject gebruikt om de bitmap naar het Windows klembord te kopiëren. Ten slotte wordt in het voorbeeld de indeling voor het Bitmap object opgehaald, wordt de CanPaste methode gebruikt om te controleren of de indeling in het RichTextBox besturingselement kan worden geplakt en wordt vervolgens de Paste methode gebruikt om de gegevens te plakken.

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

Opmerkingen

U kunt deze methode gebruiken om te bepalen of de huidige inhoud van het Klembord een opgegeven gegevensindeling van het Klembord heeft voordat de gebruiker de informatie in het RichTextBox besturingselement kan plakken. U kunt bijvoorbeeld een gebeurtenis-handler maken voor een gebeurtenis van een Popup plakopdracht MenuItem en deze methode gebruiken om te bepalen of de plakken MenuItem moet worden ingeschakeld op basis van het type gegevens in het Klembord.

Zie ook

• Paste(DataFormats+Format)
• DataFormats.Format