Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Выполняет указанную операцию поиска. Если операция поиска успешна, возвращает значение True . Логическое значение.
Синтаксис
выражение. Выполнение (FindText, MatchCase, MatchWholeWord, MatchWildcards, MatchSoundsLike, MatchAllWordForms, forward, wrap, format, replaceWith, replace, MatchKashida, MatchDiacritics, MatchAlefHamza, MatchControl)
выражение (обязательно). Переменная, представляющая объект Find .
Параметры
| Имя | Обязательный или необязательный | Тип данных | Описание |
|---|---|---|---|
| FindText | Необязательный | Variant | Текст, который необходимо найти. Используйте пустую строку ("") для поиска только по форматированию. Для поиска специальных символов указываются соответствующие коды. Например, "^p" соответствует знаку абзаца, а "^t" — символу табуляции. |
| MatchCase | Необязательный | Variant | Значение true , чтобы текст поиска учитывался регистром. Соответствует полю "Проверка конкретного регистра" в диалоговом окне "Найти и заменить" (меню "Правка"). |
| MatchWholeWord | Необязательный | Variant | True , чтобы операция поиска находила только целые слова, а не текст, который является частью большего слова. Соответствует полю "Только слова целиком" проверка диалогового окна "Найти и заменить". |
| MatchWildcards | Необязательный | Variant | True , чтобы найти текст был специальным оператором поиска. Соответствует полю "Подстановочные знаки проверка" диалогового окна "Найти и заменить". |
| MatchSoundsLike | Необязательный | Variant | True , чтобы операция поиска находила слова, похожие по звучанию на текст поиска. Соответствует полю "Похоже на проверку" в диалоговом окне "Найти и заменить". |
| MatchAllWordForms | Необязательный | Variant | True : операция поиска находит все формы текста поиска (например, "сидеть" находит слова "сидящий" и "сидящий"). Соответствует полю "Найти все формы слов" проверка диалогового окна "Найти и заменить". |
| Forward | Необязательный | Variant | True для поиска вперед (ближе к концу документа). |
| Wrap | Необязательный | Variant | Определяет, что произойдет, если поиск начинается не в начале документа, а в конце документа (или наоборот, если для параметра "Вперед" установлено значение Ложь). Этот аргумент также управляет тем, что происходит, если есть выделение или диапазон, а искомый текст не найден в выбранном или диапазоне. Может быть одной из констант WdFindWrap . |
| Format | Необязательный | Variant | Это означает , что операция "Найти" находит форматирование в дополнение к тексту "Найти" или вместо него. |
| ЗаменитьНа | Необязательный | Variant | Замещающий текст. Чтобы удалить текст, указанный аргументом Find, используйте пустую строку (""). Специальные символы и расширенные условия поиска указываются так же, как и для аргумента "Найти". Чтобы указать графический объект или другой нетекстовый элемент в качестве замены, переместите элемент в буфер обмена и укажите "^c" для ReplaceWith. |
| Replace | Необязательный | Variant | Указывает, сколько замен должно быть сделано: одну, все или ни одной. Может принимать любое значение для константы WdReplace . |
| MatchKashida | Необязательный | Variant | True , если операции поиска сопоставляются с текстом с соответствующими кашидами в документе на арабском языке. Этот аргумент может быть вам недоступен в зависимости от выбранной или установленной языковой поддержки (например, английский (США). |
| MatchDiacritics | Необязательный | Variant | Возвращает значение "True ", если в документе с написанием справа налево текст сопоставляется с диакритическими знаками. Этот аргумент может быть вам недоступен в зависимости от выбранной или установленной языковой поддержки (например, английский (США). |
| MatchAlefHamza | Необязательный | Variant | True , если операции поиска сопоставляют текст с соответствующими алифами гамзас в арабоязычном документе. Этот аргумент может быть вам недоступен в зависимости от выбранной или установленной языковой поддержки (например, английский (США). |
| MatchControl | Необязательный | Variant | True , если операции поиска сопоставляются с текстом с двунаправленными управляющими знаками в документе с написанием справа налево. Этот аргумент может быть вам недоступен в зависимости от выбранной или установленной языковой поддержки (например, английский (США). |
| MatchPrefix | Необязательный | Variant | Истина для поиска слов, начинающихся со строки поиска. Соответствует полю "Проверка префикса" в диалоговом окне "Найти и заменить". |
| MatchSuffix | Необязательный | Variant | Истина для поиска слов, которые заканчиваются строкой поиска. Соответствует полю "Проверка суффикса сопоставления" в диалоговом окне "Найти и заменить". |
| MatchPhrase | Необязательный | Variant | Истина игнорирует все пробелы и управляющие знаки между словами. |
| IgnoreSpace | Необязательный | Variant | Истина игнорирует все пробелы между словами. Соответствует полю "Игнорировать проверку пробелов" в диалоговом окне "Найти и заменить". |
| IgnorePunct | Необязательный | Variant | При использовании значения "истина " пропускаются все знаки препинания между словами. Соответствует полю "Игнорировать проверку" в диалоговом окне "Найти и заменить". |
Возвращаемое значение
Boolean
Примечания
Если функция MatchWildcards имеет значение True, вы можете указать подстановочные знаки и другие расширенные условия поиска для аргумента FindText. Например, "*(ing)" находит любое слово, оканчивающееся на "ing".
Чтобы найти символ символа, введите крышку (^), нуль (0) и код символа. Например, "^0151" соответствует длинному тире (—).
Если не указано иное, замещающий текст наследует форматирование текста, который он заменяет в документе. Например, если заменить строку "abc" на "xyz", вхождения "abc" с полужирным форматированием будут заменены строкой "xyz" с полужирным начертанием.
Кроме того, если свойство MatchCase имеет значение False, прописные вхождения искомого текста будут заменены прописными буквами замещающего текста, независимо от регистра замещающего текста. В предыдущем примере вхождения "ABC" заменяются на "XYZ".
Пример
В этом примере выполняется поиск и выбор следующего вхождения слова "библиотека".
With Selection.Find
.ClearFormatting
.MatchWholeWord = True
.MatchCase = False
.Execute FindText:="library"
End With
В этом примере найдены все вхождения слова "привет" в активном документе, где каждое вхождение заменяется на "привет".
Set myRange = ActiveDocument.Content
myRange.Find.Execute FindText:="hi", _
ReplaceWith:="hello", Replace:=wdReplaceAll
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.