Find.Execute 方法

定义

命名空间:

Microsoft.Office.Interop.Word

程序集:

Microsoft.Office.Interop.Word.dll

运行指定的查找操作。

public bool Execute (ref object FindText, ref object MatchCase, ref object MatchWholeWord, ref object MatchWildcards, ref object MatchSoundsLike, ref object MatchAllWordForms, ref object Forward, ref object Wrap, ref object Format, ref object ReplaceWith, ref object Replace, ref object MatchKashida, ref object MatchDiacritics, ref object MatchAlefHamza, ref object MatchControl);

abstract member Execute : obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> bool

Public Function Execute (Optional ByRef FindText As Object, Optional ByRef MatchCase As Object, Optional ByRef MatchWholeWord As Object, Optional ByRef MatchWildcards As Object, Optional ByRef MatchSoundsLike As Object, Optional ByRef MatchAllWordForms As Object, Optional ByRef Forward As Object, Optional ByRef Wrap As Object, Optional ByRef Format As Object, Optional ByRef ReplaceWith As Object, Optional ByRef Replace As Object, Optional ByRef MatchKashida As Object, Optional ByRef MatchDiacritics As Object, Optional ByRef MatchAlefHamza As Object, Optional ByRef MatchControl As Object) As Boolean

参数

FindText

Object

可选 对象。 要搜索的文本。 使用空字符串 ("") 仅搜索格式。 可以指定适当的字符代码来搜索特殊字符。 例如，"^p"对应段落标记，"^t"对应制表符。

MatchCase

Object

可选 对象。 True 指定查找文本是区分大小写。 对应于“查找和替换”对话框（“编辑”菜单）中的“区分大小写”复选框。

MatchWholeWord

Object

可选 对象。 如果为 True ，则查找操作仅查找整个单词，而不是较大单词的一部分的文本。 对应于“查找和替换”对话框中的“全字匹配”复选框。

MatchWildcards

Object

可选 对象。 为 要查找的文字是特殊搜索操作符。 对应于“查找和替换”对话框中的“使用通配符”复选框。

MatchSoundsLike

Object

可选 对象。 类似于查找的文字发音单词 ，则返回 true ，则查找操作定位。 对应于 查找和替换对话框中的 听起来象复选框。

MatchAllWordForms

Object

可选 对象。 ，则返回 true ，则查找操作定位查找文字的所有形式 (例如，"sit"查找"坐"，而"坐")。 对应于 查找和替换对话框中的 查找单词的各种形式复选框。

Forward

Object

可选 对象。 真 要向前搜索 (向文档的末尾)。

Wrap

Object

可选 对象。 控制如果搜索从文档开头以外的某个点开始，并且到达文档的末尾 (，反之亦然（如果 Forward 设置为 False) ）。 此参数还控制如果存在所选内容或区域，并且所选内容或区域中未找到搜索文本，会发生什么情况。可以是以下WdFindWrap常量之一：wdFindAsk 搜索所选内容或范围后，Microsoft Word会显示一条消息，询问是否搜索文档的其余部分。wdFindContinue 如果达到搜索范围的开始或结束，则查找操作会继续。wdFindStop如果到达搜索范围的开始或结束，则查找操作将结束。

Format

Object

可选 对象。 如果为 True ，则让查找操作在查找文本之外查找格式。

ReplaceWith

Object

可选 对象。 替换文字。 若要删除参数指定的 Find 文本，请使用空字符串 (“”) 。 可以指定特殊字符和高级搜索条件，就像为 参数指定 Find 一样。 若要指定图形对象或其他非文本项作为替换项，请将该项移动到剪贴板并为 指定“^c”。ReplaceWith

Replace

Object

可选 对象。 指定要执行替换的个数：一个、全部或者不替换。 可以是任何 WdReplace 常量：wdReplaceAll wdReplaceNone wdReplaceOne

MatchKashida

Object

可选 对象。 如此 如果查找操作用 kashida 阿拉伯语文档中匹配的文本。 根据您所选择或安装的语言支持（例如，美国英语），此参数可能不可用。

MatchDiacritics

Object

可选 对象。 如此 如果查找操作用匹配从右到左语言的文档中的音调符号来匹配文字。 根据您所选择或安装的语言支持（例如，美国英语），此参数可能不可用。

MatchAlefHamza

Object

可选 对象。 如此 如果查找操作用匹配 alef hamza 适用于阿拉伯语文档中的匹配的文本。 根据您所选择或安装的语言支持（例如，美国英语），此参数可能不可用。

MatchControl

Object

可选 对象。 如此 如果查找操作用匹配的从右到左语言的文档中的双向控制字符来匹配文字。 根据您所选择或安装的语言支持（例如，美国英语），此参数可能不可用。

返回

Boolean

注解

如果查找操作成功，此方法返回 True 。

如果 MatchWildcards 为 True，则可以为 FindText 参数指定通配符和其他高级搜索条件。 例如，“* (ing) ”查找以“ing”结尾的任何单词。

要搜索符号字符，可键入脱字符号 (^)、零 (0)，然后键入符号字符的代码。 例如，“^0151”对应于 em 短划线 ( — ) 。

除非另外指定，否则替换文本将沿用文档中被替换文本的格式。 例如，如果将字符串“abc”替换为“xyz”，则使用粗体格式的“abc”将替换为带有加粗格式的字符串“xyz”。

此外，如果 MatchCase 为 False，则搜索文本为大写的匹配项将替换为替换文本的大写版本，而不管搜索和替换文本大小写。 使用前面的示例，“ABC”的匹配项将替换为“XYZ”。