DataGridViewCell.GetClipboardContent Metodo

Definizione

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.

Si applica a

Vedi anche