Criar um manipulador de eventos

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Ao escrever script para um modelo de formulário do Microsoft Office InfoPath, você geralmente escrever código em um formulário de manipuladores de validação de dados ou modelo. Um manipulador de eventos é o código de função em um modelo de formulário do InfoPath que responde a uma ação do usuário ou uma alteração aos dados XML em um formulário. Como criar um manipulador de eventos depende do tipo de evento que você deseja usar. É importante criar o manipulador de eventos no modo de design porque o InfoPath automaticamente cria as declarações dos manipuladores de evento no arquivo de script e torna as entradas no arquivo de definição (. xsf) de formulário que permitem a um modelo de formulário para usar esses manipuladores de eventos.

Observação : Embora seja possível criar os manipuladores de eventos manualmente no arquivo de script e habilitá-los adicionando manualmente os elementos apropriados ao arquivo .xsf, isso não é recomendado. Se uma alteração inválida for feita no arquivo .xsf, o modelo de formulário pode ficar inutilizável.

A tabela a seguir lista cada um dos manipuladores de evento do InfoPath e as etapas para criá-los. Quando você cria um manipulador de eventos para um modelo de formulário, o InfoPath inicia o Script Editor MSE (Microsoft) e coloca o cursor no código de manipulador de eventos. Em seguida, você pode escrever o script manipulador de eventos. Para obter informações detalhadas sobre o InfoPath eventos e manipuladores de evento, consulte Referência do desenvolvedor do InfoPath, que está disponível na Ajuda do MSE.

Event handler

Description

Steps for creating

OnAfterChange

Esse evento ocorre depois que um usuário altera o valor no controle especificado vinculado a um campo. Por exemplo, você pode exibir um painel de tarefas personalizado do HTML depois que um usuário seleciona um item em um controle de caixa de listagem. Este evento é executado após o evento OnValidate .

Um controle no modelo de formulário ou um campo no painel de tarefas Fonte de dados de atalho, aponte para programação no menu de atalho e, em seguida, clique Em após alterar evento.

OnAfterImport

Este evento é executada após o usuário mescla com êxito vários formulários em um formulário.

Adicione manualmente a declaração de manipulador de eventos OnAfterImport diretamente para o arquivo de script usando MSE. Este manipulador de eventos não pode ser criado no modo de design.

OnBeforeChange

Este evento é executado após o valor em um controle de alterações de um usuário e antes que o valor é adicionado ao campo especificado associado ao controle. Por exemplo, você pode impedir que um usuário adicionando uma linha adicional antes de preencher a última linha em uma tabela de repetição.

Um controle no modelo de formulário ou um campo no painel de tarefas Fonte de dados de atalho, aponte para programação no menu de atalho e clique Em antes de alterar evento.

OnClick

Este evento é executado quando um usuário clica em um botão associado ao evento. Este evento está disponível após adicionar um botão ao modelo de formulário. Por exemplo, você pode executar um cálculo complexo usando os valores nos campos na fonte de dados principal quando um usuário clica no botão.

Clique duas vezes no controle de botão e, na guia Geral da caixa de diálogo Propriedades do botão, clique em Editar código do formulário.

OnContextChange

Este evento é executado quando o foco muda no formulário. Por exemplo, este evento é executado quando um usuário navega de uma caixa de texto para um selecionador de data, ou quando um usuário alterna entre os modos de exibição. Esse evento ocorre depois que todos os outros eventos ocorreram.

No menu Ferramentas, aponte para programação e clique Em evento de alteração de contexto.

OnLoad

Este evento é executado sempre que um usuário cria um novo formulário ou abre um formulário existente com base no seu modelo de formulário. Por exemplo, você pode copiar uma lista de itens de uma fonte de dados secundária à fonte de dados principal quando um usuário abre o formulário.

No menu Ferramentas, aponte para programação e clique Em evento de carga.

OnMergeRequest

Este evento é executado quando formulários com base no seu modelo de formulário são mesclados. Por exemplo, você pode exibir o número de formulários que foram mescladas para dar um status de um usuário durante a operação de mesclagem.

No menu Ferramentas, clique em Opções de formulário. Na lista categoria, clique em Avançado. Em Mesclar Formulários, marque a caixa de seleção Mesclar usando código personalizado e clique em Editar.

OnSaveRequest

Este evento é executado quando um usuário salva um formulário baseado em seu modelo de formulário. Por exemplo, você pode salvar o formulário baseado neste modelo de formulário para mais de um local quando um usuário salva o formulário. InfoPath adiciona duas linhas adicionais de código para este evento: uma linha que salva o formulário e outra linha que informa se o InfoPath salvo com êxito o formulário.

No menu Ferramentas, clique em Opções de formulário. Na lista categoria, clique em Abrir e salvar. Em comportamento de salvar, marque a caixa de seleção Salvar usando código personalizado e clique em Editar.

OnSign

Este evento é executado quando um usuário aplica uma assinatura digital a um formulário. Por exemplo, você pode adicionar dados adicionais à assinatura digital de um formulário de relatório de despesas quando um usuário entra-lo.

No menu Ferramentas, aponte para programação e clique Em evento de entrada.

OnSubmitRequest

Este evento é executado quando um usuário envia sua dados de formulário. Por exemplo, você poderá enviar os dados do formulário para um serviço Web seguro quando o usuário clica em Enviar no menu arquivo. Como o InfoPath não oferece suporte a uma conexão de dados para um serviço Web seguro, você precisa adicionar uma conexão de dados personalizados que funciona com o seu serviço da Web seguro.

No menu Ferramentas, clique em Opções de envio. Marque a caixa de seleção Permitir que os usuários enviarem este formulário, clique em Executar ação personalizada usando código e, em seguida, clique em Editar código.

OnSwitchView

Este evento é executada quando um usuário abre um formulário com base no seu modelo de formulário ou alterna para outro modo de exibição do formulário. Por exemplo, quando um usuário alterna para um modo de exibição específico, você pode criar uma mensagem de email que contém os dados dos campos na fonte de dados principal do formulário.

No menu Ferramentas, clique em programação e clique Em Alternar exibição evento.

OnValidate

Este evento é executado quando um usuário altera o valor em um controle acoplado a um campo. Por exemplo, quando o usuário altera o valor em um controle específico, você pode calcular um novo valor para outro controle usando o número que o usuário inseriu e um número que está no script. Esse evento ocorre após a execução do manipulador de eventos OnBeforeChange .

Um controle no modelo de formulário ou um campo no painel de tarefas Fonte de dados de atalho, aponte para programação no menu de atalho e, em seguida, clique Em Após validar evento.

OnVersionUpgrade

Este evento é executado quando um usuário abre um formulário existente e o número de versão do modelo de formulário usado pelo formulário existente é mais antigo do que o número da versão do modelo de formulário no local de publicação. Quando um usuário abre um formulário existente, o InfoPath verifica o número da versão do modelo de formulário associado ao formulário existente. Se o modelo de formulário tem um número de versão mais recente, o InfoPath executa o manipulador de eventos OnVersion quando o usuário abre o formulário existente. Por exemplo, imagine que você adiciona um novo campo a um modelo de formulário existente e publicá-lo novamente, e você deseja que o novo campo a ser adicionado à fonte de dados principal se um usuário abrir um formulário existente. Este evento adiciona o novo campo à fonte de dados principal quando um usuário abre um formulário existente.

No menu Ferramentas, clique em Opções de formulário. Na lista categoria, clique em controle de versão. Na lista na atualização de versão, clique em Usar evento personalizado e clique em Editar.

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×