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

El DataGridView.GetClipboardContent método llama a este método para recuperar un valor con formato del portapapeles que representa el valor de la celda.This method is called by the DataGridView.GetClipboardContent method to retrieve a Clipboard-formatted value that represents the cell value.

El valor de la celda se recupera primero en su formato de GetEditedFormattedValue presentación desde el método.The cell value is first retrieved in its display format from the GetEditedFormattedValue method. Esto puede generar el DataGridView.CellFormatting evento para dar formato al valor y DataGridView.DataError el evento si el formato no se realiza correctamente.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 DataGridView en el 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 puede devolver información de formato adicional junto con el valor de celda con formato de presentación.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 de 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 DataFormats.UnicodeTextadmitidos incluyen DataFormats.CommaSeparatedValue DataFormats.Text,, DataFormats.Htmly.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 del portapapeles.Override this method to provide customized Clipboard values. Por ejemplo, podría invalidar este método para permitir la copia de valores de tipos de celda personalizados.For example, you could override this method to support copying values from custom cell types.

Se aplica a

Consulte también: