RichTextBox.CanPaste(DataFormats+Format) Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Determina se è possibile incollare informazioni dagli Appunti nel formato di dati specificato.

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

Parametri

clipFormat

DataFormats.Format

Uno dei valori di DataFormats.Format.

Restituisce

Boolean

true se è possibile incollare dati dagli Appunti nel formato di dati specificato; in caso contrario, false.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il Paste metodo per incollare una bitmap nel RichTextBox controllo . Dopo aver aperto una bitmap dal file, nell'esempio viene usato il SetDataObject metodo per copiare la bitmap negli Appunti di Windows. Infine, l'esempio recupera il formato per l'oggetto Bitmap , usa il CanPaste metodo per verificare che il formato possa essere incollato nel RichTextBox controllo e quindi usa il Paste metodo per incollare i dati.

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

Commenti

È possibile utilizzare questo metodo per determinare se il contenuto corrente degli Appunti si trova in un formato di dati degli Appunti specificato prima di consentire all'utente di incollare le informazioni nel RichTextBox controllo. Ad esempio, è possibile creare un gestore eventi per un Popup evento di un comando MenuItem Incolla e usare questo metodo per determinare se il incolla MenuItem deve essere abilitato in base al tipo di dati negli Appunti.

Vedi anche

• Paste(DataFormats+Format)
• DataFormats.Format