Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. |
Traducción
Original
|
DataGridViewCell.GetClipboardContent (Método)
Recupera el valor con formato de la celda que copiar en el Clipboard.
Ensamblado: System.Windows.Forms (en System.Windows.Forms.dll)
protected virtual Object GetClipboardContent( int rowIndex, bool firstCell, bool lastCell, bool inFirstRow, bool inLastRow, string format )
Parámetros
- rowIndex
- Tipo: System.Int32
Índice de base cero de la fila que contiene la celda.
- firstCell
- Tipo: System.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
- Tipo: System.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
- Tipo: System.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
- Tipo: System.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
- Tipo: System.String
Cadena de formato actual de la celda.
Valor devuelto
Tipo: System.ObjectObject que representa el valor de la celda que se va a copiar en Clipboard.
| Excepción | Condición |
|---|---|
| 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 en un tipo de FormatException. |
El método DataGridView.GetClipboardContent llama a este método para recuperar del Portapapeles un valor con formato que representa el valor de celda.
El valor de celda, con su formato de presentación, se recupera primero del método GetEditedFormattedValue. Esto puede provocar el evento DataGridView.CellFormatting para dar formato al valor y el evento DataGridView.DataError si la asignación de formato no se realiza correctamente.
Los parámetros de este método relacionados con la posición indican dónde se encuentra situada esta celda en la tabla de datos que representa la región definida por las celdas seleccionadas en el control DataGridView. En función de la posición de la celda, este método puede devolver información de formato adicional, además del valor de la celda con formato de presentación. Por ejemplo, el formato HTML de una celda situada en la primera columna de una fila incluirá la etiqueta que indica que se trata del principio de una fila.
Los formatos del Portapapeles compatibles son DataFormats.Text, DataFormats.UnicodeText, DataFormats.Html y DataFormats.CommaSeparatedValue.
Para obtener más información, vea la clase Clipboard.
Notas para los herederos
Reemplace este método para proporcionar valores de Portapapeles personalizados. Por ejemplo, podría reemplazar este método para admitir la copia de valores de tipos de celda personalizados.
Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
