DataGridViewCell.GetClipboardContent 方法

定义

检索要复制到 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,它表示要复制到 Clipboard 的单元格的值。

例外

rowIndex 小于 0 或大于等于控件中的行数。

单元格的 DataGridView 属性的值是 null

- 或 -

ColumnIndex 小于 0,这表示该单元格为行标头单元格。

格式化失败,这是由于 DataError 控件的 DataGridView 事件无处理程序或处理程序将 ThrowException 属性设置为 true 而引起的。 通常情况下,可将该异常对象强制转换为类型 FormatException

注解

此方法由 方法调用, DataGridView.GetClipboardContent 用于检索表示单元格值的剪贴板格式的值。

首先从 GetEditedFormattedValue 方法检索单元格值的显示格式。 如果格式设置失败, DataGridView.CellFormatting 这可能会引发 事件来设置值和 DataGridView.DataError 事件的格式。

此方法的位置相关参数指示此单元格在数据表中的位置,该数据表表示控件中 DataGridView 选定单元格定义的区域。 根据单元格的位置,此方法可能会返回其他格式信息以及显示格式的单元格值。 例如,行第一列中单元格的 HTML 格式将包含指示行开头的 标记。

支持的剪贴板格式包括 DataFormats.TextDataFormats.UnicodeTextDataFormats.HtmlDataFormats.CommaSeparatedValue

有关更多信息,请参见 Clipboard 类。

继承者说明

重写此方法以提供自定义剪贴板值。 例如,可以重写此方法以支持从自定义单元格类型复制值。

适用于

另请参阅