Tag event

.html ›› .html ›› .html ››
Parent Previous Next

Tag event

Esta tag especial serve para tratar um evento de uma tag/controle usando a linguagem de programação LUA (veja A linguagem de programação LUA).



Observações: 


Importante: Não deixe de ler as Orientações ao usar código LUA em um Lua Form

Características

Propriedades e atributos


Propriedade

Tipo

Valor Padrão

Descrição

name

String

<Não há valor padrão>

Identifica o nome do evento que deseja manipular.


Cada tag/controle possui seu próprio conjunto de eventos que podem ser tratados. Consulte a documentação!


O preenchimento desta propriedade é obrigatório.


Exemplos

Exemplo 1 - Olá mundo com um botão.


A tag event está dentro da tag button, portanto, a tag está manipulando o evento "onClick" do button


<?xml version="1.0" encoding="UTF-8"?>
<form name="frmFichaTeste">         

        <button left="20" top="20" text="clique">
                <event name="onClick">
                        showMessage("Olá mundo!");
                </event>
        </button>

</form>



Importante: Não deixe de ler as Orientações ao usar código LUA em um Lua Form


Exemplo 2 - Centralizando um controle na interface visual


A tag event está dentro da tag form, portanto ela está manipulando o evento "onResize" do form.


<?xml version="1.0" encoding="UTF-8"?>
<form name="frmFichaTeste">         

        <event name="onResize">
                self.btnMeuBotao.left = self.width / 2 - self.btnMeuBotao.width / 2;
                self.btnMeuBotao.top = self.height / 2 - self.btnMeuBotao.height / 2;
        </event>       

        <button name="btnMeuBotao" text="Meu botão!"/>
</form>




Importante: Não deixe de ler as Orientações ao usar código LUA em um Lua Form


Exemplo 3  - Definindo funções e as chamando em eventos


<?xml version="1.0" encoding="UTF-8"?>
<form name="frmFichaTeste">         

        <script><![CDATA[
                local function rotacionarUmPouco(controle)
                        local angulo = controle.rotationAngle;
                        angulo = angulo + 30;                       

                        while angulo >= 360 do
                                angulo = angulo - 360;
                        end;                       

                        controle.rotationAngle = angulo;
                end;   
        ]]>
        </script> 

        <button name="btnMeuBotao" left="20" top="30" text="Botão 1">
                <event name="onClick">
                        rotacionarUmPouco(self.btnMeuBotao);
                </event>               
        </button>       

        <button name="btnMeuBotao2" left="20" top="100" text="Botão 2">
                <event name="onClick">
                        rotacionarUmPouco(self.btnMeuBotao2);
                </event>               
        </button>      
</form>


--->



Neste exemplo foi usada a Tag script para definir uma função e foi usado um bloco CDATA para lidar com caracteres reservados do XML.


Importante: Não deixe de ler as Orientações ao usar código LUA em um Lua Form




Created with the Personal Edition of HelpNDoc: Experience the Power and Ease of Use of a Help Authoring Tool