## FieldXE class Реализует поле XE. Чтобы узнать больше, посетите статью документации [Working with Fields](https://docs.aspose.com/words/cpp/working-with-fields/). ```cpp class FieldXE : public Aspose::Words::Fields::Field, public Aspose::Words::Fields::IFieldCodeTokenInfoProvider ``` ## Методы | Метод | Описание | | --- | --- | | [get_DisplayResult](../field/get_displayresult/)() | Получает текст, представляющий отображаемый результат поля. | | [get_End](../field/get_end/)() const | Получает узел, представляющий конец поля. | | [get_EntryType](./get_entrytype/)() | Получает или задает тип записи индекса. | | [get_FieldEnd](../field/get_fieldend/)() const | Получает узел, представляющий конец поля. | | [get_FieldStart](../field/get_fieldstart/)() const | Получает узел, представляющий начало поля. | | [get_Format](../field/get_format/)() | Получает объект [FieldFormat](../fieldformat/), который предоставляет типизированный доступ к форматированию поля. | | [get_IsBold](./get_isbold/)() | Получает или задает, применять ли полужирное форматирование к номеру страницы записи. | | [get_IsDirty](../field/get_isdirty/)() | Получает или задает, является ли текущий результат поля более некорректным (устаревшим) из‑за других изменений, внесённых в документ. | | [get_IsItalic](./get_isitalic/)() | Получает или задает, применять ли курсивное форматирование к номеру страницы записи. | | [get_IsLocked](../field/get_islocked/)() | Получает или задает, заблокировано ли поле (не должно пересчитывать свой результат). | | [get_LocaleId](../field/get_localeid/)() | Получает или задает LCID поля. | | [get_PageNumberReplacement](./get_pagenumberreplacement/)() | Получает или задает текст, используемый вместо номера страницы. | | [get_PageRangeBookmarkName](./get_pagerangebookmarkname/)() | Получает или задает имя закладки, обозначающей диапазон страниц, который вставляется как номер страницы записи. | | [get_Result](../field/get_result/)() | Получает или задает текст, находящийся между разделителем поля и его концом. | | [get_Separator](../field/get_separator/)() | Получает узел, представляющий разделитель поля. Может быть **null**. | | [get_Start](../field/get_start/)() const | Получает узел, представляющий начало поля. | | [get_Text](./get_text/)() | Получает или задает текст записи. | | virtual [get_Type](../field/get_type/)() const | Получает тип поля Microsoft Word. | | [get_Yomi](./get_yomi/)() | Получает или задает йоми (первый фонетический символ для сортировки индексов) для записи индекса. | | [GetFieldCode](../field/getfieldcode/)() | Возвращает текст между началом поля и разделителем поля (или концом поля, если разделитель отсутствует). Включены как код поля, так и результат дочерних полей. | | [GetFieldCode](../field/getfieldcode/)(bool) | Возвращает текст между началом поля и разделителем поля (или концом поля, если разделитель отсутствует). | | [GetType](./gettype/)() const override | | | [Is](./is/)(const System::TypeInfo\&) const override | | | virtual [Remove](../field/remove/)() | Удаляет поле из документа. Возвращает узел сразу после поля. Если конец поля является последним дочерним элементом его родительского узла, возвращает родительский абзац. Если поле уже удалено, возвращает **null**. | | [set_EntryType](./set_entrytype/)(const System::String\&) | Сеттер для [Aspose::Words::Fields::FieldXE::get_EntryType](./get_entrytype/). | | [set_IsBold](./set_isbold/)(bool) | Сеттер для [Aspose::Words::Fields::FieldXE::get_IsBold](./get_isbold/). | | [set_IsDirty](../field/set_isdirty/)(bool) | Сеттер для [Aspose::Words::Fields::Field::get_IsDirty](../field/get_isdirty/). | | [set_IsItalic](./set_isitalic/)(bool) | Сеттер для [Aspose::Words::Fields::FieldXE::get_IsItalic](./get_isitalic/). | | [set_IsLocked](../field/set_islocked/)(bool) | Сеттер для [Aspose::Words::Fields::Field::get_IsLocked](../field/get_islocked/). | | [set_LocaleId](../field/set_localeid/)(int32_t) | Сеттер для [Aspose::Words::Fields::Field::get_LocaleId](../field/get_localeid/). | | [set_PageNumberReplacement](./set_pagenumberreplacement/)(const System::String\&) | Сеттер для [Aspose::Words::Fields::FieldXE::get_PageNumberReplacement](./get_pagenumberreplacement/). | | [set_PageRangeBookmarkName](./set_pagerangebookmarkname/)(const System::String\&) | Сеттер для [Aspose::Words::Fields::FieldXE::get_PageRangeBookmarkName](./get_pagerangebookmarkname/). | | [set_Result](../field/set_result/)(const System::String\&) | Сеттер для [Aspose::Words::Fields::Field::get_Result](../field/get_result/). | | [set_Text](./set_text/)(const System::String\&) | Сеттер для [Aspose::Words::Fields::FieldXE::get_Text](./get_text/). | | [set_Yomi](./set_yomi/)(const System::String\&) | Сеттер для [Aspose::Words::Fields::FieldXE::get_Yomi](./get_yomi/). | | static [Type](./type/)() | | | [Unlink](../field/unlink/)() | Выполняет отсоединение поля. | | [Update](../field/update/)() | Выполняет обновление поля. Вызывает исключение, если поле уже обновляется. | | [Update](../field/update/)(bool) | Выполняет обновление поля. Выбрасывает исключение, если поле уже обновляется. | ## Примеры Показывает, как создать поле INDEX и затем использовать поля XE для заполнения его записями. ```cpp auto doc = System::MakeObject(); auto builder = System::MakeObject(doc); // Создайте поле INDEX, которое будет отображать запись для каждого найденного в документе поля XE. // Каждая запись будет отображать значение свойства Text поля XE слева // и страницу, содержащую поле XE, справа. // Если у полей XE одинаковое значение в их свойстве "Text", // поле INDEX сгруппирует их в одну запись. auto index = System::ExplicitCast(builder->InsertField(Aspose::Words::Fields::FieldType::FieldIndex, true)); // Настройте поле INDEX так, чтобы оно отображало только поля XE, находящиеся в пределах // закладки с именем "MainBookmark" и у которых свойство "EntryType" имеет значение "A". // Для полей INDEX и XE свойство "EntryType" использует только первый символ строкового значения. index->set_BookmarkName(u"MainBookmark"); index->set_EntryType(u"A"); ASSERT_EQ(u" INDEX \\b MainBookmark \\f A", index->GetFieldCode()); // На новой странице начните закладку с именем, соответствующим значению // свойства "BookmarkName" поля INDEX. builder->InsertBreak(Aspose::Words::BreakType::PageBreak); builder->StartBookmark(u"MainBookmark"); // Поле INDEX подхватит эту запись, потому что она находится внутри закладки, // и её тип записи также соответствует типу записи поля INDEX. auto indexEntry = System::ExplicitCast(builder->InsertField(Aspose::Words::Fields::FieldType::FieldIndexEntry, true)); indexEntry->set_Text(u"Index entry 1"); indexEntry->set_EntryType(u"A"); ASSERT_EQ(u" XE \"Index entry 1\" \\f A", indexEntry->GetFieldCode()); // Вставьте поле XE, которое не появится в INDEX, потому что типы записей не совпадают. builder->InsertBreak(Aspose::Words::BreakType::PageBreak); indexEntry = System::ExplicitCast(builder->InsertField(Aspose::Words::Fields::FieldType::FieldIndexEntry, true)); indexEntry->set_Text(u"Index entry 2"); indexEntry->set_EntryType(u"B"); // Закончите закладку и вставьте поле XE после неё. // Оно того же типа, что и поле INDEX, но не появится // поскольку находится за пределами границ закладки. builder->EndBookmark(u"MainBookmark"); builder->InsertBreak(Aspose::Words::BreakType::PageBreak); indexEntry = System::ExplicitCast(builder->InsertField(Aspose::Words::Fields::FieldType::FieldIndexEntry, true)); indexEntry->set_Text(u"Index entry 3"); indexEntry->set_EntryType(u"A"); doc->UpdatePageLayout(); doc->UpdateFields(); doc->Save(get_ArtifactsDir() + u"Field.INDEX.XE.Filtering.docx"); ``` Показывает, как заполнить поле INDEX записями с помощью полей XE и также изменить его внешний вид. ```cpp auto doc = System::MakeObject(); auto builder = System::MakeObject(doc); // Создайте поле INDEX, которое будет отображать запись для каждого найденного в документе поля XE. // Каждая запись будет отображать значение свойства Text поля XE слева, // а номер страницы, содержащей поле XE, — справа. // Если у полей XE одинаковое значение в их свойстве "Text", // поле INDEX сгруппирует их в одну запись. auto index = System::ExplicitCast(builder->InsertField(Aspose::Words::Fields::FieldType::FieldIndex, true)); index->set_LanguageId(u"1033"); // Установка значения этого свойства в "A" сгруппирует все записи по первой букве, // и разместит эту букву в верхнем регистре над каждой группой. index->set_Heading(u"A"); // Установите, чтобы таблица, созданная полем INDEX, охватывала 2 столбца. index->set_NumberOfColumns(u"2"); // Установите, чтобы любые записи, начинающиеся с букв вне диапазона "a-c", были опущены. index->set_LetterRange(u"a-c"); ASSERT_EQ(u" INDEX \\z 1033 \\h A \\c 2 \\p a-c", index->GetFieldCode()); // Следующие два поля XE появятся под заголовком "A", // при этом их соответствующее форматирование текста также будет применено к номерам страниц. builder->InsertBreak(Aspose::Words::BreakType::PageBreak); auto indexEntry = System::ExplicitCast(builder->InsertField(Aspose::Words::Fields::FieldType::FieldIndexEntry, true)); indexEntry->set_Text(u"Apple"); indexEntry->set_IsItalic(true); ASSERT_EQ(u" XE Apple \\i", indexEntry->GetFieldCode()); builder->InsertBreak(Aspose::Words::BreakType::PageBreak); indexEntry = System::ExplicitCast(builder->InsertField(Aspose::Words::Fields::FieldType::FieldIndexEntry, true)); indexEntry->set_Text(u"Apricot"); indexEntry->set_IsBold(true); ASSERT_EQ(u" XE Apricot \\b", indexEntry->GetFieldCode()); // Оба следующих поля XE будут под заголовками "B" и "C" в содержании таблицы полей INDEX. builder->InsertBreak(Aspose::Words::BreakType::PageBreak); indexEntry = System::ExplicitCast(builder->InsertField(Aspose::Words::Fields::FieldType::FieldIndexEntry, true)); indexEntry->set_Text(u"Banana"); builder->InsertBreak(Aspose::Words::BreakType::PageBreak); indexEntry = System::ExplicitCast(builder->InsertField(Aspose::Words::Fields::FieldType::FieldIndexEntry, true)); indexEntry->set_Text(u"Cherry"); // Поля INDEX сортируют все записи в алфавитном порядке, поэтому эта запись появится под "A" вместе с другими двумя. builder->InsertBreak(Aspose::Words::BreakType::PageBreak); indexEntry = System::ExplicitCast(builder->InsertField(Aspose::Words::Fields::FieldType::FieldIndexEntry, true)); indexEntry->set_Text(u"Avocado"); // Эта запись не появится, потому что она начинается с буквы "D", // что находится вне диапазона символов "a-c", определяемого свойством LetterRange поля INDEX. builder->InsertBreak(Aspose::Words::BreakType::PageBreak); indexEntry = System::ExplicitCast(builder->InsertField(Aspose::Words::Fields::FieldType::FieldIndexEntry, true)); indexEntry->set_Text(u"Durian"); doc->UpdatePageLayout(); doc->UpdateFields(); doc->Save(get_ArtifactsDir() + u"Field.INDEX.XE.Formatting.docx"); ``` ## См. также * Class [Field](../field/) * Namespace [Aspose::Words::Fields](../) * Library [Aspose.Words for C++](../../)