Inserir campos

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

Neste artigo, vamos olhar cada vez mais detalhadamente e analisar como inserir determinados campos usando essas opções.

Inserindo campos em um documento usando DocumentBuilder

Em Aspose.Words o InsertField método é usado para inserir novos campos em um documento. O primeiro parâmetro aceita o código de campo completo do campo a ser inserido. O segundo parâmetro é opcional e permite que o resultado de campo do campo seja definido manualmente. Se isso não for fornecido, então o campo é atualizado automaticamente. Você pode passar nulo ou vazio para este parâmetro para inserir um campo com um valor de campo vazio. Se você não tem certeza sobre a sintaxe do código de campo em particular, crie o campo em Microsoft Word primeiro e mudar para ver seu código de campo.

O exemplo 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 Locale no Nível de Campo

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

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

Inserir campo não digitado / vazio

Se você quiser inserir campos não digitados / vazios ({}) apenas como Microsoft Word permite, você pode usar o InsertField método com o FieldType.FieldNone parâmetro. 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:

Inserção COMPARE Campo

O COMPARE campo compara dois valores e retorna o valor numérico 1 se a comparação for true ou 0 se a comparação for false.

O seguinte exemplo de código mostra como adicionar COMPARE campos usando DocumentBuilder:

Inserção IF Campo

O IF campo pode ser usado para avaliar argumentos condicionalmente.

O seguinte exemplo de código mostra como adicionar IF campos usando DocumentBuilder:

Inserindo campos em um documento usando FieldBuilder

A maneira alternativa de inserir campos em Aspose.Words é o FieldBuilder classe. Ele fornece interface fluente para especificar switches 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:

Inserindo campos usando DOM

Você também pode inserir vários tipos de campos usando Aspose.Words Document Object Model (DOM). Nesta seção, vamos ver alguns exemplos.

Inserindo fusão Campo em um documento usando DOM

MERGEFIELD campo no documento do Word pode ser representado pelo FieldMergeField classe. Você pode usar FieldMergeField classe para executar as seguintes operações:

  • especifique o nome do campo de fusão
  • especifique a formatação do campo de mesclagem
  • especifique o texto que está entre o separador de campo e a extremidade de 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 MERGE campo usando DOM para um parágrafo em um documento:

Inserção Mail Merge ADDRESSBLOCK campo em um documento usando DOM

O ADDRESSBLOCK campo é usado para inserir um mail merge bloco de endereço em um documento do Word. ADDRESSBLOCK campo no documento do Word pode ser representado pelo FieldAddressBlock classe. Você pode usar FieldAddressBlock classe para executar as seguintes operações:

  • especificar se deve incluir o nome do país/região no campo
  • especifique se deve formatar o endereço de acordo com o país/região do destinatário conforme definido pelo POST*CODE (Universal Postal Union 2006)
  • especificar o nome do país/região excluído
  • especifique o nome e o formato de endereço
  • especifique o ID de idioma usado para formatar o endereço

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

Inserção ADVANCE campo em um documento sem usar DocumentBuilder

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

  • especificar 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 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 esquerda, direita, para cima ou para baixo

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

Inserção ASK campo em um documento sem usar DocumentBuilder

O ASK campo é usado para levar o usuário para o texto para atribuir a um Bookmark no documento do Word. ASK campo no documento do Word pode ser representado pelo FieldAsk classe. Você pode usar FieldAsk classe para executar as seguintes operações:

  • especifique o nome do marcador
  • especifique a resposta do usuário padrão (valor inicial contido na janela do prompt)
  • especifique se a resposta do usuário deve ser recebida uma vez por uma mail merge operação
  • especifique o texto de prompt (o título da janela de prompt)

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

Inserção AUTHOR campo em um documento sem usar DocumentBuilder

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

  • especifique o nome do autor do documento

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

Inserção INCLUDETEXT campo em um documento sem usar DocumentBuilder

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

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

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

Inserção TOA campo em um documento sem usar DocumentBuilder

O TOA (* Tabela de Autoridades*) campo constrói e insere uma tabela de autoridades. O TOA campo recolhe entradas marcadas por TA (* Tabela de Entrada de Autoridades*) campos. Microsoft Office Word insere o TOA campo quando você clica *Inserir tabela de autoridades* no **Quadro das Autoridades** grupo sobre o **References** Aba. Quando você vê o TOA campo em seu documento, a sintaxe parece assim:

{ TOA [Switches ] }

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

Introdução a Campos em Java Como Encontrar Propriedades de Campo