DataGridViewCell.GetClipboardContent Метод

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Извлекает форматированное значение ячейки для копирования в объект 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

Параметры

rowIndex: Int32

Отсчитываемый с нуля индекс строки, содержащей ячейку.

firstCell: Boolean

Значение true, если необходимо указать, что ячейка находится в первом столбце области, определяемой выбранными ячейками; в противном случае — значение false.

lastCell: Boolean

Значение true, если необходимо указать, что ячейка находится в последнем столбце области, определяемой выбранными ячейками; в противном случае — значение false.

inFirstRow: Boolean

Значение true, если необходимо указать, что ячейка находится в первой строке области, определяемой выбранными ячейками; в противном случае — значение false.

inLastRow: Boolean

Значение true, если необходимо указать, что ячейка находится в последней строке области, определяемой выбранными ячейками; в противном случае — значение false.

format: String

Строка текущего формата для ячейки.

Возвращаемое значение

Object

Объект Object, представляющий значение ячейки для копирования в Clipboard.

Исключения

ArgumentOutOfRangeException

Значение rowIndex меньше 0 либо больше или равно числу строк в элементе управления.

InvalidOperationException

Значение свойства DataGridView ячейки равно null.

-или-

Значение ColumnIndex меньше 0, свидетельствующее о том, что ячейка является ячейкой заголовка строки.

Exception

Форматирование закончилось неудачей, и либо отсутствует обработчик для события DataError элемента управления DataGridView, либо обработчик установил для свойства ThrowException значение true. Объект исключения обычно можно привести к типу FormatException.

Значение ячейки сначала извлекается в формате отображения из GetEditedFormattedValue метода . Это может вызвать DataGridView.CellFormatting событие форматирования значения и событие, DataGridView.DataError если форматирование не удается.

Связанные с положением параметры этого метода указывают, где находится эта ячейка в таблице данных, представляющей область, определенную выбранными ячейками в элементе DataGridView управления . В зависимости от положения ячейки этот метод может возвращать дополнительные сведения о форматировании вместе со значением ячейки в отображаемом формате. Например, формат HTML для ячейки в первом столбце строки будет включать тег, указывающий начало строки.

Поддерживаемые форматы буфера обмена включают DataFormats.Text, DataFormats.UnicodeText, DataFormats.Htmlи DataFormats.CommaSeparatedValue.

Дополнительные сведения см. в описании класса Clipboard.

Примечания для тех, кто наследует этот метод

Переопределите этот метод, чтобы предоставить настраиваемые значения буфера обмена. Например, этот метод можно переопределить для поддержки копирования значений из пользовательских типов ячеек.

Применяется к

Поделиться через