DataGridViewCell.GetClipboardContent Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> objProtected Overridable Function GetClipboardContent (rowIndex As Integer, firstCell As Boolean, lastCell As Boolean, inFirstRow As Boolean, inLastRow As Boolean, format As String) As ObjectPará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 que 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 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.
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.
