執行指定的尋找作業。 如果尋找作業成功,則會傳回 True 。
語法
表情。Execute2007 (FindText、MatchCase、MatchWholeWord、MatchWildcard、MatchSoundsLike、MatchAllWordForms、轉發、換行、格式、ReplaceWith、ReplacePlace、MatchKashida、MatchDiacritics、MatchAlefHamza、MatchControl、MatchPrefix、MatchSuffix、MatchPhrase、忽略空間, 忽略Punct)
詞 一個代表 Find 物件的變數。
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
| FindText | 選用 | Variant | 要搜尋的文字。 請使用空字串 ("") 來單獨搜尋格式。 您可以藉由指定適當的字元程式碼來搜尋特殊字元。 例如,"^p" 會對應至段落標記,而 "^t" 會對應至定位字元。 |
| MatchCase | 選用 | 變數 | True 是表示 以指定要尋找的文字應該是區分大小寫。 會對應至 (在 [ 首頁] 索引標籤中 [ 編輯] 群組) 的 [ 尋找及取代] 對話方塊中的 [ 大小寫須相符] 核取方塊。 |
| MatchWholeWord | 選用 | 變數 | 則為 true 可尋找整個單字,不屬於較長的單字的文字。 會對應至 [ 尋找及取代] 對話方塊中的 [ 全字拼寫須相符] 核取方塊。 |
| MatchWildcards | 選用 | 變數 | True 可尋找文字中使用萬用字元搜尋運算子。 會對應至 [ 尋找及取代] 對話方塊中 使用萬用字元] 核取方塊。 |
| MatchSoundsLike | 選用 | 變數 | 發音類似於要尋找的文字 ,則為 true 可尋找單字。 會對應至 [ 尋找及取代] 對話方塊中的 類似的聲音] 核取方塊。 |
| MatchAllWordForms | 選用 | 變數 | True 可尋找所有形式的要尋找的文字 (例如"sit 這個"會找出"坐"和"坐")。 會對應至 [ 尋找及取代] 對話方塊中的 [ 尋找所有形態] 核取方塊。 |
| Forward | 選用 | Variant | True 是表示 向前搜尋 (直到文件的結尾)。 |
| Wrap | 選用 | Variant | 其中一個 WdFindWrap 常數,控制在搜尋是從文件開頭以外的位置開始而且到達文件結尾時發生的事件 (反之,如果 Forward 設定為 False 也是如此)。 此引數也會控制如果選取範圍或選取範圍或範圍中找不到範圍和搜尋文字會發生什麼事。 |
| Format | 選用 | 變數 | True 可尋找格式中及 (或) 而不是,若要尋找的文字。 |
| 替換 | 選用 | Variant | 取代文字。 若要刪除 Find 引數指定的文字,請使用空字串 ("")。 您可以指定特殊字元和進階搜尋準則,就如同針對 Find 引數所做的一樣。 若要將圖形物件或其他非文字項目指定為取代項目,請將此項目移至 [剪貼簿] 並針對 ReplaceWith 指定 "^c"。 |
| Replace | 選用 | 變數 | 其中一個 WdReplace 常數,指定要進行的取代數目:一個、全部或無。 |
| MatchKashida | 選用 | 變數 | True 是表示 在阿拉伯文文件中尋找比對 kashida。 此引數可能無法使用時,根據您所選取或安裝之語言支援 (例如美式英文)。 |
| MatchDiacritics | 選用 | 變數 | True 是表示 在從右至左語言之文件中尋找比對讀音符號。 此引數可能無法使用時,根據您所選取或安裝之語言支援 (例如美式英文)。 |
| MatchAlefHamza | 選用 | 變數 | True 是表示 在阿拉伯文文件中尋找比對 alef hamzas,搜尋。 此引數可能無法使用時,根據您所選取或安裝之語言支援 (例如美式英文)。 |
| MatchControl | 選用 | 變數 | True 是表示 在從右至左語言之文件中尋找比對雙向控制字元。 此引數可能無法使用時,根據您所選取或安裝之語言支援 (例如美式英文)。 |
| MatchPrefix | 選用 | 變數 | True 可尋找搜尋字串開頭的單字。 會對應至 [ 尋找及取代] 對話方塊中的 [ 前置詞須相符] 核取方塊。 |
| MatchSuffix | 選用 | 變數 | True 可尋找文字的結尾搜尋字串。 會對應至 [ 尋找及取代] 對話方塊中的 相符項目尾碼] 核取方塊。 |
| MatchPhrase | 選用 | 變數 | True 可忽略所有空格和控制字元單字之間。 |
| IgnoreSpace | 選用 | 變數 | 則為 true 可忽略文字之間的空格。 會對應至 [ 尋找及取代] 對話方塊中的 [ 略過空白字元] 核取方塊。 |
| IgnorePunct | 選用 | 變數 | 則為 true 可忽略文字間所有標點符號字元。 會對應至 [ 尋找及取代] 對話方塊中的 [ 略過標點符號] 核取方塊。 |
傳回值
指出尋找作業是否成功的 Boolean 值。
註解
MatchWildcards 則為 True 時,您可以指定萬用字元和其他進階的搜尋準則 FindText 引數。 例如,"* (傳送)"會找出任何 word 的結束於 「 傳送 」。
若要搜尋符號字元,請依序輸入 ^ 字元、零 (0) 以及此符號的字元碼。 例如,"^0151" 會對應至長破折號 (-)。
除非另外指定,否則取代文字會繼承文件中它所取代之文字的格式。 例如,如果您將字串 "abc" 取代成 "xyz",粗體格式的 "abc" 項目就會取代成粗體格式的 "xyz" 字串。
此外,如果 MatchCase 是 False ,搜尋文字的大寫的項目將會取代來取代的文字,不論取代文字的大小寫的大寫版本。 使用前一個範例,出現的"ABC"取代"XYZ"。
範例
下列範例會尋找並選取下一個出現的 "library" 這個字。
With Selection.Find
.ClearFormatting
.MatchWholeWord = True
.MatchCase = False
.Execute2007 FindText:="library"
End With
下列範例會在使用中文件內尋找 "hi" 這個字的所有項目,然後將每個項目都取代為 "hello"。
Set myRange = ActiveDocument.Content
myRange.Find.Execute2007 FindText:="hi", _
ReplaceWith:="hello", Replace:=wdReplaceAll
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。