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

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

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

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

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

//For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
auto doc = MakeObject<Document>();
auto builder = MakeObject<DocumentBuilder>(doc);

builder->InsertField(u"MERGEFIELD MyMergeField1 \\* MERGEFORMAT");
builder->InsertField(u"MERGEFIELD MyMergeField2 \\* MERGEFORMAT");

// Select all field start nodes so we can find the merge fields.
SharedPtr<NodeCollection> fieldStarts = doc->GetChildNodes(NodeType::FieldStart, true);
for (const auto& fieldStart : System::IterateOver<FieldStart>(fieldStarts))
{
    if (fieldStart->get_FieldType() == FieldType::FieldMergeField)
    {
        auto mergeField = MakeObject<WorkingWithFields::MergeField>(fieldStart);
        mergeField->set_Name(mergeField->get_Name() + u"_Renamed");
    }
}

doc->Save(ArtifactsDir + u"WorkingWithFields.RenameMergeFields.docx");

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

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

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

//For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
auto doc = MakeObject<Document>(MyDir + u"Various fields.docx");

doc->UpdateFields();

for (const auto& field : System::IterateOver(document->get_Range()->get_Fields()))
{
    std::cout << field->get_DisplayResult() << std::endl;
}