Aspose::Words::Replacing::FindReplaceOptions класс

FindReplaceOptions class

Указывает параметры операций поиска/замены. Чтобы узнать больше, посетите статью документации Find and Replace.

class FindReplaceOptions : public System::Object

Методы

МетодОписание
FindReplaceOptions()Инициализирует новый экземпляр класса FindReplaceOptions с настройками по умолчанию.
FindReplaceOptions(Aspose::Words::Replacing::FindReplaceDirection)Инициализирует новый экземпляр класса FindReplaceOptions с указанным направлением.
FindReplaceOptions(const System::SharedPtr<Aspose::Words::Replacing::IReplacingCallback>&)Инициализирует новый экземпляр класса FindReplaceOptions с указанным обратным вызовом замены.
FindReplaceOptions(Aspose::Words::Replacing::FindReplaceDirection, const System::SharedPtr<Aspose::Words::Replacing::IReplacingCallback>&)Инициализирует новый экземпляр класса FindReplaceOptions с указанным направлением и обратным вызовом замены.
get_ApplyFont() constФорматирование текста, применяемое к новому содержимому.
get_ApplyParagraphFormat() constФорматирование Paragraph применяемое к новому содержимому.
get_Direction() constВыбирает направление для замены. Значение по умолчанию — Forward.
get_FindWholeWordsOnly() constTrue указывает, что oldValue должен быть отдельным словом.
get_IgnoreDeleted() constПолучает или задает логическое значение, указывающее, следует ли игнорировать текст внутри удалённых правок. Значение по умолчанию — false.
get_IgnoreFieldCodes() constПолучает или задает логическое значение, указывающее, следует ли игнорировать текст внутри кодов полей. Значение по умолчанию — false.
get_IgnoreFields() constПолучает или задает логическое значение, указывающее, следует ли игнорировать текст внутри полей. Значение по умолчанию — false.
get_IgnoreFootnotes() constПолучает или задает логическое значение, указывающее, следует ли игнорировать сноски. Значение по умолчанию — false.
get_IgnoreInserted() constПолучает или задает логическое значение, указывающее, следует ли игнорировать текст внутри вставленных правок. Значение по умолчанию — false.
get_IgnoreOfficeMath() constПолучает или задает логическое значение, указывающее, следует ли игнорировать текст внутри OfficeMath/>. Значение по умолчанию — true.
get_IgnoreShapes() constПолучает или задает логическое значение, указывающее, следует ли игнорировать фигуры внутри текста. Значение по умолчанию — false.
get_IgnoreStructuredDocumentTags() constПолучает или задает логическое значение, указывающее, следует ли игнорировать содержимое StructuredDocumentTag. Значение по умолчанию — false.
get_LegacyMode() constПолучает или задает логическое значение, указывающее, что используется старый алгоритм поиска/замены.
get_MatchCase() constTrue указывает на сравнение с учётом регистра, false указывает на сравнение без учёта регистра.
get_ReplacementFormat() constУказывает формат замены. По умолчанию — Text.
get_ReplacingCallback() constПользовательский метод, который вызывается перед каждым вхождением замены.
get_SmartParagraphBreakReplacement() constПолучает или задает логическое значение, указывающее, разрешено ли заменять разрыв абзаца, когда нет следующего соседнего абзаца. Значение по умолчанию — false.
get_UseLegacyOrder() constЗначение true указывает, что поиск текста выполняется последовательно сверху вниз с учётом текстовых полей. Значение по умолчанию — false.
get_UseSubstitutions() constПолучает или задает логическое значение, указывающее, следует ли распознавать и использовать подстановки в шаблонах замены. Значение по умолчанию — false.
GetType() const override
Is(const System::TypeInfo&) const override
set_Direction(Aspose::Words::Replacing::FindReplaceDirection)Выбирает направление для замены. Значение по умолчанию — Forward.
set_FindWholeWordsOnly(bool)Сеттер для Aspose::Words::Replacing::FindReplaceOptions::get_FindWholeWordsOnly.
set_IgnoreDeleted(bool)Сеттер для Aspose::Words::Replacing::FindReplaceOptions::get_IgnoreDeleted.
set_IgnoreFieldCodes(bool)Сеттер для Aspose::Words::Replacing::FindReplaceOptions::get_IgnoreFieldCodes.
set_IgnoreFields(bool)Сеттер для Aspose::Words::Replacing::FindReplaceOptions::get_IgnoreFields.
set_IgnoreFootnotes(bool)Сеттер для Aspose::Words::Replacing::FindReplaceOptions::get_IgnoreFootnotes.
set_IgnoreInserted(bool)Сеттер для Aspose::Words::Replacing::FindReplaceOptions::get_IgnoreInserted.
set_IgnoreOfficeMath(bool)Сеттер для Aspose::Words::Replacing::FindReplaceOptions::get_IgnoreOfficeMath.
set_IgnoreShapes(bool)Сеттер для Aspose::Words::Replacing::FindReplaceOptions::get_IgnoreShapes.
set_IgnoreStructuredDocumentTags(bool)Сеттер для Aspose::Words::Replacing::FindReplaceOptions::get_IgnoreStructuredDocumentTags.
set_LegacyMode(bool)Сеттер для Aspose::Words::Replacing::FindReplaceOptions::get_LegacyMode.
set_MatchCase(bool)Сеттер для Aspose::Words::Replacing::FindReplaceOptions::get_MatchCase.
set_ReplacementFormat(Aspose::Words::Replacing::ReplacementFormat)Указывает формат замены. По умолчанию — Text.
set_ReplacingCallback(const System::SharedPtr<Aspose::Words::Replacing::IReplacingCallback>&)Пользовательский метод, который вызывается перед каждым вхождением замены.
set_SmartParagraphBreakReplacement(bool)Сеттер для Aspose::Words::Replacing::FindReplaceOptions::get_SmartParagraphBreakReplacement.
set_UseLegacyOrder(bool)Значение true указывает, что поиск текста выполняется последовательно сверху вниз с учётом текстовых полей. Значение по умолчанию — false.
set_UseSubstitutions(bool)Сеттер для Aspose::Words::Replacing::FindReplaceOptions::get_UseSubstitutions.
static Type()

Примеры

Показывает, как переключать чувствительность к регистру при выполнении операции поиска и замены.

auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

builder->Writeln(u"Ruby bought a ruby necklace.");

// Мы можем использовать объект "FindReplaceOptions" для изменения процесса поиска и замены.
auto options = System::MakeObject<Aspose::Words::Replacing::FindReplaceOptions>();

// Установите флаг "MatchCase" в значение "true", чтобы применять чувствительность к регистру при поиске строк для замены.
// Установите флаг "MatchCase" в значение "false", чтобы игнорировать регистр символов при поиске текста для замены.
options->set_MatchCase(matchCase);

doc->get_Range()->Replace(u"Ruby", u"Jade", options);

ASSERT_EQ(matchCase ? System::String(u"Jade bought a ruby necklace.") : System::String(u"Jade bought a Jade necklace."), doc->GetText().Trim());

Показывает, как переключать операции поиска и замены только отдельными словами.

auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

builder->Writeln(u"Jackson will meet you in Jacksonville.");

// Мы можем использовать объект "FindReplaceOptions" для изменения процесса поиска и замены.
auto options = System::MakeObject<Aspose::Words::Replacing::FindReplaceOptions>();

// Установите флаг "FindWholeWordsOnly" в значение "true", чтобы заменять найденный текст, если он не является частью другого слова.
// Установите флаг "FindWholeWordsOnly" в значение "false", чтобы заменять весь текст независимо от его окружения.
options->set_FindWholeWordsOnly(findWholeWordsOnly);

doc->get_Range()->Replace(u"Jackson", u"Louis", options);

ASSERT_EQ(findWholeWordsOnly ? System::String(u"Louis will meet you in Jacksonville.") : System::String(u"Louis will meet you in Louisville."), doc->GetText().Trim());

См. также