DataGridViewCell.GetClipboardContent Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

Paramètres

rowIndex
Int32

Index de base zéro de la ligne contenant la cellule.

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.

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.

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.

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.

format
String

Chaîne de mise en forme actuelle de la cellule.

Retours

Object

Object qui représente la valeur de la cellule à copier dans Clipboard.

Exceptions

ArgumentOutOfRangeException

rowIndex est inférieur à 0 ou supérieur ou égal au nombre de lignes contenues dans le contrôle.

InvalidOperationException

La propriété DataGridView de la cellule a la valeur null.

- ou -

ColumnIndex est inférieur à 0, ce qui indique que la cellule est une cellule d'en-tête de ligne.

Exception

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. L’objet exception peut généralement être converti en type FormatException.

Remarques

Cette méthode est appelée par la DataGridView.GetClipboardContent méthode pour récupérer une valeur au format Presse-papiers qui représente la valeur de cellule.

La valeur de cellule est d’abord récupérée dans son format d’affichage à partir de la GetEditedFormattedValue méthode . Cela peut déclencher l’événement DataGridView.CellFormatting pour mettre en forme la valeur et l’événement si la DataGridView.DataError mise en forme échoue.

Les paramètres liés à la position de cette méthode indiquent où se trouve cette cellule dans la table de données représentant la région définie par les cellules sélectionnées dans le DataGridView contrôle. 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 la cellule au format d’affichage. Par exemple, le format HTML d’une cellule de la première colonne d’une ligne inclut la balise qui indique le début d’une ligne.

Les formats pris en charge du Presse-papiers incluent DataFormats.Text, DataFormats.UnicodeText, DataFormats.Htmlet DataFormats.CommaSeparatedValue.

Pour plus d'informations, consultez la classe Clipboard.

Notes pour les héritiers

Remplacez cette méthode pour fournir des valeurs personnalisées dans le Presse-papiers. Par exemple, vous pouvez remplacer cette méthode pour prendre en charge la copie de valeurs à partir de types de cellules personnalisés.

S’applique à

Voir aussi