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 le 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 est 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 région définie par les cellules sélectionnées ; sinon, false.
- format
- String
Chaîne de format actuelle de la cellule.
Retours
Qui Object représente la valeur de la cellule à copier dans le Clipboard.
Exceptions
rowIndex est inférieur à 0 ou supérieur ou égal au nombre de lignes dans le contrôle.
La valeur de la propriété de DataGridView la cellule est null.
- ou -
ColumnIndex est inférieur à 0, indiquant que la cellule est une cellule d’en-tête de ligne.
La mise en forme a échoué et il n’existe aucun gestionnaire pour l’événement DataError du DataGridView contrôle ou le gestionnaire a défini la ThrowException propriété truesur . L’objet d’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 des données représentant la région définie par les cellules sélectionnées dans le DataGridView contrôle. Selon 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 mise en forme affichée. Par exemple, le format HTML d’une cellule dans la première colonne d’une ligne inclut la balise qui indique le début d’une ligne.
Les formats de Presse-papiers pris en charge 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 de Presse-papiers personnalisées. Par exemple, vous pouvez remplacer cette méthode pour prendre en charge la copie de valeurs à partir de types de cellules personnalisés.
