DataGridViewCell.GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String) Metodo

Definizione

Recupera il valore formattato della cella da copiare nell'oggetto Clipboard.Retrieves the formatted value of the cell to copy to the 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);
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.The zero-based index of the row containing the cell.

firstCell
Boolean

true per indicare che la cella è nella prima colonna dell'area definita dalle celle selezionate; in caso contrario, false.true to indicate that the cell is in the first column of the region defined by the selected cells; otherwise, false.

lastCell
Boolean

true per indicare che la cella è nell'ultima colonna dell'area definita dalle celle selezionate; in caso contrario, false.true to indicate that the cell is the last column of the region defined by the selected cells; otherwise, false.

inFirstRow
Boolean

true per indicare che la cella è nella prima riga dell'area definita dalle celle selezionate; in caso contrario, false.true to indicate that the cell is in the first row of the region defined by the selected cells; otherwise, false.

inLastRow
Boolean

true per indicare che la cella è nell'ultima riga dell'area definita dalle celle selezionate; in caso contrario, false.true to indicate that the cell is in the last row of the region defined by the selected cells; otherwise, false.

format
String

Stringa di formato corrente della cella.The current format string of the cell.

Restituisce

Object

Classe Object che rappresenta il valore della cella da copiare nella classe Clipboard.An Object that represents the value of the cell to copy to the Clipboard.

Eccezioni

Il parametro rowIndex è minore di 0 oppure è maggiore o uguale al numero di righe nel controllo.rowIndex is less than 0 or greater than or equal to the number of rows in the control.

Il valore della proprietà DataGridView della cella è null.The value of the cell's DataGridView property is null.

-oppure--or- La proprietà ColumnIndex è minore di 0, a indicare che la cella è un cella di intestazione di riga.ColumnIndex is less than 0, indicating that the cell is a row header cell.

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.Formatting failed and either there is no handler for the DataError event of the DataGridView control or the handler set the ThrowException property to true. In genere è possibile eseguire il cast dell'oggetto eccezione al tipo FormatException.The exception object can typically be cast to type FormatException.

Commenti

Questo metodo viene chiamato dal DataGridView.GetClipboardContent metodo per recuperare un valore formattato negli Appunti che rappresenta il valore della cella.This method is called by the DataGridView.GetClipboardContent method to retrieve a Clipboard-formatted value that represents the cell value.

Il valore della cella viene innanzitutto recuperato nel formato di visualizzazione dal GetEditedFormattedValue metodo.The cell value is first retrieved in its display format from the GetEditedFormattedValue method. Questo può generare l' DataGridView.CellFormatting evento per formattare il valore e l' DataGridView.DataError evento se la formattazione ha esito negativo.This may raise the DataGridView.CellFormatting event to format the value and the DataGridView.DataError event if formatting is unsuccessful.

I parametri relativi alla posizione di questo metodo indicano dove si trova la cella nella tabella di dati che rappresenta l'area definita dalle celle selezionate nel DataGridView controllo.The position-related parameters of this method indicate where this cell is located in the table of data representing the region defined by the selected cells in the DataGridView control. A seconda della posizione della cella, le informazioni aggiuntive sulla formattazione possono essere restituite da questo metodo insieme al valore della cella formattato per la visualizzazione.Depending on the cell's position, additional formatting information may be returned by this method along with the display-formatted cell value. Ad esempio, il formato HTML per una cella nella prima colonna di una riga includerà il tag che indica l'inizio di una riga.For example, the HTML format for a cell in the first column of a row will include the tag that indicates the beginning of a row.

I formati degli Appunti supportati sono DataFormats.Text ,, DataFormats.UnicodeText DataFormats.Html e DataFormats.CommaSeparatedValue .The supported Clipboard formats include DataFormats.Text, DataFormats.UnicodeText, DataFormats.Html, and DataFormats.CommaSeparatedValue.

Per altre informazioni, vedere la classe Clipboard.For more information, see the Clipboard class.

Note per gli eredi

Eseguire l'override di questo metodo per fornire valori degli Appunti personalizzati.Override this method to provide customized Clipboard values. Ad esempio, è possibile eseguire l'override di questo metodo per supportare la copia dei valori dai tipi di cella personalizzati.For example, you could override this method to support copying values from custom cell types.

Si applica a

Vedi anche