Eventos definidos pelo usuário

Visualizações se comunicam com outras visualizações usando ligações de dados. No entanto, também é possível usar eventos para interagir com outras visualizações. Para ilustrar os conceitos neste tópico, três visualizações relacionadas, denominadas Renda, Despesas e Lucro, foram incluídas em um serviço manual do lado do cliente. Essas visualizações usam eventos para interagir entre si e elas são todas do tipo de visualização Decimal. O restante deste tópico descreve alguns dos recursos-chave na estrutura de eventos para visualizações.

Um ID de controle é um identificador que pode ser especificado no código JavaScript para se referir a uma visualização. Os IDs de controle podem ser referenciados por outras visualizações para permitir que eles interajam uns com os outros usando eventos. Por exemplo, nas propriedades Gerais, é possível especificar um ID de controle para uma visualização no campo ID de controle.

Todos os manipuladores de eventos definidos pelo usuário para uma visualização são exibidos nas propriedades de Eventos. Cada manipulador de eventos tem um editor JavaScript expansível para incluir a lógica de negócios e tem um assistente de conteúdo que pode ser chamado pressionando Ctrl-Espaço. Os manipuladores de eventos Em carregamento e Em mudança são mostrados na imagem a seguir:

Para definir eventos definidos pelo usuário, use o tipo integrado Evento que foi incluído para complementar os tipos integrados Objeto e Serviço. Em Declarações de variável, inclua uma ou mais opções de configuração. Em Dados, mude uma ou mais opções de configuração para os eventos, selecionando o botão de opções Evento e especificando um nome e um rótulo. Na figura a seguir, o evento definido pelo usuário eventON_LOAD é selecionado em Declarações de variável e o nome, o rótulo e a documentação correspondentes para esse evento definido pelo usuário são mostrados em Dados:

O evento definido pelo usuário eventON_LOAD é um manipulador de eventos especial. Se você definir uma opção de configuração de evento com o nome eventON_LOAD, ela será executada automaticamente no manipulador de eventos load.

Para registrar um evento definido pelo usuário após ele ter sido definido, selecione um manipulador de eventos nas propriedades Comportamento e, em seguida, use o editor JavaScript em Código para incluir opcionalmente a lógica de registro. Se houver variáveis adicionais que você gostaria de passar para o manipulador de eventos, será possível chamar a função registerEventHandlingFunction. No entanto, se você não chamar explicitamente a função de registro, o manipulador de eventos será registrado sem variáveis adicionais.

Para designar quando um evento definido pelo usuário deve ser disparado, selecione um manipulador de eventos nas propriedades Comportamento e, em seguida, use o editor JavaScript em Código para incluir a lógica necessária. Na lógica, é necessário chamar a função executeEventHandlingFunction para executar a lógica de evento. Na figura a seguir, o evento valueChange é executado no manipulador de eventos change. O assistente de conteúdo foi chamado na instrução this. selecionando Ctrl-Espaço para localizar e selecionar a função executeEventHandlingFunction:

Os manipuladores de eventos definidos pelo usuário para a visualização são exibidos nas propriedades de Eventos. Cada manipulador de eventos tem um editor JavaScript expansível para incluir a lógica de negócios e tem um assistente de conteúdo que pode ser chamado pressionando Ctrl-Espaço. Usando o editor JavaScript, é possível inserir código customizado em um manipulador de eventos. Isso permite que sua visualização interaja com outras visualizações e execute tarefas, como configurar valores e verificar validações. Na figura a seguir, o assistente de conteúdo é chamado no editor JavaScript para o manipulador de eventos definido pelo usuário On Change e o${VIEW_ID}a variável está prestes a ser selecionada:

Se você incluir o${VIEW_ID}para o editor JavaScript de um manipulador de eventos definido pelo usuário, é necessário substituir o token VIEW_ID pelo ID de controle de outra visualização, que fornece ao manipulador de eventos definido pelo usuário acesso completo a essa visualização. Por exemplo, você poderia substituir o${VIEW_ID}com ${Revenue} (que é o ID de controle para a visualização Renda). Você poderia então chamar uma função como${Revenue}.getData()para obter o valor limite atual para a visualização Renda.