Метод Application.ReplaceEx (Project)
Выполняет поиск нефильтрованного значения в указанном поле или во всех доступных полях и заменяет его указанным значением.
Синтаксис
expression. ReplaceEx (Field, Test, Value, Replace, ReplaceAll, Next, MatchCase, FieldID, TestID, SearchAllFields)
Выражение Выражение, возвращающее объект Application .
Параметры
| Имя | Обязательный или необязательный | Тип данных | Описание |
|---|---|---|---|
| Field | Необязательный | String | Имя поля для поиска. |
| Test | Необязательный | String | Тип сравнения между полем и значением. Может быть одной из строк сравнения. |
| Value (Значение) | Необязательный | Variant | Значение для сравнения со значением поля, указанного в поле Поле. |
| Replacement | Необязательный | Variant | Используйте "" (пустую строку), чтобы очистить поле , в котором оно соответствует тесту, указанному в параметрах Test и Value. |
| ReplaceAll | Необязательный | Variant | Значение true , если все вхождения значения заменены. False, если заменяется только первое вхождение. Значение по умолчанию — False. |
| Next | Необязательный | Variant | Значение true, если Project выполняет поиск следующего вхождения соответствующих условий поиска. False, если Project ищет следующее вхождение. Значение по умолчанию — True. |
| MatchCase | Необязательный | Variant | Значение True , если в поиске учитывается регистр. Значение по умолчанию — False. |
| FieldID | Необязательный | Variant | Идентификационный номер поля может быть одной из констант PjField . FieldID имеет приоритет над любым значением Поля . |
| TestID | Необязательный | Variant | Тестовый идентификационный номер может быть одной из констант PjComparison . TestID имеет приоритет над любым значением Test . |
| SearchAllFields | Необязательный | Variant | Если задано значение True, замените указанное значение во всех доступных полях. Значение по умолчанию — False. SearchAllFields имеет приоритет над Field и FieldID. |
Строки сравнения
| Строка сравнения | Описание |
|---|---|
| "равно" | Значение Поля равно Значению. |
| "не равно" | Значение Поля не равно Значению. |
| "больше, чем" | Значение Поля больше значения Value. |
| "больше или равно" | Значение Поля больше или равно Значению. |
| "меньше, чем" | Значение Поля меньше значения Value. |
| значение "меньше или равно" | Значение Поля меньше или равно значению Value. |
| "is within" | Значение Поля находится в значении Value. |
| "не внутри" | Значение Field не находится в значении Value. |
| "contains" | Поле содержит значение. |
| "не содержит" | Поле не содержит значение. |
| "содержит точно" | Поле содержит точно значение. |
Возвращаемое значение
Boolean
Значение true , если производится какая-либо замена; в противном случае — False.
Замечания
При использовании метода ReplaceEx без аргументов или без указания поля, теста и значения отображается диалоговое окно Заменить с параметрами, заданными для предыдущего состояния. Если для параметра SearchAllFields заданозначение True, для программного использования по-прежнему требуются значения параметров Field, Test и Value .
Пример
Любая строка в следующем примере заменяет "Bad" на "Хорошо" в наборе всех доступных полей.
Sub Bad2Good()
ReplaceEx Field:="Name", Test:="contains", Value:="Bad", Replacement:="Good", _
ReplaceAll:=True, SearchAllFields:=True
ReplaceEx Field:="xx", Test:="xx", TestID:=pjCompareContains, Value:="Bad", Replacement:="Good", _
ReplaceAll:=True, SearchAllFields:=True
End Sub
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.