WPS 基础接口 > 表格 API 参考 > Range > Range 对象成员

代表某一单元格、某一行、某一列、某一选定区域(该区域可包含一个或若干连续单元格区域),或者某一三维区域。

方法

?名称说明
Activate激活单个单元格,该单元格必须处于当前选定区域内。要选择单元格区域,请使用 Select 方法。
AddComment为区域添加批注。
AdvancedFilter基于条件区域从列表中筛选或复制数据。如果初始选定区域为单个单元格,则使用单元格的当前区域。
AllocateChanges在基于 OLAP 数据源的区域中的所有已编辑的单元格上执行回写操作。
ApplyNames将名称应用于指定区域中的单元格。
ApplyOutlineStyles对指定区域应用分级显示样式。
AutoComplete从列表中返回一个记忆式键入匹配项。如果没有相应的记忆式键入匹配项,或者在列表中有不止一个与已键入字符串相匹配的项,此方法将返回一空字符串。
AutoFill对指定区域中的单元格执行自动填充。
AutoFilter使用“自动筛选”筛选一个列表。
AutoFit更改区域中的列宽或行高以达到最佳匹配。
AutoOutline自动为指定区域创建分级显示。如果区域为单个单元格,ET 将创建整个工作表的分级显示。新分级显示将取代所有的分级显示。
BorderAround向单元格区域添加边框,并设置该新边框的 ColorLineStyleWeight 属性。Variant
Calculate计算所有打开的工作簿、工作簿中的某张特定工作表或工作表指定区域中的单元格,如下表所示。
CalculateRowMajorOrder计算指定的单元格区域。
CheckSpelling检查对象的拼写。
Clear清除整个对象。
ClearComments清除指定区域的所有单元格批注。
ClearContents清除指定区域的公式。
ClearFormats清除对象的格式设置。
ClearHyperlinks删除指定区域中的所有超链接。
ClearNotes清除指定区域中所有单元格的批注和语音批注。
ClearOutline清除指定区域的分级显示。
ColumnDifferences返回一个 Range 对象,该对象代表各列中其内容与比较单元格不同的单元格。
Consolidate将多个工作表中多个区域的数据合并计算至单个工作表上的单个区域。Variant 类型。
Copy将单元格区域复制到指定的区域或剪贴板中。
CopyFromRecordset将 ADO 或 DAO Recordset 对象中的内容复制到工作表,从指定区域的左上角开始。如果 Recordset 对象包含具有 OLE 对象的字段,则该方法无效。
CopyPicture将所选对象作为图片复制到剪贴板。Variant
CreateNames在指定区域中依据工作表中的文本标签创建名称。
Cut将对象剪切到剪贴板,或者将其粘贴到指定的目的地。
DataSeries在指定区域内创建数据系列。Variant 类型。
Delete删除对象。
DialogBox显示由 ET 4.0 宏工作表上的对话框定义表所定义的对话框。返回选定控件的编号,或者当用户单击“取消”按钮时返回 False
Dirty下一次重新计算发生时指定要重新计算的区域。
DiscardChanges放弃对该区域的已编辑的单元格的所有更改。
EditionOptions您查询的是 Macintosh 专用的 Visual Basic 关键词。有关该关键词的帮助信息,请查阅 Microsoft Office Macintosh 版的语言参考帮助。
ExportAsFixedFormat导出为指定格式的文件。
FillDown从指定区域的顶部单元格开始向下填充,直至该区域的底部。区域中首行单元格的内容和格式将复制到区域中其他行内。
FillLeft从指定区域的最右边单元格开始向左填充。区域中最右列单元格的内容和格式将复制到区域中其他列内。
FillRight从指定区域的最左边单元格开始向右填充。区域中最左列单元格的内容和格式将复制到区域中其他列内。
FillUp从指定区域的底部单元格开始向上填充,直至该区域的顶部。区域中尾行单元格的内容和格式将复制到区域中其他行内。
Find在区域中查找特定信息。
FindNext继续由 Find 方法开始的搜索。查找匹配相同条件的下一个单元格,并返回表示该单元格的 Range 对象。该操作不影响选定内容和活动单元格。
FindPrevious继续由 Find 方法开始的搜索。查找匹配相同条件的上一个单元格,并返回代表该单元格的 Range 对象。该操作不影响选定内容和活动单元格。
FunctionWizard对指定区域左上角单元格启动“函数向导”。
GroupRange 对象代表某个数据透视表字段的数据区域中的单个单元格时,Group 方法在该字段中执行基于数字或日期的分组。
Insert在工作表或宏表中插入一个单元格或单元格区域,其他单元格相应移位以腾出空间。
InsertIndent向指定的区域添加缩进量。
Justify调整区域内的文字,使之均衡地填充该区域。
ListNames从指定区域的第一个单元格位置开始,将所有未隐藏的名称的列表粘贴到工作表上。
Merge由指定的 Range 对象创建合并单元格。
NavigateArrow定位追踪箭头,此箭头指定引用单元格、从属单元格或错误源单元格。选定引用单元格、从属单元格或错误源单元格并返回一个 Range 对象,该对象代表新选定区域。本方法应用于没有可见追踪箭头的单元格时将出错。
NoteText返回或设置与区域左上角单元格相关联的单元格注释。String 类型,可读写。单元格注释已经替换为区域注释。有关详细信息,请参阅 Comment 对象。
Parse分列区域内的数据并将这些数据分散放置于若干单元格中。将区域内容分配于多个相邻接的列中;该区域只能包含一列。
PasteSpecialRange 从剪贴板粘贴到指定的区域中。
PrintOut打印对象。
PrintPreview按对象打印后的外观效果显示对象的预览。
RemoveDuplicates从值区域中删除重复的值。
RemoveSubtotal删除列表中的分类汇总。
Replace返回 Boolean,它表示指定区域内单元格中的字符。使用此方法并不会更改选定区域或活动单元格。
RowDifferences返回一个 Range 对象,该对象代表各行中其内容与比较单元格不同的所有单元格。
Run在该处运行 ET 宏。区域必须位于宏表上。
Select选择对象。
SetPhonetic为指定区域中的所有单元格创建 Phonetic 对象。
Show滚动当前活动窗口中的内容以将指定区域移到视图中。此区域必须由活动文档中的单个单元格组成。
ShowDependents绘制从指定区域指向直接从属单元格的追踪箭头。
ShowErrors绘制通过从属单元格树而指向错误源单元格的追踪箭头,并返回包含该单元格的区域。
ShowPrecedents绘制从指定区域指向直接引用单元格的追踪箭头。
Sort对值区域进行排序。
SortSpecial使用东亚排序方法对区域或数据透视表进行排序;或者如果区域中只包含一个单元格,则对活动区域使用本方法。例如,日文排序方法是按照假名音节表进行排序的。
Speak按行或列的顺序朗读单元格区域。
SpecialCells返回一个 Range 对象,该对象代表与指定类型和值匹配的所有单元格。
SubscribeTo您查询的是 Macintosh 专用的 Visual Basic 关键词。有关该关键词的帮助信息,请查阅 Microsoft Office Macintosh 版的语言参考帮助。
Subtotal创建指定区域或当前区域(如果该区域为单个单元格时)的分类汇总。
Table依据输入值和工作表上定义的公式创建模拟运算表。
TextToColumns将包含文本的一列单元格分解为若干列。
Ungroup在分级显示中对一个区域进行升级(即降低其分级显示的级别)。指定区域必须是行或列,或者行区域或列区域。如果指定区域在数据透视表中,本方法将对该区域内的项取消分组。
UnMerge将合并区域分解为独立的单元格。

属性

?名称说明
AddIndent返回或设置一个 Variant 值,它指明当单元格中文本的对齐方式为水平或垂直等距分布时,文本是否为自动缩进。
Address返回一个 String 值,它代表宏语言的区域引用。
AddressLocal以用户语言返回对指定区域的区域引用。String 类型,只读。
AllowEdit返回一个 Boolean 值,它指明是否可以在受保护的工作表上编辑区域。
Application如果不使用对象识别符,则该属性返回一个代表 ET 应用程序的 Application 对象。如果使用对象识别符,则该属性返回一个代表指定对象的创建程序的 Application 对象(可对一个 OLE 自动化对象使用该属性来返回该对象的应用程序)。只读。
Areas返回一个 Areas 集合,该集合代表多区域选定内容中的所有区域。只读。
Borders返回一个 Borders 集合,该集合代表样式或单元格区域(包括定义为条件格式的一部分的区域)的边框。
Cells返回一个 Range 对象,该对象代表指定区域中的单元格。
Characters返回一个 Characters 对象,它代表对象文本内的字符区域。使用 Characters 对象可为文本字符串内的字符设置格式。
Column返回指定区域中第一块中的第一列的列号。Long 类型,只读。
Columns返回一个 Range 对象,该对象代表指定区域中的列。
ColumnWidth返回或设置指定区域中所有列的列宽。Variant 类型,可读写。
Comment返回一个 Comment 对象,该对象代表与区域左上角中的单元格关联的注释。
Count返回一个 Long 值,它代表集合中对象的数量。
CountLarge在指定区域的值中计算最大值。只读 Variant 类型。
Creator返回一个 32 位整数,该整数指示创建对象的应用程序。只读 Long 类型。
CurrentArray如果指定单元格属于数组,则返回一个 Range 对象,该对象表示整个数组。只读。
CurrentRegion返回一个 Range 对象,该对象代表当前区域。当前区域是由空行和空列的任意组合所限定的区域。只读。
Dependents返回一个 Range 对象,该对象代表包含某个单元格的所有从属单元格的区域。如果有多个从属单元格,则这可以是多个选定内容(Range 对象的联合)。只读 Range 对象。
DirectDependents返回一个 Range 对象,该对象代表包含某个单元格的所有直接从属单元格的区域。如果有多个从属单元格,则这可以是多个选定内容(Range 对象的联合)。只读 Range 对象。
DirectPrecedents返回一个 Range 对象,该对象代表包含某个单元格的所有直接引用单元格的区域。如果有多个引用单元格,则这可以是多个选定内容(Range 对象的联合)。只读 Range 对象。
DisplayFormat返回一个 DisplayFormat 对象,该对象代表指定区域的显示设置。只读。
End返回一个 Range 对象,该对象代表包含源区域的区域末尾的单元格。等同于按 END + 向上键、END + 向下键、END + 向左键或 END + 向右键。只读 Range 对象。
EntireColumn返回一个 Range 对象,该对象代表包含指定区域的整列或多列。只读。
EntireRow返回一个 Range 对象,该对象代表包含指定区域的整行或多行。只读。
Errors允许用户访问错误检查选项。
Font返回一个 Font 对象,它代表指定对象的字体。
FormatConditions返回一个 FormatConditions 集合,该集合代表指定区域的所有条件格式。只读。
Formula返回或设置一个 Variant 值,它代表 A1 样式表示法和宏语言中的对象的公式。
FormulaArray返回或设置区域的数组公式。返回(或可设置为)单个公式或 Visual Basic 数组。如果指定区域不包含数组公式,则该属性返回 nullVariant 类型,可读写。
FormulaHidden返回或设置一个 Variant 值,它指明在工作表处于保护状态时是否隐藏公式。
FormulaLocal返回或设置对象的公式,使用用户语言 A1 格式引用。可读/写 Variant 类型。
FormulaR1C1返回或设置对象的公式,使用宏语言 R1C1 格式符号表示。可读/写 Variant 类型。
FormulaR1C1Local返回或设置对象的公式,使用用户语言 R1C1 格式符号表示。可读/写 Variant 类型。
HasArray如果指定单元格属于数组公式,则该属性值为 TrueVariant 类型,只读。
HasFormula如果区域中所有单元格均包含公式,则该属性值为 True;如果所有单元格均不包含公式,则该属性值为 False;其他情况下为 nullVariant 类型,只读。
Height返回或设置一个 Variant 值,该值代表区域的高度(以磅为单位)。
Hidden返回或设置一个 Variant 值,它指明是否隐藏行或列。
HorizontalAlignment返回或设置一个 Variant 值,它代表指定对象的水平对齐方式。
Hyperlinks返回一个 Hyperlinks 集合,该集合代表区域的超链接。
ID返回或设置一个 String 值,它代表将页面另存为网页时指定单元格的识别标志。
IndentLevel返回或设置一个 Variant 值,它代表单元格或单元格区域的缩进量。可为 0 到 15 之间的整数。
Interior返回一个 Interior 对象,它代表指定对象的内部。
Item返回一个 Range 对象,该对象代表与指定区域存在一定偏移的区域。
Left返回一个 Variant 值,它代表从列 A 的左边缘到区域的左边缘的距离(以磅为单位)。
ListHeaderRows返回指定区域中标题行的数目。Long 类型,只读。
ListObject返回 Range 对象的 ListObject 对象。只读 ListObject 对象。
LocationInTable返回一个常量,该常量描述包含指定区域左上角部分的 PivotTable 部分。可为以下 XlLocationInTable 常量之一。Long 类型,只读。
Locked返回或设置一个 Variant 值,它指明对象是否已被锁定。
MDX返回指定的 Range 对象的 MDX 名称。只读 String 类型。
MergeArea返回一个 Range 对象,该对象代表包含指定单元格的合并区域。如果指定的单元格不在合并区域内,则该属性返回指定的单元格。只读。Variant 类型。
MergeCells 如果区域包含合并单元格,则为 TrueVariant 型,可读写。
Name返回或设置一个 Variant 值,它代表对象的名称。
Next返回一个 Range 对象,该对象代表下一个单元格。
NumberFormat返回或设置一个 Variant 值,它代表对象的格式代码。
NumberFormatLocal以采用用户语言字符串的形式返回或设置一个 Variant 值,它代表对象的格式代码。
Offset返回一个 Range 对象,该对象代表与指定区域存在一定偏移的区域。
Orientation返回或设置一个 Variant 值,它代表文本方向。
OutlineLevel返回或设置指定行或列的当前分级显示级别。Variant 类型,可读写。
PageBreak返回或设置分页符的位置。可为以下 XlPageBreak 常量之一:xlPageBreakAutomaticxlPageBreakManualxlPageBreakNoneLong 类型,可读写。
Parent返回指定对象的父对象。只读。
Phonetic返回 Phonetic 对象,该对象包含单元格中特定拼音文本字符串的相关信息。
Phonetics返回区域的 Phonetics 集合。只读。
PivotCell返回一个 PivotCell 对象,该对象代表数据透视表中的单元格。
PivotField返回一个 PivotField 对象,该对象代表包含指定区域左上角的数据透视表字段。
PivotItem返回一个 PivotItem 对象,该对象代表包含指定区域左上角的数据透视表项。
PivotTable返回一个 PivotTable 对象,该对象代表包含指定区域左上角的数据透视表。
Precedents返回一个 Range 对象,该对象代表单元格的所有引用单元格。如果有多个引用单元格,则这可以是多个选定内容(Range 对象的联合)。只读。
PrefixCharacter返回单元格的前缀字符。Variant 类型,只读。
Previous返回一个 Range 对象,该对象代表下一个单元格。
QueryTable返回一个 QueryTable 对象,该对象代表与指定 Range 对象相交的查询表。
Range返回一个 Range 对象,该对象代表单元格或单元格区域。
ReadingOrder返回或设置指定对象的阅读次序。可为以下常量之一:xlRTL(从右到左)、xlLTR(从左到右)或 xlContextLong 类型,可读写。
Resize调整指定区域的大小。返回 Range 对象,该对象代表调整后的区域。
Row返回区域中第一个子区域的第一行的行号。Long 类型,只读。
RowHeight?(磅:指打印的字符的高度的度量单位。1 磅等于 1/72 英寸,或大约等于 1 厘米的 1/28。)为单位返回或设置指定区域中所有行的行高。如果指定区域中的各行的行高不等,则返回 nullVariant 类型,可读写。
Rows返回一个 Range 对象,该对象代表指定区域中的行。只读 Range 对象。
ServerActions指定可在 SharePoint 服务器上对 Range 对象执行的操作。
ShowDetail如果扩展了指定区域的分级显示(从而行或列的明细数据可见),则为 True。指定区域必须为分级显示中的单个汇总列或汇总行。Variant 型,可读写。对于 PivotItem 对象(如果该区域在数据透视表中,则为 Range 对象),当数据项显示明细数据时,此属性设为 True
ShrinkToFit返回或设置一个 Variant 值。
SoundNote本属性不应再被使用。语音批注已从 ET 中删除。
SparklineGroups返回一个 SparklineGroups 对象,该对象代表指定区域中的现有迷你图组。只读。
Style返回或设置一个包含 Style 对象的 Variant 值,它代表指定区域的样式。
Summary返回或设置与指定表的可选文本字符串关联的说明。可读写。
Text返回或设置指定对象中的文本。String 型,只读。
Top返回或设置一个 Variant 值,它代表行 1 上边缘到区域上边缘的距离(以磅为单位)。
UseStandardHeight如果 Range 对象的行高等于工作表的标准行高,则该值为 True。如果区域包含不止一行并且不是所有的行都等高,则返回 NullVariant 类型,可读写。
UseStandardWidth如果 Range 对象的列宽等于工作表的标准列宽,则该属性的值为 True。如果区域包含不止一列并且不是所有的列都等宽,则返回 nullVariant 类型,可读写。
Validation返回 Validation 对象,该对象代表指定区域的数据验证。只读。
Value返回或设置一个 Variant 型,它代表指定单元格的值。
Value2返回或设置单元格值。Variant 类型,可读写。
VerticalAlignment返回或设置一个 Variant 值,它代表指定对象的垂直对齐方式。
Width返回一个 Variant 值,它代表区域的宽度(以单位表示)。
Worksheet返回一个 Worksheet 对象,该对象代表包含指定区域的工作表。只读。
WrapText返回或设置一个 Variant 值,它指明 ET 是否为对象中的文本自动换行。
XPath返回一个 XPath 对象,它代表映射到指定 Range 对象的元素的 Xpath。该区域的上下文确定操作是否成功,或返回空对象。只读。