{"id":17872,"date":"2026-08-04T15:02:25","date_gmt":"2026-08-04T18:02:25","guid":{"rendered":"https:\/\/kb.elipse.com.br\/?p=17872"},"modified":"2026-08-04T15:56:05","modified_gmt":"2026-08-04T18:56:05","slug":"detectando-a-mudanca-de-selecao-de-um-hpoptionbutton","status":"publish","type":"post","link":"https:\/\/kb.elipse.com.br\/en\/detectando-a-mudanca-de-selecao-de-um-hpoptionbutton\/","title":{"rendered":"Detectando a mudan\u00e7a de sele\u00e7\u00e3o de um hpOptionButton."},"content":{"rendered":"
\n
\n

O hpOptionButton<\/code> n\u00e3o exp\u00f5e um evento Change<\/code>. Um Evento Definido pelo Usu\u00e1rio, ligado \u00e0 propriedade EventChange<\/code>, dispara o script a cada troca de op\u00e7\u00e3o.<\/p>\n

1.<\/span> Introdu\u00e7\u00e3o<\/h2>\n<\/div>\n<\/div>\n
\n
O hpOptionButton<\/code> \u00e9 o bot\u00e3o de op\u00e7\u00e3o da Biblioteca HighPerformance, usado nas telas de formul\u00e1rio para o operador escolher entre alternativas mutuamente exclusivas. Em muitas aplica\u00e7\u00f5es \u00e9 preciso reagir no exato momento em que a sele\u00e7\u00e3o muda<\/strong> \u2014 recalcular um valor, habilitar um comando, atualizar outra parte da tela.O problema \u00e9 que o hpOptionButton<\/code> n\u00e3o exp\u00f5e um m\u00e9todo\/evento Change<\/code><\/strong> ao qual se possa anexar diretamente um script. Sem esse gancho, n\u00e3o h\u00e1 como, \u00e0 primeira vista, disparar c\u00f3digo a cada troca de op\u00e7\u00e3o.A solu\u00e7\u00e3o n\u00e3o est\u00e1 em um evento nativo do objeto, e sim em um recurso da pr\u00f3pria plataforma E3\/Power: os Eventos Definidos pelo Usu\u00e1rio<\/strong>. Cria-se um evento de usu\u00e1rio cuja express\u00e3o geradora aponta para a propriedade EventChange<\/code> do hpOptionButton<\/code>, configurado para disparar sempre que essa express\u00e3o mudar de valor.<\/section>\n
\n

2.<\/span> O objeto hpOptionButton<\/h2>\n

O hpOptionButton<\/code> \u00e9 um dos objetos de formul\u00e1rio<\/strong> da Biblioteca HighPerformance. Ele apresenta uma op\u00e7\u00e3o selecion\u00e1vel (no estilo radio button<\/em>, com visual chapado e tem\u00e1vel do padr\u00e3o HP-HMI) e reflete a escolha atual do operador.<\/p>\n

Como qualquer objeto da biblioteca, ele \u00e9 um controle da plataforma E3\/Power, mas n\u00e3o traz um evento Change<\/code> pr\u00f3prio<\/strong>. Para observar a mudan\u00e7a de sele\u00e7\u00e3o sem esse evento, usa-se a propriedade EventChange<\/code> do objeto como gatilho de um evento de usu\u00e1rio, descrito a seguir.<\/p>\n<\/section>\n

\n

3.<\/span> Como funciona: Eventos Definidos pelo Usu\u00e1rio<\/h2>\n

Um Evento Definido pelo Usu\u00e1rio<\/strong> \u00e9 um evento personalizado, criado sobre um objeto, para executar um script quando um Tag ou uma propriedade<\/strong> (a express\u00e3o geradora<\/em>) atende a uma condi\u00e7\u00e3o. Ele \u00e9 o mecanismo padr\u00e3o do E3\/Power para “reagir \u00e0 mudan\u00e7a” quando o objeto de origem n\u00e3o oferece um evento adequado.<\/p>\n

Cada evento de usu\u00e1rio tem uma Condi\u00e7\u00e3o de Ocorr\u00eancia<\/strong>, que define quando o script \u00e9 executado:<\/p>\n\n\n\n\n\n\n\n
Condi\u00e7\u00e3o de ocorr\u00eancia<\/th>\nQuando dispara<\/th>\n<\/tr>\n<\/thead>\n
Sempre que a express\u00e3o alterar seu valor<\/td>\nA cada mudan\u00e7a<\/strong> do valor da express\u00e3o \u2014 \u00e9 a que interessa aqui<\/td>\n<\/tr>\n
Sempre que a express\u00e3o for verdadeira<\/td>\nQuando a express\u00e3o passa a ser verdadeira<\/td>\n<\/tr>\n
Repeti\u00e7\u00e3o c\u00edclica enquanto verdadeira<\/td>\nRepetidamente, no per\u00edodo (ms) configurado, enquanto verdadeira<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Para o hpOptionButton<\/code>, a express\u00e3o geradora \u00e9 a propriedade EventChange<\/code><\/strong> do pr\u00f3prio objeto, e a condi\u00e7\u00e3o usada \u00e9 “Sempre que a express\u00e3o alterar seu valor”<\/strong>. Assim, cada troca de op\u00e7\u00e3o altera o valor de EventChange<\/code>, o evento dispara e o script associado \u00e9 executado.<\/p>\n

\n

Por que isso resolve o problema?<\/p>\n

EventChange<\/code> muda de valor a cada sele\u00e7\u00e3o. Ao us\u00e1-la como express\u00e3o de um evento de usu\u00e1rio com a condi\u00e7\u00e3o “alterar valor”, obt\u00e9m-se exatamente o comportamento de um evento Change<\/code> \u2014 mesmo sem o objeto expor um.<\/p>\n<\/div>\n<\/section>\n

\n

4.<\/span> Como configurar<\/h2>\n

Pelo E3 Studio<\/h3>\n
    \n
  1. Selecione o objeto hpOptionButton<\/code> na tela e abra sua aba Scripts<\/strong>.<\/li>\n
  2. Clique em Criar novo evento<\/strong>, d\u00ea um nome ao evento (por exemplo, OnEventChange<\/code>) e confirme para abrir o editor.<\/li>\n
  3. No campo Express\u00e3o<\/strong> do evento, aponte para a propriedade EventChange<\/code> do pr\u00f3prio objeto.<\/li>\n
  4. Em Condi\u00e7\u00e3o de Ocorr\u00eancia<\/strong>, escolha “Sempre que a express\u00e3o alterar seu valor”<\/strong>.<\/li>\n
  5. Escreva, no corpo do evento, o script que deve rodar a cada mudan\u00e7a de sele\u00e7\u00e3o.<\/li>\n<\/ol>\n

    Por script<\/h3>\n

    O disparo \u00e9 configurado nas propriedades do evento (express\u00e3o + condi\u00e7\u00e3o de ocorr\u00eancia); o bloco abaixo \u00e9 o corpo do evento de usu\u00e1rio<\/strong> OnEventChange<\/code>, executado a cada troca de op\u00e7\u00e3o:<\/p>\n

    \n
    ' Evento de usuario OnEventChange do hpOptionButton<\/span>\r\n'   Expressao geradora ....: EventChange (propriedade do proprio objeto)<\/span>\r\n'   Condicao de ocorrencia : Sempre que a expressao alterar seu valor<\/span>\r\n' Executado automaticamente a cada mudanca de selecao do hpOptionButton.<\/span>\r\n\r\nSub<\/span> OnEventChange()\r\n    ' A selecao acabou de mudar. Coloque aqui a acao desejada, por exemplo:<\/span>\r\n    Application.GetObject(\"Dados.SelecaoAtual\"<\/span>).Value = Me.EventChange\r\n\r\n    ' ... recalcular, habilitar um comando, atualizar outra parte da tela etc.<\/span>\r\nEnd Sub<\/span><\/pre>\n<\/div>\n<\/section>\n
    \n
    5.<\/span> Resultado<\/h2>\n
    Com o evento de usu\u00e1rio configurado, a tela passa a reagir a cada troca de op\u00e7\u00e3o sem depender de um evento nativo do objeto:<\/p>\n\n\n\n\n\n\n
    Situa\u00e7\u00e3o<\/th>\nComportamento<\/th>\n<\/tr>\n<\/thead>\n
    <\/p>\n
    Sem o evento de usu\u00e1rio
    \n<\/span><\/td>\n
    		N\u00e3o h\u00e1 como disparar script na mudan\u00e7a \u2014 o hpOptionButton<\/code> n\u00e3o tem evento Change<\/code><\/td>\n<\/tr>\n
    <\/p>\n
    Com o evento de usu\u00e1rio
    \n<\/span><\/td>\n
    		O script roda automaticamente a cada mudan\u00e7a<\/strong> de sele\u00e7\u00e3o (EventChange<\/code> + “alterar valor”)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
     <\/p>\n<\/section>\n
    \n
    6.<\/span> Observa\u00e7\u00f5es e boas pr\u00e1ticas<\/h2>\n
      \n
    • Use a condi\u00e7\u00e3o “alterar valor”<\/strong>, n\u00e3o “for verdadeira”. A primeira dispara em qualquer mudan\u00e7a de sele\u00e7\u00e3o; a segunda tem sem\u00e2ntica diferente e n\u00e3o atende ao caso.<\/li>\n
    • A t\u00e9cnica \u00e9 geral.<\/strong> O mesmo padr\u00e3o \u2014 evento de usu\u00e1rio com condi\u00e7\u00e3o “alterar valor” sobre uma propriedade \u2014 vale para qualquer objeto ou propriedade<\/strong> que n\u00e3o exponha um evento de mudan\u00e7a nativo, n\u00e3o s\u00f3 o hpOptionButton<\/code>.<\/li>\n
    • O script fica junto do objeto.<\/strong> Por ser um evento de usu\u00e1rio do pr\u00f3prio hpOptionButton<\/code>, o script acompanha o objeto \u2014 facilita a manuten\u00e7\u00e3o e o reaproveitamento em bibliotecas.<\/li>\n
    • Escopo de produto.<\/strong> A Biblioteca HighPerformance roda sobre o E3, e os Eventos Definidos pelo Usu\u00e1rio s\u00e3o um recurso da plataforma; a t\u00e9cnica se aplica igualmente nos dois.<\/li>\n<\/ul>\n<\/section>\n
      <\/section>\n