Uso de botões

Para que os usuários iniciem ações, como o envio de dados, a execução de operações de serviços da Web ou a execução de uma consulta de banco de dados, é possível adicionar um botão ao formulário. Com a ajuda das comunicações e scripts de suporte ao cliente-servidor incorporadas do Designer, os formulários podem suportar estes tipos de ações por meio de botões:

  • Executar um cálculo

  • Processar e manipular dados por meio de um script

  • Enviar dados (incluindo anexos opcionais) a um servidor

  • Assinar conteúdo de formulário enviado

  • Criptografar conteúdo de formulário enviado

  • Abrir uma conexão com um host

  • Enviar solicitações de clientes para um servidor

  • Chamar uma operação de serviços da Web

  • Consultar uma fonte de dados

As ações associadas ao botão são iniciadas quando o usuário clica nesse botão.

Depois de adicionar um objeto de botão ao design do formulário, é possível editar o texto da legenda e manipular as propriedades do objeto nas guias Campo, Enviar e Executar da paleta Objeto. As seguintes propriedades podem ser definidas:

  • Alterar a legenda do botão

  • Definir um estilo de borda para o botão

  • Especificar o estilo do realce do botão

  • Definir o botão como visível, invisível ou oculto

  • Especificar uma localidade para o botão

  • Especificar um comportamento em tempo de execução

O Designer também inclui quatro botões adicionais que estão pré-configurados para fornecer funções específicas. Eles incluem um botão Enviar por email, um botão Enviar por HTTP, um botão Imprimir e um botão Redefinir.

Botões Enviar por e-mail

O botão Enviar por email é um botão padrão com algumas propriedades já definidas e com uma paleta Objeto especializada. Esse objeto facilita a criação de botões nos quais os usuários podem clicar para retornar seus dados de formulário por email. Como o Adobe Reader não salva alterações em arquivos PDF, incluindo dados de formulários, convém incluir um botão Enviar por email em formulários que possam ser preenchidos pelos usuários nesse aplicativo.

O botão Enviar por email funciona como um objeto de botão padrão, com estas configurações:

  • Tipo de controle definido como Enviar

  • Formato de submissão definido como Dados XML

  • Envio para URL definido para o uso do protocolo, como mailto:name@adobe.com

  • Codificação definida como UTF-8

Se o Assistente para novos formulários for usado para criar um formulário e selecionar um dos métodos de retorno de Enviar, um botão Enviar por email será incluído automaticamente nesse formulário.

Depois de adicionar um botão ao design de formulário, edite o texto da legenda e manipule as propriedades do objeto na guia Campo da paleta Objeto. As seguintes propriedades podem ser definidas:

  • Alterar a legenda do botão

  • Definir um estilo de borda para o botão

  • Especificar o estilo do realce do botão

  • Definir o endereço Para e o Assunto da mensagem de email

  • Assinar conteúdo de formulário enviado

  • Criptografar conteúdo de formulário enviado

  • Definir o botão como visível, invisível ou oculto

  • Especificar uma localidade para o botão

Também é possível alterar o nome do botão na paleta Hierarquia e definir um estilo para a legenda nas paletas Fonte e Parágrafo.

Configuração do botão Enviar por email

É possível especificar o endereço de email para o qual os dados do formulário serão enviados e a linha de assunto do email que será enviado.

  1. Adicione um botão Enviar por email para o design de formulário. Consulte Adicionar objetos a um design de formulário.

  2. Na paleta Objeto, clique na guia Campo.

  3. Na caixa Endereço de email, digite o endereço de email de destino.

  4. (Opcional) Na caixa Assunto do email, digite uma linha de assunto para o email.

  5. (Opcional) Para aplicar uma assinatura de dados aos dados submetidos, selecione Assinar submissão e, em seguida, clique em Configurações para fazer as configurações de assinatura opcionais.

  6. (Opcional) Para aplicar a criptografia XML ao conteúdo do formulário, selecione Criptografar envio e clique em Configurações para definir as configurações de criptografia opcionais.

Botões Enviar por HTTP

O botão Enviar por HTTP é um botão padrão com algumas propriedades já definidas e com uma paleta Objeto especializada. Esse objeto facilita a criação de botões nos quais os usuários podem clicar para retornar seus dados de formulário por HTTP post.

O botão Enviar por HTTP funciona como um objeto de botão padrão, com estas configurações:

  • Tipo de controle definido como Enviar

  • Formato de envio definido como Dados codificados por URL

  • Enviar para URL definido para o uso do http: protocolo

Se for necessário retornar os dados por meio do protocolo https seguro, será possível usar o objeto de botão padrão como alternativa.

Depois de adicionar um botão ao design de formulário, edite o texto da legenda e manipule as propriedades do objeto na guia Campo da paleta Objeto. As seguintes propriedades podem ser definidas:

  • Alterar a legenda do botão

  • Definir um estilo de borda para o botão

  • Selecionar o estilo do realce para o botão

  • Especificar o URL para o qual os dados serão enviados

  • Assinar conteúdo de formulário enviado

  • Criptografar conteúdo de formulário enviado

  • Definir o botão como visível, invisível ou oculto

  • Especificar uma localidade para o botão

Também é possível alterar o nome do botão na paleta Hierarquia e definir um estilo para a legenda nas paletas Fonte e Parágrafo.

Configurar o botão Enviar por HTTP

  1. Adicione um botão Enviar por HTTP ao design do formulário. Consulte Adicionar objetos a um design de formulário.

  2. Na paleta Objeto, clique na guia Campo e digite o protocolo URL na caixa URL.

    Para

    Usar este protocolo URL

    Exemplo

    Enviar o pacote para um site de FTP

    FTP

    ftp://ftp.gnu.org/gnu/GPL

    Enviar o pacote para um servidor da Web

    http

    http://servidor/cgi-bin/

    Enviar o pacote para um servidor da Web seguro

    https

    https://myserver/cgi-bin/

    Enviar o pacote para um endereço de email

    mailto

    mailto:username@domain.com
    Nota: Ao enviar dados a um URL, convém especificar um destino absoluto. Destinos relativos são interpretados de acordo com o ambiente do usuário, que pode variar de um usuário para outro em tempo de execução.

  3. (Opcional) Para aplicar uma assinatura de dados aos dados submetidos, selecione Assinar submissão e, em seguida, clique em Configurações para fazer as configurações de assinatura opcionais.

  4. (Opcional) Para aplicar a criptografia XML ao conteúdo do formulário, selecione Criptografar envio e clique em Configurações para definir as configurações de criptografia opcionais.

Botões Imprimir

O botão Imprimir abre uma caixa de diálogo Imprimir para que o usuário possa imprimir o formulário. Ele é um objeto de botão padrão que tem o Tipo de controle definido como Regular e um script incluído no seu evento Click que imprime o formulário no momento em que o botão é clicado.

Na versão independente do Designer, se o Assistente para novos formulários for usado para criar um formulário e selecionar um dos métodos de retorno de Imprimir, um botão Imprimir será incluído automaticamente no formulário.

Botões Redefinir

Um botão Redefinir redefine todos os campos no formulário para seus valores padrão. Ele é um objeto de botão padrão que possui o Tipo de controle definido como Regular e um script incluído no seu evento Click que redefine os valores de campo no momento em que o botão é clicado.

Para inserir um botão padrão que executa um cálculo ou um script

  1. Adicione o botão a um design de formulário. Consulte Adicionar objetos a um design de formulário.

  2. Na paleta Objeto, clique na guia Campo.

  3. Selecione um evento da caixa Mostrar. Por exemplo, se você quiser que o botão execute um cálculo, selecione Click.

  4. No Editor de scripts, selecione um idioma da lista de idiomas.

  5. Digite o cálculo ou script no Editor de script.