DataGridViewCell.GetClipboardContent 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
检索要复制到 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 或大于等于控件中的行数。
格式化失败,这是由于 DataError 控件的 DataGridView 事件无处理程序或处理程序将 ThrowException 属性设置为 true
而引起的。 通常情况下,可将该异常对象强制转换为类型 FormatException。
注解
此方法由 方法调用, DataGridView.GetClipboardContent 用于检索表示单元格值的剪贴板格式的值。
首先从 GetEditedFormattedValue 方法检索单元格值的显示格式。 如果格式设置失败, DataGridView.CellFormatting 这可能会引发 事件来设置值和 DataGridView.DataError 事件的格式。
此方法的位置相关参数指示此单元格在数据表中的位置,该数据表表示控件中 DataGridView 选定单元格定义的区域。 根据单元格的位置,此方法可能会返回其他格式信息以及显示格式的单元格值。 例如,行第一列中单元格的 HTML 格式将包含指示行开头的 标记。
支持的剪贴板格式包括 DataFormats.Text、 DataFormats.UnicodeText、 DataFormats.Html和 DataFormats.CommaSeparatedValue。
有关更多信息,请参见 Clipboard 类。
继承者说明
重写此方法以提供自定义剪贴板值。 例如,可以重写此方法以支持从自定义单元格类型复制值。