RichTextBox.CanPaste(DataFormats+Format) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bestimmt, ob Sie Informationen aus der Zwischenablage im angegebenen Datenformat einfügen können.

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

Parameter

clipFormat: DataFormats.Format

Einer der DataFormats.Format-Werte.

Gibt zurück

Boolean

true, wenn Sie Daten aus der Zwischenablage im angegebenen Datenformat einfügen können, andernfalls false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Paste -Methode verwenden, um eine Bitmap in das RichTextBox Steuerelement einzufügen. Nach dem Öffnen einer Bitmap aus einer Datei wird im Beispiel die SetDataObject -Methode verwendet, um die Bitmap in die Windows-Zwischenablage zu kopieren. Schließlich ruft das Beispiel das Format für das Bitmap -Objekt ab, verwendet die CanPaste -Methode, um zu überprüfen, ob das Format in das RichTextBox Steuerelement eingefügt werden kann, und verwendet dann die Paste -Methode, um die Daten einzufügen.

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

Hinweise

Mit dieser Methode können Sie bestimmen, ob sich der aktuelle Inhalt der Zwischenablage in einem angegebenen Zwischenablagedatenformat befindet, bevor der Benutzer die Informationen in das RichTextBox Steuerelement einfügen kann. Beispielsweise können Sie einen Ereignishandler für ein Popup Ereignis eines Paste-Befehls MenuItem erstellen und mithilfe dieser Methode bestimmen, ob das Einfügen MenuItem basierend auf dem Datentyp in der Zwischenablage aktiviert werden soll.

Gilt für: