C++ 应用集成 WPS 指南 > 表格 API 参考 > Range > Range 对象成员

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

方法

? 名称 说明
Activate 激活单个单元格，该单元格必须处于当前选定区域内。要选择单元格区域，请使用 Select 方法。
AddComment 为区域添加批注。
AdvancedFilter 基于条件区域从列表中筛选或复制数据。如果初始选定区域为单个单元格，则使用单元格的当前区域。
AllocateChanges 在基于 OLAP 数据源的区域中的所有已编辑的单元格上执行回写操作。
ApplyNames 将名称应用于指定区域中的单元格。
ApplyOutlineStyles 对指定区域应用分级显示样式。
AutoComplete 从列表中返回一个记忆式键入匹配项。如果没有相应的记忆式键入匹配项，或者在列表中有不止一个与已键入字符串相匹配的项，此方法将返回一空字符串。
AutoFill 对指定区域中的单元格执行自动填充。
AutoFilter 使用“自动筛选”筛选一个列表。
AutoFit 更改区域中的列宽或行高以达到最佳匹配。
AutoOutline 自动为指定区域创建分级显示。如果区域为单个单元格，ET 将创建整个工作表的分级显示。新分级显示将取代所有的分级显示。
BorderAround 向单元格区域添加边框，并设置该新边框的 Color、LineStyle 和 Weight 属性。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 对指定区域左上角单元格启动“函数向导”。
Group 当 Range 对象代表某个数据透视表字段的数据区域中的单个单元格时，Group 方法在该字段中执行基于数字或日期的分组。
Insert 在工作表或宏表中插入一个单元格或单元格区域，其他单元格相应移位以腾出空间。
InsertIndent 向指定的区域添加缩进量。
Justify 调整区域内的文字，使之均衡地填充该区域。
ListNames 从指定区域的第一个单元格位置开始，将所有未隐藏的名称的列表粘贴到工作表上。
Merge 由指定的 Range 对象创建合并单元格。
NavigateArrow 定位追踪箭头，此箭头指定引用单元格、从属单元格或错误源单元格。选定引用单元格、从属单元格或错误源单元格并返回一个 Range 对象，该对象代表新选定区域。本方法应用于没有可见追踪箭头的单元格时将出错。
NoteText 返回或设置与区域左上角单元格相关联的单元格注释。String 类型，可读写。单元格注释已经替换为区域注释。有关详细信息，请参阅 Comment 对象。
Parse 分列区域内的数据并将这些数据分散放置于若干单元格中。将区域内容分配于多个相邻接的列中；该区域只能包含一列。
PasteSpecial 将 Range 从剪贴板粘贴到指定的区域中。
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 数组。如果指定区域不包含数组公式，则该属性返回 null。Variant 类型，可读写。
FormulaHidden 返回或设置一个 Variant 值，它指明在工作表处于保护状态时是否隐藏公式。
FormulaLocal 返回或设置对象的公式，使用用户语言 A1 格式引用。可读/写 Variant 类型。
FormulaR1C1 返回或设置对象的公式，使用宏语言 R1C1 格式符号表示。可读/写 Variant 类型。
FormulaR1C1Local 返回或设置对象的公式，使用用户语言 R1C1 格式符号表示。可读/写 Variant 类型。
HasArray 如果指定单元格属于数组公式，则该属性值为 True。Variant 类型，只读。
HasFormula 如果区域中所有单元格均包含公式，则该属性值为 True；如果所有单元格均不包含公式，则该属性值为 False；其他情况下为 null。Variant 类型，只读。
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 如果区域包含合并单元格，则为 True。Variant 型，可读写。
Name 返回或设置一个 Variant 值，它代表对象的名称。
Next 返回一个 Range 对象，该对象代表下一个单元格。
NumberFormat 返回或设置一个 Variant 值，它代表对象的格式代码。
NumberFormatLocal 以采用用户语言字符串的形式返回或设置一个 Variant 值，它代表对象的格式代码。
Offset 返回一个 Range 对象，该对象代表与指定区域存在一定偏移的区域。
Orientation 返回或设置一个 Variant 值，它代表文本方向。
OutlineLevel 返回或设置指定行或列的当前分级显示级别。Variant 类型，可读写。
PageBreak 返回或设置分页符的位置。可为以下 XlPageBreak 常量之一：xlPageBreakAutomatic、xlPageBreakManual 或 xlPageBreakNone。Long 类型，可读写。
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（从左到右）或 xlContext。Long 类型，可读写。
Resize 调整指定区域的大小。返回 Range 对象，该对象代表调整后的区域。
Row 返回区域中第一个子区域的第一行的行号。Long 类型，只读。
RowHeight 以磅（磅：指打印的字符的高度的度量单位。1 磅等于 1/72 英寸，或大约等于 1 厘米的 1/28。）为单位返回或设置指定区域中所有行的行高。如果指定区域中的各行的行高不等，则返回 null。Variant 类型，可读写。
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。如果区域包含不止一行并且不是所有的行都等高，则返回 Null。Variant 类型，可读写。
UseStandardWidth 如果 Range 对象的列宽等于工作表的标准列宽，则该属性的值为 True。如果区域包含不止一列并且不是所有的列都等宽，则返回 null。Variant 类型，可读写。
Validation 返回 Validation 对象，该对象代表指定区域的数据验证。只读。
Value 返回或设置一个 Variant 型，它代表指定单元格的值。
Value2 返回或设置单元格值。Variant 类型，可读写。
VerticalAlignment 返回或设置一个 Variant 值，它代表指定对象的垂直对齐方式。
Width 返回一个 Variant 值，它代表区域的宽度（以单位表示）。
Worksheet 返回一个 Worksheet 对象，该对象代表包含指定区域的工作表。只读。
WrapText 返回或设置一个 Variant 值，它指明 ET 是否为对象中的文本自动换行。
XPath 返回一个 XPath 对象，它代表映射到指定 Range 对象的元素的 Xpath。该区域的上下文确定操作是否成功，或返回空对象。只读。