DataGridViewCell.GetClipboardContent Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> objProtected Overridable Function GetClipboardContent (rowIndex As Integer, firstCell As Boolean, lastCell As Boolean, inFirstRow As Boolean, inLastRow As Boolean, format As String) As ObjectParamè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 qui représente la valeur de la cellule à copier dans Clipboard.
Exceptions
rowIndex est inférieur à 0 ou supérieur ou égal au nombre de lignes contenues dans le contrôle.
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.
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.
