Exporter (0) Imprimer
Développer tout
Développer Réduire

DataGridViewCell.GetClipboardContent, méthode

Remarque : cette méthode est nouvelle dans le .NET Framework version 2.0.

Récupère la valeur mise en forme de la cellule à copier dans Clipboard.

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

protected virtual Object GetClipboardContent (
	int rowIndex,
	bool firstCell,
	bool lastCell,
	bool inFirstRow,
	bool inLastRow,
	string format
)
protected Object GetClipboardContent (
	int rowIndex, 
	boolean firstCell, 
	boolean lastCell, 
	boolean inFirstRow, 
	boolean inLastRow, 
	String format
)
protected function GetClipboardContent (
	rowIndex : int, 
	firstCell : boolean, 
	lastCell : boolean, 
	inFirstRow : boolean, 
	inLastRow : boolean, 
	format : String
) : Object

Paramètres

rowIndex

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

firstCell

true pour indiquer que la cellule se trouve dans la première colonne de la zone définie par les cellules sélectionnées ; sinon, false.

lastCell

true pour indiquer que la cellule se trouve dans la dernière colonne de la zone définie par les cellules sélectionnées ; sinon, false.

inFirstRow

true pour indiquer que la cellule se trouve dans la première ligne de la zone définie par les cellules sélectionnées ; sinon, false.

inLastRow

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

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

Valeur de retour

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

Type d'exceptionCondition

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 référence Null (Nothing en Visual Basic).

- 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 casté en type FormatException.

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.

La valeur de la cellule est d'abord récupérée dans son format d'affichage à partir de la méthode GetEditedFormattedValue. 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 est infructueuse.

Les paramètres liés à la position de cette méthode indiquent où cette cellule est située dans le tableau des données représentant la région définie par les cellules sélectionnées dans le contrôle DataGridView. Selon la position de la cellule, d'autres informations de mise en forme peuvent être retournées par cette méthode, ainsi que la valeur de la cellule mise en forme par l'affichage. Par exemple, le format HTML d'une cellule située 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.Html et DataFormats.CommaSeparatedValue.

Pour plus d'informations, consultez la classe Clipboard.

Remarques à l'attention des héritiers Substituez cette méthode pour fournir des valeurs de Presse-papiers personnalisées. Par exemple, vous pouvez substituer cette méthode pour prendre en charge des valeurs de copie à partir de types de cellule personnalisés.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft