RichTextBox.CanPaste(DataFormats+Format) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Określa, czy można wkleić informacje ze Schowka w określonym formacie danych.
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
Parametry
- clipFormat
- DataFormats.Format
DataFormats.Format Jedna z wartości.
Zwraca
true
jeśli możesz wkleić dane ze Schowka w określonym formacie danych; w przeciwnym razie , false
.
Przykłady
W poniższym przykładzie kodu pokazano, jak za pomocą Paste metody wkleić mapę bitową do kontrolki RichTextBox . Po otwarciu mapy bitowej z pliku przykład używa SetDataObject metody , aby skopiować mapę bitową do schowka systemu Windows. Na koniec przykład pobiera format obiektu Bitmap , używa CanPaste metody , aby sprawdzić, czy format można wkleić do RichTextBox kontrolki, a następnie używa Paste metody do wklejania danych.
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
Uwagi
Za pomocą tej metody można określić, czy bieżąca zawartość Schowka znajduje się w określonym formacie danych Schowka przed włączeniem użytkownikowi wklejenia informacji do kontrolki RichTextBox . Można na przykład utworzyć program obsługi zdarzeń dla Popup zdarzenia polecenia MenuItem wklejania i użyć tej metody, aby określić, czy wklejanie MenuItem powinno być włączone na podstawie typu danych w Schowku.