フィールドプロパティのカスタマイズ

Aspose.Words は、さまざまなフィールド プロパティをプログラムで操作する機能を提供します。この記事では、フィールド プロパティの操作の基本原則を理解できるように、いくつかの例を見ていきます。 フィールドモジュール 内の対応するクラスの各フィールド タイプのプロパティの完全なリストを確認できます。

フィールドプロパティの更新

場合によっては、ユーザーはフィールド プロパティの値を変更する必要があります。たとえば、AUTHOR フィールドの author_name プロパティを更新するか、MERGEFIELD フィールドの field_name プロパティを変更します。

次のコード例は、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)