Criar um processador de eventos

Nota:  Queremos fornecer-lhe os conteúdos de ajuda mais recentes o mais rapidamente possível e no seu idioma. Esta página foi traduzida automaticamente e pode conter erros gramaticais ou imprecisões. O nosso objetivo é que estes conteúdos lhe sejam úteis. Pode informar-nos se as informações foram úteis no final desta página? Eis o artigo em inglês para referência.

Quando escrever um script para um modelo de formulário do Microsoft Office InfoPath, é normalmente, escrever código de uma do formulário processadores de eventos de validação de dados ou modelo. Um processador de eventos é o código de função num modelo de formulário do InfoPath que responde a uma acção do utilizador ou uma alteração aos dados XML de um formulário. Como criar um processador de eventos depende do tipo de evento que pretende utilizar. É importante criar o processador de eventos no modo de estrutura porque o InfoPath automaticamente cria as declarações dos processadores de eventos no ficheiro de script e entradas no ficheiro de definição (. xsf) do formulário que permitem um modelo de formulário utilizar esses processadores de eventos.

Nota: Apesar de é possível criar manualmente os processadores de eventos no ficheiro de script e, em seguida, ativá-las ao adicionar manualmente os elementos adequados para o ficheiro. xsf, não é recomendado. Se for feita uma alteração inválida para o ficheiro. xsf, o modelo de formulário poderá não ser utilizável.

A tabela seguinte apresenta cada um dos processadores de eventos do InfoPath e os passos para criá-los. Quando cria um processador de eventos para um modelo de formulário, o InfoPath inicia o Microsoft Script Editor (MSE) e coloca o cursor no código para esse processador de eventos. Em seguida, pode escrever o script processador de eventos. Para obter informações detalhadas sobre o InfoPath eventos e processadores de eventos, consulte o artigo referência para programadores do InfoPath, que se encontra disponível na ajuda do MSE.

Processador de eventos

Descrição

Passos para criar

OnAfterChange

Este evento é executado depois de um utilizador altera o valor no controlo especificado vinculado a um campo. Por exemplo, pode apresentar um painel de tarefas personalizado HTML depois de um utilizador seleciona um item num controlo de caixa lista. Este evento é executado depois do evento OnValidate .

Um controlo num modelo de formulário ou um campo no painel de tarefas Origem de dados com o botão direito, aponte para a programação no menu de atalho e, em seguida, clique No depois de alterar evento.

OnAfterImport

Este evento é executado depois do utilizador com êxito intercala vários formulários de um formulário.

Adicione manualmente a declaração de processador de eventos OnAfterImport diretamente para o ficheiro de script utilizando MSE. Não é possível criar esta processador de eventos no modo de estrutura.

OnBeforeChange

Este evento é executado depois de um utilizador altere o valor num controlo e antes do valor é adicionado ao campo especificado vinculado nesse controlo. Por exemplo, pode impedir que um utilizador adicionar uma linha adicional antes de preencher da última linha numa tabela de repetição.

Um controlo num modelo de formulário ou um campo no painel de tarefas Origem de dados com o botão direito, aponte para programação no menu de atalho e, em seguida, clique No antes de alterar evento.

AoFazerClique

Este evento é executada quando um utilizador clica num botão associado com este evento. Este evento está disponível depois de adicionar um botão ao modelo de formulário. Por exemplo, pode executar cálculos complexos, utilizando os valores nos campos na origem de dados principal quando um utilizador clica no botão.

Faça duplo clique sobre o controlo de botão e, em seguida, no separador Geral da caixa de diálogo Propriedades do botão, clique em Editar código do formulário.

OnContextChange

Este evento é executada quando altera o foco no formulário. Por exemplo, este evento é executada quando um utilizador navega a partir de uma caixa de texto para um selecionador de data ou quando um utilizador alterna entre vistas. Este evento ocorre depois de tem ocorrido todos os outros eventos.

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

OnLoad

Este evento é executada sempre que um utilizador cria um novo formulário ou abre um formulário existente baseado no seu modelo de formulário. Por exemplo, pode copiar uma lista de itens de uma origem de dados secundária à origem de dados principal quando um utilizador abre o formulário.

No menu Ferramentas, aponte para de programação e, em seguida, clique No evento ao carregar.

OnMergeRequest

Este evento é executada quando formulários com base no seu modelo de formulário são intercalados. Por exemplo, pode apresentar o número de formulários que foram unidas para conceder a um Estado de um utilizador durante a operação de impressão em série.

No menu Ferramentas, clique em Opções de formulário. Na lista categoria, clique em Avançadas. Em Intercalar formulários, selecione a caixa de verificação em série com código personalizado e, em seguida, clique em Editar.

OnSaveRequest

Este evento é executada quando um utilizador guarda um formulário baseado no seu modelo de formulário. Por exemplo, pode guardar o formulário baseado neste modelo de formulário para mais do que uma localização quando um utilizador guarda o formulário. O InfoPath adiciona duas linhas adicionais de código para este evento: uma linha que guarda o formulário e outra linha que mostra-lhe se InfoPath guardado com êxito o formulário.

No menu Ferramentas, clique em Opções de formulário. Na lista categoria, clique em Abrir e guardar. Em comportamento de guardar, selecione a caixa de verificação Guardar utilizando código personalizado e, em seguida, clique em Editar.

OnSign

Este evento é executada quando um utilizador aplica-se uma assinatura digital a um formulário. Por exemplo, pode adicionar dados adicionais para a assinatura digital de um formulário de relatório de despesas quando um utilizador inicia-lo.

No menu Ferramentas, aponte para de programação e, em seguida, clique No evento de início de sessão.

OnSubmitRequest

Este evento é executada quando um utilizador submete dele dados de formulário. Por exemplo, pode submeter os dados do formulário a um serviço Web seguro quando o utilizador clica Submeter no menu ficheiro. Uma vez que o InfoPath não suporta a ligação de dados para um serviço Web seguro, tem de adicionar uma ligação de dados personalizados que funciona com o seu serviço Web seguro.

No menu Ferramentas, clique em Opções de submeter. Selecione a caixa de verificação Permitir que os utilizadores para submeter este formulário, clique em executar a ação personalizada utilizando o código e, em seguida, clique em Editar código.

OnSwitchView

Este evento é executada quando um utilizador abre um formulário baseado no seu modelo de formulário ou muda para outra vista no formulário. Por exemplo, quando um utilizador muda para uma vista específica, pode criar uma mensagem de correio electrónico que contém os dados a partir de campos na origem de dados principal do formulário.

No menu Ferramentas, clique em de programação e, em seguida, clique Em mudar ver evento.

OnValidate

Este evento é executada quando um utilizador altere o valor num controlo vinculado a um campo. Por exemplo, quando o utilizador altera o valor num controlo específico, pode calcular um novo valor para outro controlo utilizando o número que o utilizador introduziu e um número que esteja no script. Este evento ocorre após o processador de eventos OnBeforeChange é executado.

Um controlo num modelo de formulário ou um campo no painel de tarefas Origem de dados com o botão direito, aponte para a programação no menu de atalho e, em seguida, clique No depois de validar evento.

OnVersionUpgrade

Este evento é executada quando um utilizador é aberto um formulário existente e o número da versão do modelo de formulário utilizado pelo formulário existente é mais antigo do que o número da versão do modelo de formulário na localização publicar. Quando um utilizador abre um formulário existente, o InfoPath verifica o número da versão do modelo de formulário associado com o formulário existente. Se o modelo de formulário tem um número de versão mais recente, o InfoPath executa o processador de eventos OnVersion quando o utilizador abre o formulário existente. Por exemplo, imagine que adicionar um novo campo a um modelo de formulário existente e publicá-lo e pretende que o novo campo para ser adicionada à origem de dados principal, se um utilizador é aberto um formulário existente. Este evento adiciona o novo campo à origem de dados principal quando um utilizador abre um formulário existente.

No menu Ferramentas, clique em Opções de formulário. Na lista categoria, clique em controlo de versões. Na lista de actualização da versão, clique em evento personalizado para utilizar e, em seguida, clique em Editar.

Aumente os seus conhecimentos do Office
Explore as formações
Seja o primeiro a obter novas funcionalidades
Adira ao Office Insider

As informações foram úteis?

Obrigado pelos seus comentários!

Obrigado pelo seu feedback! Parece que poderá ser benéfico reencaminhá-lo para um dos nossos agentes de suporte do Office.

×