Inserir Campos

Existem várias maneiras diferentes de inserir campos em um documento:

Neste artigo, examinaremos cada forma com mais detalhes e analisaremos como inserir determinados campos usando essas opções.

Inserir campos num documento utilizando DocumentBuilder

Em Aspose.Words o método InsertField é utilizado para inserir novos campos num documento. O primeiro parâmetro aceita o código de campo completo do campo a inserir. O segundo parâmetro é opcional e permite que o resultado do campo seja definido manualmente. Se isso não for fornecido, o campo é atualizado automaticamente. Você pode passar null ou empty para este parâmetro para inserir um campo com um valor de campo vazio. Se você não tiver certeza sobre a sintaxe do código de campo específico, crie o campo em Microsoft Word Primeiro e alterne para ver seu código de campo.

O exemplo de código a seguir mostra como inserir um campo de mesclagem em um documento usando DocumentBuilder:

A mesma técnica é usada para inserir campos aninhados em outros campos.

O exemplo de código a seguir demonstra como inserir campos aninhados em outro campo usando DocumentBuilder:

Especificar localidade ao nível do campo

Um identificador de idioma é uma abreviatura numérica internacional padrão para o idioma em um país ou região geográfica. Com Aspose.Words, você pode especificar a localidade no nível do campo usando a propriedade LocaleId, que obtém ou define a localidade do campo ID.

O exemplo de código a seguir mostra como usar essa opção:

Inserir Campo Não Digitado / Vazio

Se você deseja inserir campos não digitados / vazios ({}) da mesma forma que Microsoft Word permite, você pode usar o método InsertField com o parâmetro FieldType.FieldNone. Para inserir um campo em um documento do Word, você pode pressionar a combinação de teclas “Ctrl + F9”.

O exemplo de código a seguir mostra como inserir um campo vazio no documento:

Inserir Campo COMPARE

O campo COMPARE compara dois valores e devolve o valor numérico 1 se a comparação for verdadeira ou 0 se a comparação for falsa.

O exemplo de código a seguir mostra como adicionar campos COMPARE Usando DocumentBuilder:

Inserir Campo IF

O campo IF pode ser usado para avaliar argumentos condicionalmente.

O exemplo de código a seguir mostra como adicionar campos IF Usando DocumentBuilder:

Inserir campos num documento utilizando FieldBuilder

A forma alternativa de inserir campos em Aspose.Words é a classe FieldBuilder. Ele fornece interface fluente para especificar comutadores de campo e valores de argumento como texto, nós ou mesmo campos aninhados.

O exemplo de código a seguir mostra como inserir um campo em um documento usando FieldBuilder:

Inserir Campos utilizando DOM

Você também pode inserir vários tipos de campos usando Aspose.Words Modelo De Objecto Do Documento (DOM). Nesta secção, veremos alguns exemplos.

Inserindo o campo de mesclagem em um documento usando DOM

MERGEFIELD field in Word document can be represented by the FieldMergeField class. You can use FieldMergeField class to perform the following operations:

  • especifique o nome do campo de mesclagem
  • especifique a formatação do campo de mesclagem
  • especifique o texto que está entre o separador de campo e o fim do campo do campo de mesclagem
  • especifique o texto a ser inserido após o campo de mesclagem se o campo não estiver em branco
  • especifique o texto a ser inserido antes do campo de mesclagem se o campo não estiver em branco

O exemplo de código a seguir mostra como adicionar o campo MERGE usando DOM a um parágrafo em um documento:

Inserir o campo Mail Merge ADDRESSBLOCK num documento utilizando DOM

O campo ADDRESSBLOCK é utilizado para inserir um bloco de endereços Mail Merge num documento do Word. O campo ADDRESSBLOCK no documento do Word pode ser representado pela classe FieldAddressBlock. Você pode usar a classe FieldAddressBlock para executar as seguintes operações:

  • especificar se deve incluir o nome do país / região no campo
  • especificar se deve formatar o endereço de acordo com o país / região do destinatário, tal como definido em POST * CODE (União Postal Universal 2006)
  • especificar o nome do país/região excluído
  • especificar o nome e o formato do endereço
  • especificar o idioma ID utilizado para formatar o endereço

O exemplo de código a seguir mostra como adicionar o campo Mail Merge ADDRESSBLOCK usando DOM a um parágrafo em um documento:

Inserir o campo ADVANCE num documento sem utilizar DocumentBuilder

O campo ADVANCE é utilizado para deslocar o texto subsequente dentro de uma linha à esquerda, à direita, para cima ou para baixo. O campo ADVANCE no documento do Word pode ser representado pela classe FieldAdvance. Você pode usar a classe FieldAdvance para executar as seguintes operações:

  • especifique o número de pontos pelos quais o texto que segue o campo deve ser movido verticalmente a partir da borda superior da página
  • especifique o número de pontos pelos quais o texto que segue o campo deve ser movido horizontalmente a partir da borda esquerda da coluna, quadro ou caixa de texto
  • especificar o número de pontos pelos quais o texto que segue o campo deve ser movido para a esquerda, direita, para cima ou para baixo

O exemplo de código a seguir mostra como adicionar o campo ADVANCE usando DOM a um parágrafo em um documento:

Inserir o campo ASK num documento sem utilizar DocumentBuilder

O campo ASK é utilizado para solicitar ao utilizador que o texto atribua a um marcador no documento do Word. O campo ASK no documento do Word pode ser representado pela classe FieldAsk. Você pode usar a classe FieldAsk para executar as seguintes operações:

  • especifique o nome do marcador
  • especifique a resposta padrão do Usuário (valor inicial contido na janela do prompt)
  • especificar se a resposta do utilizador deve ser recebida uma vez por uma operação Mail Merge
  • especifique o texto do prompt (O título da janela do prompt)

O exemplo de código a seguir mostra como adicionar o campo ASK usando DOM a um parágrafo em um documento:

Inserir o campo AUTHOR num documento sem utilizar DocumentBuilder

O campo AUTHOR é utilizado para especificar o nome do autor do documento a partir das propriedades Document. O campo AUTHOR no documento do Word pode ser representado pela classe FieldAuthor. Você pode usar a classe FieldAuthor para executar as seguintes operações:

  • especificar o nome do autor do documento

O exemplo de código a seguir mostra como adicionar o campo AUTHOR usando DOM a um parágrafo em um documento:

Inserir o campo INCLUDETEXT num documento sem utilizar DocumentBuilder

O campo INCLUDETEXT insere o texto e os gráficos contidos no documento indicado no código do campo. Pode inserir o documento inteiro ou uma parte do documento referido por um marcador. Este campo no documento do Word é representado por INCLUDETEXT. Você pode usar a classe FieldIncludeText para executar as seguintes operações:

  • especificar o nome do marcador do documento incluído
  • especificar a localização do documento

O exemplo de código a seguir mostra como adicionar o campo INCLUDETEXT usando DOM a um parágrafo em um documento:

Inserir o campo TOA num documento sem utilizar DocumentBuilder

O campo TOA (Table of Authorities) cria e insere uma tabela de autoridades. O campo TOA recolhe entradas marcadas por campos TA (Table of Authorities Entry). Microsoft o Office Word insere o campo TOA quando clica em Insert Table of Authorities no grupo Table of Authorities no separador References. Quando visualiza o campo TOA no documento, a sintaxe é semelhante a esta:

{ TOA [Switches ] }

O exemplo de código a seguir mostra como adicionar o campo TOA usando DOM a um parágrafo em um documento.

Introdução aos campos em Java Como encontrar propriedades de campo