Partilhar via


Evento OnPreStageChange (referência da API do cliente)

Esse evento ocorre antes que o estágio de um controle de fluxo de processo de negócios seja alterado. Esse evento ocorre depois que o usuário seleciona os botões Next Stage, Move to previous stage ou set Ative Stage na interface do usuário ou quando um desenvolvedor usa os formContext.data.process.moveNextmétodos , formContext.data.process.movePreviousou formContext.data.process.setActiveStage .

Observação

O evento OnPreStageChange é suportado apenas na Interface Unificada.

De dentro de um script de recurso da Web registrado no evento onPreStageChange, um desenvolvedor pode invocar o seguinte no objeto executionContext passado para o script de recurso da Web:

executionContext.getEventArgs().preventDefault();

Quando invoca preventDefault:

  • A navegação do palco não será processada. A instância do processo permanecerá no estágio original.
  • Em uma navegação entre tabelas, o formulário da tabela do estágio de destino não será aberto.
  • O salvamento do formulário principal não será processado. Se a forma principal estivesse em estado sujo, permaneceria em estado sujo.
  • Quaisquer recursos da Web que se registraram onStageChange não serão invocados.

Um objeto de contexto de execução é passado para manipuladores de eventos para esse evento. Você pode usar o método getEventArgs para recuperar um objeto que tenha os seguintes métodos:

  • getDirection: retorna uma cadeia de caracteres que é ou NextPrevious para mostrar a direção da alteração de estágio.
  • getStage: retorna um objeto stage. Exceto quando a navegação se move para uma nova tabela, o estágio retornado representa o objeto do estágio de destino, ou seja, o próximo estágio ativo. Quando a navegação se move para uma nova tabela, o palco é o estágio a partir do qual está sendo navegado, ou seja, o objeto de estágio ativo anterior. Mais informações: Métodos de estágio.

Métodos suportados para este evento

  • formContext.data.process. addOnPreStageChange método para adicionar manipuladores de eventos para este evento.
  • formContext.data.process. removeOnPreStageChange método para remover manipuladores de eventos para este evento.

Eventos (referência da API do cliente)
Eventos em formulários e grelhas em aplicações condicionadas por modelo