Botão
Nome |
Button |
Tecla de atalho |
Nenhuma |
Ícone |
|
Objeto gráfico |
Sim |
Button
Este objeto apresenta um botão na tela onde for inserido, permitindo ao usuário associar uma ação
(via script).
A tabela seguinte apresenta as propriedades de identificação geral do objeto:
Propriedades de identificação do objeto |
||
|---|---|---|
Propriedade |
Descrição |
Default |
Nome do item |
Define o nome do item que será exibido na árvore do painel de projeto e será utilizado quando necessário referenciar o mesmo. |
Item_NNN |
Comentário |
Permite a inclusão de um comentário acerca do objeto. Este campo não é obrigatório. |
(Nenhum) |
Argumentos |
Neste campo pode-se inserir uma string que será o valor da propriedade Argument do item. A string fornecida é uma forma geral de passagem de parâmetros para os scripts associados ao objeto durante sua execução. |
(Nenhum) |
A tabela seguinte apresenta as propriedades comuns dos objetos de tela Button:
Propriedades Comuns |
||
|---|---|---|
Propriedade |
Descrição |
Default |
Descrição |
Pode-se acrescentar uma breve descrição sobre o objeto. Este campo é apenas documental, não não sendo utilizado no projeto. Este campo não é obrigatório. |
(Nenhuma) |
Título Botão Normal |
Neste campo é possível inserir um texto que será exibido no botão quando ele não estiver pressionado. |
Button_001 |
Título Botão Pressionado |
Neste campo é possível inserir um texto que será exibido no botão quando ele estiver pressionado. |
Button_001 |
Dica |
Texto a ser apresentado quando o mouse é posicionado sobre o objeto. Este campo não é obrigatório. |
(Nenhuma) |
Topo |
Define a distância, em pixels, entre a borda superior do objeto e a borda superior da tela. |
10 |
Esquerda |
Define a distância, em pixels, entre a borda esquerda do objeto e a borda esquerda da tela. |
10 |
Largura |
Largura, em pixels, do objeto. |
50 |
Altura |
Altura, em pixels, do objeto. |
50 |
Habilitado |
Define se o objeto pode responder a interação do usuário. |
Sim |
Grupo com permissão de execução |
Neste campo é possível selecionar qual grupo de usuários terá permissão para executar a imagem na tela da aplicação. |
Todos os grupos |
Visível |
Define se o objeto será ou não exibido na tela. |
Sim |
Grupo com permissão de visualização |
Neste campo é possível selecionar qual grupo de usuários terá permissão para executar a imagem na tela da aplicação. |
Todos os grupos |
A tabela seguinte apresenta as propriedades específicas para este objeto de tela:
Propriedades Específicas |
||
|---|---|---|
Propriedade |
Descrição |
Default |
Propriedades da fonte |
Abre tela para definições das propriedades da fonte do título do botão. |
Arial, 10, Preto |
Imagem do Botão |
Seleciona uma imagem a ser apresentada no corpo do botão. |
Padrão |
Modo retentivo |
Ativa a opção de modo retentivo do botão (modo on-off). |
Não |
Sem efeito de relevo |
Remove o efeito de profundidade do botão. |
Não |
Cor do botão Normal |
Cor de fundo do botão quando o mesmo não está pressionado. |
RGB (22,0,0) |
Cor do botão Pressionado |
Cor de fundo do botão quando o mesmo está pressionado. |
RGB (22,0,0) |
Cor de Efeito do botão |
Cor do efeito de profundidade do botão. |
RGB (20,0,0) |
Cor de borda do botão Normal |
Cor da borda do botão quando o mesmo não está pressionado. |
RGB (6,0,0) |
Cor de borda do botão Pressionado |
Cor de borda do botão quando o mesmo está pressionado. |
RGB (6,0,0) |
Quebra de linha |
Habilita a quebra de linha automática do título do botão quando o mesmo possuir pelo menos duas palavras. |
Não |
Quando a propriedade Modo retentivo estiver habilitada, é possível associar um tag diretamente a um objeto do tipo botão.
A tabela seguinte apresenta a propriedade associada a este recurso:
Tags |
||
|---|---|---|
Propriedade |
Descrição |
Default |
Nome do Tag |
Nome do tag associado ao objeto. Quando Modo retentivo estiver habilitado |
(Nenhum) |
|
Todas as propriedades específicas deste objeto, incluindo o atributo Nome do Tag apresentado anteriormente, estão disponíveis apenas para o HIscada Pro a partir da versão 1.4.00. |
A tabela seguinte lista os tipos de eventos que podem ser associados ao objeto:
Eventos |
||
|---|---|---|
Propriedade |
Descrição |
Default |
On Click |
Executa uma ação após o evento de um clique simples sobre o objeto. Necessita do nome do script a ser executado. Este campo não é obrigatório. |
(Nenhum) |
On Exit |
Executa uma ação quando o objeto perde o foco por meio do teclado ou mouse. Necessita do nome do script a ser executado. Este campo não é obrigatório. |
(Nenhum) |
On MouseDown |
|
(Nenhum) |
On MouseUp |
|
(Nenhum) |
On Release |
|
(Nenhum) |
Executa uma ação após o evento de mouse pressionado
publicando as propriedades X, Y, Button e Shift
(clique 
Executa uma ação após o evento de retorno de
botão pressionado.
Necessita do nome do
|
|
API Lua
A lista das propriedades e atributos deste e outros componentes estão documentadas em Scripts e Acesso a atributos e funções de Componentes de Tela. A seguir apresentamos as tabelas com as propriedades e atributos de gerenciamento que podem ser utilizados via scripts, para o objeto descrito nessa página:
Atributos Comuns
São apresentados neste item os atributos que são comuns à grande maioria dos componentes de tela.
Atributos Comuns |
|
|---|---|
Nome da Propriedade |
Descrição |
Visible |
Torna o componente visível ou não. |
Enabled |
Habilita ou não a interação com o componente. |
Top |
Distância em pixels do topo do componente ao topo da tela em que está contido. |
Left |
Distância em pixels da lateral esquerda do componente à lateral esquerda da tela em que está contido. |
Width |
Largura em pixels do componente. |
Height |
Altura em pixels do componente. |
Arguments |
Texto preenchido no IDE na propriedade Argumentos. |
Button
Button |
|
|---|---|
Propriedades Específicas |
Descrição |
Caption |
Texto que rotula este componente. |
CaptionButtonPress |
Texto que rotula este componente quando pressionado. |