RichTextBox.Paste(DataFormats+Format) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Incolla il contenuto degli Appunti nel formato degli Appunti specificato.
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)
Parametri
- clipFormat
- DataFormats.Format
Formato degli Appunti in cui devono essere ottenuti i dati dagli Appunti.
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 , verifica che il formato possa essere incollato nel RichTextBox controllo e 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 incollare i dati dagli Appunti nel controllo . Questa versione del Paste metodo è diversa dal TextBoxBase.Paste metodo perché consente di incollare solo il testo in un formato specificato negli Appunti. È possibile utilizzare il CanPaste metodo per determinare se i dati all'interno degli Appunti sono nel formato degli Appunti specificato. È quindi possibile chiamare questa versione del Paste metodo per assicurarsi che l'operazione incolla venga eseguita con il formato di dati appropriato.