[]
        
(Showing Draft Content)

GrapeCity.Documents.Excel.IRange

IRange Interface

表示IRange对象。

Namespace: GrapeCity.Documents.Excel
Assembly: GcDocs.Excel.dll
Syntax
public interface IRange

Properties

Name Description
AddIndent

获取或设置当水平或垂直对齐方式设置为分布时控制文本缩进的属性。

Address

获取一个string 值,该值表示以绝对A1格式表示的范围引用。

Areas

返回一个IAreas 实例,该实例表示一个 IRanges 数组,其中 IAreas 返回的每个 IRange 代表一个单元格或范围。

BackgroundImage

获取或设置单元格背景图片。支持以下图片类型:PNG、JPG、ICO、SVG、GIF。 此图片仅在SpreadJS中可见,以及导出到PDF/HTML/IMG时可见。

BackgroundImageLayout

获取或设置单元格背景图像布局,默认为 Stretch。

BindingPath

获取或设置当前单元格或列的绑定路径。 如果范围是普通范围,则获取或设置范围左上角单元格的绑定路径。 如果范围是 EntireColumn,则获取或设置范围的左侧列绑定路径。 如果范围是 EntireRow,则获取或设置 null。

Borders

返回一个IBorders 实例,该实例代表由此 IRange 表示的单元格或区域的单元格边框。

CellPadding

获取或设置区域的单元格边距。 仅适用于SpreadJS。

CellType

获取或设置工作表中指定范围的单元格类型。

Cells

返回表示指定范围内的单元格的IRange 对象。

Column

返回第一个范围的第一列的列号,列号从0开始计算。

ColumnCount

返回第一个范围的列数。

ColumnWidth

获取或设置此范围内表示的各个列的宽度(以字符为单位)。

ColumnWidthInPixel

获取或设置此范围内表示的各个列的宽度(以像素为单位)。

Columns

返回表示指定范围内列的IRange 对象。

Comment

返回一个 IComment 实例,该实例可用于获取和设置单元格的注释属性。

CommentThreaded

返回一个 ICommentThreaded 实例,该实例可用于获取和设置单元格的 ICommentThreaded 属性。

Count

返回集合中的对象数量。

CurrentArray

获取指定单元格是否为数组的一部分,返回一个代表整个数组的IRange 对象。

Decoration

获取或设置单元格装饰。 仅适用于 SpreadJS。

DefaultValue

获取或设置单元格的默认值,可以是值数据或公式字符串。当单元格没有数据时,该值生效。

DisplayFormat

获取一个 DisplayFormat 对象,该对象表示指定范围的显示设置。

EntireColumn

返回一个新实例,该实例表示同一单元格范围,但扩展到包括所有行。IRange

EntireMergeArea

返回一个IRange ,它表示当前IRange 的区域,该区域会迭代增长以包含没有部分合并的单元格。

EntireRow

返回一个新实例的IRange ,它表示相同范围的单元格,但扩展到包括所有列。

Font

返回一个IFont 实例,该实例可用于获取和设置由此 IRange 表示的单元格的字体属性。

FormatConditions

返回一个 FormatConditions 集合,该集合表示指定范围的所有条件格式。

Formula

获取或设置以此IRange 表示的单元格的公式,使用A1样式表示法。

Formula2

获取或设置由此IRange 表示的单元格的公式,使用A1样式的数组表示法。

Formula2Local

获取或设置以此IRange 表示的单元格的本地化公式,使用A1样式的数组表示法。

Formula2R1C1

获取或设置由此IRange 表示的单元格在 R1C1 风格数组表示法中的公式。

Formula2R1C1Local

获取或设置此IRange 表示的单元格在R1C1数组表示法中的本地化公式。

FormulaArray

获取或设置区域的数组公式。

FormulaArrayR1C1

获取或设置使用 ReferenceStyle.R1C1 的区域数组公式。

FormulaHidden

获取或设置当工作表被保护时,公式是否会被隐藏。

FormulaLocal

获取或设置以此IRange 表示的单元格的本地化公式,使用A1样式表示法。

FormulaR1C1

获取或设置以此IRange 表示的单元格的公式,使用 R1C1 样式的表示法。

FormulaR1C1Local

获取或设置以此IRange 表示的单元格的本地化公式,使用 R1C1 样式的表示法。

HasArray

确定指定单元格是否属于数组公式的一部分。

HasFormula

如果单元格或区域包含任何公式,则返回 true;否则返回 false。

HasValidation

返回如果此范围表示的任何单元格具有关联的数据验证,则为 true。

Height

获取范围的高度,以点为单位。

HeightInPixel

获取范围的高度(以像素为单位)。

Hidden

获取或设置一个属性,该属性指定是否应隐藏行或列。

HorizontalAlignment

获取或设置单元格或区域的HorizontalAlignment

返回 IHyperLinks 的一个实例,可用于获取和设置超链接属性。

IgnoredError

获取或设置要忽略的范围的错误类型。

IndentLevel

获取或设置指定单元格的缩进级别。

Interior

返回一个IInterior 对象,该对象表示指定单元格的内部(背景)颜色和图案。

IsRichText

指示单元格字符串值是否为富文本。

this[int]

通过索引返回一个代表单元格的新IRange 实例。

this[int, int]

返回一个从当前 IRange 偏移的新 IRange 实例。

LabelOptions

获取或设置水印的设置。 仅适用于SpreadJS。

LastColumn

返回第一个范围的最后一列的列号,列号从0开始计算。

LastRow

返回第一个范围的最后一行的行号,行号从0开始计算。

Locked

获取或设置一个属性,该属性指定单元格是否应被锁定。

MergeArea

返回一个IRange ,它表示包含指定单元格的合并范围。如果指定单元格不在合并范围内,此属性将返回指定单元格。

MergeCells

获取或设置一个属性,该属性指定是否合并单元格。

NumberFormat

获取或设置范围内单元格的数字格式。

Orientation

获取或设置单元格或区域中文本的旋转角度,该角度可以从-90到90度,或者是255(垂直文本)。

OutlineLevel

获取或设置指定行或列的当前大纲级别。

ReadingOrder

获取或设置指定对象的阅读顺序。

RichText

获取与此范围的左上角单元格关联的富文本对象

Row

返回第一个范围的第一行的行号,行号从0开始计算。

RowCount

返回第一个范围的行数。

RowHeight

获取或设置此范围所表示的各个行的高度(以点为单位)。

RowHeightInPixel

获取或设置此范围所表示的各个行的高度(以像素为单位)。

Rows

返回表示指定范围内行的IRange 对象。

ShowDetail

获取或设置是否显示详细信息(如果为指定范围展开大纲,则返回 True,以便列或行的详细信息可见)。 指定的范围必须是大纲中的一个单一的汇总列或行(可读或可写)。

ShrinkToFit

获取或设置一个属性,该属性指定是否需要缩小字体以显示单元格内容。

SparklineGroups

返回一个 ISparklineGroups 实例,该实例可用于获取和设置单元格的 SparklineGroups 属性

Style

获取或设置与此 IRange 表示的单元格相关联的命名样式 IStyle

Summary

确定该范围是否为大纲摘要行或列。

Tag

获取或设置工作表中指定区域的标签值。 仅限SpreadJS。

Text

获取此IRange 表示的单元格的值,作为一个格式化字符串。

UseStandardHeight

确定该IRange 对象的行高是否等于工作表的标准行高。

UseStandardWidth

确定该IRange 对象的列宽是否等于工作表的标准宽度。

UsedRange

返回一个IRange ,表示当前范围内的已使用区域。

Validation

返回一个 IValidation 实例,该实例可用于获取和设置由此 IRange 表示的单元格的验证属性。

ValidationIsSame

返回由此IRange 表示的所有单元格的验证选项是否相同; 如果相同则返回 true,否则返回 false。

Value

获取指定范围的值,作为stringdoublebool , object [,] (在 Visual Basic 中为 Object (,)) 或null (在 Visual Basic 中为 Nothing ); 或者设置指定单元格的值,作为stringdoubleshortintlongboolDateTimeTimeSpan , object [,] (在 Visual Basic 中为 Object (,)) 或null (在 Visual Basic 中为 Nothing ).

VerticalAlignment

获取或设置单元格或区域的VerticalAlignment

Watermark

获取或设置区域的水印。 仅限SpreadJS。

Width

获取范围的宽度,以点为单位。

WidthInPixel

获取范围的像素宽度。

Worksheet

返回此范围所属的父Worksheet

WrapText

获取或设置一个标志,指示单元格中是否启用了自动换行。

Methods

Name Description
Activate()

激活单个单元格,该单元格必须位于当前选中区域内。

AddComment(string)

向当前 IRange 添加注释。

AddCommentThreaded(string, string)

向当前 IRange 添加一个带线程的注释。

AutoFilter(bool, int, object, AutoFilterOperator, object, bool)

使用自动筛选功能过滤列表。

AutoFilter(int, object, AutoFilterOperator, object, bool)

使用自动筛选功能过滤列表。

AutoFit()

改变范围内列的宽度或行的高度以达到最佳适配。

AutoFit(bool)

改变范围内列的宽度或行的高度以达到最佳适配。 considerMergedCell 指示是否考虑单行中的合并单元格。

Calculate()

按需计算范围的公式。

Characters(int, int)

返回一个ITextRun 对象,该对象表示单元格文本中的字符范围。此方法只能在单元格的值为字符串时调用,否则将抛出InvalidOperationException

Clear()

清除当前IRange中的公式、值以及所有格式。

ClearComments()

清除当前 IRange 的注释。

ClearCommentsThreaded()

清除当前 IRange 中的线程评论。

ClearContents()

清除当前 IRange 的公式和值。

ClearFormats()

清除当前 IRange 的所有格式。

清除当前 IRange 中的所有超链接。

ClearOutline()

清除指定范围的大纲。

Copy(IRange)

将范围复制到指定范围。

Copy(IRange, PasteOption)

将范围复制到指定范围。

Copy(IRange, PasteType)

将范围复制到指定范围。

Cut(IRange)

将范围剪切到指定范围。

Delete(DeleteShiftDirection)

从工作表中删除一个单元格或一系列单元格,并将其他单元格移动以替换已删除的单元格。

指定移动单元格的方向。
Dirty()

指定当下一次计算发生时,重新计算该范围内的所有公式。

Find(object, IRange, FindOptions)

在一个范围内查找特定的信息。

FromJson(string)

从JSON字符串生成区域数据。

GenerateGetPivotDataFunction(IRange)

为数据透视表中的单元格生成相应的 "GETPIVOTDATA" 函数。

GetAddress(bool, bool, ReferenceStyle, IRange)

返回一个string 值,表示范围引用。 如果所有参数都被省略,返回值等于Address 属性。

GetDependents()

获取区域左上单元格的依赖范围。

GetDependents(bool)

获取范围内所有单元格的依赖范围。

GetPrecedents()

获取区域左上单元格的前导区域。

GetPrecedents(bool)

获取该范围内所有单元格的前导范围。

GetUsedRange(UsedRangeType)

获取表示当前范围内已使用区域的IRange

GoalSeek(double, IRange)

尝试通过修改指定的changingCell来实现此IRange所代表的单元格中公式的计算结果达到指定的目标。 如果你知道公式要达到的结果,但不清楚公式需要输入什么值才能得到这个结果,请使用目标寻求功能。

Group()

增加指定行或列的大纲级别。

ImportData(IEnumerable, DataImportOptions)

将数据(最多二维)从数据源导入到范围。

ImportData(DataTable, DataImportOptions)

将数据从表格导入到范围。

ImportData<T>(IEnumerable<T>, DataImportOptions)

将数据从数据源(最多二维)导入到范围。

Insert(InsertShiftDirection)

在工作表中插入一个单元格或一系列单元格,并将其他单元格移开以腾出空间。

指定移动单元格的方向。
Intersect(IRange)

返回一个表示两个区域相交的IRange对象。
如果range2来自不同的工作表,则会抛出异常。

Intersect(params IRange[])

返回一个表示多个区域交集的IRange对象。
如果指定了来自不同工作表的的一个或多个区域,将抛出异常。

Merge(bool)

将表示范围内的单元格合并为单个合并单元格。

Offset(int, int)

返回一个表示此范围的偏移的IRange对象。

RemoveSubtotal()

从列表中移除小计。

Replace(object, object, ReplaceOptions)

在公式中搜索并进行替换。 使用此方法不会改变选区或活动单元格。

Select()

选择对象。

Sort(IRange, SortOrder, SortOrientation, bool)

根据指定的选项对由此范围表示的单元格进行排序。

Sort(SortOrientation, bool, params IValueSortField[])

根据指定的选项对由此范围表示的单元格进行排序。

SpecialCells(SpecialCellType, SpecialCellsValue?)

获取一个IRange 对象,该对象表示所有 与指定类型和值匹配的单元格。

Subtotal(int, ConsolidationFunction, IEnumerable<int>, bool, bool, SummaryRow)

为范围创建小计。

ToImage(Stream, ImageType)

将范围保存到指定的图像流。

ToImage(Stream, ImageType, ImageSaveOptions)

使用指定选项将范围保存到指定的图像流。

ToImage(string)

将范围保存到指定的图像文件。

ToImage(string, ImageSaveOptions)

使用指定选项将范围保存到指定的图像文件。

ToJson()

从范围生成一个JSON字符串。

UnMerge()

将所表示范围内的合并单元格转换为正常单元格。

Ungroup()

减少指定行或列的大纲级别。

Union(IRange)

返回一个表示两个区域并集的IRange对象。
如果range2来自不同的工作表,则会抛出异常。

Union(params IRange[])

返回一个表示多个区域并集的IRange对象。
如果指定了来自不同工作表的的一个或多个区域,将抛出异常。