Texto estático

Nome	Texto estático
Tecla de atalho	Nenhuma
Ícone
Objeto gráfico	Sim

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

Static Text

ico Este objeto permite inserir uma caixa de texto na tela.

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)
Título	Neste campo é possível definir um título para este objeto.	Depende
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.	Depende
Esquerda	Define a distância, em pixels, entre a borda esquerda do objeto e a borda esquerda da tela.	Depende
Largura	Largura, em pixels, do objeto.	Depende
Altura	Altura, em pixels, do objeto.	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, Altura e Título 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
Transparente	Define se a cor de fundo correspondente à área do objeto será ou não apresentada. Quando definido como “Sim”, o objeto mantém a aparência do objeto sobreposto. Neste caso, apenas o texto associado é visível.	Não
Cor de fundo	Define a cor de fundo do objeto.	00FFFFFFh
Propriedades da Fonte	Abre tela para definições das propriedades da fonte.	Arial, 10, Preto
Alinhamento	Define o alinhamento vertical do texto dentro do objeto. Opções: Esquerda Direita Centro	Centro
Borda	Especifica o tipo de borda utilizada. Opções: Nenhuma Simples Relevo	Nenhuma
Quebra de Linha	Habilita ou desabilita a quebra de linha automatica do texto do objeto.	Não

Esta propriedade está disponível para o HIscada Pro a partir da versão 1.3.00.

Eventos
Propriedade	Descrição	Default
On Click	Ação 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)

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.

StaticText

StaticText
Propriedades Específicas	Descrição
Caption	Texto apresentado no componente. Este valor pode ser lido ou escrito.
Font.Color	Cor da fonte do StaticText

Exemplo de uso:

local scr = Screens.Get("Screen_001")
print(scr.StaticText_001.Caption)
scr.StaticText_001.Caption = "Alterado"

obs

A propriedade Font.Color de um StaticText só pode ser alterada se a propriedade Transparent estiver False.Quando Transparent estiver True, Font.Color estará fixa para o tema corrente do Windows.

Ver também