DataGridViewCell.GetClipboardContent Método

Definición

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

Índice de base cero de la fila que contiene la celda.

firstCell
Boolean

true para indicar que la celda está en la primera columna de la región definida por las celdas seleccionadas; de lo contrario, false.

lastCell
Boolean

true para indicar que la celda es la última columna de la región definida por las celdas seleccionadas; de lo contrario, false.

inFirstRow
Boolean

true para indicar que la celda está en la primera fila de la región definida por las celdas seleccionadas; de lo contrario, false.

inLastRow
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.

format
String

Cadena de formato actual de la celda.

Devoluciones

que Object representa el valor de la celda que se va a copiar en .Clipboard

Excepciones

rowIndex es menor que 0 o mayor o igual que el número de filas del control.

El valor de la propiedad de DataGridView la celda es null.

O bien

ColumnIndex es menor que 0, lo que indica que la celda es una celda de encabezado de fila.

Error de formato y no hay ningún controlador para el DataError evento del DataGridView control o el controlador establece la ThrowException propiedad trueen . Normalmente, el objeto de excepción se puede convertir al tipo FormatException.

Comentarios

El método llama DataGridView.GetClipboardContent a este método para recuperar un valor con formato portapapeles que representa el valor de celda.

El valor de la celda se recupera primero en su formato de presentación del GetEditedFormattedValue método . Esto puede provocar el DataGridView.CellFormatting evento para dar formato al valor y al evento si el DataGridView.DataError formato no es correcto.

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 del 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 pantalla. 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.

Los formatos admitidos del Portapapeles incluyen DataFormats.Text, DataFormats.UnicodeText, DataFormats.Htmly DataFormats.CommaSeparatedValue.

Para obtener más información, vea la clase Clipboard.

Notas a los desarrolladores de herederos

Invalide este método para proporcionar valores personalizados del Portapapeles. Por ejemplo, podría invalidar este método para admitir la copia de valores de tipos de celda personalizados.

Se aplica a

Consulte también