Поделиться через


Метод Find.Execute (Word)

Выполняет указанную операцию поиска. Возвращает значение True , если операция поиска выполнена успешно. Логическое значение.

Синтаксис

expression. Выполнение (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 , чтобы операция поиска обнаружила все формы текста поиска (например, "sit" находит "сидящий" и "sat"). Соответствует проверка поле Найти все формы слов в диалоговом окне Поиск и замена.
Forward Необязательный Variant Значение true для поиска вперед (ближе к концу документа).
Wrap Необязательный Variant Определяет, что происходит, если поиск начинается в точке, отличной от начала документа и достигается конец документа (или наоборот, если для параметра Forward задано значение False). Этот аргумент также определяет, что происходит, если есть выделенный фрагмент или диапазон, а текст поиска не найден в выделенном или диапазоне. Может быть одной из констант WdFindWrap .
Format Необязательный Variant Значение true , чтобы операция поиска обнаружила форматирование в дополнение к тексту поиска или вместо него.
ReplaceWith Необязательный Variant Замещающий текст. Чтобы удалить текст, указанный аргументом Find, используйте пустую строку (""). Вы указываете специальные символы и расширенные условия поиска так же, как и для аргумента Найти. Чтобы указать графический объект или другой нетекстовый элемент в качестве замены, переместите элемент в буфер обмена и укажите "^c" для ReplaceWith.
Replace Необязательный Variant Указывает количество замен: одна, все или ни одна. Может быть любой константой WdReplace .
MatchKashida Необязательный Variant Значение true , если операции поиска соответствуют тексту с соответствующими кашидами в документе на арабском языке. Этот аргумент может быть вам недоступен в зависимости от выбранной или установленной языковой поддержки (например, английский язык США).
MatchDiacritics Необязательный Variant Значение true , если поиск операций соответствует тексту с соответствующими диакритиками в документе языка справа налево. Этот аргумент может быть вам недоступен в зависимости от выбранной или установленной языковой поддержки (например, английский язык США).
MatchAlefHamza Необязательный Variant Значение true , если поиск операций соответствует тексту с соответствующими хамзами alef в документе на арабском языке. Этот аргумент может быть вам недоступен в зависимости от выбранной или установленной языковой поддержки (например, английский язык США).
MatchControl Необязательный Variant Значение true, если операции поиска соответствуют тексту с соответствующими двунаправленными контрольными символами в документе языка справа налево. Этот аргумент может быть вам недоступен в зависимости от выбранной или установленной языковой поддержки (например, английский язык США).
MatchPrefix Необязательный Variant Значение true , чтобы сопоставить слова, начинающиеся со строки поиска. Соответствует проверка префикса соответствия в диалоговом окне Поиск и замена.
MatchSuffix Необязательный Variant Значение true , чтобы сопоставить слова, заканчивающиеся строкой поиска. Соответствует суффиксу соответствия проверка в диалоговом окне Поиск и замена.
MatchPhrase Необязательный Variant Значение True игнорирует все пробелы и управляющие символы между словами.
IgnoreSpace Необязательный Variant Значение True игнорирует все пробелы между словами. Соответствует поле Пропускать пробелы проверка в диалоговом окне Поиск и замена.
IgnorePunct Необязательный Variant Значение True игнорирует все знаки препинания между словами. Соответствует проверка игнорировать пунктуацию в диалоговом окне Поиск и замена.

Возвращаемое значение

Boolean

Примечания

Если параметр MatchWildcards имеет значение True, можно указать подстановочные знаки и другие расширенные критерии поиска для аргумента FindText. Например, "*(ing)" находит любое слово, заканчивающееся на "ing".

Чтобы найти символ символа, введите курсор (^), ноль (0), а затем код символа. Например, "^0151" соответствует тире em (–).

Если не указано иное, замещающий текст наследует форматирование текста, который он заменяет в документе. Например, если заменить строку "abc" на "xyz", вхождения "abc" с полужирным форматированием будут заменены строкой "xyz" полужирным шрифтом.

Кроме того, если параметр MatchCase имеет значение False, вхождения текста поиска с прописными буквами будут заменены версией замещающего текста в верхнем регистре, независимо от варианта замещающего текста. В предыдущем примере вхождения ABC заменяются на XYZ.

Пример

В этом примере выполняется поиск и выбор следующего вхождения слова "library".

With Selection.Find 
    .ClearFormatting 
    .MatchWholeWord = True 
    .MatchCase = False 
    .Execute FindText:="library" 
End With

В этом примере выполняется поиск всех вхождений слова "hi" в активном документе и их замена на "hello".

Set myRange = ActiveDocument.Content 
myRange.Find.Execute FindText:="hi", _ 
    ReplaceWith:="hello", Replace:=wdReplaceAll

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.