LAquis 3.

0
Introduo para utilizao e desenvolvimento de aplicativos

Software Supervisrio

Apostila 17/7/2008

Leo Consultoria e Desenvolvimento de Sistemas Ltda http//:www.lcds.com.br leao@lcds.com.br

ndice
Introduo .................................................................................................... 4 Passo a passo ............................................................................................. 5 1 Pontos de leitura e escrita (tags). ........................................................ 5 2 Arquivo / Relatrio ............................................................................... 9 3 Objetos visuais .................................................................................. 12 4 Script visual e texto ......................................................................... 19 Planilha de pontos de Leitura e Escrita (Tags)........................................... 21 Configurao da Comunicao................................................................ 24 Frmula na planilha de tags .................................................................. 25 Definio do arquivo................................................................................ 26 Drivers ....................................................................................................... 27 Selecionar um Driver ............................................................................... 29 Campos especiais do equipamento......................................................... 30 Relatrio / Histrico.................................................................................... 31 Relatrio principal.................................................................................... 31 Criar relatrios a partir do modelo ........................................................... 31 Planilhas para relatrio e anlise............................................................. 32 Frmulas e comandos para planilhas LGX .............................................. 34 Bancos LB ............................................................................................... 35 Opo LB (ODBC)................................................................................... 36 Campos (estrutura).................................................................................. 36 Conexo/Tipo do banco de dados ........................................................... 37 Editar (Abrir tabela) ................................................................................. 38 Rede .......................................................................................................... 39 Servidor ................................................................................................... 39 Cliente ..................................................................................................... 40 Comunicao em Rede ........................................................................... 41 Objetos Visuais .......................................................................................... 42 Objetos para desenhos vetoriais ............................................................. 44 Inserir Objeto Visual ................................................................................ 45 Configurao do Painel ........................................................................... 46 Exemplos de objetos visuais ................................................................... 47 Criao e alterao de objetos visuais 2D (personalizar) ........................ 52 Janela da interface 3D ............................................................................... 54 Objetos da planta 3D............................................................................... 55 Objeto (arquivo 3D) ................................................................................. 56 Parede..................................................................................................... 57 Painel 3D................................................................................................. 57 Cano 3D .................................................................................................. 58 Objeto Visual 3D...................................................................................... 58 Criao e alterao de objetos visuais 3D (personalizar) ........................ 59 Menu principal............................................................................................ 60 Opes (Preferncias) ............................................................................... 63 Senha ........................................................................................................ 64 Script (texto e visual).................................................................................. 65
2

Eventos ................................................................................................... 69 Browser................................................................................................. 70 Acessando os "tags" da planilha de E/S (Objeto TAG) ............................ 71 Variveis.................................................................................................. 72 Operaes bsicas.................................................................................. 73 Comandos e expresses bsicas ............................................................ 74 Objetos Visuais........................................................................................ 78 Objeto Painel........................................................................................... 79 Objeto Planilha ........................................................................................ 80 Exemplo (OnDepoisVarreduras).............................................................. 81 Exemplo - Evento Global (script texto)..................................................... 82 Funes e objetos de memria................................................................ 83 Objeto Tabela.......................................................................................... 87 Funes e objetos de arquivos e banco de dados................................... 89 Funes de texto ..................................................................................... 95 Funes matemticas............................................................................ 103 Funes de bits ..................................................................................... 107 Funes de tempo................................................................................. 108 Funes de aplicativo ............................................................................ 112 Funes de comunicao...................................................................... 114 Funes de janelas de mensagens ....................................................... 117 Objeto GRID.......................................................................................... 118 Comandos principais da planilha de relatrios....................................... 119 Outras funes e objetos....................................................................... 120 Declare (script texto) ............................................................................. 121

Introduo
No LAquis possvel tanto realizar aquisies de dados como tambm desenvolver programas especficos para as mais diversas aplicaes. Script / opes dos objetos

Painel (objetos visuais)

Planilha de pontos de leitura e escrita (tags)

A tela principal se divide em duas partes: a parte inferior, onde fica a planilha de pontos de entrada e sada ("tags") e a parte superior, painel onde se programam os objetos visuais. Na planilha de "tags" so definidas as variveis, arquivos, equipamentos, frmulas, escalas ou outras proprieades e parmetros criados pelo usurio para cada caso. Os objetos visuais podem ser usados tanto para o desenvolvimento de sistemas especficos atravs de "script" como tambm para o acompanhamento simples de uma aquisio de dados. Cada objeto pode estar relacionado a uma linha da planilha (tags). Para a gerao de relatrios e grficos de leituras armazenadas basta "clicar" sobre o boto selecionar uma das opes do "menu" "Dados e Relatrios". possvel utilizar interface em 3D. Veja em no captulo Planta 3D (introduo). ou

Exemplos teis: Alguns exemplos de aplicativos podem usados para entender o uso do software supervisrio LAquis. Estes exemplos esto disponveis na pasta principal do LAquis (LAquis\Apls\Exemplos\*.lqs). Para acessar estes exemplos selecione, no LAquis, a opo Abrir do menu Arquivo. Alguns deles: - planta3d.lqs (exemplo de planta 3D) - modeloteste.lqs e modeloteste2.lqs (exemplos simples para teste das funes bsicas do sistema) - modbus_teste.lqs (exemplo para teste de um ponto de leitura usando o protocolo modbus rtu) - simularelatrio5.lqs (exemplo de uso de objetos visuais, telas e relatrios)

Passo a passo
Sero apresentados 4 passos bsicos: 1 Definio dos pontos de E/S (tags). 2 Arquivo / Relatrio 3 Objetos Visuais 4 Scripts visual e texto

1 Pontos de leitura e escrita (tags).

Defina os pontos de leitura e escrita na planilha de tags situada na parte inferior da tela principal. Esta planilha contm as informaes necessrias para definir as informaes que sero lidas ou escritas nos equipamentos. Estes tags podem ser tambm variveis genricas. Alguns dos campos principais para cada tag so: Nome, Ttulo, Valor, Driver (Equipamento), Arquivo, Param1, Param2, etc.... Escolha os drivers dos equipamentos a serem usados na coluna Driver (Equipamento). O driver pode ser definido arrastando o ponteiro do mouse com o boto esquerdo pressionado sobre a coluna Driver, ou clicando sobre o ttulo da coluna Driver para selecionar todos os tags desejados.

Ao soltar o boto do mouse a janela driver ser mostrada:

Planilha de pontos de leitura e escrita ou tags. O driver a ser escolhido depende do equipamento (hardware) utilizado. Para testar o funcionamento do software sem equipamento utilize, por exemplo, o driver DEMO. 5

Se, por exemplo, desejar comunicar com um equipamento que utilize o protocolo Modbus rtu escolha o driver MODBUS RTU.ldriver. O Param1 fica sendo o nmero do registro e o Param2 o nmero do n (Exemplo: Param1=400001. Param2=1). Veja a descrio dos parmetros do driver Modbus no captulo Drivers. Configure a comunicao (porta, velocidade, temporizao, etc....) no boto Config da janela Driver ou na coluna Config da planilha. Ao pressionar o boto Config da janela Driver a seguinte janela ser mostrada para configurao da porta serial:

Configure as caractersticas da comunicao. Exemplo de configurao para porta serial COM1: 1:9600,N,8,1. (porta serial 1, velocidade 9600, paridade nenhuma, bits de dados 8, bits de stop 1). Se o driver for OPC, ao clicar sobre o boto Config ser apresentada uma janela para definio do ProgID e Item ID do servidor OPC (opcionalmente para conexes remotas coloque o IP do servidor no campo Servidor):

- Defina as outras caractersticas do tag. Neste exemplo foram colocados o nome (valor1), ttulo (Valor 1), unidade ( Param1 (400001) e C), Param2 (1):

Exemplo com quatro tags: (sero lidos os quatro primeiro registros holding do equipamento do n 1 atravs do protocolo Modbus)

Se desejar testar o software e no tiver equipamento conectado ao computador utilize, por exemplo, o driver DEMO:

Para iniciar a leitura dos valores e testar a comunicao clique sobre o boto (play Iniciar aplicao). Na barra inferior ser apresentada uma mensagem de atualizao dos tags. Os valores devero ser mostrados na coluna Valor. Se houver erro de comunicao aparecer nesta coluna a mensagem ERRO e na coluna Status Erro de leitura. Para fins de melhor visualizao neste teste, clique no boto situado na parte superior do software. para mostrar os visores no painel

Para desligar a comunicao pressione o boto

(stop Parar aplicao). 7

Para testar a alterao de algum valor no equipamento associado ao tag utilize a coluna Set. Tecle enter ou saia da clula para efetuar a alterao.

Os tags podem ser tambm variveis para diversos fins. Utilize, por exemplo, o driver VAR.

Opcionalmente, os tags podem possuir outras caractersticas personalizveis conforme a aplicao. Para isso utilize o boto ou a opo do menu Editar Pontos de leitura e escrita (Tags) Personalizar colunas de parmetros.

Novas colunas podem ser criadas para os tags. Estas colunas so colocadas no final ( direita) da planilha. Neste exemplo foram criados dois campos a mais LI, LS, Alarme, Acao, Ocorrncia e Resp. Para adicionar o campo digite o nome do campo ou selecione na lista direita e clique sobre o boto Adicionar. No necessrio que o campo exista na lista direita. possvel criar quaisquer nomes de campos que desejar, desde que no contenham espaos ou caracteres especiais. Estes campos podero ser armazenados no arquivo que ser mostrado na seo a seguir. Todavia os campos LI, LS e Alarme, usados neste exemplo, tm significados pr-definidos no LAquis. LI e LS so respectivamente um limite superior e um limite inferior. Alarme um campo que retorna a condio do valor ter ultrapassados os limites. Entretanto, no necessrio utilizar estes campos para limites. Pode-se criar outras maneiras de fazer a mesma coisa. Por exemplo, pode-se criar campos como LSCritico, LSSeguranca, LICritico, LISeguranca, etc.... e a partir disso programar o aplicativo para respeitar os valores conforme as especificaes do processo.

Mais detalhes veja o captulo Planilha de Pontos de E/S(Tags). 8

2 Arquivo / Relatrio
Os valores lidos e controlados nos tags podem ser gravados em arquivo. Para isso clique sobre a coluna Arquivo. Da mesma forma que o driver, o arquivo pode ser definido arrastando o ponteiro do mouse com o boto esquerdo pressionado sobre a coluna Arquivo, ou clicando sobre o ttulo da coluna Arquivo para selecionar todos os tags desejados.

Neste exemplo, os valores dos quatro tags sero armazenados no banco de dados TESTE.LB:

O intervalo de tempo em que os valores sero armazenados definido na coluna Intervalo:

Clique no boto

para iniciar a leitura com a gravao no banco de dados.

Observao: os dados (leituras), como padro, so gravados na sub-pasta dados dentro da pasta do aplicativo lqs. O nome dos arquivos, como padro, fica sendo <nome do arquivo><data>.LBX. Neste exemplo TESTE060608.LBX. Note que ser possvel reconfigurar o banco para outros tipos de banco de dados. Para alterar a configurao do banco de dados utilize a opo do menu Dados e Relatrios Banco de dados / Arquivo (LB/ODBC) / Exportao. 9

Se os campos Resp, Ocorrencia e Acao forem criados neste exemplo, eles podero ser do tipo texto. Para isso faa o seguinte: 1 Pressione o boto para parar a execuo. 2 Selecione o menu Dados e Relatrios Banco de dados / Arquivo (LB/ODBC). 3 Pressione o boto Campos. 4 V at os campos Resp, Ocorrencia e Acao. Na coluna Tipo coloque 1 Texto. 5 Pressione o boto OK e confirme a converso. Tendo alguns dados j gravados no banco de dados j possvel criar os relatrios. Um dos relatrios pode ser considerado o principal, e o que ser mostrado a seguir. Para gerar um relatrio dos dados gravados, clique sobre o boto Abrir relatrio principal (Histrico / Leituras). ou no menu Dados e Relatrios

Na primeira vez, nesta fase de desenvolvimento, aparecer uma janela para escolha do modelo do formato de relatrio:

10

Cada modelo de relatrio tem um fim especfico. Os formatos tambm podem ser criados e modificados conforme a necessidade da aplicao. Veja mais sobre os formatos de relatrio no captulo Gerao de Relatrios. Exemplo de modelo Amostragem: Exemplo de modelo Limites e ocorrncias (se os campos Resp, Acao e Ocorrencia forem usados como texto, neste caso possvel inserir informao de ocorrncias e aes no prprio relatrio e armazen-las no arquivo):

Exemplo de modelo Individual Simples: Se desejar fazer o grfico clique sobre o boto Grfico. Se quiser imprimir com vrias colunas para economizar folha, utilize a opo colunas no boto Imprimir.

Exemplo de modelo Individual Simples visualizando apenas o grfico:

O nome do formato do relatrio principal fica sendo Conexo <nome do arquivo>.lgx. Neste exemplo fica sendo Conexo TESTE.lgx. Novos relatrios: Para criar novos relatrios utilize a opo do menu Dados e Relatrios Criar relatrio.... Para abrilos utilize o menu Dados e Relatrios Abrir relatrio... ou crie um boto associado ao relatrio criado (Veja o prximo passo objetos visuais). Novos formatos de relatrios: possvel tambm personalizar os relatrios e tambm criar novos modelos. Opo do Menu Dados e Relatrios Editar/desenvolver relatrio ou boto .

Veja mais detalhes sobre os relatrios no captulo Gerao de Relatrios e sobre os arquivos/banco de dados em Opo LB (ODBC). 11

3 Objetos visuais
Na parte superior da janela principal do software est situado o painel de objetos visuais. Neste painel so programados os objetos e controles visuais que podero servir de interface para o usurio. Selecione o objeto desejado e coloque no painel. Para isso clique sobre o cone do objeto na barra de ferramentas ou escolha o objeto na janela direita, na aba Objeto, quando nenhum objeto estiver sendo selecionado. Clique sobre o painel ou arraste o ponteiro do mouse com o boto esquerdo pressionado para desenhar o objeto.

Objeto displaytext (visualizao) Objeto LEditar (alterao de valores)

No exemplo acima foi adicionado um objeto displaytext, para visualizao de valores, e um objeto LEditar para alterao de valores. Cada objeto visual pode estar associado a um tag. Para isso clique duas vzes sobre o objeto ou selecione a propriedade Frmula do objeto.

Selecione o tag a ser associado ao objeto. No exemplo acima, o tag valor2. 12

Os objetos visuais tm diversas propriedades. No exemplo a seguir foi includo um boto uma vez sobre o boto aparecero suas propriedades na janela direita.

. Ao clicar

No exemplo acima foram alteradas as seguintes as propriedades Texto (com o valor Relatrio) e Relatrio (com o valor 1 Relatrio do tag). A propriedade Texto, neste caso, o ttulo do boto. A propriedade Relatrio com o valor 1 significa que ao pressionar o boto, ser mostrado o relatrio principal do aplicativo atual associado ao tag do boto. Outra propriedade importante do boto Comando. Quando o boto for pressionado o valor do tag relacionado ser o valor da propriedade Comando. Veja tambm as propriedades Pagina, PopupPagina e AlterarTag. Veja as propriedades do boto no tpico Exemplos de Objetos Visuais. Exemplo de objeto visual termmetro. Os limites superior e inferior podem ser associados planilha.

13

Exemplo de objeto visual Figura. Este objeto visual pode ter diversas finalidades. Botes de dois estados, informao de estado, simples ilustrao, etc.... No exemplo abaixo a Figura configurada como boto de duplo estado (propriedade Duplo estado):

Quando o aplicativo for executado este objeto visual se tornar como um boto (propriedade Clique altera). Ao clicar sobre este objeto, o estado do tag associado ser alterado para valores que alternam entre 0 e 1. Sua visualizao alterada conforme a propriedade Estado atual. O nome da figura deve ter o formato <nome><estado>.emf ou bmp. Neste caso, vlvulaazul1.emf e vlvulaazul2.emf. O nmero de estados neste caso 2.

14

No exemplo abaixo a Figura configurada conforme um boto com animao (propriedade Duplo estado desmarcada):

Quando o aplicativo for executado este objeto visual tambm se tornar como um boto (propriedade Clique altera). Ao clicar sobre este objeto, o estado do tag associado ser alterado para valores que alternam entre 0 e 1. Mas quando a propriedade estado atual se torna 1 ento o objeto entra em estado de animao variando de 1 at o nmero de estados. O nome da figura tambm deve ter o formato <nome><estado>.emf ou bmp. Neste caso, motorverde1.emf e motorverde2.emf. Para todos os casos se for desejada apenas a visualizao do sinal, sem a interveno do usurio, ento a propriedade Clique altera deve ser desmarcada. Para utilizao dos objetos 3D veja o captulo Janela da Interface 3D . Veja os exemplos modeloteste2.lqs e grupospginas.lqs para conhecer o objeto ObjetoPagina. Para criar novos objetos visuais utilize um dos trs editores: Script, 2D ou 3D. Mais detalhes sobre objetos visuais veja o captulo Objetos Visuais.

15

Para desenhar no painel utilizando objetos vetoriais clique sobre o boto

Clique duas vezes sobre o objeto para editar suas propriedades. Ser mostrada a seguinte janela:

possvel tambm associar o valor de tags para algumas das propriedades do objeto. Por exemplo, desenhe um objeto escala e desenhe um objeto polgono conforme abaixo:

Clique duas vezes sobre o objeto polgono para abrir suas propriedades. Clique sobre a clula da coluna tag associada coordenada MY (ponto mdio no eixo vertical do objeto). Selecione o tag e clique em OK.

Ao executar o aplicativo, a posio do polgono vai variar conforme o tag dentro da escala definida. Mais detalhes dos objetos vetoriais veja o tpico Objetos para desenhos vetoriais .

16

 possvel definir grupos de objetos baseados em um painel padro. Uma das formas de fazer isso utilizando o objeto ObjetoPagina .

1 Defina objetos em uma das pginas do painel (a partir da pgina 1)

2 Associe os objetos aos tags. Podem ser tags dentro de um grupo. 3 Coloque (na pgina 0) o objeto ObjetoPagina. 4 Associe o objeto ObjetoPagina a um tag ou grupo.

Mais detalhes veja os exemplos modeloteste2.lqs e grupospginas.lqs.

Como editar ou criar novos objetos visuais?

Existem 3 formas principais de se criar ou editar objetos visuais: 1 Script. 2 Editor 2D. 3 Editor 3D. 1 Script: Selecione o objeto. Clique sobre o boto Opes do Objeto. Para editar clique em Cdigo fonte. Para criar clique em Novo.... 2 Editor 2D: Menu Editar - Painel Editor de objetos 2D simples. Veja os exemplos disponveis no menu Arquivo Abrir. 3 Editor 3D: Menu Editar Interface 3D Editor de objetos 3D. Veja os exemplos disponveis no menu Arquivo Abrir. Os objetos 3D tambm podem ser arquivos do tipo X3D. Mais detalhes sobre objetos visuais veja o captulo Objetos Visuais.

17

Para edio de uma interface simples de planta em 3D, faa o seguinte: 1 Defina os painis colocando os objetos visuais a partir da pgina 1.

2 Na pgina 0 coloque os objetos vetoriais 3D para definir a planta.

Parede 3D

Painel 3D

3 Clique sobre o boto

. A interface ficar desta forma:

Mais detalhes sobre a utilizao dos objetos 3D veja o captulo Janela da Interface 3D Veja tambm o exemplo planta3d.lqs. Mais detalhes sobre objetos visuais veja o captulo Objetos Visuais.

18

4 Script visual e texto

Scripts so seqncias de instrues ou programas usados para personalizar as aes do aplicativo para atender o processo. Eles so executados dentro dos eventos disponveis no sistema. Existem dois tipos principais de script no LAquis: visual e texto. O script visual uma linguagem que funciona de forma grfica, anloga a um fluxograma. J o script texto uma linguagem semelhante ao Basic. Exemplo de Script Visual Exemplo de simples atribuio de valor a um tag usando o script visual (note que uma operao simples como a que ser usada neste exemplo no requer necessariamente o uso de script este exemplo ser apresentado apenas para entender o princpio do script). Coloque um boto no painel. Escolha a aba Linguagem Visual e selecione o evento OnClick. Selecione a opo comandos situada na barra de ferramentas:

Clique sobre a rea quadriculada. Ser mostrada uma janela com uma lista de comandos, funes e variveis disponveis. Selecione ento o TAG motor.

Clique em OK. 19

O editor da linguagem visual ter uma caixa relacionada ao tag motor. Ficar assim:

Selecione agora a opo nmero situada na barra de ferramentas:

Clique sobre a rea quadriculada. Ser colocada uma caixa relacionada a uma constante numrica:

Clique duas vezes sobre a constante, coloque o nmero 1 e tecle enter. A constante ser 1. Agora, para associar o valor da constante ao tag motor faa a seqncia de dois passos: 1 Clique sobre a ponta no lado direito da constante 1. 2 Clique sobre a ponta no lado esquerdo do tag motor. Vai ficar desta forma:

Est pronto o exemplo. O que vai ocorrer na execuo do aplicativo ser o seguinte. No momento que o usurio pressionar o boto, o tag motor ter o seu valor 1. Exemplo de Script texto Selecione a aba Script texto. Digite motor = 1.

Note que uma operao simples como esta, usada neste exemplo, no requer necessariamente o uso de script este exemplo foi colocado apenas para entender o princpio do script. A mesma coisa poderia ser feita, apenas colocando no objeto boto o valor 1 na sua propriedade Comando. As possibilidades que o script oferece so muitas. Operaes, condies, iteraes, etc... Para conhec-las estude o captulo Scripts. 20

Planilha de pontos de Leitura e Escrita (Tags)

A programao de uma aquisio simples pode ser feita na planilha situada na parte inferior do programa.

Cada linha desta planilha pode ser um tag relacionado a um ponto de entrada ou sada conectado ao instrumento, frmula, varivel, etc... dependendo do driver. A planilha contm os seguintes campos (colunas) como "default" (podem-se criar quantas colunas forem necessrias a mais*):

Canal: Nmero do canal relacionado linha da planilha. Pode ser o n ou endereo fsico do equipamento ou apenas um identificador nmerico. Opcionalmente defina o n ou endereo do equipamento na coluna Param1 com a sintaxe n=<nmero>;. Veja a coluna Param1. Nome: Nome do "tag". Ser o nome da varivel utilizada pela frmula, objeto visual ou script para acessar o seu valor. Se no houver nome o "tag" ser acessado por x<nmero da linha>. (Exemplo: x1) Para acessar outras colunas do mesmo tag utilize o ponto. (Exemplos: x1.setpoint, temperatura1 = x1.Fator*x2 ) Ttulo: Ttulo ou descrio do significado do "tag". Se o ttulo no estiver em branco este ser enviado para todos os objetos visuais relacionados linha. Esta descrio tambm ser armazenada ao lado de cada leitura armazenada no arquivo AQ ou LB separado no campo ttulo. Pode ser usado tambm como um comentrio de eventos no decorrer do processo de aquisio. [...] Unidade da grandeza Valor. Valor: Valor do "tag". Set: Valor do "Set Point" do instrumento ou entrada para alterao do valor do "tag". Param1 e Param2 Valores numricos de dois principais parmetros do instrumento. (Exemplo: Alarme1, Alarme2, Endereo, etc...). (Exemplo do Param1 no caso MODBUS: 400001) Status: Descrio do status atual da leitura. (Exemplo: Erro de leitura) Arquivo: Nome do arquivo ou banco onde as leituras sero armazenadas. Para alterar todos os arquivos no grupo selecionado clique sobre o cabealho "Arquivo". Mais detalhes sobre o arquivo veja aqui. Driver: Nome do "driver" ou instrumento conectado ao sistema ou, se o "tag" for apenas uma varivel, utilize VAR. Ao selecionar o "driver" possvel definir a configurao para comunicao. Veja a coluna "config" abaixo. Para alterar todos os drivers na planilha ou no grupo selecionado clique sobre o cabealho "Driver". Varreduras: Nmero mximo de leituras que sero armazenadas no arquivo. Tempo: Tempo mximo permitido de aquisio no arquivo. Intervalo: Intervalo de tempo entre cada gravao ou leitura (dependendo da opo definida em "Leitura contnua"). Inter. Alarme: Intervalo de tempo entre cada leitura de alarme. Incio: (opcional) Hora de incio da aquisio no formato hh:mm:ss. (ex: 9:00:00) Fim: (opcional) Hora de trmino da aquisio no formato hh:mm:ss. (ex: 12:00:00) Frmula: Frmula ou escala relacionada ao tag. O resultado da frmula ser constantemente atualizado em Valor. Se quiser utilizar uma simples escala utilize o smbolo * (Exemplo: *0.01). Para saber mais sobre o uso da frmula clique aqui. Config: Configurao da comunicao relacionada ao "tag". Se nada for preenchido ento adotada a configurao "default" definida no menu "Configurao" - "Porta". Caso seja OPC ento o formato servidor->item. Formato da configurao na coluna "config" para porta de comunicao: porta ou dispositivo:velocidade,paridade,bits de dados,bits de stop. Exemplo: COM1:9600,N,8,1. Esta configurao pode ser definida no momento em que for selecionado o "driver". 21

Indica se o "tag" estar em pausa ou no. Para desligar basta clicar novamente sobre o boto. Inicia a gravao do "tag" no arquivo relacionado. Para desligar basta clicar novamente sobre o boto. Parar a aquisio em todas as linhas da planilha.

Colunas opcionais: *Se for necessrio possvel criar colunas personalizadas definindo outras propriedades para os "tags". Estas colunas tambm podem ser gravadas no arquivo de aquisio se os campos tiverem sido criados. Exemplos: limites de segurana, nome do produto, ocorrncia, no conformidade, etc... Para criar novas colunas utilize a opo no menu "Editar" - "Colunas de parmetros". Estes nomes devem ser sucintos e de preferncia sem acento para que sejam fceis de acessar atravs de frmulas ou "scripts". Importante: Alguns dos nomes de colunas personalizadas esto reservados: - Alarme: Define valor do alarme para o "tag". "Default": 0 = Desligado; 1 = Maior que LS; 0 - Menor que LI. As colunas LI e LS so usadas como "default" para os limites. Opcionalmente para criar um outro critrio de alarme atravs de uma frmula digite o smbolo = e escreva a frmula nesta coluna. Exemplo 1: "=(x<10)+(x>30)". Neste exemplo o alarme ser acionado se o valor do "tag" for menor que 10 ou maior que 30. Exemplo 2: "=(x<.LIE)+(x>.LSE)". Neste exemplo o alarme ser acionado se o valor do "tag" for menor que o valor na coluna LIE ou maior que o valor na coluna LSE. Para definir valores para cada expresso opcionalmente faa como este exemplo: =(x<10)+(x>30)#3 (x>10)*(x<15)#5 (para x<10 ou x>30 o valor do alarme 3, para valores entre 10 e 15 o alarme 5) Para casos mais avanados se desejar utilize o "script" para alterar o valor do alarme. - AlarmeTexto: Define um texto descritivo opcional a ser colocado na coluna status relacionado ao alarme. Exemplo: 1="Ligado"0="Desligado" - TextoLB: Define um texto, que pode ser usado como um cdigo, que ser colocado no ttulo do arquivo LBX associado a um banco LB. Por exemplo: se cada arquivo de aquisio deve estar relacionado e separado por produto, processo ou lote que tenha um cdigo, utilize este coluna para defin-lo. No nome da tabela definido no banco LB coloque, por exemplo, o seguinte texto "LOTE <texto>.LBX". Cada lote ser gravado em um arquivo separado com o nome definido na coluna TextoLB, por exemplo, LOTE XYZ12345.LBX. Veja o exemplo de como utilizar este recurso e gerar relatrios em LOTE.LQS. - Atualizao: Data e hora da ltima atualizao feita pelo "driver" do valor do "tag". - TempoLeitura: Intervalo de tempo a ser usado para a atualizao das leituras caso a opo "Leitura contnua" esteja desabilitada. Exemplo: 1s. Se esta coluna no estiver adicionada ento usada a coluna "Intervalo". - AlterouValor: Retorna 1 se o valor do "tag" sofreu alterao. Deve sempre ser "resetado" para 0 toda vez que usado. - ValorInicial: Valor inicial do "tag". O "default" vazio. No script e na frmula possvel acessar os "tags" definidos na planilha atravs de seus nomes. Exemplos: Presso, Temperatura1.setpoint. Se no houver nome definido na planilha utilize x<nmero da linha>. (Exemplo x1) Se desejar acessar outras colunas (propriedades) dos "tags" utilize o ponto. (Exemplo x1.setpoint)

22

Grupos A planilha pode ser dividida em grupos. Na aba existente abaixo de planilha, ou na lisa em rvore esquerda, "clique" o boto direito do "mouse". Escolha a opo do menu: - Novo grupo: para criar novo grupo. - Renomear grupo: para renomear o grupo selecionado. - Apagar grupo: para apagar o grupo selecionado. - Duplicar grupo: para duplicar contedo do grupo selecionado em um novo grupo.

Acrescentar um "tag" no grupo selecionado pode ser feito vrias maneiras: para adicionar o tag selecionando o driver. - clique sobre o boto - clique sobre o boto para adicionar o tag como varivel. - "clique" com o boto direto do "mouse" sobre a planilha e selecione a opo: Acrescentar linha (tag) para adicionar o tag selecionando o driver. - "clique" com o boto direto do "mouse" sobre a planilha e selecione a opo: Acrescentar linha (VAR) para adicionar o tag como varivel.

23

Configurao da Comunicao
Para configurar os "tags" individualmente utilize a coluna "config" na planilha ou, na janela para selecionar o "driver", defina a configurao. Na janela driver utilize o boto Config. Se quiser selecionar uma configurao para todos os tags (ou todos os tags da pgina atual) clique sobre o ttulo da coluna "Driver". Na janela driver utilize o boto Config. Formato da configurao: porta:configurao (Exemplo: 1:9600,N,8,1) Caso seja OPC ento o formato servidor->item.

Ao pressionar o boto "Config" a seguinte janela apresentada:

24

Frmula na planilha de tags

A frmula pode ser usada na planilha (coluna frmula) ou em objetos visuais. Tanto no script como na frmula possvel acessar os "tags" definidos na planilha atravs de seus nomes. Exemplos: Presso, Temperatura1.setpoint. Os "tags" que no possuem nomes definidos, seus valores relacionados s linhas e colunas da planilha podem ser usados atravs de variveis pr-definidas do tipo: x<nmero da linha>[.coluna] Exemplo de variveis pr-definidas: x - Valor da mesma linha. x1 - Valor da primeira linha. x2 - Valor da segunda linha. x1.setpoint - Setpoint do "tag" da primera linha. x3.produto - Coluna produto (criada pelo usurio) do "tag" da terceira linha. ... Exemplos de frmulas: x1*1.7 + 3 Celsius + 273.16 Farenheit > 100 O nome da varivel relativo ao "tag" tambm o mesmo definido na coluna Nome da planilha de programao.

Ex: Celsius + 273.16 Frmulas em geral: Os operadores so: + - * / > < >= <= = <> ^. Algumas funes e comandos da frmula na planilha: - Bit(x,b1,b2): Retorna o valor dos bits escolhidos. Exemplo: "Bit(x1,3,3)" retorna o terceiro bit do valor x1. - play if expresso: Habilita a leitura do tag se a condio for verdadeira. Exemplo: "play if x5>10". - Int(x): Retorna a parte inteira do valor. Exemplo: Int(x*1000)/1000 - Abs(x): Retorna o valor absoluto. - Log(x): Logaritmo na base 10. - Ln(x): Logaritmo na base e. - Exp(x): Exponencial. - Sqr(x): Raiz quadrada. Frmula nos objetos visuais: Objetos Visuais. Frmula na planilha: Para relacionar uma frmula com a linha desejada basta escrev-la na coluna frmula da planilha de "tags". Exemplo:

Escala: 25

Para definio de uma escala com fator multiplicativo e aditivo utilize a sintaxe: *a+b onde a o fator multiplicativo e b o fator aditivo. Exemplo: *1000+3. Tanto a leitura como a alterao de valores ser baseada nestes fatores. A escala pode ser usada como converso ou at mesmo calibrao. Observaes importantes: 1- Se o nome contiver espaos em branco ento na varivel estes sero substitudos por _ ("underline"). Exemplo: Nome: ab cd, varivel: ab_cd. 2- Se o nome tiver mais que 10 caracteres ento a varivel ser somente os 10 primeiros caracteres. Exemplo: Nome: abcdefghijklmn, varivel: abcdefghij

Definio do arquivo
Para definir o nome do arquivo ou banco onde as leituras sero armazenadas clique sobre a clula da coluna Arquivo. Para definir todos os arquivos no grupo selecionado clique sobre o cabealho "Arquivo". A janela ser mostrada:

Selecione ou digite o nome do arquivo ou banco. Se este no existir ser automaticamente criado na primeira gravao. Os campos sero criados a partir dos "tags" definidos na planilha. Usurios avanados: para criar o banco manualmente utilize a opo do Menu "Dados e Relatrios" "Banco de Dados LB/ODBC" - "Arquivo" - "Novo". O armazenamento pode ser feito no formato LB Separado, LB Geral ou AQ. Formato LB: Neste formato possvel incluir num registro quantos campos forem necessrios. Alm disso, possvel tambm gravar as outras colunas (ou linhas relacionadas) da planilha de "tags". Existem dois tipos de gravao: LB geral e o LB separado. O LB geral registra todos os "tags" relacionados de uma varredura em um registro. O LB separado armazena um "tag" (e seus respectivos dados relacionados) por registro. Neste caso possvel gravar "tags" com diferentes perodos de amostragem no mesmo banco. Para ambos os casos existem formatos de relatrios prontos que montam at planilhas gerais de amostragem com os "tags" disponveis. Mais detalhes de bancos LB aqui. Formato AQ e TXT: Estes formatos permitem utilizar algumas funes antigas do LAquis. O valor do tag, setpoint, param1 e param2 so gravados em um registro. Os relatrios podem ser planilhas e grficos gerais ou individuais por "tag". Pode-se utilizar no nome do arquivo, o formato nome<ddmmaa>.aq para manuteno de histrico (inclusive com pastas dirias criadas automaticamente). Na primeira gerao de relatrio para o formato LB (Menu "Dados e Relatrios" - "Leituras" ou boto ser apresentada a seguinte janela: )

26

Escolha o modelo de relatrio (Exemplo: Individual com grfico.lgx). O relatrio ser gerado com base no modelo escolhido. Ser gerado um nome para o formato escolhido que ser como "default" Conexo <nomedoarquivolqs>.lgx. O formato deste tipo de relatrio LGX e ser gravado na mesma pasta que o arquivo LQS. Veja mais detalhes sobre as planilhas para relatrio e anlise LGX. Para criar ou alterar modelos de relatrios que possam ser usados como formatos genricos como os exemplos acima, grave o arquivo LGX na pasta do LAquis\RELS\RELI ou RELG ou RELAQ.

Drivers
O "driver" permite ao computador se comunicar com o equipamento.

No LAquis, estes "drivers" podem ser desenvolvidos atravs da uma linguagem script simples semelhante ao "Basic" ou atravs de uma linguagem interpretada "LDriver". Alguns "drivers" prontos disponveis: - Modbus.ldriver: protocolo serial MODBUS RTU. Utilizado para comunicao com uma grande variedade de equipamentos. - VAR: tag como varivel ou memria (nmero ou texto). - DEMO: demonstrao (senoidal variando de "Param1" at "Param2") - OPC: Conexo OPC cujo endereo definido no "Config". - TIMER: Contador em milissegundos. Para utilizar o formato "double" utilize TIMERFORMAT. - SOFT: Valor varia logaritmicamente at o "set" especificado. - LINEAR: Valor varia linearmente at o "set" especificado. Alguns exemplos de drivers tambm esto disponveis como para os controladores NOVUS, clps OMRON, mdulos ADAM da ADVANTECH (ou LR - IMPAC), controladores WEST, Modbus genrico (RTU, Ascii e TCP), etc.... Existem dois tipos de drivers: LD e LDriver. - LDriver: Drivers para comunicao serial (COM, TCP, etc ....). 27

- LD: Casos especiais (placas, clculos, etc...). Para listar os "drivers" disponveis clique na coluna "Drivers" da planilha de tags. Os "drivers" esto no subdiretrio CTRLS (na pasta LAquis) com a extenso LD(x) ou LDriver. O nome de um driver MODBUS desenvolvido em "ldriver" o Modbus RTU.ldriver. Selecione o "driver" Modbus RTU.ldriver. Defina a porta e as configuraes de comunicao. Na coluna Param1 defina o endereo* do parmetro. Exemplo: "400001". Na coluna Param2 defina nmero do n.

Exemplo: endereo do valor 1 dos "holding registers" (param1=40001) n fsico 1 (param2=1)

* Formato do endereo dos parmetros MODBUS: - Holding registers: 4xxxxx - Input registers: 3xxxxx - Input status: 1xxxxx - Coil: 0xxxxx onde xxxxx o nmero do registro. Veja o cdigo fonte completo no arquivo c:\Arquivos de Programas\LAquis\Ctrls\Modbus RTU.ldriver.

28

Selecionar um Driver
Selecione o "driver" clicando na clula correspondente linha do "tag" desejado e da coluna "driver". Se desejar selecionar vrias linhas arraste o "mouse" com o boto esquerdo pressionado.

Escolha o "driver" desejado e clique sobre o boto OK.

29

Campos especiais do equipamento

possvel acessar as diversas propriedades dos equipamentos dependendo do "driver" disponvel. Esta opo encontra-se no Menu "Configurao".

Estas variveis podem ser usadas na planilha de tags atravs das colunas especiais. Menu Editar Pontos de leitura e escrita Personalizar colunas de parmetros.

30

Relatrio / Histrico
As opes relacionadas a este tpico esto no menu "Dados e Relatrios": - Abrir relatrio principal (histrico/leituras): Abre/cria relatrio principal para o aplicativo. - Criar relatrio...: Cria outros formatos de relatrios baseados em modelos. - Abrir relatrio: Abre relatrios criados a partir do formato LGX escolhido. Editar/desenvolver relatrio (planilhas para anlise): Altera/Cria formato de relatrios LGX.

Estes formatos de relatrios so gravados no formato LGX. Os valores (dados) propriamente ditos so gravados no banco LB (mais detalhes no captulo banco LB).

Relatrio principal
Opo do menu: "Dados e Relatrios" - "Abrir Relatrio (Histrico/Leituras)", boto . Na primeira gerao de relatrio ser apresentada a seguinte janela para escolher o modelo de relatrio para criao do seu formato:

Escolha o modelo de relatrio (Exemplo: Individual com grfico.lgx). O relatrio ser gerado com base no modelo escolhido. Ser automaticamente criado um nome para o formato: Conexo<nomedoarquivolqs>.lgx. Este formato ser o "default" para o arquivo LB do aplicativo. gravado na mesma pasta que o arquivo LQS. Se desejar criar outros formatos de relatrios baseados nos modelos acima utilize a opo do menu "Dados e Relatrios" - "Criar relatrio a partir do modelo" descrito no captulo a seguir.

Criar relatrios a partir do modelo

Esta opo permite criar outros formatos de relatrio alm do formato padro descrito captulo anterior. Menu "Relatrios e Dados" - "Criar relatrio...". Ser apresentada a janela para a escolha do modelo de relatrio. Escolha o modelo de relatrio (Exemplo: Individual com grfico.lgx). O relatrio ser gerado com base no modelo escolhido e um arquivo LGX ser gerado. O formato deste tipo de relatrio LGX e pode ser gravado na mesma pasta que o arquivo LQS. Para alterar este formato veja mais detalhes sobre as planilhas para relatrio e anlise. Para abrir o relatrio utilize o menu Dados e Relatrios Abrir relatrio.... Se desejar crie um boto no painel e indique o nome do relatrio na propriedade Relatrio. (Para criar ou alterar modelos de relatrios que possam ser usados como formatos grave o arquivo LGX na pasta do LAquis\RELS\RELI ou RELG.) 31

Planilhas para relatrio e anlise

Opo do menu: "Dados e Relatrios" - "Editar/desenvolver relatrio (Planilhas para relatrio e anlise)" ou boto .

As planilhas para relatrio e anlise so genricas e podem ser usadas para diversos tipos de relatrio, inclusive sobre os dados armazenados em bancos LB. Esta planilha possui funes voltadas para construo de relatrios com clculos, grficos e tabelas baseadas nos dados armazenados. Os formatos de relatrio deste tipo de planilha so arquivos gravados com extenso LGX. Os arquivos, de formato "LGX", podem ser criados ou alterados conforme a necessidade do usurio. So diversas as funes disponveis neste tipo de planilha. Consulte algumas frmulas e comandos disponveis dentro da planilha. Utilize o "script" para desenvolver relatrios. Consulte exemplos disponveis (opo do menu "Arquivo" - "Abrir" da janela planilha LGX). Alguns exemplos de formatos de relatrio LGX: - Amostragem.lgx: Permite calcular a mdia ou amostragem dos valores por intervalo de tempo dispondo os "tags" desejados numa mesma planilha. - Estatstica do perodo com LI LS Ocorrncia.lgx: Calcula, dentro de um perodo de datas, os percentuais de valores dentro e fora dos limites especificados. - Limites e ocorrncias.lgx: Lista as leituras com possibilidade de edio de aes, ocorrncias e no conformidades relacionadas com os valores e seus limites especificados .

A planilha LGX possui dois modos: Apresentao e Edio. No modo apresentao a planilha fica pronta para utilizao ou impresso. A listagem automtica de dados de bancos LB ativada e os botes de comando e edio definidos na planilha tambm so ativados. possvel chamar um relatrio LGX, diretamente no modo apresentao, atravs de objetos botes utilizando a propriedade "Relatrio". Veja mais detalhes no objeto visual boto. Consulte algumas frmulas e comandos disponveis dentro da planilha. Botes Abrir: Abre um arquivo formato LGX. Salvar: Salva um arquivo formato LGX. Se no houver arquivo nenhum aberto ento necessrio digitar o seu nome. Imprimir: Abre a janela de impresso do relatrio ou grfico no formato LGX. 32

Modo apresentao: Passa a planilha para o modo apresentao (sem as linhas das clulas e os cabealhos). Executa: Executa a varivel de execuo (se houver) utilizada para operaes mais demoradas. Veja o exemplo estatstica perodo LB.lgx. LGX) Grfico: Passa para a janela de edio do grfico somente (definido ou no dentro da planilha Formatar (clulas): Formatao das clulas selecionadas. Copiar: Copia as clulas selecionadas para a rea de transferncia. Colar: Cola as clulas da rea de transferncia para a planilha. Inserir coluna: Insere uma coluna na posio da clula selecionada. Apagar coluna: Apaga uma coluna na posio da clula selecionada. Inserir linha: Insere uma linha na posio da clula selecionada. Apagar linha: Apaga uma linha na posio da clula selecionada. planilha. Menu: Arquivo Novo: Apaga a planilha e prepara para edio de novo formato de relatrio LGX. Abrir: Abre um arquivo formato LGX. Salvar: Salva um arquivo formato LGX. Se no houver arquivo nenhum aberto ento necessrio digitar o seu nome. Salvar como: Salva um arquivo formato LGX obrigando a digitao do seu caminho e nome. Imprimir: Abre a janela de impresso do relatrio ou grfico no formato LGX. Imprimir com grfico: Se houver um grfico no disposto sobre a planilha, utilize esta opo para imprim-lo junto. "Wizard" LB: Assistente para criar um relatrio LGX de um banco LB. Editar Copiar: Copia as clulas selecionadas para a rea de transferncia. Colar: Cola as clulas da rea de transferncia para a planilha. Selecionar tudo: Seleciona todas as clulas da planilha. Formatar (clulas): Formatao das clulas selecionadas. Formatar grfico: Formatao do grfico selecionado na planilha. Apresentao: Passa a planilha para o modo apresentao (sem as linhas das clulas e os cabealhos) e vice-versa. Executa: Executa a varivel de execuo (se houver) utilizada para operaes mais demoradas. Veja o exemplo estatstica perodo LB.lgx. planilha. Frmula: Abre um "browser" de algumas das frmulas possveis de serem usadas na Frmula: Abre um "browser" de algumas das frmulas possveis de serem usadas na

Veja tambm o captulo Comandos principais da planilha de relatrios.

33

Frmulas e comandos para planilhas LGX

Algumas das frmulas disponveis para o uso na planilha do formato LGX de relatrio: =GRAFICO(dados) Desenha um grfico nas clulas mescladas utilizando os valores no intervalo de clulas definido em dados. Exemplos: =GRAFICO(D32) =GRAFICO(D32;E32;J32) A coluna do eixo X sempre a primeira esquerda. Veja o exemplo Conexo LEITURAACOES.lgx. =GRAFICOSEPARADO(dados) O mesmo que GRAFICO exceto pelo fato de que invisvel na planilha. Para visualizao ou impresso selecione a opo Grfico. =TAG("coluna","linha") Retorna o valor da planilha referente coluna e a linha especificada. A coluna pode ser "VALOR", "SET", "PARAM1", "PARAM2", "TITULO", "NOME", etc... A linha pode ser o nome ou o nmero da linha. =TAGCANAL("coluna",canal) Retorna o valor da planilha de tags referente coluna e o canal especificado. A coluna pode ser "VALOR", "SET", "PARAM1", "PARAM2", "TITULO", "NOME", etc... =PLANILHA("coluna","linha") Retorna o valor da planilha referente coluna e a linha especificada. A coluna pode ser "VALOR", "SET", "PARAM1", "PARAM2", "TITULO", "NOME", etc... A linha pode ser o nome ou o nmero da linha. =MEDIA(clulas) Mdia dos valores no intervalo definido em clulas. =SOMA(clulas) Soma dos valores no intervalo definido em clulas. =CONTA(clulas) Contagem do nmero de itens no intervalo definido em clulas. =DESVPAD(clulas) Desvio padro dos valores no intervalo definido em clulas. =MAXIMO(clulas) Valor mximo no intervalo definido em clulas. =MINIMO(clulas) Valor mnimo no intervalo definido em clulas. =AMPLITUDE(clulas) Amplitude dos valores no intervalo definido em clulas. =TSTUD(clulas) "TStudent" dos valores no intervalo definido em clulas. =MVT(clulas) Converte tenso em "milivolt" para de termopar tipo T C =MVJ(clulas) Converte tenso em "milivolt" para de termopar tipo J C =MVK(clulas) Converte tenso em "milivolt" para de termopar tipo K C =MVS(clulas) Converte tenso em "milivolt" para de termopar tipo S C =MVR(clulas) Converte tenso em "milivolt" para de termopar tipo R C =SLOPE(clulasx,clulasy) =SLOPEI(clulasx,clulasy) =INTERCEPT(clulasx,clulasy) =INTERCEPTI(clulasx,clulasy) =CORRELACAO(clulasx,clulasy) =SSDEV(clulas) =SMEDIAX(clulas) Comandos utilizados no modo apresentao: @BOTAO(texto) Desenha um boto para ser pressionado pelo usurio no modo apresentao. Utilize o evento "OnClick" e as variveis ColClicked e RowClicked no "script" do LGX. Veja o exemplo Conexo LEITURAACOES.lgx. @COMBO(item1;item2;item3;...) Coloca um boto de "combo" para ser pressionado pelo usurio no modo apresentao. A clula esquerda recebe os dados selecionados pelo usurio. Veja o exemplo Conexo LEITURAACOES.lgx. LDB_LBANCO(nome do banco) Cria uma listagem dos dados armazenados no banco LB especificado do formato LBX no modo apresentao. Veja o exemplo Conexo LEITURAACOES.lgx. 34

Bancos LB
O banco LB uma estrutura flexvel onde so gravadas informaes, podendo ser dados de aquisio ou no. Os campos podem ser personalizados de acordo com a aplicao. possvel criar ou editar campos manualmente ou atravs da primeira gravao (veja como criar os campos automaticamente na primeira gravao em planilhas para relatrio e anlise).

Os arquivos com extenso LB definem a estrutura do banco. Os dados podem ser gravados em arquivos com formato LBX (padro binrio), DBF ou ODBC. O LBanco, com extenso LBX, um formato padro do LAquis. Possui flexibilidade na estrutura de campos e podem ser utilizadas as ferramentas de relatrio e anlise do LAquis. No formato LB, alm da manuteno de histrico, possvel incluir num registro quantos campos forem necessrios. Alm disso possvel tambm gravar as outras colunas (ou linhas relacionadas) da planilha de "tags". Existem dois tipos de gravao: LB geral e o LB separado. O LB geral registra todos os "tags" relacionados de uma varredura em um registro. O LB separado armazena um "tag" (e seus respectivos dados relacionados) por registro. Para este caso existem formatos de relatrios prontos que montam planilhas de amostragem e estatsticas gerais. Se for necessrio possvel criar colunas personalizadas definindo outras propriedades para os "tags". Estas colunas tambm podem ser gravadas no arquivo de aquisio se os campos tiverem sido criados. Exemplos: limites de segurana, nome do produto, ocorrncia, no conformidade, etc... Para criar novas colunas utilize a opo no menu "Editar" - "Colunas de parmetros". Estes nomes devem ser sucintos e de preferncia sem acento. O banco LB pode manter um histrico por quantos anos forem necessrios. Os arquivos LBX, por "default", so internamente separados por dia. Esta definio feita no nome da tabela. Exemplo nome<ddmmaa>.LBX. Veja mais detalhes aqui. Um campo importante que pode ser adicionado na planilha TextoLB. Este campo define um texto, que pode ser usado como um cdigo, que ser colocado no ttulo do arquivo LBX associado a um banco LB. Por exemplo: se cada arquivo de aquisio deve estar relacionado e separado por produto, processo ou lote que tenha um cdigo, utilize este coluna para defin-lo. No nome da tabela definido no banco LB coloque, por exemplo, o seguinte texto "LOTE <texto>.LBX". Cada lote ser gravado em um arquivo separado com o nome definido na coluna TextoLB, por exemplo, LOTE XYZ12345.LBX. Veja o exemplo de como utilizar este recurso e gerar relatrios em LOTE.LQS.

35

Opo LB (ODBC)
Escolha o banco LB a ser editado:

Menu: Arquivo Editar (Abrir tabela) Edita, pesquisa, exporta, importa ou imprime os dados armazenados no banco LB selecionado. Campos (estrutura) Altera a estrutura de campos do banco LB selecionado. Novo Cria novo banco LB. Eliminar Elimina o banco LB selecionado.

Campos (estrutura)
Altera a estrutura de campos do banco LB selecionado:

A configurao fsica do banco definida na caixa de texto "Banco". O formato padro o LBanco. Possui flexibilidade na estrutura de campos e podem ser utilizadas as ferramentas de relatrio e anlise do LAquis. 36

Utilize o boto banco de dados. Colunas para definio dos campos da tabela:

para alterar a configurao do Tipo da conexo do

- Nome: Nome do campo. No deve possuir espaos. Evite os acentos. - Tipo: Tipo do campo: 0 - Nmero: Campo numrico. Defina seu tipo na coluna tamanho: vazio ou 8: Tipo "double" (8 - bytes) com ponto flutuante. 1: Tipo byte. 2: Tipo inteiro (2 - bytes) com sinal. 4: Tipo inteiro longo (4 - bytes) com sinal. 1 - Texto: Campo texto. Seu tamanho definido na coluna tamanho. - Tamanho: Veja a coluna Tipo para cada caso. - Formato: Formato do nmero. Exemplo: hh:nn:ss (trata o nmero "double" como tempo).

Conexo/Tipo do banco de dados

Utilize o boto banco de dados. para alterar a configurao do tipo da conexo do

Prov/driv: Para o caso do LBanco (banco proprietrio do LAquis) o nome da pasta onde estaro os arquivos de dados. Exemplo: c:\temp\. Para indicar a pasta principal do sistema ento use <.>. Exemplos: <.> <.>banco\ Para o caso de ODBC o nome do banco de dados. Exemplo: c:\temp\arquivo.mdb Tabela: Para o caso do LBanco o nome do arquivo binrio LBX. Se desejar separar os arquivos por data utilize <ddmmyy>. Exemplo: PRENSA<ddmmyy>.LBX. Se desejar separar na troca de turno coloque a hora de incio. Exemplo PRENSA<ddmmyy,-19:30>.LBX Se desejar utilizar uma indentificao externa utilize <texto>. Exemplo: "LOTE <texto>.LBX. Para o caso de ODBC o nome da tabela do banco de dados. Usurio: Nome do usurio opcional do banco de dados se for usado ODBC. Senha: Senha opcional do banco de dados. DSN: Opcionalmente defina o texto completo do DSN para a conexo ODBC. LB Geral: Se estiver ativado ento cada registro do banco contm todas as leituras da varredura dos tags. 37

Se estiver desativado ento cada registro esta relacionado a um tag. Veja outros detalhes aqui.

Editar (Abrir tabela)

Edita, pesquisa, exporta, importa ou imprime os dados armazenados no banco LB selecionado:

Menu Arquivo Pesquisar: Abre a janela de pesquisa para filtrar os dados do banco. Exportar: Exporta os dados para TXT ou CSV. Importar: Importa dados a partir de arquivos TXT ou CSV. Imprimir: Imprime os dados do banco. Editar Novo: Cria novo registro. Apagar: Apaga registro selecionado. Copiar: Copia as clulas selecionadas para a rea de transferncia. Selecionar tudo: Seleciona todos os dados. Copiar tudo: Copia todos os dados e cabealho para a rea de transferncia.

38

Rede
O servidor principal o microcomputador conectado aos aparelhos do servidor e podem at mesmo enviar ordens para os equipamentos atravs da rede. (um cliente pode ser tambm um servidor e vice-versa) Configurao da rede: 1- Servidor Nome do servidor, diretrio de comunicao, linhas a serem compartilhadas da planilha, etc.. 2- Cliente Conexo do cliente, diretrio de comunicao, IP, comandos, etc..

A comunicao em rede pode ser tambm implementada atravs de OPC.

Servidor

O servidor pode ser configurado de duas formas: 1 - Comunicao via TCP atravs da opo do menu Arquivo - Servidor TCP. 2 - Comunicao atravs de arquivo em diretrio comum, atravs da opo Cliente&Servidor no "menu" Arquivo:

Clique sobre a opo "Servidor". Escreva um nome qualquer para o servidor (no mximo 8 caracteres sem espaos). O tempo em segundos para o servidor indica o intervalo entre cada atualizao dos dados na rede. Defina um diretrio comum de comunicao em rede atravs do boto Avanado. Planilha de aquisio: Para definir quais sero as linhas a serem compartilhadas em rede clique sobre a primeira coluna 39

relacionada com o boto direito do mouse e selecione a opo Compartilhar. Aparecero alguns smbolos como na planilha abaixo:

Significado dos smbolos: A linha ser compartilhada e o cliente poder ler e alterar seus dados. A linha ser compartilhada, mas o cliente no poder ler ou alterar seus dados.

Cliente
Nos microcomputadores clientes, ou seja, aqueles no conectados ao equipamento e que devem receber as informaes do servidor, escolha a opo Cliente&Servidor no "menu" Arquivo para abrir esta janela:

Escolha a opo "Cliente". O cliente pode ser configurado de duas formas: 1 - Clique sobre o "combo" "Cliente conectado " e escolha o nome do servidor do qual deseja receber os dados. O tempo em segundos para o cliente indica o intervalo entre cada leitura da rede. Defina tambm o diretrio de comunicao em rede comum ao servidor. 2 - Coloque o nmero do IP do servidor se for utilizada a comunicao via TCP. Planilha de aquisio: As linhas sero recebidas automaticamente. A planilha ser como segue abaixo:

Significado dos smbolos: Toda a linha est compartilhada e o cliente poder ler e alterar seus dados. 40

Somente os valores, "Set Points" e alarmes da linha esto compartilhados. O cliente pode ler e alterar somente estes valores. Toda a linha est compartilhada, mas o cliente no pode ler ou alterar seus dados. Somente os valores, "Set Points" e alarmes da esto compartilhados. O cliente no pode ler nem alterar estes valores.

Comunicao em Rede
Existem duas formas para configurar a comunicao em rede: 1 - Clique sobre o boto "Avanado>>" (na janela Cliente&Servidor do "menu" "Arquivo"). Escolha um diretrio na rede que seja comum entre os microcomputadores clientes e servidor. Todos os micros devero ser capazes de ler e gravar neste diretrio. O nome do diretrio ser armazenado no arquivo LAquis.INI do "Windows" local ou no INI do LQS atual. 2 - Utilize o nmero do IP para comunicao via TCP. No servidor utilize a opo que se encontra no menu Arquivo - Servidor TCP. No cliente coloque o valor do IP ao invs de selecionar o nome.

41

Objetos Visuais

Os objetos visuais so dispostos no painel para o desenvolvimento de aplicativos especficos e tambm para o acompanhamento e controle dos "tags".

Consulte os Principais objetos visuais Consulte os Objetos para desenho vetorial .

Para associar o objeto a um "tag" (ou sua propriedade) clique duas vzes sobre o objeto, ou com o boto direito do "mouse" escolha a opo "Tag" do objeto (digite, se necessrio, uma frmula):

Se desejar associar o valor do "tag" utilize apenas "x1" ou o nome do "tag" (Exemplo: P1 ou nivel). Se quiser associar valores de outras colunas do mesmo "tag" utilize o ponto ou o "combo" ao lado do nome. (Exemplo: x1.param1 ou x1.setpoint). Se necessrio digite uma frmula. Consulte os Principais objetos visuais

42

Para alterar suas propriedades, clique sobre o boto "Opes do objeto" ou utilize a janela ao lado do painel. Para cada tipo de objeto, diferentes caractersticas podero ser alteradas como: cores, tamanhos de letra, casas visveis, alarmes, etc.

Os ttulos dos objetos so definidos pela coluna "Ttulo" da planilha de "tags". Se a clula do ttulo correspondente a um objeto estiver vazia ento a indicao ser "x<nmero da linha na planilha de "tags">". Exemplo: "x30", ou seja, este objeto est relacionado linha 30. Este nome (x30) poder ser usado em frmulas (x30*2 + 10). Para alterar o cdigo fonte do objeto visual utilize o boto Editar. Consulte os Principais objetos visuais Para se alternar entre a visualizao automtica e manual dos objetos visuais utilize o boto .

Viso automtica

43

Objetos para desenhos vetoriais

Objetos usados para desenhos vetoriais. Os objetos para desenhos vetoriais so tratados de forma diferente dos objetos visuais normais. A edio de objetos para desenhos vetoriais ativada atravs do boto Utilizao: 1 - Podem ser combinados para gerao de novos objetos visuais 2 - Plantas para gerao de interfaces em 3D. 3 - Animaes. 4 - Simples ilustraes. .

Tipos de objetos para desenhos vetoriais: Geral: Cano ou fio. (O cano pode ser usado na planta para interface em 3D tambm) Polgono. Elipse. Cubo (projetado em 2D). Cilindro (projetado em 2D). Retngulo com borda arredondada. Planta para interface em 3D: Parede 3D. Painel 3D. Objeto (arquivo) 3D. Gerao de objetos: Escala Texto simples Clique duas vzes sobre o objeto para editar seus atributos.

44

Atributos dos objetos para desenhos vetoriais:

Nome: Nome do objeto para desenho vetorial. Visvel: Visibilidade do objeto vetorial. Linha: Existncia da linha de contorno principal. Cor (da linha): Cor da linha de contorno principal. Espessura: Espessura da linha de contorno principal. Estilo: Estilo da linha de contorno principal. Preenchimento: Existncia do preenchimento do objeto. Cor (do preenchimento): Cor do preenchimento do objeto vetorial. Padro (do preenchimento): Padro do preenchimento do objeto vetorial. Preenchimento 2 (para gradiente): Existncia de gradiente de cor no preenchimento do objeto. Cor (do preenchimento 2): Cor destino do gradiente de cor no preenchimento do objeto. Dimenses: Atravs destas propriedades possvel associar as dimenses e posies do objeto aos "tags". A relao matemtica do valor da dimenso e o "tag" pode ser definida nas colunas "e.x1", "e.y1", "e.x2", "e.y2" ou na coluna escala. X1: Posio do lado esquerdo do objeto. Y1: Posio do lado superior do objeto. Largura: Largura do objeto. Altura: Altura do objeto. X2: Posio do lado direito do objeto. Y2: Posio do lado inferior do objeto. MX: Posio mdia do objeto na horizontal. MY: Posio mdia do objeto na vertical.

Inserir Objeto Visual

1 - Escolha um objeto da parte superior da tela, logo abaixo do menu, "clicando" no mesmo. Para um primeiro contato com o programa, recomendamos o visor com ponteiro ou o termmetro. 2 - Na rea limpa entre o "menu" e a planilha, segure o boto do "mouse" e arraste, gerando um 45

retngulo, soltando boto o "mouse" aps o trmino. O objeto escolhido dever aparecer dentro do retngulo. 3 - Ajuste a altura e a largura do objeto para melhor visualizao. 4 - Crie outros objetos, de forma similar. A cada objeto criado, o programa ir associ-lo a um canal de forma seqencial. 5 - Para associar manualmente o objeto visual a um dos canais da planilha: selecione o objeto, "clique" duas vezes sobre este e escolha o "tag". 6 - Para alterar as propriedades do objeto selecione o objeto, utilize a janela ao lado ou "clique" duas vezes sobre este e "clique" no boto "Opes do objeto...". Todo o objeto visual possui a propriedade Frmula. Exemplo: x1*2+5 onde x1 o valor da primeira linha da planilha de "tags". O valor apresentado pelo objeto ser o resultado da frmula. Se desejar associar o prprio valor do "tag" utilize apenas "x1" ou o nome do "tag" (Exemplo: temperatura1). Se quiser associar valores de outras colunas do mesmo "tag" utilize o ponto (Exemplo: x1.param1 ou x1.setpoint) Para alternar entre a visualizao automtica e manual dos objetos visuais utilize o boto .

Configurao do Painel
Configurao do painel de objetos visuais do LAquis:

Figura: esta opo permite selecionar uma figura de fundo para o painel (tela) atrs dos objetos visuais. Lado a lado: se esta opo estiver ativada, a figura disposta na tela lado a lado repetidamente. Se desativada, a figura ser disposta no canto superior esquerdo. Janela: Largura e Altura - possvel definir o tamanho da tela (em pixels) quando a aplicao for executada. Pr visualizao: se esta opo estiver ativada, possvel visualizar a figura selecionada na rea de trabalho no momento em que est sendo escolhida. Fundo normal: se esta opo estiver ativada, a cor da tela de fundo se torna cinza. Se desativada, o fundo recebe o preenchimento de um padro.

46

Exemplos de objetos visuais

So estes alguns dos principais objetos visuais: DisplayText Mostrador de valores. LEditar Editor de valores. Figura Figura para fundo, duplo estado ou animao. Boto Boto de ativao de evento. LTexto Texto explicativo. LCombo Editor de valores com combo. MGrfico Grfico para acompanhamento em tempo real.

Barra Barra com limites. - TChave Chave de duplo estado. - Check Chave de duplo estado em formato de boto e luz. - Acrescenta Boto para acrescenta novo registro LB. - Lista Boto para listar registros LB. - Tanque Tanque de nvel. - Funil - Tanquefechado - PID Boto para controle PID sobre o "tag" relacionado. - Receita Boto para execuo de receita (tempos e "setpoints") sobre o "tag" relacionado. Gauge Gauge ponteiro analgico. Termometro Termmetro com escala. Mostrador digital Mostrador de valores numricos imitando LCD.

DisplayText
DisplayText Mostrador de valores (ou texto).

- Principais: Nome: Nome do objeto. 47

Frmula (tag): Nome do "tag" ou frmula indicando o valor associado ao objeto. Ttulo: Ttulo opcional do objeto. Cor: Cor do texto ou valor. Cor de fundo: Cor de fundo do objeto. Visibilidade: se 0 o objeto est invisvel, caso contrrio estar visvel. Pode ser includa uma frmula. (Exemplo x7>30) Atualizao: Menor intervalo de tempo, em milissegundos, da atualizao do objeto. - Especficas: Tamanho ttulo: Tamanho do ttulo do objeto. Borda: 1 - Utilizar borda ao redor do objeto. 0 - No utilizar borda. Formato: Formato do texto ou valor a ser visualizado no objeto. Exemplo: 0.2f Alinhamento: Alinhamento do texto. 0 - esquerda. 1 - centro. 2 - direita. 3 - preenchimento. Mostra Erro: 1 - Mostra informao de erro de leitura. 0 - Fica invisvel se houver erro de leitura.

LEditar
LEditar Editor de valores (ou texto).

Propriedades: - Principais: Nome: Nome do objeto. Frmula (tag): Nome do "tag" ou frmula indicando o valor associado ao objeto. Ttulo: Ttulo opcional do objeto. Cor: Cor do texto ou valor. Cor de fundo: Cor de fundo do objeto. Visibilidade: se 0 o objeto est invisvel, caso contrrio estar visvel. Pode ser includa uma frmula. (Exemplo x7>30) Atualizao: Menor intervalo de tempo, em milissegundos, da atualizao do objeto. - Especficas: Texto: Texto do editor de valores. Tamanho: Tamanho do texto. Se 0 o tamanho fica sendo proporcional altura do editor. Transparente: Se 1 o fundo transparente. Alinhamento: Alinhamento do texto. 0 - esquerda. 1 - centro. 2 - direita. 3 - preenchimento. Fonte: Fonte do texto. Bold: 1 - Texto em negrito. 0 - Texto normal. Itlico: 1 - Texto em itlico. 0 - Texto normal. Borda3D: Se 1 desenha uma borda ao redor do objeto. Editar: Se 0 no permite a editar o valor. Normalmente est em 1. EditarTexto: Texto que aparece na janela opcional de edio (dois cliques). Comando: Comando interno a ser enviado para a planilha de "tags". Formato: Formato do texto a ser visualizado no objeto. Exemplo: %0.2f Planilha: Se 0 o valor objeto no atualizado conforme o "tag" na planilha. Normalmente est em 1. Mximo: Mximo valor numrico permitido. Mnimo: Mnimo valor numrico permitido.. Passo: Passo numrico a ser usado no "spin" da janela opcional de edio (dois cliques). Editor: Se 0 no utilizado o editor no painel e sim apenas a janela de edio. Normalmente est em 1.

48

Figura
Figura Figura para fundo, duplo estado ou animao.

Se a figura estiver associada a um "tag" ento seu valor 1 ou 0 ir determinar se a figura estar em estado de animao, duplo estado ou parada. Para definir uma animao ou duplo estado, utilize arquivos com valores numricos aps seus nomes. Exemplo: Motor001.emf, Motor002.emf e Motor003.emf. A propriedade Estados define o nmero mximo de estados ou quadros para animao. Veja o exemplo canos1.lqs. Propriedades: Nome: Nome do objeto. Frmula (tag): Nome do "tag" ou frmula indicando o valor associado ao objeto. Transparente: Se selecionado o fundo transparente. Tamanho fixo: A figura mantm seu tamanho original fixo. Borda: Desenha uma borda ao redor da figura. Visibilidade: se 0 o objeto est invisvel, caso contrrio estar visvel. Pode ser includa uma frmula. (Exemplo x7>30) Estados: Nmero mximo de estados habilitados para a figura. (0 .. n) Estado atual: Nmero do estado atual (se houver mais de um estado). Duplo estado: Define se os estados compreendem uma animao ou apenas dois estados. "Clique" altera: Alterna o valor do "tag" associado ao objeto em 1 ou 0 se o usurio clicar sobre figura. Antialias: Suaviza as linhas do "metafile". Utilize a caixa abaixo das propriedades para escolher a figura.

49

Boto
Button Boto de ativao de evento.

Propriedades: - Principais: Nome: Nome do boto. Frmula (tag): Nome do "tag" ou frmula indicando a linha da planilha de "tags" associada ao boto. Cor: Cor do boto. Visibilidade: se 0 o boto est invisvel, caso contrrio estar visvel. Pode ser includa uma frmula. (Exemplo x7>30) - Especficas: Texto: Texto que ser mostrado no boto. Comando: Valor que ser colocado no "tag" associado ao boto. Margem: Largura da borda em alto relevo do boto. Letra: Tamanho da fonte que ser usada no texto mostrado no boto. Cor do texto: Cor do texto mostrado no boto. Bold: Tipo da letra do texto mostrado no boto: 1 - Negrito. 0 - Normal. Pagina: Numero da pgina que ser selecionada no painel de objetos visuais quando o boto for pressionado. o mesmo que usar o comando script Painel.Pagina = pgina. Relatrio: Se for preenchido pode assumir dois tipos valores: a) Se for 1 ento ao pressionar o boto ser mostrado o relatrio .lgx "default" da linha da planilha de "tags" associada ao boto. b) Nome do relatrio .lgx que ser apresentado pressionar o boto. PopupPagina: Numero da pgina do painel que ser acionada como popup quando o boto for pressionado. o mesmo que usar o comando script Painel.Popup(pgina). AlterarTag: Altera os tags dos objetos da pgina escolhida para o tag ou grupo do boto. A pgina pode ser escolhida na propriedade Pagina ou PopupPagina. o mesmo que usar o comando script Painel.AlteraTodosOsTagsDaPagina(pgina,nome).

MGrfico
MGrafico Grfico para acompanhamento em tempo real.

Propriedades: - Principais: Nome: Nome do objeto. Frmula (tag): Nome do "tag" ou frmula indicando o valor associado ao objeto. Ttulo: Ttulo opcional do objeto. 50

Cor: Cor da primeira curva. Cor de fundo: Cor de fundo do grfico. Visibilidade: se 0 o objeto est invisvel, caso contrrio estar visvel. Pode ser includa uma frmula. (Exemplo x7>30) Atualizao: Deve ser sempre 0. No caso do grfico utilize a propriedade "Sampling". - Especficas: Mximo: Mximo valor superior da escala no eixo Y. Mnimo: Mnimo valor inferior da escala no eixo Y. Auto Escala: Se 1 a escala automtica. Seno os limites Mximo e Mnimo sero usados. Cor da Grade: Cor da grade na parte interior do grfico. DivisesX: Nmero de divises na escala do eixo X. DivisesY: Nmero de divises na escala do eixo Y. Pontos: Nmero mximo de pontos permitidos no grfico. Reinicia: Se 1 as curvas so apagadas e o grfico pode reiniciar o acompanhamento. FormatoTempo: Formato em que os valores de tempo no eixo X sero mostrados. Exemplo: hh:nn:ss DeltaTempo: Intervalo mximo de tempo que os valores sero mostrados no grfico. CorTexto: Cor dos nmeros e textos no grfico. Sampling: Menor intervalo de tempo, em milissegundos, da atualizao do grfico. Somente no caso deste grfico de acompanhamento deixe a propriedade Atualizao em 0 e utilize o "Sampling". Espessura: Espessura das linhas do grfico. Borda: Se 1 desenhada uma borda 3D ao redor do grfico. TamanhoLetra: Tamanho das letras e dos nmeros colocados no grfico. TamanhoTtulo: Tamanho do ttulo colocado sobre o grfico. Cor2: Cor da curva 2. Cor3: Cor da curva 3. Cor4: Cor da curva 4. Cor5: Cor da curva 5. UsarLegenda: Se 1 a legenda (definida nas propriedades abaixo) mostrada. Legenda1: Texto da legenda para curva 1. Legenda2: Texto da legenda para curva 2. Legenda3: Texto da legenda para curva 3. Legenda4: Texto da legenda para curva 4. Legenda5: Texto da legenda para curva 5. FixoX: Se 1 fixa o eixo X, seno realiza a rolagem como se fosse um papel.

51

Criao e alterao de objetos visuais 2D (personalizar)

Existem duas maneiras de se criar ou editar objetos e controles visuais 2D: - Editor de objetos visuais 2D simples: Menu Editar Painel Editor de objetos visuais 2D simples. - Editor de objetos script texto: Clique duas vezes sobre o objeto. Selecione opes do objeto. Clique em Cdigo fonte. Os arquivos de objetos 2D ficam preferencialmente dentro da pasta objs (c:\Arquivos de Programas\LAquis\objs\....\..).

52

Planta 3D (introduo)

O LAquis oferece a possibilidade de gerar interfaces em 3 dimenses. Defina uma planta em 2 dimenses e associe os tags correspondentes:

A planta ento transformada em uma interface 3D: (boto

53

Janela da interface 3D
Para acessar a janela da interface 3D utilize o boto . Se desejar iniciar a tela automaticamente ao iniciar o aplicativo marque a opo Mostrar planta 3D ao iniciar no menu Configurao Opes.

No modo geral, onde a cmera est posicionada de forma a ter um panorama geral da planta 3D, "clique" com o boto esquerdo do "mouse" sobre a rea da qual se deseja aproximar. Se desejar, utilize opcionalmente o "Mapa" para posicionar a cmera. Para mover a cmera arraste com o ponteiro do "mouse" sobre a interface 3D com o boto do "mouse" pressionado quando o cursor estiver sobre o cho ou pressionando o boto direito. Durante a execuo, para "clicar" sobre um objeto utilize o boto esquerdo do "mouse". No exemplo planta3d.lqs, disponvel na pasta do LAquis, possvel "clicar" sobre os motores, vlvulas, chaves e painis. Botes principais: Grava (ou edita) posies pr-definidas da cmera. Geral: Posiciona a cmera para um panorama geral da planta 3D. Para se aproximar de alguma rea especfica "clique" com o boto esquerdo do "mouse" sobre a interface 3D ou clique sobre o boto de posio da cmera pr-definida. Mapa: Planta em 2D para posicionar a cmera. < ou >: Vira a cmera para esquerda ou para a direita. Atualizao: Seleciona o intervalo de tempo em milissegundos entre cada atualizao da interface 3D durante a execuo. Gerais: Inicia o aplicativo. Pra o aplicativo. Inicia o aplicativo com a opo de gravao em arquivo ou banco de dados. Relatrio dos dados gravados no banco. 54

Objetos da planta 3D
Os objetos de desenho vetorial para a planta 3D so: Parede 3D. (obrigatrio para a gerao de interfaces 3D) Painel 3D. Objeto 3D. Cano.

Objetos visuais 3D tambm podem ser gerados a partir de script texto conforme os objetos visuais normais. Veja tambm: Exemplo disponvel na pasta do LAquis: "planta3d.lqs"

55

Objeto (arquivo 3D)

Objeto (arquivo) 3D: Define um objeto lido de um arquivo. O arquivo pode ser .objeto3d, padro .x3d ou .lobj3d.

Para criar novos objetos 3D utilize o programa editordeobjetos3D.exe na pasta do LAquis. Se desejar utilizar outros softwares para criao de objetos 3D utilize o formato X3D (exemplo Blender). Para escolher o arquivo ou alterar outras propriedades clique duas vzes sobre o objeto 3D.

Arquivo: Nome do arquivo objeto3d ou x3d. Cor base: Altera a cor principal do objeto 3D. Tag (opcional): Associa o objeto 3D ao tag escolhido. Estados: Nmero de estados para animao. Os estados so definidos pelo nmero no nome do arquivo (exemplo vlvula1.x3d e vlvula2.x3d). Estado: Nmero do estado atual do objeto. Varia de 1 a nmero de estados. Se o valor do tag for diferente de 0 o objeto estar em animao. Duplo estado: Altera entre estado 1 e 2 quando o objeto 3D for "clicado" (alterando tambm o tag). Se no estiver ativado ento utilizada a animao de 1 at o nmero de estados. Se o valor do tag for 0 o objeto estar em estado 1. Se no seu estado ser 2. Pgina para edio do tag (opcional): Associa o objeto 3D a uma pgina (tela) do painel. Veja tambm: Exemplo disponvel na pasta do LAquis: "planta3d.lqs"

56

Parede
Parede 3D: Define as paredes na interface 3D. Obrigatrio para a gerao de interfaces em 3D.

As paredes tambm delimitam o tamanho da planta.

Painel 3D
Painel 3D:

Define um painel com os objetos visuais definidos em uma das pginas ou telas do painel principal. Para escolher a tela/pgina ou alterar outras propriedades clique duas vzes sobre o painel 3D.

57

Tela a ser associada ao bloco 3D: Esta pgina ser colocada em um cubo 3D representando o painel. Tag (opcional): Associa os objetos visuais da pgina ao tag (ou grupo) especificado.

Cano 3D
Cano. Define um cano 3D conforme a figura abaixo. Para alterar a cor ou espessura clique duas vzes sobre o cano 3D.

Objeto Visual 3D
Objetos visuais 3D podem ser gerados atravs de script texto da mesma forma que os objetos visuais normais.

Exemplo

Pasta3D\tanque3d:

58

Criao e alterao de objetos visuais 3D (personalizar)

Existem duas maneiras de se criar ou editar objetos e controles visuais 3D: - Editor de objetos 3D: Menu Editar Painel Interface 3D - Editor de objetos 3D. (formato lobj3d) - X3D: O software aceita objetos no formato X3D. Este formato pode ser gerado por diversos aplicativos de design 3D. (Exemplo Blender). Os arquivos de objetos 3D ficam preferencialmente dentro da pasta Plan3D (c:\Arquivos de Programas\LAquis\Plan3D\....\..).

59

Menu principal
Arquivo Novo Abrir Abre o arquivo LQS. Este arquivo (em conjunto com ELS INI LQX) contm todas as informaes especficas de uma aplicao. Salvar Salva o arquivo LQS. Se no houver arquivo nenhum aberto ento necessrio digitar o seu nome. Salvar Como Salva o arquivo LQS obrigando a digitao do seu caminho e nome. Distribuio/Executvel Gerao de executvel para distribuio da aplicao. Cliente Servidor Opes para comunicao em rede atravs de arquivos ou cliente TCP. Servidor TCP Servidor de comunicao em rede atravs de TCP. Editar Copiar Copia para a rea de transferncia as clulas selecionadas na planilha de "tags" ou os objetos visuais marcados. Colar Cola da rea de transferncia sobre a planilha de "tags" ou objetos visuais, dependendo de quem est selecionado no momento. Personalizar colunas de Parmetros Insere colunas a mais na planilha de "tags". Estas colunas podem ser novas propriedades ou outras variveis do mesmo "driver". Veja mais detalhes sobre a Planilha de "Tags". Acrescentar linha (tag) Acrescenta uma linha na planilha de tags. Pode ser feito manualmente na prpria planilha. "Driver" / Equipamento do tag Altera o "driver" ou tipo do tag da linha selecionada. Pode ser feito manualmente na prpria planilha clicando sobre a(s) clula(s) na coluna "driver" correspondente ao tag desejado. "Driver" / Equipamento do grupo Altera o "driver" ou tipo do tag do grupo selecionado ou de todos os tags. Pode ser feito manualmente na prpria planilha clicando sobre o ttulo da coluna "driver". Bloquear "split" Bloqueia o "split" que divide o painel de objetos visuais e a planilha de "tags". Outras opes da planilha de tags Abre um menu com opes de edio da planilha de "tags". Se desejar utilize o boto direito do "mouse" sobre a planilha. Outras opes da grupo de tags Abre um menu com opes de edio do grupo de "tags". Se desejar utilize o boto direito do "mouse" sobre as abas abaixo da planilha. Desenho (Objetos vetoriais / Planta para interface 3D) Passa para o modo de edio dos objetos de desenho. Estes podem ser usados para criar a planta

Para trs Passa o objeto visual marcado para trs dos outros objetos. Para frente Passa o objeto visual marcado para frente dos outros objetos. Selecionar Tudo Seleciona todos os objetos visuais. Trancar objetos Bloqueia ou desbloqueia no painel a movimentao dos objetos visuais na edio. Trancar figuras Bloqueia ou desbloqueia no painel a movimentao das figuras. Estas ficam em segundo plano permitindo editar os outros objetos visuais. Apagar objeto do painel Apaga o objeto visual marcado. Grade Define o tamanho da grade no painel para desenho dos objetos visuais. Pgina 60

3D.

Seleciona a pgina do painel de objetos visuais. Podem ser utilizadas as abas abaixo da barra de ferramentas. Tabela de objetos visuais Passa do modo de visualizao por painel de objetos visuais para tabela automtica (e vice-versa). Nomes dos objetos Permite editar em uma planilha os nomes, associaes e posies dos objetos visuais do painel. Janela da interface 3D... Abre a janela da interface 3D se houver planta definida. Editor de objetos 3D Abre o editor de objetos 3D para serem usados na interface 3D. Para usar os objetos criados utilize na planta 3D o objeto 3D. Opes do objeto visual Seleciona a pasta de opes e propriedades do objeto visual no canto direito do painel. Script visual (Linguagem visual) Seleciona a pasta da linguagem (script) visual no canto direito do painel. Script texto Seleciona a pasta do "script" texto no canto direito do painel. Selecionar "driver" ou tipo do tag Altera o "driver" ou tipo do tag da linha selecionada. Pode ser feito manualmente na prpria planilha clicando sobre a(s) clula(s) na coluna "driver" correspondente ao tag desejado. Desenvolver novo driver (ldriver) Abre o editor LDriver para desenvolvimento de "drivers". Drivers (Script texto e ldriver) Abre o editor de "drivers" no formato "script" texto e ldriver. Janelas da linguagem visual (LVarObj) Mostra todas as janelas do script visual "LVarObj" ativas na aplicao. Mais detalhes sobre "script" visual aqui. Fecha todas as janelas (LVarObj) Fecha todas as janelas do script visual "LVarObj" ativas na aplicao. Compilar tudo (script texto) Compila o script texto de toda aplicao atual gerando um arquivo compilado LQX. Execuo Iniciar aplicao Inicia a aplicao atual (sem necessariamente ligar a gravao em arquivo). Iniciar gravao Inicia a aplicao atual ligando automaticamente a gravao em arquivo se houver. Parar aplicao Pra a aplicao atual. OPC Cliente Mostra uma janela com as conexes atuais OPC cliente. Dados e Relatrios Abrir Relatrio (Histrico / Leituras) Abre a janela de relatrios ou planilha de leituras gravadas em arquivo. Criar relatrio... Cria relatrios a partir de modelos pr-definidos. Abrir outro relatrio.... Abre o relatrio com o formato (planilha LGX) especificado. Editar/desenvolver relatrio (Planilhas para anlise) Abre a janela da planilha LGX para edio de modelos de relatrio e anlise de dados. Banco de Dados / Arquivo (LB / ODBC) / Exportao Abre a janela para edio manual das estruturas de bancos LB e ODBC. Configurao Equipamento (driver) Abre uma janela contendo as variveis disponveis no driver da linha selecionada na planilha de "tags" Alterao de senha Permite criar ou alterar senha para proteo da edio da aplicao atual. Protegido Protege a aplicao atual impedindo digitao na planilha de "tags" e outras opes. Tempo entre varreduras Define um intervalo de tempo adicional em milissegundos entre as varreduras. Este intervalo de tempo geralmente 0 (inexistente). Tempo da animao 61

Define o intervalo de tempo em milissegundos entre cada quadro das animaes. Tempo do evento "OnTimer" Define o intervalo de tempo em milissegundos em que o evento "OnTimer" ser executado novamente. Nmero mximo de pontos (tags) Define o nmero mximo de pontos da planilha de "tags". Painel Configurao de propriedades visuais do painel. Porta Configurao da comunicao global para todos "tags" na planilha que no tiverem sido configurados. Utilize a coluna "config" na planilha para configurar individualmente. Opes Opes e preferncias gerais. Botes: Abrir: Abre o arquivo LQS. Este arquivo (em conjunto com ELS INI LQX) contm todas as informaes especficas de uma aplicao. Salvar: Salva o arquivo LQS. Se no houver arquivo nenhum aberto ento necessrio digitar o seu nome. Abrir relatrio/histrico principal: Abre a janela de relatrios ou planilha de leituras gravadas em arquivo. Editar/desenvolver relatrio - planilhas para anlise: Abre a janela da planilha LGX para relatrio e anlise de dados. Iniciar aplicao: Inicia a aplicao atual (sem necessariamente ligar a gravao em arquivo). Parar aplicao: Pra a aplicao atual. Iniciar gravao: Inicia a aplicao atual ligando automaticamente a gravao em arquivo se houver. Tabela de objetos visuais (automtica): Passa do modo de visualizao por painel de objetos visuais para tabela automtica (e vice-versa). Desenho (objetos vetoriais e 3D): Modo de edio usando objetos vetoriais para desenho ou planta 3D.

62

Opes (Preferncias)
Menu "Configurao" - "Opes" Estas opes devem ser alteradas com muito cuidado. As alteraes podem alterar o desempenho do sistema. - Armazenar dimenses do grfico: Mantem as ltimas dimenses das janelas do grfico aps seu fechamento. Padro: Ativada. - Utilizar arquivo compilado: Se existir o arquivo LQX correspondente aplicao atual ento este usado para sua execuo. Seno a compilao realizada a cada incio da aplicao. Padro: Ativada. - Arquivo referenciado pelo canal: Define a chave primria dos arquivos de leitura como sendo o nmero do canal do "tag". Seno usado o nome do "tag" Padro: Ativada. - Armazenar colunas especiais: Armazena nos arquivos de leitura as colunas de parmetros especiais se existirem os campos no banco LB. Estas colunas so definidas no menu "Editar" - "Colunas de Parmetros". Padro: Ativada. - Todos os processos em paralelo: Toda a comunicao com o equipamento externo definido nos "drivers" executada em tarefa "thread" separada. Alm de melhorar o desempenho do sistema possvel utilizar mais de uma porta de comunicao no mesmo instante. Padro: Ativada. - Aguardar leitura aps algum "set": Marca o "tag" no estado "Aguarde" durante o perodo de tempo em que esta sendo "setado". Padro: Ativada. - Ler valor aps algum set: Fora leitura do tag logo aps toda vez que for alterado. Padro: Ativada. - Forar o set sncrono: Executa a alterao dos tag entre as varreduras sem interromper as tarefas em paralelo. Padro: Desativada. - Forar o set assncrono: Fora a execuo da alterao dos tag imediatamente interrompendo as tarefas em paralelo. Padro: Desativada. - No realizar primeira gravao: Esperar o tempo definido na coluna "Tempo" para gravar a primeira varredura no arquivo de leituras. Seno em todo incio de aplicao gravada uma varredura. Padro: Desativada. - Alterar dados dos subitens conforme "tag" principal: Ao alterar um "tag" que possui subitens identados abaixo, seus dados correspondentes so alterados para o mesmo valor tambm. Padro: Desativada. - LOG das alteraes: Grava no arquivo LOG.TXT as aes realizadas pelo usurio ou "sets" realizados pelo sistema. Padro: Desativada. - Mostrar posio da varredura: Mostra o "tag" sendo atualizado no momento na planilha. Padro: Desativada. - Mostrar planta 3D ao iniciar: Mostrar a janela com a planta 3D no incio da execuo do aplicativo. Padro: Desativada. - Objeto invisvel se houver erro na comunicao: Torna o objeto invisvel quando ocorre erro de comunicao no tag associado. Padro: Ativada.

63

Senha
Para proteger algumas opes do "LAquis" possvel utilizar uma senha. Esta senha definida na opo "Alterao de senha" no menu "Configurao".

Para alterar a senha: Digite a senha antiga no texto superior. Se esta no existe deixe em branco. Digite a senha nova repetindo-a nos dois espaos reservados abaixo.

64

Script (texto e visual)

LCDS - Basic Script Para criar aplicaes avanadas o LAquis oferece duas opes de desenvolvimento: - Script Visual: linguagem visual (LVAROBJ). - Script Texto: linguagem semelhante ao Basic. Script Visual:

- Script Texto:

Nestas linguagens possvel acessar os "tags" definidos na planilha atravs de seus nomes. No script texto se no houver nome definido na planilha utilize x<nmero da linha>. (Exemplo x1) Se desejar acessar outras colunas dos "tags" utilize o ponto. (Exemplo x1.setpoint) Exemplo: Crie um boto. Programe sua ao atravs do script. Execute a aplicao. Ao clicar neste boto o script programado ser executado.

OBS: Os "drivers" de comunicao tambm podem ser desenvolvidos atravs de "script" ou da linguagem "ldriver". 65

Script Visual
O script visual (LVAROBJ) permite desenvolver programas atravs de uma linguagem visual. Cada objeto visual corresponde a um comando, operao, constante, varivel, etc... No exemplo abaixo o valor 7 colocado no tag x2. A sintaxe equivalente no script texto x2=7.

Os pinos de sadas dos valores sempre ficam direita do objeto. Os pinos de entrada ficam esquerda.

66

Objetos principais disponveis para utilizao: Acessa os objetos e comandos do LAquis. Escolha atravs do "browser". "Browser" de objetos:

"Browser" de comandos:

67

Constante numrica. Constante texto. Invoca um outro arquivo .LVAROBJ LVAROBJ) LVAROBJ) Varivel nmero (pode ser utilizada como parmetro de entrada ou sada de um arquivo Varivel texto (pode ser utilizada como parmetro de entrada ou sada de um arquivo

Vai para (ou GoTo). Flecha que aponta para o prximo passo ou comando. Comentrio simples. Operaes matemticas bsicas: Realiza a operao entre as duas entradas e retorna o resultado. retorna o resultado. Executa a funo matemtica sobre a entrada e

Executa a frmula digitada. As variveis antes do simbolo "=" so sadas e as outras variveis so entradas. Executa uma funo desenvolvida em "script" texto no evento <Global>. Digite o nome da funo (parmetros). Outras operaes: Concactena as duas entradas texto.

Define um bloco condicional. Se a entrada recebe 1 ento o interior do bloco executado. Define um bloco de repetio. Possui duas entradas opcionais. - Se a primeira entrada recebe 1 ento o bloco de repetio continua. Se receber 0 ento pra. - A segunda entrada recebe o nmero de vzes que o bloco ser repetido. Pra a execuo do script visual atual. Retorna 1 se a comparao entre as duas entradas for

verdadeira.

Executa a operao lgica entre as duas entradas e retorna 1 se for verdadeiro. Inverte a entrada entre 1 e 0.

68

Eventos
Para editar um programa atravs de script clique sobre o boto LS ou selecione um objeto e utilize a janela ao lado.

No script possvel acessar os "tags" definidos na planilha atravs de seus nomes. Se no houver nome definido na planilha utilize x<nmero da linha>. (Exemplo x1) Se desejar acessar outras colunas (propriedades) dos "tags" utilize o ponto. (Exemplo x1.setpoint) Existem dois tipos de eventos onde os scripts podem ser executados: eventos gerais e eventos nos objetos. No item "Evento" encontram-se as seguintes opes para os eventos gerais: <Global> define as funes que sero usadas em toda sua aplicao; OnStart define o que acontece no incio da aplicao; OnAntesVarreduras define o que acontece antes das varreduras na planilha; OnDuranteVarreduras define o que acontece durante as varreduras; OnDepoisVarreduras define o que acontece depois das varreduras; OnFinish define o que acontece na hora que termina. Para acessar os eventos de cada objeto ento selecione o nome respectivo no item Objeto. No momento em que o objeto desejado for selecionado a lista de eventos ser atualizada para: OnClick define o que acontece quando o usurio clica sobre o objeto. OnMouseDown define o que acontece quando o boto do mouse pressionado sobre o objeto. OnMouseMove define o que acontece quando o mouse arrastado sobre o objeto (pressionado). OnMouseUp define o que acontece quando o boto do mouse "despressionado" sobre o objeto. OnKeyDown define o que acontece quando uma tecla pressionado sobre o objeto. OnKeyPress define o que acontece quando uma tecla pressionado sobre o objeto. OnKeyUp define o que acontece quando uma tecla "despressionado" sobre o objeto. OnCommand define o que acontece quando ocorre um evento especfico do objeto. Observaes: Nos eventos OnKeyDown, OnKeyPress e OnKeyUp o programador pode utilizar a varivel Key para retornar a tecla pressionada. O nmero o cdigo da tabela ANSI. No evento OnCommand o programador recebe as informaes no objeto Event: Event.Value, Event.Object, Event.Command e Event.Pointer. O significado de cada uma destas propriedades determinada pelo objeto. 69

Browser
Para consultar os tags, objetos e comandos disponveis utilize a opo browser. Na janela do script texto clique no boto "F4 - Browser" ou tecle F4. Na janela do script visual selecione o objeto .

Selecione o tag, objeto ou comando desejado. Dica: Se quiser, digite o incio do nome do comando. Uma janela apresentar uma pesquisa dos comandos disponveis.

70

Acessando os "tags" da planilha de E/S (Objeto TAG)

Como ler ou escrever em um "tag" da planilha de pontos de leitura e escrita (ou suas propriedades): Script visual: e clique sobre o editor. Aparecer uma janela com "tags", Selecione o objeto "comandos" objetos e comandos. Escolha o "tag" desejado (ou tambm sua propriedade) e clique em OK.

Exemplos:

(associa o valor 1 ao tag x1)

(retorna, na varivel y, o LI do tag valor4) Script texto: possvel acessar os "tags" definidos na planilha simplesmente atravs de seus nomes, sem utilizar o nome objeto tag, (pode-se utilizar o browser - tecla F4). Exemplo: niveldoliquido. Se no houver nome definido na planilha utilize x<nmero da linha>. (Exemplo x1) Se desejar acessar outras colunas (propriedades) dos "tags" utilize o ponto. (Exemplo x1.param1). Exemplos: x = x1 x5 = x t = Temperatura1*100 x = x7.LimiteSuperior x = Tag(3) s = Tag$(7) c = Tag(7).Canal (retorna o valor do tag x1 na varivel x) (associa o valor x no tag x5) (retorna na varivel t o valor do tag Temperatura1 x 100 ) (retorna na varivel x o valor da propriedade LimiteSuperior do tag x7) (retorna o valor do tag da linha 3 da planilha na varivel x) (retorna o valor texto do tag da linha 7 da planilha na varivel s) (retorna o valor do tag da linha 7 da planilha na varivel c)

Se desejar forar a leitura do "tag" executando o "driver" correspondente execute a propriedade atualiza. Exemplo: x1.atualiza Para utilizar um "tag" como uma simples varivel, sem um equipamento externo, utilize o "driver" VAR. 71

Variveis
Variveis podem ser criadas e utilizadas livremente dentro do script em atribuies de valores ou como parmetros de funes. Os tags tambm podem ser usados como variveis (genricas ou associadas a um equipamento). Existem dois tipos de variveis: - Texto - Nmero Script visual: Variveis: Varivel nmero (pode ser utilizada como parmetro de entrada ou sada de um arquivo Varivel texto (pode ser utilizada como parmetro de entrada ou sada de um arquivo

LVAROBJ) LVAROBJ) Constantes:

Constante numrica. Constante texto. Concactenao de texto: Concactena as duas entradas texto. Exemplo:

Script texto: Para criar variveis numricas: Inicialize a varivel como nmero. Exemplo: x = 0 y = 7.43675 w = &HEEBBFF ' em hexa i = &B011010011101111111 ' em binrio y=y+1 As variveis nmero podem ser calculadas atravs dos operadores + - * / ou atravs de diversas funes matemticas pr-definidas. Para criar variveis texto: Inicialize a varivel como texto. Exemplo: s = "" texto1 = "supervisrio" Converte nmero em texto: s = CStr( x ) Converte texto em nmero: x = Val( s ) As constantes de texto so definidas entre aspas. Os textos podem ser concactenados utilizando o 72

operador +. Exemplo de concatenao de texto: s = "Realizados " + CStr( x ) + " teste(s). " (Para usar variveis texto no comando If utilize o operador ==. - veja Expresso If) As variveis texto tambm podem funcionar como memrias ou pacotes de bytes. Podem ser usadas para comunicao ou tratamento de dados binrios. (veja funes como BytesToStr) Diversos tipos de manipulao de texto (string) podem ser realizados atravs de funes pr-definidas (veja as funes para manipulao de strings no captulo Texto). Ateno: os nomes dos "tags" j so variveis pr-definidas. Veja o tpico Acessando os "tags".

Operaes bsicas
Variveis numricas: Script texto: = : Associa. Ex:

y = 1 .Script visual:

. Ex:

Script texto: + : Soma. Ex: y

= y + 1 .Script visual:

Ex:

Script texto: - : Subtrao. Ex:

y = y 1 .Script visual:

Ex:

Script texto: * : Multiplicao. Ex:

y = y*2 .Script visual:

Ex:

Script texto: / : Diviso. Ex: Variveis texto:

y = y / 2 .Script visual:

Ex:

Script texto: = : Associa. Ex: s

= texto .Script visual:

. Ex:

Script texto: + : Concactena texto (string). Exemplo: s

= s + texto .

Script visual:

. Exemplo:

73

Comandos e expresses bsicas

Expresso If (Condio)
A expresso If indica uma deciso baseada numa condio. Exemplo1: Script visual:

Script texto: If <expresso> Then ... End If If ( x1 = 2 ) Then mensagem1 = "valor 2" End If Se x1 igual a dois ento mensagem1 ser: "valor 2". Exemplo2: Script visual:

Script texto: No caso de uma varivel texto no script texto utilize o operador "==". If Not ( resposta1 == "ERR" ) Then x8 = 3 End If Se resposta1 igual a "ERR" ento x7 ser 3.

74

Exemplo3: Script visual:

Script texto: Expresso com Else e ElseIf: If x1 > 3 Then x8 = 3 ElseIf x1 = 1 Then x8 = 1 Else x8 = 2 End If

For

Script texto: O comando For indica uma repetio onde a varivel recebe valores de n1 at n2.

No exemplo acima o valor de i varia de 1 at 10. A expresso s = s + Chr( i ) ser executada 10 vezes. Script visual:

75

Expresso While (repetio, loop, iterao)

A expresso While indica uma repetio baseada numa condio. Sintaxe: While <condio> ... WEnd Exemplo: leitura = 1 x=0 While ( leitura = 1 ) And ( x <= 20 ) ... x1.atualiza leitura = x1 ... x=x+1 WEnd No exemplo acima, enquanto a leitura realizada por um equipamento for igual a 1 e x for menor ou igual a 20 ento a repetio permanece. Script visual:

No exemplo acima, enquanto a leitura realizada por um equipamento for igual a 1 e x for menor ou igual a 20 ento a repetio permanece. Note que quando a entrada for 1 ento a execuo sai do bloco de repetio.

76

GoTo
Script texto: O comando GoTo (ir para) direciona a execuo do programa para a linha referenciada pelo "label".

No exemplo o programa no executar a linha onde x = 1. O programa executar a partir da linha referenciada pelo label, ou seja, x = 2. Script visual:

Utilize o objeto

e coloque a flecha apontando o destino (e a origem).

77

Objetos Visuais
Utilize o objeto Painel para acessar os objetos visuais. Script texto: Painel.<nome do objeto>.<propriedade> [ = valor ] Para cada objeto existem propriedades comuns e especficas. Para consultar as propriedades especficas necessrio abrir a ajuda especializada do objeto. Script visual: Selecione o objeto "comandos" e clique sobre o editor. Aparecer uma janela com "tags", objetos e comandos. Escolha Painel. e em seguida o objeto desejado (ou tambm sua propriedade) e clique em OK. Propriedades comuns: Refresh Redesenha o objeto de forma a atualizar apenas os itens necessrios. SetPoint Valor usado para o retorno da informao para o Set da planilha. Geralmente usado o envio de dados para o equipamento. Valor Valor principal do objeto. Geralmente usado como leitura do equipamento. Obj.gauge7.Valor = 0 Update Redesenha o objeto de forma completa. Painel.texto2.Update. Exemplos:

Painel.Led2.Estado = 1 o estado do objeto "Led2" ser igual a 1, ou seja, ligado s = Painel.texto1.TEXTO s recebe o texto digitado no objeto "texto1" Propriedade especial: UpdateMode: A propriedade UpdateMode do objeto Obj define a forma de como os objetos sero atualizados quando associados a algum valor. Valores possveis: 0 - Atualiza-o completamente redesenhando todas as partes do objeto. 1 - No redesenha o objeto apenas os dados internos so alterados. 2 (default) - Atualiza somente as partes necessrias do objeto para a visualizao. Exemplo: Painel.UpdateMode = 2 Veja outras propriedades do objeto Painel: Objeto Painel

78

Objeto Painel
O objeto Painel possui propriedades que acessam a configurao da tela, alm dos objetos visuais. (veja como acessar os objetos visuais do painel em Objetos Visuais) Propriedades e mtodos disponveis no objeto Painel: Nmero da pgina atual. Painel.Pagina=0 Popup ( pgina ): Abre a pgina como uma janela "popup". Painel.Popup(1) AlteraTodosOsTagsDaPagina ( pgina, nome do tag ou grupo ): Altera todos os tags ou grupo dos tags dos objetos visuais da pgina. Painel.AlteraTodosOsTagsDaPagina(1, "x7" ) Tag: Nome do tag do objeto visual atual. Tag(Painel.Tag) = 1. Grupo: Nome do grupo do objeto visual atual. Tag(Painel.Grupo+_temp) = 1. ReDesenha: Redesenha o painel. Painel.ReDesenha Foco: Seleciona o foco do windows para o painel. Painel.Foco TelaCheia: Define se o painel uma janela que preenche toda a tela. Janela ( [x,y,] largura, altura ): Define o painel como uma janela. Painel.Janela(600,400) Menu: Habilita ou desabilita o menu com o boto direito do mouse no painel de objetos. Borda: Define se a janela contm borda. Painel.Borda = True Figura: Define o nome do arquivo BMP para a figura de fundo no painel. Painel.Figura = "figura.bmp" FiguraLadoaLado: Se True ento a figura de fundo repetida e disposta lado a lado no painel. Cor: Define a cor de fundo no painel. Tipo: 0 - Painel normal com os objetos visuais. 1 - Tabela de visores. Exemplo: Pagina:

Explicao: 1 - A pgina visualizada ser a de nmero 1; 2 - Painel preencher a tela inteira; 3 - Ser mostrada a pgina 0 e o tamanho da janela ser 640 por 480.

79

Objeto Planilha
O objeto Planilha permite ao script acessar diretamente a planilha de pontos de leitura e escrita "tags". Veja tambm o objeto TAG (tpico Acessando os tags da planilha de pontos de E/S). Script visual: Objeto "comandos" . Tipo Objetos. Item Planilha.

Propriedades e mtodos disponveis no objeto Planilha: LinhaCujoNome (nome_do_tag): Retorna a linha da planilha cujo nome o nome_do_tag. Grava [(linha)]: Inicia a leitura em todas as linhas ou na linha especificada. Planilha.Grava. PararGravacao [(linha)]: Pra a gravao em todas as linhas ou na linha especificada. Planilha.PararGravacao(7) ClienteServidor: Mostra a janela Cliente&Servidor. GravaAgora (linha): Fora gravao do tag no arquivo especificado na planilha. NomeDoTag (linha): Retorna o nome do tag da linha especificada. LinhaDoTag (nome_do_tag): Retorna a linha do tag relativo ao nome especificado. LinhaCujoCanal (canal): Retorna o nmero da linha cujo canal o nmero especificado. Atualiza (linha): Fora a leitura do tag da linha da planilha. Planilha.Atualiza (<linha>) Liga (linha): Inicia a leitura na linha especificada. Planilha.Liga(3) Pausa (linha): Pausa a leitura na linha especificada. Planilha.Pausa(3) DesLiga (linha): Desliga a leitura/gravao na linha especificada. Planilha.Desliga(3) LinhaAtual: Linha atual da planilha que esta sendo lida. l =Planilha.LinhaAtual VarreduraAtual (linha): Varredura atual da leitura na linha especificada. Tags ou Canais: Nmero de canais (ou "tags") definidos na planilha. Ligado (linha): Seta/Retorna se a linha especificada est realizando leitura. Gravando (linha): Seta/Retorna se a linha especificada est realizando gravao. TempoAtual (linha): Retorna o tempo da leitura/gravao da linha especificada. TempoAtualAlarme (linha): Retorna o tempo da leitura do alarme na linha especificada. Apaga: Apaga toda a planilha. AbreLQS (arquivo): Abre um arquivo de extenso LQS ( ) dentro da planilha. Planilha.AbreLQS ( arquivo.lqs ) SalvaLQS (arquivo): Salva um arquivo de extenso LQS ( ) dentro da planilha. Planilha.SalvaLQS ( arquivo.lqs ) SalvaColuna (arquivo, nome_da_coluna): Exporta os dados de uma coluna da planilha em um arquivo texto. AbreColuna (arquivo, nome_da_coluna): Importa os dados de uma coluna da planilha de um arquivo texto. SalvaColunasEspeciais [(arquivo)]: Exporta os dados de todas as colunas especiais para um arquivo texto. AbreColunasEspeciais (arquivo, nome_da_coluna): Importa os dados de todas as colunas especiais a partir de um arquivo texto. 80

Exemplo (OnDepoisVarreduras)
Este um exemplo simples de utilizao de scripts no LAquis usando o evento OnDepoisVarreduras. Script visual:

Script texto: if x1 > 20 then painel.texto2.valor="Ultrapassou 20" else painel.texto2.valor="" end if Explicao do script acima: Se o "Valor" lido no primeiro tag (x1), ou seja, na linha 1 da planilha, for maior que 20, ento o texto do objeto "texto2" ser "Ultrapassou 20". Seno (se "Valor" no for maior que 20) o texto do objeto "texto 2" ser vazio.

81

Exemplo - Evento Global (script texto)

Script texto: Exemplo de utilizao do evento <Global>.

No evento "Global" criamos a funo dobro(x), especificando que: "dobro" igual a duas vezes a varivel x. x2 = dobro(x1) Por exemplo, no evento OnClick de um boto programamos: - x igual ao valor do texto do objeto "textcontrol" - y igual ao dobro de x. - O valor do objeto "texto1" ser o valor de y, ou seja, o resultado da funo dobro(x). Ou seja; se x (valor do objeto "textcontrol1") for igual a 5, y (valor do objeto "texto1") ser igual a 10.

82

Funes e objetos de memria

Objeto global
O objeto Global permite criar variveis que podem ser acessadas em todos os eventos do LAquis. Script visual: Objeto "comandos" Sintaxe: Global.<nome da varivel> [ = valor ] Exemplo: Global.Variavel = 5 Global.Teste = 2 ' Em outro local da aplicao: x = Global.Variavel y = Global.Teste Observao: Global.Variavel = 5 o mesmo que StoreValue(5, "Variavel") . Tipo Objetos. Item Memria.

Objeto Memory
O objeto Memory contm as propriedades e mtodos necessrios para a acessar e manipular dados numa rea de memria. possvel criar blocos de dados, arrays e campos especiais tendo como base um ponteiro de memria. Script visual: Objeto "comandos". Tipo Objetos. Item Memria. Exemplo 1:

Exemplo 2:

Propriedades e mtodos disponveis no objeto Memory:

Alloc (tamanho): Aloca uma rea de memria com o tamanho especificado. p = Memory.Alloc ( 255 ) Free (p, tamanho): Libera a rea de memria apontada pelo ponteiro p. Memory.Free ( p, 255 ) 83

ReAlloc (p, tamanho): Realoca a rea de memria p para outro tamanho sem perder os dados. Byte (p, posio): L ou escreve um byte numa posio da memria apontada pelo ponteiro p. Double (p, posio): L ou escreve um double (8 bytes) numa posio da memria apontada pelo ponteiro p. Long (p, posio): L ou escreve um long (4 bytes) numa posio da memria apontada pelo ponteiro p. Integer (p, posio): L ou escreve um integer (2 bytes) numa posio da memria apontada pelo ponteiro p. Word (p, posio): L ou escreve um word (2 bytes) numa posio da memria apontada pelo ponteiro p. PChar (p, posio): L ou escreve um pchar (texto) numa posio da memria apontada pelo ponteiro p. Comandos de alta velocidade: MemoryWriteLong ( p, posicao ) Escreve um long (4 bytes) numa posio apontada pelo ponteiro p. MemoryWriteByte ( p, posicao ) Escreve um byte (1 byte) numa posio apontada pelo ponteiro p. MemoryWriteDouble ( p, posicao ) Escreve um double (8 bytes) numa posio apontada pelo ponteiro p. MemoryWriteWord ( p, posicao ) Escreve um word (2 bytes) numa posio apontada pelo ponteiro p. MemoryReadLong ( p, posicao ) Retorna um long (4 bytes) de uma posio apontada pelo ponteiro p. MemoryReadByte ( p, posicao ) Retorna um byte (1 byte) de uma posio apontada pelo ponteiro p. MemoryReadDouble ( p, posicao ) Retorna um double (8 bytes) de uma posio apontada pelo ponteiro p. MemoryReadWord ( p, posicao ) Retorna um word (2 bytes) de uma posio apontada pelo ponteiro p.

StoreValue
Comando StoreValue ( valor, nome ) Armazena um valor numrico dentro de uma rea de memria global referenciada por um nome. A funo RestoreValue usada para acessar este nmero. Opcionalmente utilize o objeto Global para acessar estes valores. (Objeto Global) Script visual: Objeto "comandos". Tipo Objetos. Item Memria. Parmetros: valor: nome: Nmero a ser armazenado na memria global. Nome que ser usado como referncia para acessar o nmero atravs da funo RestoreValue.

Exemplo: "" StoreValue ( 30, "teste" ) ... x = RestoreValue ( "teste" ) "" No exemplo acima a varivel x recebe o valor 30.

84

RestoreValue
valor = RestoreValue ( nome ) L um valor numrico armazenado numa rea de memria global referenciado por um nome. O comando StoreValue usado para armazenar este nmero. Opcionalmente utilize o objeto Global para acessar estes valores.(Objeto Global) Script visual: Objeto "comandos". Tipo Objetos. Item Memria. Exemplo: StoreValue ( 30, "teste" ) ... x = RestoreValue ( "teste" ) No exemplo acima a varivel x recebe o valor 30.

ExistsValue
x = ExistsValue ( nome ) Retorna True se o nmero referenciado pelo nome existe na memria global gravado pelo comando StoreValue . Script visual: Objeto "comandos". Tipo Objetos. Item Memria. Exemplo: ... If ExistsValue ( "teste" ) Then x = RestoreValue ( "teste" ) ... ... End If

ClearValue
Comando ClearValue ( nome ) Desassocia a varivel referenciada pelo nome da memria global. Para fins de desempenho a rea de memria no desalocada e pode servir de espao para novos armazenamentos pelo comando StoreValue. Se desejar desalocar a parte da memria global que no est sendo utilizada basta invocar o comando CompactStoredValues. Script visual: Objeto "comandos". Tipo Objetos. Item Memria. Exemplo: StoreValue ( 30, "teste1" ) StoreValue ( 40, "teste2" ) StoreValue ( 50, "teste3" ) ... ClearValue ( "teste2" ) ... CompactStoredValues

FreeStoredValues
Comando FreeStoredValues Libera a memria global utilizada para armazenar as variveis atravs do comando StoreValue. 85

Script visual: Objeto "comandos". Tipo Objetos. Item Memria. Exemplo: StoreValue ( 30, "teste" ) ... x = RestoreValue ( "teste" ) ... FreeStoredValues

CompactStoredValues
Comando CompactStoredValues Compacta a memria global utilizada para armazenar as variveis atravs do comando StoreValue. A compactao s til se algumas das variveis forem eliminadas da memria atravs do comando ClearValue. As lacunas que no foram preenchidas depois so desalocadas da memria global. Script visual: Objeto "comandos". Tipo Objetos. Item Memria. Exemplo: StoreValue ( 30, "teste1" ) StoreValue ( 40, "teste2" ) StoreValue ( 50, "teste3" ) ... ClearValue ( "teste2" ) ... CompactStoredValues

86

Objeto Tabela

O objeto Tabela contm as propriedades e mtodos para a manipulao de uma tabela em formato de planilha. Nesta tabela podem ser apresentados os resultados de operaes realizadas na aplicao ou at mesmo servir de entrada de dados. Uma vez criada a tabela possvel gerar relatrios na tela, impressos ou para exportao. Script visual: Objeto "comandos". Tipo Objetos. Item Tabela.

O ttulo da tabela: "Relatrio" O nmero de colunas: 3 O nmero de linhas: NumLeituras + 1 O valor de determinada clula (seguindo a sequncia - linha,coluna):Linha 0, coluna 0 = "#" , e assim sucessivamente. Tabela.Mostra: o que define o tamanho, ou seja, a resoluo da tabela, no exemplo - 320 por 480.

Propriedades e mtodos disponveis no objeto ArquivoTexto: Nome: Nome da tabela. 87

Titulo: Ttulo da janela onde ser apresentada a tabela. Colunas: Nmero de colunas da tabela. Linhas: Nmero de linhas da tabela. ColunasFixas: Nmero de colunas fixas (em cinza) esquerda da tabela. LinhasFixas: Nmero de linhas fixas (em cinza) no topo da tabela. Celula (coluna, linha): L ou escreve o contedo da clula na coluna e linha especificada. CorTexto (coluna, linha): Cor do texto na clula correspondente coluna e linha especificada. Cor (coluna, linha): Cor do fundo da clula correspondente coluna e linha especificada Largura (coluna): Largura em pixels da coluna especificada na tabela. Altura (linha): Altura em pixels da linha especificada na tabela. Visivel: Torna a tabela visvel ou no. Mostra ( [x1, y2,] dx, dy ): Apresenta a tabela para o usurio e no permite eventos no plano inferior. MostraNormal ( [x1, y2,] dx, dy ): Apresenta a tabela para o usurio. Salva ( arquivo ): Grava os dados da tabela em arquivo texto. Abre ( [ y [, x ],] arquivo, [ajusta] ): Abre o arquivo texto e dispe os dados na tabela nas posies especificadas. ApagaLinha (linha): Apaga a linha especificada da tabela. InsereLinha (linha): Insere uma linha na posio especificada. Libera: Libera a memria alocada para a tabela atual. LiberaTodas: Libera a memria alocada para todas as tabelas criadas. Coluna: L ou define a posio da coluna do cursor na tabela. Linha: L ou define a posio da linha do cursor na tabela. SomenteLeitura: Se True a tabela no poder ser alterada pelo usurio. BordaFixa: Se True o tamanho da janela onde est a tabela no poder ser ajustado.

88

Funes e objetos de arquivos e banco de dados

Objeto LB
Propriedades: LB.Data Determina a data relacionada do banco para o caso de arquivos BANCO<DDMMYYYY>.LDB. Caso contrrio LB.Data = 0. Ex: LB.Data=int(now) LB.Abre(arquivo_ldb) Abre o arquivo .ldb indicado e retorna opcionalmente um nmero relacionadp ao banco. Ex: banco = LB.Abre("TESTE.LDB") LB.BancoNumero(banco) Seleciona o banco aberto atravs do seu nmero. Ex: LB.BancoNumero(banco) LB.Filtro(sql_ou_critrio) Filtra e seleciona os registros de acordo com o comando SQL ou o critrio no formato LBanco. Para selecionar todos os registros basta fazer LB.Filtro(""). Ex: LB.Filtro("VALOR > 30") LB.Registros Retorna o nmero de registros selecionados pelo Filtro. Ex: x = LB.Registros LB.Posicao Retorna ou determina a posio atual do banco em funo do filtro. Varia de 0 at Registros-1. Ex: LB.Posicao=0 LB.PosicaoReal Retorna ou determina a posio real fsica atual do banco. Varia de 0 at Registros-1 quando o filtro vazio. Ex: x=LB.PosicaoReal LB.NovoRegistro Posiciona o banco para acrescentar novo registro. Ex: LB.NovoRegistro LB.Le L o registro apontado pela posio atual. Os dados podem ser retornados pelos mtodos Campo e CampoN. Ex: LB.Le LB.Grava Grava os dados no registro apontado pela posio atual. Os dados so definidos pelos mtodos Campo e CampoN. Ex: LB.Grava LB.Campo(nome_do_campo) Retorna ou define o valor do campo no formato texto. Ex: LB.Campo("OBS")="Acima do limite" LB.CampoN(nome_do_campo) Retorna ou define o valor do campo no formato numrico. Ex: LB.CampoN("TEMPO")=now LB.Titulo(nome_do_campo) Retorna o ttulo do campo. Ex: s=LB.Titulo("CODIGO") 89

LB.Tipo(nome_do_campo) Retorna o tipo do campo. Os tipos so: 0-Nmero,1-Texto,2-AutoInc,3-Data/Hora,4-Binrio. Ex: x=LDB.Tipo("VALOR") LB.Formato(nome_do_campo) Retorna o formato do campo. Ex: s=LB.Formato("VALOR") LB.Campos Retorna o nmero de campos do banco atual. Ex: n=LB.Campos LB.NomeDoCampo(indice_do_campo) Retorna o nome do campo a partir do ndice que varia de 0 at LB.Campos-1. Ex: s=LB.NomeDoCampo(0) LB.Ordena(campo_de_ordenao) Ordena os registros filtrados utilizando o campo de ordenao especificado. Ex: LB.Ordena("TEMPO") LB.FechaBanco(banco) Fecha o banco especificado. Ex: LB.FechaBanco(banco) LB.Fecha Fecha o banco atual. Ex: LB.Fecha LB.Tabela Apresenta a tabela de edio do banco. Ex: LB.Tabela LB.TabelaDoLB(banco,texto,data) Retorna o nome da tabela do LB sem abrir o banco. Texto e data so parmetros opcionais para o nome da tabela. Ex: s=LB.TabelaDoLB("Banco.LB","",0) LB.PastaDoLB(banco,pastadefault) Retorna a pasta dos arquivos de dados sem abrir o banco. Pastadefault a pasta que ser colocada no lugar de "<.>". Ex: s=LB.PastaDoLB("Banco.LB",App.AplPath) LB.Mostra(largura,altura,campos,pesquisa,alterar,adicionar,imprimir,utilizarpesquisa) Mostra a janela para listagem ou edio dos dados de um banco. Ex: LB.Mostra(565,383,"TESTE.LB","",0,0,1,0)

90

Objeto Ini Ini.ReadNumber

A funo Ini.ReadNumber ( arquivoini, sesso, campo, valordefault ) O mtodo ReadNumber do objeto Ini l um valor numrico dentro de um campo numa sesso do arquivoini. Script visual: Objeto "comandos". Tipo Comandos. Item Ini. Exemplo: x = Ini.ReadNumber ( App.Path + "TESTE.INI", "CONFIGURAO", "Altura", 0 )

Ini.ReadString
texto = Ini.ReadString ( arquivoini, sesso, campo, valordefault ) O mtodo ReadString do objeto Ini retorna o valor texto lido a partir de um campo dentro de um sesso no arquivoini. Script visual: Objeto "comandos". Tipo Comandos. Item Ini. Exemplo: s = Ini.ReadString ( App.Path + "TESTE.INI", "CONFIGURAO", "Ttulo", "" )

Ini.WriteString
Comando Ini.WriteString ( arquivoini, sesso, campo, valor ) O mtodo WriteString do objeto Ini escreve um valor texto dentro de um campo numa sesso do arquivoini. Script visual: Objeto "comandos". Tipo Comandos. Item Ini. Exemplo: Ini.WriteString ( App.Path + "TESTE.INI", "CONFIGURAO", "Ttulo", "Aplicao X" )

Ini.WriteNumber
Comando Ini.WriteNumber ( arquivoini, sesso, campo, valor ) O mtodo WriteNumber do objeto Ini escreve um valor numrico dentro de um campo numa sesso do arquivoini. Script visual: Objeto "comandos". Tipo Comandos. Item Ini. Exemplo: Ini.WriteNumber ( App.Path + "TESTE.INI", "CONFIGURAO", "Altura", 100 )

91

Objeto ArquivoTexto
O objeto ArquivoTexto contm as propriedades e mtodos necessrios para a manipulao de arquivos texto. Script visual: Objeto "comandos". Tipo Comandos. Item ArquivoTexto. Exemplo 1:

Exemplo 2:

Propriedades e mtodos disponveis no objeto ArquivoTexto: Abre (arquivo): Abre o arquivo e retorna seu handle. n = ArquivoTexto.Abre("teste.txt") Fecha (harquivo): Fecha o arquivo. ArquivoTexto.Fecha( n ) Eof [(harquivo)]: Retorna True se chegou o fim do arquivo texto. Fim = ArquivoTexto.Eof Le [(harquivo)]: L e retorna uma linha de texto. texto = ArquivoTexto.Le Grava ( [harquivo,] texto): Grava uma linha de texto. Acrescenta ( [harquivo,] texto ): Acrescenta (append) uma linha de texto.

92

Objeto ArquivoBin
O objeto ArquivoBin contm as propriedades e mtodos necessrios para a manipulao de arquivos binrios de formato livre. possvel ler ou gravar blocos de memria de qualquer tamanho. Script visual: Objeto "comandos". Tipo Comandos. Item ArquivoBin. Exemplo 1:

Exemplo 2:

Propriedades e mtodos disponveis no objeto ArquivoBin: Abre (arquivo): Abre o arquivo e retorna seu handle. n = ArquivoBin.Abre("teste.bin") Fecha (harquivo): Fecha o arquivo. ArquivoBin.Fecha( n ) Registros (harquivo): Retorna o nmero de bytes do arquivo. r = ArquivoBin.Registros( n ) Posicao (harquivo): Posiciona o arquivo no byte especificado. ArquivoBin.Posicao (n) = 31 LeBloco ( harquivo, ponteiro, tam ): L um bloco de bytes e armazena na memria apontada pelo ponteiro. GravaBloco ( harquivo, ponteiro, tam ): Grava um bloco de bytes armazenados na memria apontada pelo ponteiro. Le (harquivo): L e retorna apenas um byte. Grava (harquivo): Grava apenas um byte.

93

Objeto Dialog
O objeto Dialog contm as janelas para a entrada de nomes de arquivos por parte do usurio. Script visual: Objeto "comandos". Tipo Comandos. Item Arquivos. Mtodos disponveis no objeto Dialog: Open [ (caminhoinicial [, filtro] ) ]: Apresenta uma janela para a entrada de um arquivo a ser aberto. Save [ (caminhoinicial [, filtro] ) ]: Apresenta uma janela para a entrada de um arquivo a ser gravado. Tando o mtodo Open como o mtodo Save retornam o nome do arquivo digitado ou escolhido. Se o texto retornado for vazio ento significa que o usurio cancelou a operao. Exemplo: Dim nome nome = Dialog.Open ( App.Path, "Arquivos Texto (*.txt)|*.txt|Todos os Arquivos (*.*)|*.*" ) If Not ( nome == "" ) Then ArquivoTexto.Abre ( nome ) ... ... End If ' Se o usurio no cancelou ' Utiliza o arquivo definido pela varivel nome

FileExists
valor = FileExists ( arquivo ) Retorna True se o arquivo especificado existe. Script visual: Objeto "comandos". Tipo Comandos. Item Arquivos. Exemplo: x = FileExists ( App.Path + "arquivo.dat" ) se este arquivo existe ento x recebe o valor True.

Kill
Comando Kill ( arquivo ) Apaga o arquivo especificado do disco. Script visual: Objeto "comandos". Tipo Comandos. Item Arquivos. Exemplo: Kill ( App.Path + "arquivo.dat" )

94

Funes de texto

Funo Val
x = Val ( texto ) A funo Val retorna o valor numrico correspondente ao texto. Script visual: Objeto "comandos" Exemplo: . Tipo Comandos. Item Texto.

Funo CStr
texto = CStr ( nmero ) A funo CStr retorna o texto correspondente a um valor numrico. Script visual: Objeto "comandos". Tipo Comandos. Item Texto. Exemplo:

95

Funo Mid
texto resultante = Mid ( texto, posio inicial, posio final ) A funo Mid retorna uma parte do texto. Exemplo: Mid ("Palavra",3,5) retorna os caracteres de 3 a 5, ou seja, "lav". A posio 1 o primeiro caracter, a posio 2 o segundo, e assim por diante. Exemplo:

Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

Funo CopyString
texto resultante = CopyString ( texto, posio inicial, n ) A funo CopyString retorna uma cpia dos n caracteres partir da posio inicial indicada. Exemplo: s = CopyString ( "Teste da funo CopyString", 10, 6 ) Retorna em s a palavra "funo". Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

Funo LeftS
texto resultante = LeftS ( texto, n ) A funo LeftS retorna uma cpia dos n caracteres esquerda do texto. Exemplo: s = LeftS ( "Teste da funo left", 5 ) Retorna em s a palavra "Teste". Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

96

Funo RightS
texto resultante = RightS ( texto, n ) A funo RightS retorna uma cpia dos n caracteres direita do texto. Exemplo: s = RightS ( "Teste da funo", 6 ) Retorna em s a palavra "funo". Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

Funo DeleteString
texto resultante = DeleteString ( texto, posio inicial, n ) A funo DeleteString retorna uma cpia do texto eliminando n caracteres partir da posio inicial. Exemplo: s = DeleteString ( "Teste da funo", 7, 3 ) Retorna em s o texto "Teste funo". Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

Funo BytesToStr
string = BytesToStr ( byte1, byte2, byte3, ... ) A funo BytesToStr retorna um texto (string) com os bytes indicados. Este string funciona como uma memria ou um pacote de bytes. usado para comunicao ou tratamento de dados binrios. Exemplo: s = BytesToStr ( 0, 5, canal, &HF3, 13, 10 ) Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

97

Funo Len
A funo Len retorna o nmero caracteres na varivel texto. Script visual: Objeto "comandos". Tipo Comandos. Item Texto. Exemplo:

Funo InStr
posio = InStr ( texto, expresso ) A funo InStr retorna a posio de uma expresso dentro de uma varivel ou constante texto. Se a expresso no for encontrada ento a posio 0. A posio 1 o primeiro caracter, a posio 2 o segundo, e assim por diante. Script visual: Objeto "comandos". Tipo Comandos. Item Texto. Exemplo:

Se desejar procurar a partir de uma posio inicial use: posio = InStrPos ( posio inicial, texto, expresso )

Funo StrToNumber
nmero = StrToNumber ( texto, posio inicial, posio final ) A funo StrToNumber converte parte de um texto (string como seqncia de bytes) para nmero byte, word ou long. Exemplo: x = StrToNumber ( s, 5, 6 ) Retorna em x no formato word (2 bytes) o valor determinado pelos bytes 5 e 6 do string s. Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

98

Funo NumberToStr
string = NumberToStr ( nmero [,bytes] ) A funo NumberToStr converte um nmero para texto (string) como uma seqncia de bytes, word ou long. Este string funciona como uma memria ou um pacote de bytes. usado para comunicao ou tratamento de dados binrios. Exemplo: s = "" s = NumberToStr ( x, 2 ) Retorna em s dois bytes do valor x no formato word. Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

Funo Format
texto = Format ( nmero, formato ) A funo Format retorna, a partir de um nmero, um texto no formato especificado. Exemplo: x = now (agora), mas a varivel s receber a nmero x no formato dd/mm/yyyy (dia, ms e ano). Script visual: Objeto "comandos". Tipo Comandos. Item Texto. Exemplos:

99

Funo IntToHex
A funo IntToHex retorna um nmero no formato hexa-decimal (texto). No caso, 12408767 com seis dgitos equivale a "CC99FF". Script visual: Objeto "comandos". Tipo Comandos. Item Texto. Exemplo:

IntToBin
s = IntToBin ( nmero, dgitos ) A funo IntToBin retorna um nmero no formato binrio em texto. No caso, 12408767 com 24 dgitos (bits) equivale a "101111010101011110111111". Script visual: Objeto "comandos". Tipo Comandos. Item Texto. Exemplo: s = "" s = IntToBin ( 12408767, 24 ) A varivel s fica sendo 101111010101011110111111.

Funo HexToInt
A funo HexToInt retorna o valor numrico correspondente ao nmero no formato hexa-decimal (texto). Script visual: Objeto "comandos". Tipo Comandos. Item Texto. Exemplo:

Se quiser digitar diretamente no cdigo utilize &H. Exemplo x = &HCC99FF

100

Funo Chr
caracter = Chr ( nmero ) A Chr retorna o caracter texto correspondente ao seu nmero ANSI (1 a 255). Exemplo: 65 equivale a "A". Script visual: Selecione o objeto "comandos" e clique sobre o editor. Aparecer uma janela com "tags", objetos e comandos. Escolha o tipo Comandos. Depois escolha Texto e em seguida o comando desejado. Clique em OK. Exemplos:

Funo Ord
A funo Ord retorna o nmero ANSI correspondente ao caracter especificado. Exemplo: "A" equivale a 65. Script visual: Objeto "comandos". Tipo Comandos. Item Texto. Exemplo:

Funo Trim
texto = Trim ( expresso ) A funo Trim retorna um texto retirando todos os espaos em branco direita e esquerda da expresso texto. Script visual: Objeto "comandos". Tipo Comandos. Item Texto. Exemplo:

101

Funo UpCase
TextoMaisculo = UpCase ( texto ) A funo UpCase retorna o texto com suas letras maisculas. Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

TextoBytes
texto = TextoBytes ( expresso ) A funo TextoBytes (ou HexText) retorna um texto como uma seqncia de nmeros no formato hexadecimal (com dois dgitos cada um) representando os bytes correspondentes aos caracteres da expresso. Script visual: Objeto "comandos". Tipo Comandos. Item Texto. Exemplo:

102

Funes matemticas

F1G
y = F1G ( x1, y1, x2, y2, x ) Retorna o valor y correspondente ao x conforme uma funo do primeiro grau definida pelos dois pontos (x1,y1) e (x2,y2). Script visual: Objeto "comandos" Exemplo: x = F1G ( 0, 20, 100, 40, 50 ) no exemplo acima a varivel x recebe o valor 30. . Tipo Comandos. Item Matemtica.

Rnd
A funo Rnd retorna um valor aleatrio de 0 a 1. Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica. Exemplo 1:

Exemplo 2:

Randomize
O comando Randomize opcional. Este comando inicializa uma varivel interna para a gerao de nmeros aleatrios atravs da funo Rnd. Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica.

103

Int
valor = Int ( x ) A funo Int retorna a parte inteira do nmero especificado "x". Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica. Exemplo 1:

Exemplo 2:

Frac
valor = Frac ( x ) A funo Frac retorna a parte fracionria de x. Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica. Exemplo: y = Frac ( 5.43672123 ) no exemplo acima a varivel y recebe o valor 0.43672123.

Round
valor = Round ( x ) A funo Round retorna o nmero especificado "x" arredondado para o prximo inteiro. Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica. Exemplo 1: y = Round ( 7.85524789 ) no exemplo acima a varivel y recebe o valor 8.

GetDecimals
valor = GetDecimals ( x ) A funo GetDecimals retorna o nmero de casas decimais do nmero x. Exemplo 1: y = GetDecimals ( 7.1234 ) no exemplo acima a varivel y recebe o valor 4.

104

Mod
A funo Mod retorna o resto de uma diviso entre os dois nmeros especificados. Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica.

PI
A funo PI retorna o valor do nmero pi (3,14...). Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica.

Sin
A funo Sin retorna o seno do nmero especificado em radianos. Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica.

Cos
A funo Cos retorna o cosseno do nmero especificado em radianos. Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica.

Power
resultado = Power ( x, y ) A funo Power retorna o resultado do nmero "x" elevado a "y". Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica.

Sqrt
valor = Sqrt ( x ) Retorna o valor da raiz quadrada de x. Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica. Exemplo: x = Sqrt ( 4 ) no exemplo acima a varivel x recebe o valor 2.

105

Exp
resultado = Exp ( x ) A funo Exp retorna o resultado do nmero e (2,71828183) elevado a "x". Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica.

Exp10
valor = Exp10 ( x ) A funo Exp10 retorna o resultado de 10 elevado a x. Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica. Exemplo: x = Exp10 ( 3 ) no exemplo acima a varivel x recebe o valor 1000.

Log
resultado = Log ( x ) A funo Log retorna o resultado do logaritmo de x na base dez. Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica.

Ln
resultado = Ln ( x ) A funo Ln retorna o resultado do logaritmo neperiano de x. Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica.

Sgn
valor = Sgn ( x ) A funo Sgn retorna o sinal de x. Se x negativo ento Sgn retorna -1. Se x positivo ento Sgn retorna 1. Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica. Exemplo: y=0-4 x = Sgn ( y ) no exemplo acima a varivel x recebe o valor -1.

Troca
resultado = Troca ( valoratual,valor1,valor2 ) A funo Troca retorna alternadamente o valoratual trocado entre valor1 e valor2. Os valores, assim como o resultado, podem ser nmeros ou textos. Script visual: Objeto "comandos". Tipo Comandos. Item Matemtica.

106

Funes de bits
Script visual: Objeto "comandos". Tipo Comandos. Item Bits.

Bits(nmero, bit [, bit2])

A funo Bits retorna o valor do bit ou da faixa de bits sobre um nmero. Exemplo: x = Bits(y, 3) (retorna o bit 3 da varivel y)

Bytes(nmero, n)
A funo Bytes retorna ensimo byte do nmero. Exemplo: x = Bytes(ylong, 1).

BitsAND(nmero1, nmero2)
A funo BitsAND retorna o resultado da operao AND sobre dois nmeros.

BitsOR(nmero1, nmero2)
A funo BitsOR retorna o resultado da operao OR sobre dois nmeros.

BitsSHL(nmero, nmero de bits)

A funo BitsSHL retorna o resultado da operao SHL sobre um nmero.

BitsSHR(nmero, nmero de bits)

A funo BitsSHR retorna o resultado da operao SHR sobre um nmero.

BitsNOT(nmero)
A funo BitsNOT retorna o resultado da operao NOT sobre um nmero.

BitsXOR(nmero1, nmero2)
A funo BitsXOR retorna o resultado da operao XOR sobre dois nmeros.

107

Funes de tempo

Objeto Timer
O objeto Timer um contador que retorna o nmero correspondente ao tempo em milisegundos a partir de um Timer.Reset. Esta funo muito til para fazer contagem de tempo como no exemplo abaixo: Timer.Reset ... While Timer < 7000 ' Enquanto Timer for menor que 7 segundos ... ' Processo WEnd Pode-se criar vrios Timers atribuindo nomes: x = Timer.<nome>[.Reset] Exemplo: Timer.Relogio1.Reset ... While Timer.Relogio1 < 7000 ' Enquanto Timer for menor que 7 segundos ... ' Processo WEnd Script visual: Objeto "comandos" . Tipo Comandos. Item Tempo.

Objeto Clock
O objeto Clock um contador semelhante ao Timer, mas retorna a data/hora em formato double. A contagem disparada a partir de um Clock.Reset. Esta funo muito til para fazer contagem de tempo como no exemplo abaixo: Clock.Reset ... ' Processo x = Clock s = "" s = Format ( x, "hh:nn:ss" ) ' Retorna o tempo corrido ' no formato hora minuto segundo Pode-se criar vrios Timers atribuindo nomes: x = Clock.<nome>[.Reset] Exemplo: Clock.Relogio1.Reset ... If Clock.Relogio1 < StrToTime ( "03:07:00" ) Then ' Se Clock for menor que ' 3 horas e 7 minutos ... ' Processo End If Script visual: Objeto "comandos". Tipo Comandos. Item Tempo.

108

Now
A funo Now retorna o dia, ms, ano, hora, minuto, segundo e milisegundo atual em apenas um nmero (double). Script visual: Objeto "comandos". Tipo Comandos. Item Tempo. x = Now MsgBox ( Format ( x, "dd/mm/yyyy hh:nn:ss" ) ) ' Mostra a data hora no formato ' exemplo: 01/07/2006 03:10:07 ... A parte inteira o nmero de dias. A parte fracionria contm as horas minutos e segundos. 1 hora 1 / 24 = 0.0416.... 1 minuto 1 / 24 / 60 = 6.94... E-4 1 segundo 1 / 24 / 60 / 60 = 1,157407...E-5 1 milissegundo 1 / 24 / 60 / 60 / 1000 = 1,157407...E-8 ...

Day(datanmero)
A funo Day retorna o nmero correspondente ao dia a partir de uma varivel tempo conforme o exemplo abaixo. Script visual: Objeto "comandos". Tipo Comandos. Item Tempo. x = Day(now)

Month(datanmero)
A funo Month retorna o nmero correspondente ao ms a partir de uma varivel tempo conforme o exemplo abaixo. Script visual: Objeto "comandos". Tipo Comandos. Item Tempo. x = Month(now)

Year(datanmero)
A funo Year retorna o nmero correspondente ao ano a partir de uma varivel tempo conforme o exemplo abaixo. Script visual: Objeto "comandos". Tipo Comandos. Item Tempo. x = Year(now)

109

Hour
A funo Hour retorna o nmero correspondente hora a partir de uma varivel tempo conforme o exemplo abaixo. Script visual: Objeto "comandos". Tipo Comandos. Item Tempo.

Minute
A funo Minute retorna o nmero correspondente ao minuto a partir de uma varivel tempo conforme o exemplo abaixo. Script visual: Objeto "comandos". Tipo Comandos. Item Tempo. x = Minute(now)

Second
A funo Second retorna o nmero correspondente ao segundo a partir de uma varivel tempo conforme o exemplo abaixo. Script visual: Objeto "comandos". Tipo Comandos. Item Tempo. x = Second(now) Observao: Da mesma forma possvel retornar o tempo em milisegundos com a funo MiliSecond.

WeekDay
A funo WeekDay retorna o nmero correspondente ao dia da semana a partir de uma varivel tempo conforme o exemplo abaixo. Script visual: Objeto "comandos". Tipo Comandos. Item Tempo. x = WeekDay(now)

StrToTime
A funo StrToTime retorna o nmero correspondente ao horario a partir de uma varivel texto. Script visual: Objeto "comandos". Tipo Comandos. Item Tempo. Se a varivel texto s for um horrio (exemplo "15:03:05") ou uma data (exemplo "01/01/2006") a funo retorna um nmero no formato tempo double. t = StrToTime ( s )

110

DateToNumber
x = DateToNumber ( dia,ms,ano ) A funo DateToNumber retorna o nmero correspondente data definida pelos valores dia, ms e ano. Script visual: Objeto "comandos". Tipo Comandos. Item Tempo. Exemplo: t = DateToNumber ( 1, 7, 6 ) A varivel t recebe a data 01/07/2006 no formato double.

Delay ou Sleep
O comando Delay ou Sleep fora um pausa durante um tempo especificado em milisegundos. Script visual: Objeto "comandos". Tipo Comandos. Item Tempo.

111

Funes de aplicativo

App.Stop
Mtodo App.Stop O mtodo Stop do objeto App interrompe a execuo do LAquis e fecha o programa. Script visual: Objeto "comandos" . Tipo Comandos. Item Aplicativo.

App.Path
caminho = App.Path A propriedade Path do objeto App retorna a pasta onde se encontra o executvel do LAquis. Script visual: Objeto "comandos". Tipo Comandos. Item Aplicativo.

App.ExeName
caminho = App.ExeName A propriedade ExeName do objeto App retorna o nome completo mais a pasta de onde foi executado o LAquis. Script visual: Objeto "comandos". Tipo Comandos. Item Aplicativo.

App.APLName
caminho = App.APLName A propriedade APLName do objeto App retorna o nome do arquivo APL ou LQS (aplicao) que est sendo utilizado. Script visual: Objeto "comandos". Tipo Comandos. Item Aplicativo.

App.APLPath
caminho = App.APLPath A propriedade APLPath do objeto App retorna a pasta do arquivo APL ou LQS (aplicao) que est sendo utilizado. Script visual: Objeto "comandos". Tipo Comandos. Item Aplicativo.

112

App.Title
caminho = App.Title A propriedade Title do objeto App define o ttulo ou o nome da aplicao. Este nome ser escrito sobre o cone na barra de tarefas e na lista de tarefas do Windows. Script visual: Objeto "comandos". Tipo Comandos. Item Aplicativo.

App.Priority
Propriedade App.Priority A propriedade Priority do objeto App define a prioridade do programa LAquis em relao aos outros aplicativos que esto sendo executados ao mesmo tempo no sistema operacional. Se Priority for 0 ento o LAquis tem prioridade normal. Se for de nvel 1 ento o LAquis ter uma prioridade um pouco maior em relao aos outros aplicativos que esto sendo executados ao mesmo tempo. Se a propriedade Priority for 2 ento o LAquis ter grande prioridade sobre os outros programas e estes comprometero bem menos o desempenho do LAquis. Script visual: Objeto "comandos". Tipo Comandos. Item Aplicativo.

App.PortConfig
caminho = App.PortConfig A propriedade PortConfig do objeto App invoca a janela de configurao da porta serial. Script visual: Objeto "comandos". Tipo Comandos. Item Aplicativo.

App.ContinuousReading
caminho = App.ContinuousReading A propriedade ContinuousReading do objeto App indica se a opo leitura contnua est ativada. Script visual: Objeto "comandos". Tipo Comandos. Item Aplicativo.

DoEvents
Comando DoEvents O comando DoEvents permite que o sistema operacional execute as operaes e mensagens pendentes. Script visual: Objeto "comandos". Tipo Comandos. Item Aplicativo.

113

Funes de comunicao
Script visual: Objeto "comandos". Tipo Comandos. Item Comunicao.

Planilha.ExecuteDriver(linha, parametro)
Execute o driver associado linha especificada da planilha de tags utilizando o parmetro informado. Retorna o valor lido. Ex: x = planilha.ExecuteDriver(7,128)

Planilha.ExecuteDriverIndependente( nome do driver, config, param1, param2, reservado, comando, canal, parmetro, valor )
Executa o driver especificado independentemente do tag ou linha da planilha e retorna o valor lido. Parmetros: driver: Nome do driver que ser executado. Exemplo "MODBUS.ldriver". config: Configurao da comunicao. Exemplo porta:velocidade,paridade,dados,stop. Param1: equipamento. Param2: equipamento. comando: Depende do driver. Geralmente indica qual a varivel que ser lida ou escrita no Depende do driver. Geralmente indica qual o n ou endereo da rede do Nmero correspondente ao tipo de ao do driver. Os comandos bsicos so: 0: Inicializao do driver 1: Leitura 2: Escrita 3: Nmero de parmetros 1000: Finalizao do driver outros comandos existentes so especficos de cada driver. Endereo do equipamento quando ldriver25 ou ld verso < 2.5. parmetro: Varivel lida ou escrita no equipamento quando ldriver25 ou ld verso < 2.5. O valor a ser enviado ao driver. Geralmente o valor a ser gravado na varivel especificada no equipamento. Ex: x=planilha.ExecuteDriverIndependente("MODBUS.ldriver","1:9600,N,8,1","400001",0,"",1,1,0,0) valor:

canal:

Opcionalmente estes comandos acesse diretamente os "tags" para esta operao, ou execute o comando de atualizao (Exemplo x1.atualiza) para forar a leitura do equipamento relativo ao tag.+ 114

As funes a seguir so usadas principalmente para drivers LD em script texto:

OpenCom
O comando OpenCom usado para abrir a porta de comunicao COM utilizando o sistema operacional. Uma vez usando este comando todas as leituras e gravaes na porta sero realizadas atravs das funes API do sistema. Este comando til, por exemplo, quando o sistema operacional NT e existe um bloqueio no acesso direto s portas. Tambm, s vezes as portas COM 3 e 4 esto disponveis apenas atravs do comando OpenCom. O nmero da porta definido na varivel Porta. Para fechar o uso da porta necessrio utilizar o comando CloseCom.

OpenDevice(nome)
O comando OpenDevice parecido com OpenCom. A diferena que o nome do dispositivo informado. Para fechar o uso da porta necessrio utilizar o comando CloseDevice. Exemplo: OpenDevice(COM3)

ConfCom
O comando ConfCom configura a porta (definida na varivel Porta) no que diz respeito velocidade (Baud), paridade, bits de dados e bits de stop. Exemplo: ConfCom("9600,N,8,1")

PoeCom (WriteCom)
Comando PoeCom ( texto ) O comando PoeCom (WriteCom) envia um conjunto de bytes (texto) para uma porta de comunicao definida pela varivel Porta conforme o exemplo abaixo.

115

LeCom (ReadCom)
resposta = LeCom ( nmero mximo de bytes ) A funo LeCom (ReadCom) retorna um conjunto de bytes lidos de uma porta de comunicao definida pela varivel Porta conforme o exemplo abaixo:

CloseCom
O comando CloseCom fecha e libera a porta de comunicao aberta pelo comando OpenCom.

CloseDevice(nome)
O comando CloseDevice fecha e libera a porta de comunicao aberta pelo comando OpenDevice.

CloseAllDevice
Fecha todos os dispositivos abertos

x = DeviceID(nome)
Retorna e torna "default" o handle do nome do "device" atual ou do informado nome informado. Ex: id=DeviceID("COM3").

IO.Port
A propriedade IO.Port l ou envia um byte diretamente a uma porta externa do computador.

116

Funes de janelas de mensagens

Input
A funo Input apresenta uma janela simples para entrada de dados e retorna o texto digitado pelo usurio. Script visual: Objeto "comandos". Tipo Comandos. Item Especial. Exemplo 1:

Exemplo 2:

Ask
A funo Ask apresenta uma caixa de mensagem com os botes Sim e No. Retorna True ou False dependendo da resposta dada pelo usurio. Script visual: Objeto "comandos". Tipo Comandos. Item Especial.

MsgBox
O comando MsgBox apresenta uma caixa de texto para informaes ao usurio. Script visual: Objeto "comandos". Tipo Comandos. Item Sada. Exemplo 1:

Exemplo 2:

117

Objeto GRID
O objeto Grid permite acessar a planilha LGX da janela de relatrios. Grid.Abre(arquivoLGX[,x,y]) Abre uma janela com a planilha LGX. Desliga Fecha a janela com a planilha LGX. Prepara(arquivo) Prepara sem mostrar a janela com a planilha LGX. usado para permitir a utilizao do comando Cells. Grid.Mostra(x,y[,z]) Mostra a janela com a planilha LGX. Grid.Cells(x,y) Valor da clula em formato texto da coluna X e da linha Y da planilha LGX. Grid.Cellsn(x,y) Valor da clula em formato nmerico da coluna X e da linha Y da planilha LGX. Grid.Col Coluna atual do cursor na planilha LGX. Grid.Row Linha atual do cursor na planilha LGX. Calcula Executa o clculo da planilha LGX. Grid.TipoModal Se TipoModal for 1 a janela, quando aparecer no permitir que o processo continue, at sair da mesma.

118

Comandos principais da planilha de relatrios

Celula(coluna,linha): L ou altera o valor da clula texto. CelulaN(coluna,linha): L ou altera o valor da clula nmero. Colunas: Retorna o nmero de colunas. Linhas: Retorna o nmero de linhas. Largura(coluna): Largura da coluna. Altura(linha): Altura da linha. Coluna: Nmero da coluna atual do cursor. Linha: Nmero da linha atual do cursor. LimparPlanilha(coluna1,linha1,coluna2,linha2) : Limpa as clulas da faixa especificada na planilha. LimparFormato(coluna1,linha1,coluna2,linha2) : Limpa o formato das clulas da faixa especificada. Apagalinha(linha) : Elimina a linha especificada. InsereColuna(coluna) : Insere uma coluna vazia no local especificado. InsereLinha(linha) : Insere uma linha vazia no local especificado. DesenhaSempre: Propriedade da planilha 1 ou 0. Se 1 a planilha redesenhada a cada alterao. ReDesenha: Fora o desenho da planilha. PausaCalculo: Pra de executar o clculo. Calcula: Fora a execuo do clculo. LarguraDoTexto(texto): Retorna a largura do texto especificado. CelulaNome(nome): L ou altera o valor da clula texto pelo nome. CelulaNNome(nome): L ou altera o valor da clula nmero pelo nome. Color(coluna,linha): Cor da clula. Font.Color(coluna,linha): Cor da fonte da clula. Font.Size(coluna,linha): Tamanho da fonte da clula. Font.Bold(coluna,linha): Clula em negrito. Formato(coluna,linha): Retorna ou define o formato da clula especificada. Alignment(coluna,linha): Retorna ou define o alinhamento da clula especificada. Bloqueado(coluna,linha): Retorna ou define se a clula est bloqueada. Calendario(coluna,linha) : Executa o calendrio para alterao do valor da clula especificada. Formula(coluna,linha): Retorna ou define a frmula da clula especificada. Borda(coluna1,linha1,coluna2,linha2,borda,cor) : Atributos das bordas de uma faixa de clulas. RowSelect: Tipo do cursor como seleo de linha. (1 ou 0) LinhaAlterada: Nmero da linha alterada (exemplo: ao sair da clula evento OnSairDaCelula). ColunaAlterada: Nmero da coluna alterada (exemplo: ao sair da clula evento OnSairDaCelula). AceitarAlteracao: Define se a alterao da clula deve ser efetivada (1 ou 0). ColunaClicada: Retorna o nmero da coluna clicada (evento OnClick). LinhaClicada: Retorna o nmero da linha clicada (evento OnClick). ColunaTexto: Retorna o nmero da coluna do texto a ser alterado no evento OnTexto. LinhaTexto: Retorna o nmero da linha do texto a ser alterado no evento OnTexto. CelulaTexto: Retorna ou define o valor do texto a ser alterado no evento OnTexto. Ordena(coluna,tipo,coluna1,linha1,coluna2,linha2) : Executa a ordenao de uma faixa de clulas. ImportarTxt(arquivo,coluna,linha) : Importa texto de um arquivo. ExportarTxt(arquivo,coluna,linha,colunas,linhas) : Exporta texto de um arquivo. ColarTexto(texto,coluna1,linha1,coluna2,linha2) : Cola texto separado por tabs e enters Veja tambm o captulo Planilha para relatrios e anlise. 119

Outras funes e objetos

Execute Event
Script texto: ExecuteEvent ( <evento>, <objeto> ) Executa o evento do objeto visual ou script especificado.

EscPressed
A funo EscPressed retorna True se o usurio digitou a tecla ESC. Script visual: Objeto "comandos". Tipo Comandos. Item Especial.

VRel.Execute
Comando VRel.Execute [(nome)] Executa a janela de impresso utilizando opcionalmente como formato de relatrio o arquivo .rlv especificado. Script visual: Objeto "comandos". Tipo Comandos. Item VREL. Parmetro: nome: Nome do arquivo .rlv a ser utilizado como formato de relatrio.

Exemplo: VRel.Execute ( "Arquivo1.rlv" )

120

Declare (script texto)

Script texto: Declare Function <nome> Lib <dll> Alias <nomeusado> (<parmetros>) As <tipo> O comando Declare permite utilizar bibliotecas DLL dentro do script no LAquis. O formato dos comandos deve ser stdcall. Nesta verso do LAquis todas as funes devem retornar algum valor. Parmetros: nome: Nome da funo original. dll: Nome da biblioteca dll. Pode ser o nome do arquivo entre aspas ou somente o nome principal. nomeusado: Nome da funo que ser usada no script. parmetros: Variveis com os seus respectivos tipos separadas por vrgula conforme o exemplo. tipo: Tipo do retorno da funo. Exemplo: Declare Function Poe Lib CCALC Alias Poe1 ( ByVal canal As Word, ByVal valor As Double ) As Long Declare Function MessageBoxA Lib USER32 Alias MessageBox ( ByVal Handle1 As Long, ByVal p1 As String, ByVal p2 As String, ByVal Handle2 As Long ) As Long Dim s MB_ICONEXCLAMATION = &H30 x = 40 texto = MessageBox ( 0, "Teste de MessageBox", "Ttulo", MB_ICONEXCLAMATION ) Poe1 ( 5, x ) Para funes que retornam valores nos parmetros, declare estas variveis com o tipo Long e trate-o da mesma forma que um ponteiro. Utilize o objeto Memory para acessar esta rea de memria. Veja um exemplo abaixo: Note que o parmetro texto deveria ser String mas na verdade encarado como se fosse um ponteiro.

121