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.

Комментарии

Этот метод вызывается методом DataGridView.GetClipboardContent для получения значения в формате буфера обмена, представляющего значение ячейки.

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

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

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

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

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

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

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

См. также раздел