【xlwings api语言参考】Range.Replace 方法

原创

已于 2023-03-06 10:56:15 修改 · 937 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#python

于 2022-06-07 20:37:54 首次发布

xlwings API的Range.Replace方法用于在Excel范围内查找并替换特定字符串。该方法返回一个布尔值，表示是否成功找到并替换了指定内容。参数包括What（要搜索的字符串）、Replacement（替换字符串）、LookAt（搜索模式）、SearchOrder（搜索顺序）、MatchCase（是否区分大小写）等。每次调用方法时，会保存设置，下次调用如果不指定参数则使用保存的值。示例中展示了如何替换工作表Sheet1的A列中所有SIN函数为COS函数。

功能：
返回布尔值，它表示指定区域内单元格中的字符。使用此方法不会更改选中范围或活动单元格。

语法：
rng.Replace(What, Replacement, LookAt, SearchOrder, MatchCase, MatchByte, SearchFormat, ReplaceFormat)
rng是一个表示 Range 对象的变量。

参数：
名称必需/可选数据类型说明
What 必需字符串要搜索Microsoft Excel字符串。
Replacement 必需字符串替换字符串。
LookAt 可选 XlLookAt 可以是下列 XlLookAt 常量之一：xlWhole 或 xlPart。
SearchOrder 可选 XlSearchOrder 可以是以下 XlSearchOrder 常量之一：xlByRows 或 xlByColumns。
MatchCase 可选布尔值如果为 True，则搜索区分大小写。
MatchByte 可选布尔值只有在已选择或安装双字节语言支持时，才能使用此参数Microsoft Excel。如果为 True，则双字节字符仅匹配双字节字符。如果为 False，则双字节字符匹配其单字节等效字符。
SearchFormat 可选字符串该方法的搜索格式。
ReplaceFormat 可选字符串方法的替换格式。

返回值：
布尔值

注解：
每次使用此方法时，将保存 LookAt、 SearchOrder、 MatchCase 和 MatchByte 的设置。如果在下次调用该方法时不指定这些参数的值，则使用保存的值。设置这些参数会更改“查找”对话框中的设置，更改“查找”对话框中的设置会更改省略参数时使用的已保存值。为了避免出现问题，请每次使用此方法时显式设置这些参数。

示例：
此示例会