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

Definición

Recupera el valor con formato de la celda que copiar en el 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

Parámetros

rowIndex
Int32 Int32 Int32 Int32

Índice de base cero de la fila que contiene la celda.The zero-based index of the row containing the cell.

firstCell
Boolean Boolean Boolean Boolean

true para indicar que la celda está en la primera columna de la región definida por las celdas seleccionadas; de lo contrario, es false.true to indicate that the cell is in the first column of the region defined by the selected cells; otherwise, false.

lastCell
Boolean Boolean Boolean Boolean

true para indicar que la celda está en la última columna de la región definida por las celdas seleccionadas; de lo contrario, es false.true to indicate that the cell is the last column of the region defined by the selected cells; otherwise, false.

inFirstRow
Boolean Boolean Boolean Boolean

true para indicar que la celda está en la primera fila de la región definida por las celdas seleccionadas; de lo contrario, es false.true to indicate that the cell is in the first row of the region defined by the selected cells; otherwise, false.

inLastRow
Boolean Boolean Boolean Boolean

true para indicar que la celda está en la última fila de la región definida por las celdas seleccionadas; de lo 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 String String String

Cadena de formato actual de la celda.The current format string of the cell.

Devoluciones

Object que representa el valor de la celda que se va a copiar en Clipboard.An Object that represents the value of the cell to copy to the Clipboard.

Excepciones

rowIndex es menor que 0 o mayor o igual que el número de filas del control.rowIndex is less than 0 or greater than or equal to the number of rows in the control.

El valor de la propiedad DataGridView de la celda es null.The value of the cell's DataGridView property is null.

O bien-or- ColumnIndex es menor que 0, lo que indica que la celda es una celda de encabezado de fila.ColumnIndex is less than 0, indicating that the cell is a row header cell.

Se ha producido un error al dar formato y, o bien no hay ningún controlador para el evento DataError del control DataGridView, o el controlador ha establecido la propiedad ThrowException en 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. El objeto de excepción normalmente se puede convertir al tipo FormatException.The exception object can typically be cast to type FormatException.

Comentarios

Este método es invocado por el DataGridView.GetClipboardContent método para recuperar un valor con formato del Portapapeles que representa el valor de celda.This method is called by the DataGridView.GetClipboardContent method to retrieve a Clipboard-formatted value that represents the cell value.

El valor de celda se recupera en primer lugar en su formato de presentación del GetEditedFormattedValue método.The cell value is first retrieved in its display format from the GetEditedFormattedValue method. Esto puede provocar la DataGridView.CellFormatting evento dar formato al valor y el DataGridView.DataError eventos si el formato incorrecto.This may raise the DataGridView.CellFormatting event to format the value and the DataGridView.DataError event if formatting is unsuccessful.

Los parámetros relacionados con la posición de este método indican dónde se encuentra esta celda en la tabla de datos que representa la región definida por las celdas seleccionadas en el DataGridView control.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. Dependiendo de la posición de la celda, este método junto con el valor de celda con formato de presentación puede devolver información de formato adicional.Depending on the cell's position, additional formatting information may be returned by this method along with the display-formatted cell value. Por ejemplo, el formato HTML para una celda de la primera columna de una fila incluirá la etiqueta que indica el principio de una fila.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.

Los formatos de Portapapeles admitidos incluyen DataFormats.Text, DataFormats.UnicodeText, DataFormats.Html, y DataFormats.CommaSeparatedValue.The supported Clipboard formats include DataFormats.Text, DataFormats.UnicodeText, DataFormats.Html, and DataFormats.CommaSeparatedValue.

Para obtener más información, vea la clase Clipboard.For more information, see the Clipboard class.

Notas a los desarrolladores de herederos

Invalide este método para proporcionar valores personalizados de Portapapeles.Override this method to provide customized Clipboard values. Por ejemplo, podría invalidar este método para admitir la copia de los valores de tipos de celda personalizado.For example, you could override this method to support copying values from custom cell types.

Se aplica a

Consulte también: