DataGridViewCell.GetClipboardContent Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

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

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, es false.

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

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, es 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

Object

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

Excepciones

ArgumentOutOfRangeException

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

InvalidOperationException

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

o bien

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

Exception

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. El objeto de excepción normalmente se puede convertir al tipo FormatException.

Comentarios

El método llama DataGridView.GetClipboardContent a este método para recuperar un valor con formato de 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 visualización. 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 de Portapapeles admitidos 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