Execute 方法(Find 對象)
運行指定的尋找操作。如果尋找成功,則返回 True。
文法
expression.Execute(FindText, MatchCase, MatchWholeWord, MatchWildcards, MatchSoundsLike, MatchAllWordForms, Forward, Wrap, Format, ReplaceWith, Replace, MatchKashida, MatchDiacritics, MatchAlefHamza, MatchControl)
expression 必需。該運算式返回 Find 對象。
FindText Variant 類型,可選。指定需尋找的文本。可用Null 字元串 ("") 尋找格式。也可通過指定適當的字元代碼尋找特殊字元。例如,“^p”對應段落標記,“^t”對應定位字元。如果需要使用特殊字元列表,請參閱尋找替換特殊字元和文件項目樣本。
如果 MatchWildcards 為 True,則可以指定萬用字元及其他進階搜尋條件。例如,“*(ing)” 將尋找以“ing”結尾的所有單詞。詳細內容,請參閱萬用字元搜尋樣本。
若要搜尋符號字元,可鍵入 (^) 字元,零(0),然後鍵入符號字元的代碼。例如,“^0151”對應一條長劃線(—)。
MatchCase Variant 類型,可選。如果是 True,則尋找文本需區分大小寫。相當於[編輯] 功能表“尋找和替換”對話方塊中的“區分大小寫”複選框。
MatchWholeWord Variant 類型,可選。如果為 True,則只尋找匹配的完整單詞,而並非作為一個長單詞的一部分的文字。相當於[編輯] 功能表“尋找和替換”對話方塊中的“全字匹配”複選框。
MatchWildcards Variant 類型,可選。如果為 True,則尋找的文字包含特殊搜尋操作符。相當於[編輯] 功能表“尋找和替換”對話方塊中的“使用萬用字元”複選框。
MatchSoundsLike Variant 類型,可選。如果為 True,則尋找與待尋找文字發音相近的單詞。相當於[編輯] 功能表“尋找和替換”對話方塊中的“同音”複選框。
MatchAllWordForms Variant 類型,可選。如果為 True,則尋找文字的所有形式(例如,“ sit” 將包含“sitting”和“sat”)。相當於[編輯] 功能表“尋找和替換”對話方塊中的“尋找單詞的各種形式”複選框。
Forward Variant 類型,可選。如果為 True,則向下(向文檔尾部)搜尋。
Wrap Variant 類型,可選。如果搜尋從不是文檔開頭的位置開始,併到達文檔末尾(如 Forward 設定為 False,則相反),用本參數控制接下來的操作。當在選定內容或地區中沒有找到搜尋文字時,本參數也控制接下來的操作。可以是下列 WdFindWrap 常量之一:
| 常量 |
描述 |
| wdFindAsk |
搜尋完所選內容或者地區後,Microsoft Word 會顯示一條訊息,詢問是否搜尋文檔的其他部分。 |
| wdFindContinue |
到達搜尋地區的開始或者結尾時,繼續執行尋找操作。 |
| wdFindStop |
到達搜尋範圍的開始或者結尾時,停止執行尋找操作。 |
Format Variant 類型,可選。 如果為 True,則尋找格式而非文字。
ReplaceWith Variant 類型,可選。替換文字。要刪除由 Find 參數指定的文字,可使用Null 字元串 ("")。與 Find 參數相似,本參數也可以指定特殊的字元和進階搜尋條件。要將繪圖物件或者其他非文本項指定為替換內容,可將這些項目置於“剪貼簿”上,然後將 ReplaceWith 指定為“ ^c”。
Replace Variant 類型,可選。指定執行替換的個數:一個、全部或者不替換。可為下列 WdReplace 常量之一:wdReplaceAll、wdReplaceNone 或 wdReplaceOne。
MatchKashida Variant 類型,可選。如果為 True,則尋找結果應與阿拉伯語文檔中區分 kashidas 的文本相匹配。由於選擇或安裝的語言支援不同(例如,美國英語),此參數可能不可用。
MatchDiacritics Variant 類型,可選。如果為 True,則尋找結果應與區分變音符號的語言文本相匹配。由於選擇或安裝的語言支援不同(例如,美國英語),此參數可能不可用。
MatchAlefHamza Variant 類型,可選。如果為 True,則在阿拉伯語文檔中,尋找內容應與區分 Alef Hamzas 的文本相匹配。由於選擇或安裝的語言支援不同(例如,美國英語),此參數可能不可用。
MatchControl Variant 類型,可選。如果為 True,則在從右至左運用語言的文檔中,尋找內容應區分雙向控制字元。由於選擇或安裝的語言支援不同(例如,美國英語),此參數可能不可用。
說明
除非另外指定,否則替換文本將沿用文檔中被替換文本的格式。例如,如果用“xyz”替換“abc”,那麼粗體“abc”將被粗體字串“xyz”所替換。
同樣,如果 MatchCase 為 False,那麼尋找到的大寫文本將被大寫的替換文本替換,而無論搜尋文本和替換文本是否大小寫。上例中,“ABC”將被“XYZ”替換。