Personalizar propriedades do campo

Aspose.Words oferece a capacidade de interagir programaticamente com várias propriedades de campo. Neste artigo, veremos alguns exemplos para que você entenda o princípio básico de trabalhar com propriedades de campo. Você pode ver a lista completa de propriedades para cada tipo de campo na classe correspondente no Módulo Campos.

Atualização de propriedade de campo

Às vezes, os usuários precisam alterar o valor de uma propriedade de campo. Por exemplo, atualize a propriedade author_name do campo AUTHOR ou altere a propriedade field_name do campo MERGEFIELD.

O exemplo de código a seguir mostra como renomear campos de mesclagem em um documento do 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")

Resultado de exibição do campo

Aspose.Words fornece uma propriedade para obter o resultado do campo para campos que não possuem um nó separador de campo. Chamamos isso de “resultado falso” ou resultado de exibição; O MS Word o exibe no documento calculando o valor do campo dinamicamente, mas não existe tal valor no modelo do documento.

O exemplo de código a seguir mostra o uso da propriedade 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)