Trabalhando com campos de formulário
Um documento que contém espaços de preenchimento (campos) é conhecido como um formulário. Por exemplo, você pode criar um formulário de registro em Microsoft Word que usa listas suspensas das quais os usuários podem selecionar entradas. O Form campo é um local onde um determinado tipo de dados, como um nome ou endereço, é armazenado. Campos de formulário Microsoft Word incluem entrada de texto, combobox e caixa de seleção.
Você pode usar campos de formulário em seu projeto para “comunicar” com seus usuários. Por exemplo, você cria um documento cujo conteúdo é protegido, mas apenas campos de formulário são editáveis. Os usuários podem inserir os dados nos campos do formulário e enviar o documento. Sua aplicação que usa Aspose.Words pode recuperar dados dos campos do formulário e processá-lo.
Colocar campos de formulário no documento através do código é fácil. DocumentBuilder tem métodos especiais para inseri-los, um para cada tipo de campo de formulário. Cada um dos métodos aceita um parâmetro de string representando o nome do campo de formulário. O nome pode ser uma string vazia. Se no entanto você especificar um nome para o campo de formulário, então um marcador de livro é criado automaticamente com o mesmo nome.
Inserir campos de formulário
Campos de formulário são um caso particular de campos do Word que permite “interação” com o usuário. Campos de formulário Microsoft Word incluem caixa de texto, caixa de combinação e caixa de seleção.
DocumentBuilder fornece métodos especiais para inserir cada tipo de campo de formulário no documento: insertTextInput, insertCheckBox ou insertComboBox.
O exemplo a seguir mostra como inserir um campo de formulário de combinação em um documento:
Insira uma entrada de texto
Use o inserção Entrada de texto método para inserir uma caixa de texto no documento.
O exemplo a seguir mostra como inserir um campo de formulário de entrada de texto em um documento:
Insira uma caixa de verificação
Chamada caixa de entrada para inserir uma caixa de seleção no documento.
O exemplo a seguir mostra como inserir um campo de formulário de caixa de seleção em um documento:
Insira uma caixa de combinação
Chamada inserçãoComboBox para inserir uma combinação no documento.
O exemplo a seguir mostra como inserir um campo de formulário Combobox em um documento:
Obter campos de formulário
Uma coleção de campos de forma é representada pelo FormFieldCollection classe que pode ser recuperado usando o Range.getFormFields propriedade. Isso significa que você pode obter campos de formulário contidos em qualquer nó de documento, incluindo o próprio documento.
O exemplo de código a seguir mostra como obter uma coleção de campos de formulário:
Você pode obter um campo de formulário particular por seu índice ou nome.
O exemplo a seguir mostra como acessar campos de formulários:
O FormField propriedades permitem que você trabalhe com nome de campo de formulário, tipo e resultado.
O exemplo de código a seguir mostra como trabalhar com nome de campo de formulário, tipo e resultado: