DataGridViewCell.GetClipboardContent 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.
Recupera il valore formattato della cella da copiare nell'oggetto Clipboard.
protected:
virtual System::Object ^ GetClipboardContent(int rowIndex, bool firstCell, bool lastCell, bool inFirstRow, bool inLastRow, System::String ^ format);
protected virtual object GetClipboardContent (int rowIndex, bool firstCell, bool lastCell, bool inFirstRow, bool inLastRow, string format);
protected virtual object? GetClipboardContent (int rowIndex, bool firstCell, bool lastCell, bool inFirstRow, bool inLastRow, string format);
abstract member GetClipboardContent : int * bool * bool * bool * bool * string -> obj
override this.GetClipboardContent : int * bool * bool * bool * bool * string -> obj
Protected Overridable Function GetClipboardContent (rowIndex As Integer, firstCell As Boolean, lastCell As Boolean, inFirstRow As Boolean, inLastRow As Boolean, format As String) As Object
Parametri
- rowIndex
- Int32
Indice in base zero della riga contenente la cella.
- firstCell
- Boolean
true
per indicare che la cella è nella prima colonna dell'area definita dalle celle selezionate; in caso contrario, false
.
- lastCell
- Boolean
true
per indicare che la cella è nell'ultima colonna dell'area definita dalle celle selezionate; in caso contrario, false
.
- inFirstRow
- Boolean
true
per indicare che la cella è nella prima riga dell'area definita dalle celle selezionate; in caso contrario, false
.
- inLastRow
- Boolean
true
per indicare che la cella è nell'ultima riga dell'area definita dalle celle selezionate; in caso contrario, false
.
- format
- String
Stringa di formato corrente della cella.
Restituisce
Classe Object che rappresenta il valore della cella da copiare nella classe Clipboard.
Eccezioni
Il parametro rowIndex
è minore di 0 oppure è maggiore o uguale al numero di righe nel controllo.
Il valore della proprietà DataGridView della cella è null
.
-oppure-
La proprietà ColumnIndex è minore di 0, a indicare che la cella è un cella di intestazione di riga.
La formattazione non è riuscita e non esiste alcun gestore per l'evento DataError del controllo DataGridView oppure il gestore ha impostato la proprietà ThrowException su true
. In genere è possibile eseguire il cast dell'oggetto eccezione al tipo FormatException.
Commenti
Questo metodo viene chiamato dal DataGridView.GetClipboardContent metodo per recuperare un valore formattato dagli Appunti che rappresenta il valore della cella.
Il valore della GetEditedFormattedValue cella viene prima recuperato nel formato visualizzato dal metodo . Questo può generare l'evento per formattare il valore e l'evento DataGridView.CellFormatting se la DataGridView.DataError formattazione non è riuscita.
I parametri correlati alla posizione di questo metodo indicano dove questa cella si trova nella tabella dei dati che rappresentano l'area definita dalle celle selezionate nel DataGridView controllo. A seconda della posizione della cella, è possibile restituire informazioni aggiuntive sulla formattazione tramite questo metodo insieme al valore della cella formattato dalla visualizzazione. Ad esempio, il formato HTML per una cella nella prima colonna di una riga includerà il tag che indica l'inizio di una riga.
I formati supportati negli Appunti includono DataFormats.Text, , DataFormats.UnicodeTextDataFormats.Htmle DataFormats.CommaSeparatedValue.
Per altre informazioni, vedere la classe Clipboard.
Note per gli eredi
Eseguire l'override di questo metodo per fornire valori personalizzati degli Appunti. Ad esempio, è possibile eseguire l'override di questo metodo per supportare la copia dei valori dai tipi di cella personalizzati.