DataGridViewCell.GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String) Méthode

Définition

Récupère la valeur mise en forme de la cellule à copier dans 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

Paramètres

rowIndex
Int32

Index de base zéro de la ligne contenant la cellule.The zero-based index of the row containing the cell.

firstCell
Boolean

true pour indiquer que la cellule se trouve dans la première colonne de la région définie par les cellules sélectionnées ; sinon, false.true to indicate that the cell is in the first column of the region defined by the selected cells; otherwise, false.

lastCell
Boolean

true pour indiquer que la cellule se trouve dans la dernière colonne de la région définie par les cellules sélectionnées ; sinon, false.true to indicate that the cell is the last column of the region defined by the selected cells; otherwise, false.

inFirstRow
Boolean

true pour indiquer que la cellule se trouve dans la première ligne de la région définie par les cellules sélectionnées ; sinon, false.true to indicate that the cell is in the first row of the region defined by the selected cells; otherwise, false.

inLastRow
Boolean

true pour indiquer que la cellule se trouve dans la dernière ligne de la zone définie par les cellules sélectionnées ; sinon, false.true to indicate that the cell is in the last row of the region defined by the selected cells; otherwise, false.

format
String

Chaîne de mise en forme actuelle de la cellule.The current format string of the cell.

Retours

Object qui représente la valeur de la cellule à copier dans Clipboard.An Object that represents the value of the cell to copy to the Clipboard.

Exceptions

rowIndex est inférieur à 0 ou supérieur ou égal au nombre de lignes contenues dans le contrôle.rowIndex is less than 0 or greater than or equal to the number of rows in the control.

La propriété DataGridView de la cellule a la valeur null.The value of the cell's DataGridView property is null.

- ou --or- ColumnIndex est inférieur à 0, ce qui indique que la cellule est une cellule d'en-tête de ligne.ColumnIndex is less than 0, indicating that the cell is a row header cell.

La mise en forme a échoué et soit il n'y a aucun gestionnaire pour l'événement DataError du contrôle DataGridView, soit le gestionnaire a affecté true à la propriété ThrowException.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. L’objet exception peut généralement être converti en type FormatException.The exception object can typically be cast to type FormatException.

Remarques

Cette méthode est appelée par la méthode DataGridView.GetClipboardContent pour récupérer une valeur au format presse-papiers qui représente la valeur de la cellule.This method is called by the DataGridView.GetClipboardContent method to retrieve a Clipboard-formatted value that represents the cell value.

La valeur de la cellule est d’abord récupérée dans son format d’affichage à partir de la méthode GetEditedFormattedValue.The cell value is first retrieved in its display format from the GetEditedFormattedValue method. Cela peut déclencher l’événement DataGridView.CellFormatting pour mettre en forme la valeur et l’événement DataGridView.DataError si la mise en forme échoue.This may raise the DataGridView.CellFormatting event to format the value and the DataGridView.DataError event if formatting is unsuccessful.

Les paramètres relatifs à la position de cette méthode indiquent où cette cellule se trouve dans la table de données représentant la région définie par les cellules sélectionnées dans le contrôle DataGridView.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. En fonction de la position de la cellule, des informations de mise en forme supplémentaires peuvent être retournées par cette méthode, ainsi que la valeur de cellule au format d’affichage.Depending on the cell's position, additional formatting information may be returned by this method along with the display-formatted cell value. Par exemple, le format HTML d’une cellule de la première colonne d’une ligne inclura la balise qui indique le début d’une ligne.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.

Les formats de presse-papiers pris en charge incluent DataFormats.Text, DataFormats.UnicodeText, DataFormats.Htmlet DataFormats.CommaSeparatedValue.The supported Clipboard formats include DataFormats.Text, DataFormats.UnicodeText, DataFormats.Html, and DataFormats.CommaSeparatedValue.

Pour plus d'informations, consultez la classe Clipboard.For more information, see the Clipboard class.

Notes pour les héritiers

Substituez cette méthode pour fournir des valeurs de presse-papiers personnalisées.Override this method to provide customized Clipboard values. Par exemple, vous pouvez substituer cette méthode pour prendre en charge la copie de valeurs à partir de types de cellules personnalisés.For example, you could override this method to support copying values from custom cell types.

S’applique à

Voir aussi