Excel区域操作

对已打开 Excel 里的某个区域赋值、设格式、调用方法或读取信息。通过 Microsoft.Office.Interop，本机需要安装 Excel。「区域」对应 Range。只读写文件、不启动 Excel 请用 Excel文件读写。

当前模块定义​

概述​

• 因权限限制，只能操作由 Quicker 打开的工作簿。用下面的动作打开：
• 编程改过的内容无法撤销，改之前先保存。
• 封装面很广，可能和预期不一致，欢迎反馈。熟悉 VBA 会更好用。

参数说明​

区域：要操作的范围，任选一种写法：

• 通过变量或表达式传入Range对象。
• 不填写内容：表示当前Excel窗口中选定的区域。
• 填写“used”（不写引号）：表示当前Excel窗口工作表中使用的整个区域。内部实现：通过当前工作表的UsedRange属性得到。
• 填写指定区域范围的文本，如“A1:E9”“A1”等（不写引号）。内部实现：通过当前工作表的Range属性(VBA文档)得到。

限定子范围：把操作目标再收窄到「区域」里的一部分。

• 整个区域
• 区域内的第一行 / 区域内的第一列 / 区域内最后一行 / 区域内最后一列
• 活动单元格：当前有录入焦点的单元格
• 整行(包含区域外)：EntireRow，调行高时用
• 整列(包含区域外)：EntireColumn，调列宽时用
• 所有行(区域范围内)：Rows
• 所有列(区域范围内)：Columns

旧稿里的「指定单元格 / cell:行,列」当前 catalog 已无此项；请改用「区域」写 A1 这类地址，或先「获取区域信息」再操作。

操作类型：

• 设置值：为区域的单元格赋值。内部实现为：为 Region.Value 属性赋值。

• 设置公式：为区域的单元格设置公式。内部实现为：为 Region.Formula 属性赋值。与在编辑栏（包括等号）中显示时的格式相同，如：“=RAND()*100000”

• 设置数值格式：设置单元格格式。内部实现为：为Range.NumberFormat 属性赋值。格式代码是在 设置单元格格式对话框中 格式代码选项相同的字符串。

• 行高,列宽：为区域设置行高列宽，格式为“行高,列宽”

• 行高可以指定的值：

• -（横线符号）：表示不更改行高；

• auto：表示自适应行高；

• std：表示默认行高；

• 整数数字：以磅为单位的行高值。

• 列宽可以指定的值：

• -（横线符号）：表示不更改列宽；

• auto：表示自适应列宽；

• std：表示默认列宽；

• 整数数字：指定具体的宽度数值。一个列宽单位等于"常规"样式中一个字符的宽度。对于比例字体，则使用字符 0（零）的宽度。

• 设置格式：每行一条格式，见下文。对应参数 格式。

• 调用方法：每行一个 Range 方法，见下文。对应参数 方法。

• 替换内容：在区域内查找替换。对应 查找内容、替换为、转义"查找内容"、转义"替换为"、区分大小写。

• 获取区域信息：读值 / 公式 / 格式 / 位置 / 对象引用。

失败后停止：失败后是否中止动作。默认开启。

设置值 / 公式 / 数值格式时，内容写在 参数 里。行高列宽写在 行高,列宽 里。

输出​

• 是否成功
• 仅「获取区域信息」：值、文本、公式、数值格式、位置引用、列号、行号、列数、行数、格式信息、区域对象、工作表对象

替换内容​

查找内容 / 替换为：要找的文本和换成的文本。

转义"查找内容" / 转义"替换为"：把 \r \n \t 当成换行和 Tab。

区分大小写：默认关闭。

设置格式​

在 格式 参数里写，每行一条，形式为 格式名称=格式值。

支持的格式如下：

调用方法​

调用Range对象的某一个方法。请参考VBA文档中Range对象的各个方法的说明获取详细信息。

每行一个方法，格式为：“方法名(不需要参数的方法):”或“方法名:参数1,参数2....”

简单方法：

注：本文部分方法的说明参考自 https://www.bilibili.com/read/cv2365417/

较为复杂的方法​

**AdvancedFilter:**Action, CriteriaRange, CopyToRange, Unique 高级筛选 VBA文档

参数：

Action 操作类型，可选值：

• xlFilterInPlace  将筛选结果显示在原位置
• xlFilterCopy  将筛选出的数据复制到新位置

CriteriaRange 条件区域，可选

CopyToRange 复制到的区域，可选

Unique  是否筛选唯一值

示例：

*AdvancedFilter:*xlFilterCopy,,G1:G9,true

Consolidate:Sources, Function, TopRow, LeftColumn, CreateLinks 合并计算

Sources：使用英文分号;分隔的多个需要计算的源区域。必须包含将要合并计算的工作表的完整路径。如Sheet1!R1C1:R4C2;Sheet1!R7C7:R10C8

Function：XlConsolidationFunction的常量值之一：

• xlAverage 平均.
• xlCount 计数.
• xlCountNums 只计数数值。
• xlDistinctCount 使用非重复计数分析进行计数。
• xlMax 最大值。
• xlMin 最小值。
• xlProduct 乘除.
• xlStDev 基于样本的标准偏差。
• xlStDevP 基于全体数据的标准偏差。
• xlSum 总值.
• xlUnknown 未指定任何分类汇总函数。
• xlVar 基于样本的方差。
• xlVarP 基于全体数据的方差。

*TopRow：可选，*如果为 True，则基于合并计算区域中首行内的列标题对数据进行合并。 如果为 False，则按位置进行合并计算。 默认值为 False。

*LeftColumn：*可选，如果为 True 则基于合并计算区域中左列内的行标题对数据进行合并计算。 如果为 False，则按位置进行合并计算。 默认值为 False。

*CreateLinks：可选，*如果为 True，则让合并计算使用工作表链接。 如果为 False，则让合并计算复制数据。 默认值为 False。

**ExportAsFixedFormat:**Type,FileName 导出为固定格式。（相对于原版方法参数有所精简）

Type:类型，可选xlTypePDF、xlTypeXPS

FileName：要导出的文件路径。

**PasteSpecial:**Paste, Operation, SkipBlanks, Transpose 特殊格式粘贴

Paste: 要粘贴的类型，可选值为XLPasteType的常量之一：

Operation：粘贴的操作方式，可选值为XlPasteSpecialOperation 的值之一：

*SkipBlanks：*如果为 True，则不将剪贴板上区域中的空白单元格粘贴到目标区域中。 默认值为 False。

*Transpose：*如果为 True , 则在粘贴区域时转置行和列。 默认值为 False。

示例：

PasteSpecial:xlPasteValues,xlPasteSpecialOperationAdd,false,false

相关链接​