Display de edição de valores

Nome

Edit

Tecla de atalho

Nenhuma

Ícone

ico

Objeto gráfico

Sim

Esta página apresenta descrição e propriedades do item Edit.

Edit

ico Este objeto pode ser utilizado para visualizar e modificar os valores de um (Tag).

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)

Propriedades Comuns

Propriedade

Descrição

Default

Descrição

Pode-se acrescentar uma breve descrição sobre o objeto. Este campo é apenas documental não sendo utilizado no projeto. Este campo não é obrigatório.

(Nenhuma)

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.

obs Depende

Esquerda

Define a distância, em pixels, entre a borda esquerda do objeto e a borda esquerda da tela.

obs Depende

Largura

Largura, em pixels, do objeto.

obs Depende

Altura

Altura, em pixels, do objeto.

obs Depende

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 imagem na tela da aplicação.

Todos os grupos

obs

As propriedades Topo, Esquerda, Largura e Altura tem seus valores default definidos no momento da criação do objeto. Então, esses valores podem variar para os diferentes tipos de objeto.

Propriedades Específicas

Propriedade

Descrição

Default

Modo de edição Z1

Define qual o modo de edição do objeto Edit.

Opções: Automático - Neste modo o objeto Edit escreve no Tag associado assim que o mesmo perder o foco ou, o usuário apertar o botão “Enter” do teclado. Via script - A ação de edição do objeto Edit sobre o Tag associado só terá efeito a partir de um script que solicite a edição. Enquanto o script não for chamado, o objeto estará em modo Pendente, ou seja, esperando uma chamada de script para efetuar a edição. Esta opção abre os novos campos: Pendente: Cor de fundo e Pendente: Cor da fonte.

Automático

Padrão: cor de fundo

Define a cor de fundo do objeto.

RGB (255,255,255)

Edição: cor de fundo

Define a cor de fundo apresentada durante a edição do texto do objeto.

RGB (255,0,0)

Edição: cor da fonte

Define a cor da fonte do objeto.

RGB (255,255,255)

Propriedades da Fonte

Abre tela para definições das propriedades da fonte. N Z3

Arial, 10, Preto

Pendente: cor de fundo

Z1 Define a cor de fundo do objeto enquanto a escrita no Tag não for ativada.

RGB (255,255,0)

Pendente: cor da fonte

Z1 Define a cor da fonte do objeto enquanto a escrita no Tag não for ativada.

RGB (0,0,0)

Alinhamento

Define onde o dado a ser inserido ficará posicionado dentro do campo de Edit. (À Esquerda, À direita ou no centro do Campo)

Esquerda

Borda

Especifica o tipo de borda utilizada.

Opções:

  • Nenhuma

  • Simples

Simples

Modo Senha

Habilita apresentação do caractere ‘*’ ao invés do valor do Tag. N Z4

Não

obs

Z3 Este atributo do objeto está disponível apenas para o HIscada Pro a partir da versão 1.3.00.

Z4 Este atributo do objeto está disponível apenas para o HIscada Pro a partir da versão 1.0.05.

Limite de Valores N

Propriedade

Descrição

Default

Limite para valores de entrada

Habilita teste para os limites de valores permitidos para a entrada de dados. Quando habilitado deve-se especificar os limites mínimo e máximo para a entrada de dados.

Não

Origem do limite mínimo

Especifica a origem para obtermos o valor númerico associado ao limite mínimo para a entrada de dados.

Opções:

  • Constante - Permite especificar um valor constante para o limite mínimo;

  • Tag - Permite especificar um Tag cujo conteúdo será o valor númerico para o limite mínimo.

Constante

Valor do limite mínimo

Valor mínimo permitido para a entrada de dados quando origem do limite mínimo for constante.

Valor = 0

Origem do limite máximo

Especifica a origem para obtermos o valor associado ao limite máximo para a entrada de dados.

Opções:

  • Constante - Permite especificar um valor constante para o limite máximo;

  • Tag - Permite especificar um Tag cujo conteúdo será o valor para o limite máximo.

Constante

Valor do limite máximo

Valor máximo permitido para a entrada de dados quando origem do limite máximo for constante.

Valor = 100

Tag para limite mínimo

Tag cujo valor será o limite minimo permitido para entrada do valor númerico.

(Nenhum)

Índice Tag limite mínimo

Se o Tag associado ao limite for do tipo vetor, pode-se especificar um índice associado a este vetor para acesso ao valor do Tag.Ou seja, para que o valor naquele índice seja o limite mínimo para o valor do Tag.

1

Tag para limite máximo

Tag cujo valor será o limite máximo permitido para entrada do valor númerico.

(Nenhum)

Índice Tag limite máximo

Se o Tag associado ao limite for do tipo vetor, pode-se especificar um índice associado a este vetor para acesso ao valor do Tag.Ou seja, para que o valor naquele índice seja o limite máximo para o valor do Tag.

1

obs

Estes atributos do objeto estão disponíveis para o HIscada Pro a partir da versão 1.0.05.

Tags

Propriedade

Descrição

Default

Nome Tag

Nome do ref:Tag <Tags> associado ao objeto.

(Nenhum)

Índice

Offset para o valor do Tag associado caso ele seja um vetor.

1

Formato

Formatação do texto para apresentação do valor do Tag.

%d

Eventos

Propriedade

Descrição

Default

On Click

Evento a ser executada 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 Change

Evento a ser executado quando se faz uma alteração (change) no dado do campo do Edit. Este evento está disponível apenas via Objeto de Ação

(Nenhum)

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.

Edit

Edit

Propriedades Específicas

Descrição

Value

Texto associado apenas ao valor corrente do campo, sem a formatação. Este atributo pode ser lido ou escrito.

DisplayedValue

Texto associado ao valor corrente formatado do campo, ou seja, retorna o valor do campo com a respectiva formatação associada ao mesmo. Este atributo é somente para leitura.

UpdatePending

Quando a propriedade “Modo de Edição” estiver configurada para “via script”, a propriedade UpdatePending (booleano) indica se o valor do campo foi alterado significando que a atualização no respectivo Tag está pendente.

SaveEdit

Quando a propriedade “Modo de Edição” estiver configurada para “via script”, atribuir 1 grava os dados do Edit no Tag somente se houver alteração, atribuir 2 sempre grava os dados do Edit no Tag associado.

CancelEdit

Quando a propriedade “Modo de Edição” estiver configurada para “via script”, atribuir 1 cancela a edição somente se houver alteração, atribuir 2 sempre cancela a edição.

Format

Compativel HIScada Pro versão >= 1.2.08. Formatação do texto para apresentação do valor do Tag.

Exemplo de uso do Edit

-- campo "Edit" com o seguinte formato = "Temperatura ###0 graus"

-- Obtém os atributos de um "Edit"
print("    edit value: " .. Sender.Screen.Edit_001.Value)
print("edit displayed: " .. Sender.Screen.Edit_001.DisplayedValue)

-- Altera o valor de um "Edit"
Sender.Screen.Edit_001.Value = "321"

-- Forma alternativa de obter acesso ao atributo Edit_001 da tela
local edit1 = Sender.Screen["Edit_001"]
edit1.Value = "123"

Exemplo de execução:

edit value: 75
edit displayed: Temperatura 75 graus

edit value: 321
edit displayed: Temperatura 321 graus

Ver também