Настройка свойств поля

Aspose.Words предоставляет возможность программного взаимодействия с различными свойствами полей. В этой статье мы рассмотрим несколько примеров, чтобы вы поняли основной принцип работы со свойствами полей. Вы можете просмотреть полный список свойств для каждого типа поля в соответствующем классе в Fields module.

Обновление свойств поля

Иногда пользователям требуется изменить значение свойства поля. Например, обновите свойство author_name поля AUTHOR или измените свойство field_name поля MERGEFIELD.

В следующем примере кода показано, как переименовать объединяемые поля в документе Word:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document()
builder = aw.DocumentBuilder(doc)

builder.insert_field("MERGEFIELD MyMergeField1 \\* MERGEFORMAT")
builder.insert_field("MERGEFIELD MyMergeField2 \\* MERGEFORMAT")

for f in doc.range.fields:
    if f.field_type == aw.fields.FieldType.FIELD_MERGE_FIELD:
        merge_field = f.as_field_merge_field()
        merge_field.field_name = merge_field.field_name + "_Renamed"
        merge_field.update()

doc.save(ARTIFACTS_DIR + "WorkingWithFields.rename_merge_fields.docx")

Результат отображения поля

Aspose.Words предоставляет свойство для получения результата поля для полей, у которых нет узла-разделителя полей. Мы называем это “поддельным результатом” или отображаемым результатом; MS Word отображает его в документе, вычисляя значение поля “на лету”, но в модели документа такого значения нет.

В следующем примере кода показано использование свойства display_result:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
document = aw.Document(docs_base.my_dir + "Various fields.docx")

document.update_fields()

for field in document.range.fields :
    print(field.display_result)