Home

Tutorial Script E3

1. 7 4 8 3 1 Propriedades Esta se o cont m informa es sobre as propriedades das Zonas do objeto EZText 7 4 8 3 1 1 BackgroundColor E Define a cor de fundo do texto da zona O valor padr o dessa propriedade branco RGB 255 255 255 7 4 8 3 1 2 Blink P Indica que esta zona participa do efeito de piscar O valor padr o dessa propriedade falso Se estiver habilitada esta zona alterna com a zona padr o conforme o tempo definido na propriedade BlinkTime do objeto EZText 7 4 8 3 1 3 HorizontalAlignment P Define o alinhamento do texto Os valores poss veis s o e O HorizontalAlignmentLeft alinha horizontalmente esquerda e 1 HorizontalAlignmentCenter alinha horizontalmente ao centro ActiveX 269 e 2 HorizontalAlignmentRight alinha horizontalmente direita Ovalor padr o desta propriedade 1 HorizontalAlignmentCenter 7 4 8 3 1 4 Maximum 9 Define o valor m ximo para a zona O valor padr o dessa propriedade 20000 7 4 8 3 1 5 Message Define o texto associado zona Esta mensagem ser mostrada quando o tag associado estiver dentro dos limites da zona 7 4 8 3 1 6 Minimum 9 Define o valor m nimo para a zona O valor padr o dessa propriedade O 7 4 8 3 1 7 TextColor E Define a cor do texto da zona O valor padr o dessa propriedade preto RGB 0 0 0 7 4 8 3 1 8 TextFont Define o estilo a core o tamanho da fonte usada para mo
2. e Alarme Banda Morta Respons vel por configura es de alarme de banda morta Propriedades do Alarme Banda Morta ITEM DESCRI O 9 DeadBandsetPoint Limite de banda morta do alarme Cada vez que o valor do tag associado ultrapassar o valor desta propriedade para mais ou para Alarmes 339 ITEM DESCRI O menos do valor de DeadBandLimit o alarme ocorrer A DeadBandReturnMessageText Mensagem de retorno de alarme de banda morta Fi peadBand Habilita ou desabilita a verifica o de alarme de banda morta 9 DeadBandLimit Limite para o alarme de banda morta DeadBandMessageText Texto da mensagem de alarme de banda morta 9 DeadBandSeverity Import ncia do alarme de banda morta Conjunto de valores e O Alta e 1 M dia e 2 Baixa Fi DeadBandAckRequired Necessidade de reconhecimento para este tipo de alarme banda morta Exemplo Sub Botaol Click Dim val Quando clica no botao muda o nivel de alarme Lo do Alarmsource BatteryLevel Application Getobject configalarmes1 Areal BatteryLevel Getalarm LoLimit 10 2 End sub 340 Alarmes 12 3 2 Propriedades Comuns Esta se o cont m informa es sobre as propriedades comuns aos objetos Fonte de Alarme 12 3 2 1 ActiveNACKAlarm Fi se ajustada para True indica que a Fonte n o foi reconhecida desde a ltima
3. 7 3 6 1 10 SpecialEffect aP A propriedade SpecialEffect especifica a apar ncia de um objeto As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para SpecialEffect OP O DESCRI O 0 fmSpecialEffectFlat Oobj bord eto aparece plano e possui um destaque na a uma altera o de cor ou ambos 1 fmSpecialEffectRaised Oobj esqu Oobj eto possui um destaque na parte superior erda e uma sombra na parte inferior direita eto parece estar em relevo 2 fmSpecialEffectSunked Oobj esqu eto possui uma sombra na parte superior erda e um destaque na parte inferior direita Oobj na Tela eto e a sua borda parecem estar afundados 3 fmSpecialEffectEtched Aborda parece estar esculpida ao redor da extre midade do objeto 6 fmSpecialEffectBump Oobj direita e parece plano na parte superior esqu eto possui um ressalto na parte inferior erda ActiveX 215 7 3 6 1 11 TextAlign a Especifica como o texto alinhado no objeto As op es dispon veis s o as seguintes e 1 fmTextAlignLeft alinha o texto com a extremidade esquerda do objeto e 2 fmTextAlignCenter centraliza o texto com a extremidade direita do objeto e 3 fmTextAlignRight alinha o texto com a extremidade direita do objeto 7 3 6 1 12 WordWrap F Habilita ou desabilita uma quebra de linha no texto cas
4. DADOS DESCRI O Num rico Sa da decimal cient fica hexadecimal bin ria e octal Texto Textos em geral Booleano Valores boleanos Data Hora Calend rio Gregoriano 12 3 2 10 FormattedValue Cont m o valor do alarme conforme a propriedade Value formatado de acordo coma propriedade Format Esta propriedade somente de leitura O valor padr o desta propriedade Null Alarmes 343 12 3 2 11 RawAlarm P Indica se o alarme deve estar ativo independentemente da espera Quando a espera for igual a O zero o valor de RawAlarm ser o mesmo da propriedade Alarm Esta propriedade somente de leitura O valor padr o desta propriedade False 12 3 2 12 Source A Cont ma express o que dever ser avaliada para determinar se o alarme deve ocorrer ou n o 12 3 2 13 Value Cont m o valor do que foi avaliado para determinar se o alarme ocorre ou n o O valor padr o desta propriedade Null 12 3 3 Fonte de Alarme Anal gico Esta se o cont m informa es sobre propriedades do objeto Fonte de Alarme Anal gico Este objeto n o possui eventos nem m todos associados 12 3 3 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Fonte de Alarme Anal gico 12 3 3 1 1 Hi Pl Habilita ou desabilita a verifica o de alarmes do tipo Hi 12 3 3 1 2 HiAckRequired FP Indica que o alarme do tipo Hi requer reconhecimento 344 Alarmes
5. OP O DESCRI O 2 ByPercent Aimagem ficar transl cida com porcentagem de transpar ncia especificada na propriedade TransparentPercent Exemplo Sub DrawPicturel Click Deixa a cor da imagem azul transparente quando se clica no objeto Figura TransparentMode 1 ByColor TransparentColor RGB O O 255 End sub 6 2 6 1 17 TranparentPercent 9 Quando a propriedade TransparentMode estiver configurada para 2 esta propriedade define qu o transl cida a imagem ser exibida variando de O totalmente transl cido a 100 opaco ou s lido Exemplo Sub Drawpicturel Clik0O i Deixa a imagem transl cida quando se clica no objeto TransparentMode 1 ByPercent TransparentPercent 50 50 transl cido End Sub Telas e Objetos de Tela 157 6 2 6 1 18 VerticalFillStyle P Define como ser o preenchimento vertical do objeto Esta propriedade trabalha em conjunto com a propriedade VerticalPercentFill que informa qual porcentagem do objeto dever ser preenchida Estas duas propriedades permitem uma simula o de um preenchimento de n vel em um objeto Op es dispon veis para VerticalFillStyle OP O DESCRI O 0 FillBottomToTop A porcentagem de preenchimento ser de baixo para cima 1 FillTopToBottom A porcentagem de preenchimento ser de cima para baixo 2 FiliCenterToEdgesV A porcentagem de preenchimento ser do centro para as bordas Exemplo
6. GenPageBreaks HTML Em True colocar quebras de p gina abaixo do elemento mais inferior em cada p gina do relat rio HTMLOutputPath HTML Caminho padr o para os arquivos HTML JPGQuality PDF Indica o n vel de qualidade das imagens exportadas de O a 100 MinColumnWidth Excel Tamanho m nimo da coluna O valor padr o 1011 twips MinRowHeight Excel Tamanho m nimo da linha MultiSheet Excel Em True cada p gina no relat rio vai para uma planilha separada 476 Relat rios PROPRIEDADE FILTRO DESCRI O PageDelimiter TEXT Configura ou retorna o caractere delimitador entre p ginas SuppressEmptyLines TEXT Retira ou Insere linhas vazias para efeito de layout TextDelimiter HTML Configura ou retorna o caractere delimitador entre os textos TrimEmptySpace Excel Em True o espa o vertical entre os elementos ser eliminado O padr o False Unicode TEXT Determina se o texto vai ser salvo em formato Unicode 16 bits WebCache Output HTML Em True o relat rio ser exportado para o servi o de WebCache Caso contr rio padr o n o ser exportado 22 2 3 Print Print Imprime um relat rio Exemplo sub Rect Click Application LoadReport Relat rio3 PrintQO End sub 22 2 4 PrintPreview PrintPreview Faz uma pr via de impress o de relat rio na Tela Se o relat rio for mostr
7. HI propriedades A Scripis 7 Para Ajuda pressione F1 k fw o o XObject exemplo Um script para alterar a propriedade Valor do XObject seria Sub CommandButton1l click application Cetob ject Dados Ob ject ID valor End Su Ou ainda sub CommandButton1_ClickO Application Getobject Dados Item xobject11 valor 123 End Sub Pode se ainda ter um XControl acessando um XObject atrav s de uma XProperty Por exemplo a figura mostra um XControl chamado XContro 11 que possui uma propriedade XValor do tipo XObject1 que o nome do XObject criado dl Xobjects gil xcontrol 4 b x gibxobjects gi XControts atx J x Nome T gt 4 valor inicial Texto de Aj EF Xvalor XObject1 fa aj H N Propriedades A Serpis NJ 4 HJ NV Design A Propriedades Scripts 7 XControl acessando um XObject exemplo 34 Programando no E3 Faz se por exemplo uma associa o do valor do objeto Text 01 coma propriedade Valor do XObjectl1 Isso feito atrav s da propriedade XValor criada no XControl1 Assim o valor da propriedade Valor do Xobject1 ser mostrada no objeto Texto1l doxControl1 CEEE de Texto1 Panel DrawString Propriedade Valor No projeto o v nculo da inst ncia XObject11 inst ncia XControl11 pode ser feito atrav s de uma associa o na propriedade XValor Programando no E3 35 Propriedades de XContr
8. OP O DESCRI O 90 72 90 A primeira coluna possui 90 pontos 1 25 polegada a segunda coluna possui 72 pontos 1 polegada a terceira coluna possui 90 pontos 6 cm 0 6 cm A primeira coluna possui 6 cent metros a segunda coluna est oculta a terceira coluna possui 6 cent metros Como parte da terceira coluna vis vel uma barra de rolagem horizontal aparece 1 5 pol 0 2 5 pol A primeira coluna possui 1 5 polegadas a segunda coluna est oculta e a terceira coluna possui 2 5 polegadas 2 pol 2 pol A primeira coluna possui 2 polegadas a segunda coluna possui 1 polegada padr o e a terceira coluna possui 2 polegadas Como somente metade da terceira coluna vis vel uma barra de rolagem horizontal aparece Vazio Todas as tr s colunas possuem a mesma largura 1 33 polegadas Ovalor padr o desta propriedade vazio o E3 ir utilizar o valor padr o do sistema ActiveX 219 7 3 7 2 8 Font A A propriedade Font utilizada para determinar a fonte do objeto Esta propriedade n o pode ser utilizada em scripts ou em associa es sendo configurada unicamente via Studio 7 3 7 2 9 IMEMode aP A propriedade IMEMode especifica o modo IME Input Method Editor de um objeto Essa propriedade aplica se apenas em aplicativos escritos em idiomas asi ticos chin s simplificado chin s tradicional coreano e japon s e ignorada em outros aplicativos El
9. VALOR DESCRI O 1 Habilita a barra de t tulo na janela 2 Habilita o bot o Fechar na janela 4 Habilita o bot o Minimizar na janela 8 Habilita o bot o Maximizar na janela 16 Habilita a borda na janela 32 Especifica que a janela pode ser dimensionada Para isso necess rio que a janela em quest o tenha borda 64 Especifica que a janela pode ser movida 256 Especifica que a janela ficar no topo da Tela 512 Especifica que a janela ser configurada no estilo Barra de Ferramentas 1024 Desabilita os bot es de objeto Exemplo Sub Tela OnPreshow Application Item top setFrameoptions Tela de Alarmes 114 End sub No exemplo anterior o valor 114 2 16 32 64 indica que a janela ter o bot o Fechar habilitado 2 ter uma borda 16 poder ser dimensionada 32 e poder ser movida 64 O t tulo da janela ser Tela de Alarmes Nos picks Abrir Tela e Abrir Tela Modal tamb m poss vel configurar o estilo da janela durante a edi o atrav s da caixa de di logo Estilo da Janela Para mais informa es veja o t pico Picks 326 Viewer 10 4 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto top 10 4 2 1 ISHTML PI A propriedade ISHTML retorna True se o divisor cont m c digos HTML inseridos no quadro Caso contr rio retorna False 10 4 2 2 Screen 58 Retorna a Tela pai do objeto Esta propriedade acess vel apenas em tempo de execu o
10. 7 3 9 3 29 TabkKeyBehavior PI Determina se as tabula es s o permitidas na regi o de edi o Se a propriedade estiver configurada para True ao pressionar a tecla TAB inserido um caractere de espa amento na regi o de edi o Caso contr rio ao pressionar TAB o foco passado para o pr ximo objeto na ordem de tabula o 7 3 9 3 30 Text Retorna o texto sendo digitado na op o selecionada Esta propriedade acess vel apenas em tempo de execu o 7 3 9 3 31 TextAlign P Especifica como o texto alinhado no objeto As op es dispon veis s o as seguintes e 1 fmTextAlignLeft alinha o texto com a extremidade esquerda do objeto e 2 fmTextAlignCenter centraliza o texto com o centro do objeto e 3 fmTextAlignRight alinha o texto com a extremidade direita do objeto 7 3 9 3 32 TextLensth 9 Retorna o n mero de caracteres digitados no objeto Esta propriedade acess vel apenas em tempo de execu o 7 3 9 3 33 Value o texto na rea de edi o 240 ActiveX 7 3 9 3 34 WordWrap F Habilita ou desabilita uma quebra de linha no texto caso a rea dispon vel para o texto ultrapasse os limites determinados no objeto Para que esta propriedade funcione a propriedade Multiline deve ser obrigatoriamente igual a True 7 3 10 Bot o Incremento Decremento Esta se o cont m informa es sobre eventos e propriedades do objeto Bot o Incremento Decremento Este objeto n o possui m to
11. E Esta propriedade especifica a cor do preenchimento do frente do objeto Esta cor utilizada quando a propriedade FillStyle est configurada para O s lido ou entre 2 e 9 Nos scripts utilize a fun o do VBScript RGB para montar a cora ser associada a esta propriedade O valor padr o para esta propriedade azul RGB 0 0 255 Exemplo Sub Botaol Click Troca a cor de fundo do botao para verde quando se clica no objeto Foregroundcolor RGB 0 255 0 End su 6 2 8 1 8 Format A A propriedade Format especifica que tipo de formato ser atribu do ao objeto Permite mudar a forma como os dados s o apresentados sem mudar o valor que existe por tr s deles Esta propriedade pode ser editada manualmente ou configurada atrav s da janela de formata o Seu uso semelhante aos formatadores usados nas planilhas de dados seguindo a mesma sintaxe S o suportados os seguintes tipos de dados Tipos de dados suportados por Format DADOS DESCRI O Num rico Sa da decimal cient fica hexadecimal bin ria e octal Texto Textos em geral Booleano Valores boleanos Data Hora Calend rio Gregoriano Telas e Objetos de Tela 167 6 2 8 1 9 GradientStyle a Esta propriedade especifica o estilo de preenchimento degrad do objeto Esta propriedade s ser utilizada quando a valor da propriedade FillStyle estiver configurada para 8 Gradient Os degrad s consideram a mud
12. GB Carregar valor Atribui o valor O para Carregar valor Mensagens 14 a hi N Design Scripts Configura es do pick Carregar Valor Op es dispon veis no pick Carregar Valor CAMPO DESCRI O Nome do tag Especifica o nome do tagno qual ser carregado o valor Pode se escolher o tag no AppBrowser apertando se o bot o a Valor Determina o valor que ser carregado no tag Pode se escolher o tipo de dados apertando a seta para baixo Introdu o 17 1 3 5 Inverter Valor Permite inverter o valor de um tag Se o valor do tag for igual a Valor1 ent o o tag recebe Valor2 Se o valor do tag for igual a Valor2 ent o o tag recebe Valor1 Se o valor do tag n o for igual a Valor1 nem Valor2 o tag recebe Valor1 poss vel colocar tantos picks Inverter Valor quanto o desejado Isso permite a verifica o de m ltiplos valores para um mesmo tag ou at mesmo para diversos tags em um mesmo evento J Tetatniciat aex 3 Telatnicial E click dosdpra x Eg a amp Click Fires when screen is dicked on iX Inverter valor Se o valor em for 0 troca para 0 sen o troca para O Inverter valor Nome do tag E Valor 1 po o Valor 2 po Mensagens m ocon o eny Configura es do pick Inverter Valor Op es dispon veis no pick Inverter Valor CAMPO DESCRI O Nome do E tag Aper
13. 10 4 2 3 SplitBorder F Habilita ou desabilita a borda do divisor e determina se a borda entre o divisor mandante e o divisor restante deve ser exibida em tempo de execu o Esta propriedade n o tem efeito no divisor restante O valor padr o desta propriedade True 10 4 2 4 SplitDockPosition P Indica a posi o do divisor desejado na Tela As op es dispon veis s o Op es dispon veis para SplitDockPosition OP O DESCRI O 0 dockRemaining Posiciona o divisor como restante ou seja ele ocupar o espa o que sobra na divis o horizontal ou vertical 1 dockTop Posiciona o divisor como mandante acima do restante 2 dockBottom Posiciona o divisor como mandante abaixo do restante 3 dockLeft Posiciona o divisor como mandante esquerda do restante 4 dockRight Posiciona o divisor como mandante direita do restante Viewer 327 10 4 2 5 SplitLink A A propriedade SplitLink cont m um ink que deve ser mostrado no divisor poss vel especificar uma Tela do projeto um execut vel ou um link na Internet No caso de Telas poss vel especificar um percentual de zoom e a habilita o das barras de rolagem usando a chave como no modelo lt nome da tela gt lt zoom gt lt barra de rolagem gt onde lt nome da tel a gt o nome da Tela a ser aberta lt Z00m gt o percentual de zoom e lt barra de ro lagem gt 1 para habil
14. 468 Bibliotecas de Usu rio la coin Bl Cogni o H DETE Bibliotecas de Objetos El Visualiza o Configurar Recursos OR ad Objetos de Servidor EM Explorer Menu de contexto da inst ncia do ElipseX Bibliotecas de Usu rio 469 21 1 2 Propriedades Esta se o cont m informa es sobre as propriedades dos objetos XControls e XObjects 21 1 2 1 CustomConfigText Indica o texto que dever aparecer no menu para a op o de configura o da inst ncia do ElipseX Aop o s ir aparecer se existir um script associado ao evento CustomConfig da defini o do ElipseX Se o valor da propriedade estiver em branco aparecer o texto Configurar na op o do menu O valor padr o desta propriedade vazio 21 2 Propriedades de um ElipseX Esta se o cont m informa es sobre eventos das Propriedades de um ElipseX Estas propriedades n o possuem m todos nem propriedades associadas 21 2 1 Eventos Esta se o cont m informa es sobre os eventos das Propriedades de um ElipsexX 21 2 1 1 OnPropertyChanged OnPropertyChanged Ocorre quando uma propriedade de um ElipseX modificada Pode se utilizar este evento para disparar scripts que executem a es de acordo com determinado status de um ElipseX 470 Bibliotecas de Usu rio CAP TULO Relat rios Esta se o cont m informa es sobre eventos m todos e propriedades do objeto Relat rio 22 1 Eventos E
15. 6 2 3 2 Frame Retorna o quadro pai do objeto Esta propriedade acess vel apenas em tempo de execu o 146 Telas e Objetos de Tela 6 2 3 3 HasFocus P Esta propriedade determina se o objeto selecionado est com o foco Esta propriedade acess vel apenas em tempo de execu o 6 2 3 4 Height 9 Apropriedade Height define a altura do objeto em unidades Himetric 6 2 3 5 Layer 9 Esta propriedade define em quais camadas o objeto deve aparecer Ovalor representa uma m scara de 32 bits um bit para cada camada Portanto podem ser definidas at 32 camadas individuais Assim objetos podem ser agrupados logicamente e mostrados ou escondidos apenas com a modifica o da m scara da propriedade Layer 6 2 3 6 MouseOver FI A propriedade MouseOver informa se o ponteiro do mouse encontra se em cima da Tela Caso afirmativo a propriedade MouseOver habilitada do contr rio ser False Esta propriedade somente de leitura e acess vel apenas em tempo de execu o O valor padr o desta propriedade False 6 2 3 7 MouseOverChild FI A propriedade MouseOverChild informa se o ponteiro do mouse encontra se em cima de um dos objetos inseridos na Tela Caso afirmativo a propriedade MouseOverChild habilitada Caso contr rio alterada para False Esta propriedade somente de leitura e acess vel apenas em tempo de execu o O valor padr o desta propriedade False 6 2 3 8 Screen 58 Retorna
16. Este m todo fecha a janela no Viewer Exemplo sub Botaol Click Application ExitO EndSub 10 2 7 GetFrame GetFrame FrameName O m todo GetFrame procura por um objeto divisor que j esteja aberto no Viewer atual Este m todo possui o par metro FrameName que opcional e determina o nome do quadro a ser buscado Caso o valor especificado em FrameName seja vazio ele retornar um quadro que cont m todos os divisores ou a Tela ativa no momento Com o retorno deste m todo utilize os m todos do divisor como por exemplo o m todo OpenScreen para abrir uma outra Tela Exemplo sub Botaol Click Ao clicar no Bot o pega o quadro Menu e substitui a Tela atual deste quadro pela tela Op es Set frame Application GetFrame Menu frame possui um objeto do tipo divisor frame 0openscreen op es O End sub 10 2 8 GetFullUserName GetFullUserName O m todo GetFullUserName retorna o nome completo do usu rio logado no E3 Caso n o haja nenhum usu rio logado retornada uma string vazia Viewer 303 10 2 9 GetValue GetValue TagName O m todo GetValue busca pelo valor de um objeto especificado no par metro Tag Name Se TagName apontar para uma propriedade este m todo retornar o valor da propriedade Se por outro lado o par metro TagName especificar um objeto o m todo retornar o valor da propriedade Value do objeto Exemplo sub Botaol Click Ao clicar no Bot o pega o valor de um
17. OP O DESCRI O 0 IgTop Mostra a legenda no topo 1 IgLeft Mostra a legenda esquerda 2 IgBottom Mostra a legenda na base 3 IgRight Mostra a legenda direita Exemplo Sub CommandButtonlO Click Screen Item E3Chart1 Legend LegendPos 3 End sub 18 9 2 3 ShowAllPens FI Quando a propriedade for True todas as penas do E3Chart s o mostradas na legenda A propriedade Visible da pena ignorada Quando em False somente as penas coma propriedade Visible igual a True ser o mostradas Exemplo Sub CommandButton1 clickQO Set E3Chartl Screen Item E3Chart1 E3chart1 Legend showallPens Not _ E3Chart1 Legend showal lPens End sub 456 E3Chart 18 9 2 4 ShowHeader Pl Determina a visibilidade do t tulo da legenda cabe alho Se a op o for configurada para True o t tulo da legenda mostrado Caso contr rio o t tulo fica invis vel Exemplo Sub CommandButton2 clickQO Screen Item E3Chart1 Legend showHeader False End sub 18 9 2 5 Size 9 Determina o tamanho da legenda Este tamanho pode significar a altura ou largura dependendo da posi o da legenda Exemplo Sub CommandButton13 click MsgBox Screen Item E3Chart1 Legend size End Sub 18 9 2 6 Visible PI Determina a visibilidade da legenda Se a op o estiver configurada como True a Legenda vis vel no E3Chart Caso contr rio fica invis vel Exemplo Sub CommandButton13 Click a reen
18. Sub circulol onStartRunningO verticalrilistyle 2 End sub 6 2 6 1 19 VerticalPercentFill 9 Utilize a propriedade VerticalPercentFill para especificar qual a porcentagem da rea vertical do objeto dever ser preenchida Os valores aceitos por esta propriedade variam de 0 a 100 Esta propriedade trabalha em conjunto com a propriedade VerticalFillStyle que informa como este preenchimento ocorrer O valor padr o desta propriedade 100 Exemplo Sub circulol OnStartRunningO VerticalPercentFill 254 End sub 6 2 7 Texto Display e SetPoint Esta se o cont m informa es sobre eventos e propriedades dos objetos Texto Display e SetPoint Estes objetos n o possuem m todos associados 158 Telas e Objetos de Tela 6 2 7 1 Eventos Esta se o cont m informa es sobre os eventos dos objetos Texto Display e SetPoint 6 2 7 1 1 Validate Validate Cancel NewValue Ocorre ap s os testes de limites do SetPoint ver propriedades MinLimit MaxLimit EnableLimits e antes do valor do SetPoint ser enviado para o tag Afinalidade deste evento permitir que o usu rio cancele o envio do valor do SetPoint para o tag O par metro Cancel booleano e indica se a opera o de atribui o do valor do SetPoint ao tag deve ser cancelada Cancel igual a True O padr o False ou seja o valor do SetPoint ser enviado ao tag NewValue o valor que est sendo avaliado O valor antigo pode ser acessado pela propried
19. 2 fmSpecialEffectSunken O objeto possui uma sombra na parte superior esquerda e um destaque na parte inferior direita Oobjeto e a sua borda parecem estar afundados na Tela 3 fmSpecialEffectEtched Aborda parece estar esculpida ao redor da extremidade do objeto 6 fmSpecialEffectBump O objeto possui um ressalto na parte inferior direita e parece plano na parte superior esquerda ActiveX 229 7 3 8 2 12 TextAlign a Especifica como o texto alinhado no objeto As op es dispon veis s o as seguintes e 1 fmTextAlignLeft alinha o texto com a extremidade esquerda do objeto e 2 fmTextAlignCenter centraliza o texto ao centro do objeto e 3 fmTextAlignRight alinha o texto com a extremidade direita do objeto 7 3 8 2 13 TripleState F A propriedade TripleState determina at tr s estados de valores para o objeto Se a propriedade estiver configurada para True o usu rio poder escolher entre tr s op es de estados Falso Verdadeiro ou Nulo O valor Nulo exibido como um bot o sombreado Caso contr rio o usu rio pode escolher entre os valores False ou True O valor padr o desta propriedade False 7 3 8 2 14 Value Indica o valor inicial do objeto Tem comportamento booleano se True o objeto inicia marcado do contr rio seu estado inicial n o marcado O valor padr o desta propriedade False 7 3 8 2 15 WordWrap F Habilita ou desabilita uma quebra d
20. A Especifica o arquivo de figura para o objeto As extens es permitidas s o bmp gif jpg cur ico emfe wmf O valor padr o desta propriedade vazio Relat rios 505 22 6 4 1 8 PictureAlignment P Determina o alinhamento da figura no objeto As op es dispon veis s o as seguintes Op es dispon veis para PictureAlignment OP O DESCRI O 0 ddPATopLeft Alinha a figura no topo esquerdo do objeto 1 ddPATopRight Alinha a figura no topo direito do objeto 2 ddPACenter Alinha a figura no centro do objeto 3 ddPABottomLeft Alinha a figura esquerda do objeto 4 ddPABottomRight Alinha a figura direita do objeto Ovalor padr o desta propriedade 2 ddPACenter 22 6 4 1 9 SizeMode aP Especifica o tamanho do objeto As op es dispon veis s o as seguintes Op es dispon veis para SizeMode OP O DESCRI O O ddsMClip Mostra o objeto no seu tamanho atual 1 ddsMStretch Ajusta o objeto de acordo com a sua rea 2 ddsMZoom Ajusta a altura ou a largura da imagem do objeto dentro da rea especificada sem distorc la 506 Relat rios 22 6 5 SetPoint Esta se o cont m informa es sobre propriedades do objeto SetPoint do Relat rio Este objeto n o possui eventos nem m todos associados 22 6 5 1 Propriedades Esta se o cont m informa es sobre as propriedades do
21. Administrador Senha eee Coment rios pr definidos ultimo coment rio oa Coment rio Novo coment rio Caixa de Di logo de Assinatura Eletr nica Par metros do m todo Esign NOME DESCRI O ObjName Texto que cont m o nome de um tag ou outro objeto da aplica o 300 Viewer NOME DESCRI O Description Texto que cont m a descri o de ObjName Este par metro opcional e se for omitido a caixa de di logo tentar buscar os dados da propriedade DocString de ObjName Action Texto que cont m a a o a ser executada por exemplo Altera o do valor Este par metro opcional e o seu valor padr o uma string vazia From Variant que cont m o valor original ou o estado que vai ser alterado Este par metro opcional To Variant que cont m o novo valor do tag ou o valor a ser aplicado em Action Este par metro opcional User Texto de retorno Recebe o nome de login digitado na caixa de di logo Este par metro opcional Comment Texto de retorno Recebe o coment rio digitado na caixa de di logo Este par metro opcional Este m todo retorna True se o usu rio pressionar OKe se os campos Usu rio e Senha forem v lidos Caso contr rio se a caixa de di logo for cancelada ouse o login ou a senha estiverem errados ap s tr s tentativas o m todo retorna False
22. CAMPO DESCRI O Abrir atela Indica qual Tela deve ser aberta No quadro Indica o Quadro onde a Tela ser visualizada Se estiver em branco ser o Quadro principal _top Zoom inicial Define o zoom da Tela quando mostrada 12 Introdu o CAMPO DESCRI O Par metro Indica um par metro a ser passado na chamada da Tela Habilitar scroll da Habilita o uso das barras de rolagem na Tela tela Especificar posi o Indica a posi o da Tela em pixels datela Especificar tamanho Indica o tamanho da Tela em pixels ou HIMETRIC datela Estilo da janela Chama a caixa de di logo Estilo de janela 1 3 1 1 Caixa de Di logo Estilo de Janela Permite configurar o estilo da janela a ser mostrada definindo t tulo e a disponibilidade das bordas e bot es de fechar maximizar e minimizar entre outros Se a op o Usar configura o padr o das janelas for marcada o sistema desabilita as op es desta janela e assume a configura o padr o do Viewer conforme o que pode ser visto na aba Visualizador das propriedades do objeto Viewer Introdu o 13 Estilo da janela E Op o de redimensionar Barra de titulo menor E Ej Ej Ej E E Ej E E Fj Bj OOOO Caixa de di logo Estilo de Janela 14 Introdu o 1 3 2 Abrir Tela Modal Abre uma Tela Modal isto uma Tela que n o perm
23. Este m todo retorna True se o cursor foi movido caso contr rio retorna False E3Chart 433 18 5 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Pena 18 5 2 1 AutoQuery PI Determina consulta autom tica da pena Se True a pena requer o uso da consulta autom tica Do contr rio a consulta autom tica n o ser utilizada Aconsulta autom tica n o poder ser utilizada nos seguintes casos e Quando o SQL customizado pelo usu rio e Quandose est utilizando Storage e Quandose est utilizando v rias tabelas 18 5 2 2 AverageY 9 Informa a m dia da pena no intervalo caso a propriedade EnableCalc esteja habilitada Caso o E3Chart esteja no modo de Pesquisa de Intervalos mostra a m dia neste intervalo do contr rio mostra a m dia no intervalo entre o in cio e o fim no eixo horizontal Valores com qualidade ruim n o s o considerados caso a propriedade ShowBadPoints esteja desabilitada Esta propriedade somente de leitura 18 5 2 3 BkColor E Determina a cor de fundo usada em uma pena do tipo rea O valor padr o desta propriedade vazio Exemplo Sub CommandButtonl clickO Set Pen1 Screen Item E3Chart1 Pens Item Pen1 Peni BkColor RGB 255 0 0 End sub 18 5 2 4 BufferSize 9 Determina o n mero de pontos mantidos na pena de tempo real Ap s este valor os dados mais antigos s o descartados Nas penas hist ricas esta propriedade n o tem efeito
24. Foregroundcolor RGB 255 0 0 End sub 2 7 3 7 PathContainer Retorna um String contendo o caminho do objeto que cont m o objeto atual incluindo as pastas Este valor determinado apenas no momento em que for requisitado por isso n o recomendado criar associa es para esta propriedade 2 7 3 8 PathName Identifica o caminho do objeto no sistema Esta propriedade acess vel apenas em tempo de execu o Exemplo Sub commandButton9 click MsgBox O path da Tela amp Screen PathName End Sub 50 Programando no E3 2 7 3 9 PathVolume Retorna um String contendo o nome do arquivo prj ou lib que cont m o objeto No E3 Studio a propriedade retorna o caminho completo do projeto ou biblioteca c MolderYolderiwolume prj Em tempo de execu o os objetos que rodam no Viewer retornam sempre um String vazio J os que rodam no servidor retornam o caminho relativo do projeto ou biblioteca conforme ele esteja armazenado no Dom nio volume prj Este valor determinado apenas no momento em que for requisitado por isso n o recomendado criar associa es para esta propriedade Programando no E3 51 CAP TULO Drivers Esta se o cont m informa es sobre eventos m todos e propriedades dos seguintes objetos Driver de Comunica o Tag de Comunica o Bloco de Comunica o Elemento de Bloco de Comunica o Driver de Comunica o OPC Tag de Comunica o OPC Bloco de Comuni
25. IsWebViewer Verifica se o aplicativo est sendo visualizado pelo E3 WebViewer O m todo retorna True se a aplica o estiver sendo executada no E3 WebViewer Caso contr rio retorna False Viewer 305 10 2 15 LoadFormulaDIg LoadFormulaDIg FormulaName UnitName ValueName Este m todo apresenta uma caixa de di logo que permite ao usu rio escolher o conjunto de valores e a unidade de destino carregando uma f rmula Este m todo possui o par metro FormulaName que determina o nome do objeto da f rmula que ser operada Utilize o m todo LoadFormulaDlg para chamar uma caixa de di logo para carregamento dos dados do objeto F rmula especificado por FormulaName Nesta caixa poss vel especificar qual conjunto de valores UnitName ser enviado para qual conjunto de tags ValueName Nesta caixa de mensagem o usu rio conta com todos os conjuntos de valores e unidades dispon veis no objeto F rmula podendo atribuir um a outro livremente Quando o usu rio clicar em OK o conjunto de valores ser carregado na unidade especificada Exemplo sub Botaol Click Chama a caixa de di logo para operar Dim val APP ication LoadFormulaDlg Formula1l End Su 10 2 16 LoadFormulaValues LoadFormulaValues FormulaName UnitName ValueName Este m todo carrega automaticamente um conjunto de valores para uma unidade de destino apresentando uma caixa de di logo que permite ao usu rio informar valores diferentes daq
26. O Booleano Retorna Verdadeiro True ou Falso False 9 Num rico Retorna positivo negativo inteiro ou double a ser definido pela propriedade ER Data Retorna uma data em formato Gregoriano desde 1899 A Texto Retorna um texto Variant Retorna um tipo Vari vel que pode assumir v rios formatos a Cor Retorna uma cor no formato RGB pci Link Retorna uma associa o entre objetos aP Enum Retorna um conjunto determinado de valores 48 Programando no E3 Algumas propriedades podem propagar seus valores mesma propriedade em seus objetos filhos Neste caso s o chamadas de propriedades propag veis Pode se no entanto for ar a propriedade do objeto filho a se comportar de modo diferente 2 7 3 1 Application A propriedade Application retorna o objeto de aplica o relacionado a este objeto Com o objeto aplica o poss vel por exemplo buscar outros objetos presentes no aplicativo Exemplo sub Telal click Quando clica na tela faz busca por um tag Dim obj Set a plication Getobject Dados TagInternol obj value 100 End Sub 2 7 3 2 Count 9 Retorna o n mero de objetos filhos itens que o objeto possui Esta propriedade funciona em conjunto com o m todo Item Se o objeto n o possuir filhos o valor retornado ser 0 Exemplo Sub Telal click Num clique de tela faz a busca por todos os objetos da tela e ajusta a propriedade ForegroundC
27. e 1 fmEnterFieldBehaviorRecallSelection deixa a sele o inalterada 7 3 9 3 13 EnterKeyBehavior FP Define o efeito da tecla ENTER no objeto Se esta propriedade estiver configurada para True ao pressionar a tecla ENTER uma nova linha criada na rea de edi o do texto no objeto Caso contr rio ao pressionar a tecla ENTER o foco passado para o pr ximo objeto da ordem de tabula o Isto tamb m ocorre se a propriedade Multiline estiver configurada para False independente do valor da propriedade EnterKeyBehavior Acombina o das teclas CTRL ENTER tamb m depende do valor da propriedade Multiline Se esta propriedade estiver configurada para True ao pressionar estas teclas uma nova linha criada na rea de edi o do texto do objeto independente do valor da propriedade EnterKeyBehavior Se a propriedade for False as teclas n o ter o efeito sobre o texto 7 3 9 3 14 Font A A propriedade Font utilizada para determinar a fonte do objeto Esta propriedade n o pode ser utilizada em scripts ou em associa es sendo configurada unicamente via Studio ActiveX 235 7 3 9 3 15 HideSelection F A propriedade HideSelection especifica se o texto selecionado continua em destaque quando um objeto n o tem mais o foco Se a propriedade estiver configurada para True o texto selecionado n o est em destaque a menos que o objeto tenha o foco Caso contr rio o texto selecionado sempre aparece em destaque O valor padr
28. o do script Olocal do cursor mostrado atrav s da anima o com uma seta piscante 2 2 Declarando Vari veis poss vel declarar vari veis de duas maneiras implicitamente ou explicitamente Para declarar uma vari vel implicitamente basta usar seu nome no script Automaticamente a vari vel ser criada e inicializada com o valor da atribui o ou permanecer EMPTY vazia sem nenhum valor caso n o receba nenhum valor antes de ser utilizada Esta uma pr tica r pida por m se o script for muito extenso isto pode causar confus o e a cria o de mais de uma vari vel com o mesmo nome gerando bugs no script Para declarar vari veis explicitamente utiliza se o comando Dim como no exemplo Dim Temperatura Pode se declarar m ltiplas vari veis separando cada nome de vari vel com uma v rgula Por exemplo Dim Esquerda Direita Topo Base Em virtude dos scripts no E3 serem todos associados a um objeto em particular as vari veis s o sempre locais v lidas apenas para o escopo do script Para ter se vari veis p blicas ou globais deve se criar um taginterno e utiliz lo para armazenar o valor desejado 2 3 Obtendo refer ncias aos objetos Uma das caracter sticas mais importantes ao se trabalhar com scripts dentro do E3 considerar a separa o existente entre os processos que s o executados no servidor e aqueles executados na interface do cliente E3 Viewer Para se trabalhar com scripts pode s
29. reas de Alarme Fontes de Alarme e Servidor de Alarmes 12 1 Configura o de Alarmes Oobjeto Configura o de Alarmes n o cont m eventos m todos ou propriedades espec ficos somente gerais Estes podem ser visualizados na se o Eventos M todos e Propriedades Gerais dos Objetos 12 2 reas de Alarme Esta se o cont m informa es sobre propriedades do objeto rea de Alarme Este objeto n o possui eventos nem m todos associados 12 2 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto rea de Alarme 12 2 1 1 ActiveAlarms 9 Determina o n mero de alarmes ativos dentro da rea do sistema Se esta propriedade estiver com valor 0 os alarmes que est o desativados ser o listados atrav s da propriedade ActiveNACKAlarms Esta propriedade somente de leitura O valor padr o desta propriedade O 12 2 1 2 ActiveHighAlarms 9 Indica o n mero de alarmes ativos com severidade alta Esta propriedade somente de leitura Alarmes 333 12 2 1 3 ActiveHighNACKAlarms 9 Indica o n mero de alarmes n o reconhecidos com severidade alta Esta propriedade somente de leitura 12 2 1 4 ActivelLowAlarms 9 Indica o n mero de alarmes ativos com severidade baixa Esta propriedade somente de leitura 12 2 1 5 ActiveLowNACKAlarms 9 Indica o n mero de alarmes n o reconhecidos com severidade baixa Esta propriedade somente de leitura 12 2 1 6 ActiveMedAlarms 9 In
30. somente de leitura mas pode ser modificada em tempo de execu o 16 3 14 Screen 58 Retorna a Tela pai do objeto Esta propriedade acess vel apenas em tempo de execu o 16 3 15 SQL A Cont m o c digo SQL especificado para a consulta Esta propriedade somente para leitura mas pode ser modificada em tempo de execu o Consultas 397 16 3 16 Table A A propriedade Table cont m as tabelas que ser o consultadas por exemplo Alarms a tabela de alarmes ou eventos Corresponde ao argumento da cl usula FROM do c digo SQL da consulta Esta propriedade somente de leitura mas pode ser modificada em tempo de execu o 16 3 17 Where Determina a condi o da consulta que filtra os registros da tabela a serem visualizados ou seja s ser o visualizados os registros que satisfizerem a condi o Corresponde ao argumento WHERE do c digo SQL da consulta Esta propriedade somente de leitura mas pode ser modificada em tempo de execu o 398 Consultas CAP TULO E3Browser Esta se o cont m informa es sobre eventos m todos e propriedades do objeto E3Browser 17 1 Eventos Esta se o cont m informa es sobre os eventos do objeto E3Browser 17 1 1 KeyPress KeyPress KeyAscii Ocorre quando o E3Browser tem o foco de teclado e o usu rio pressiona uma tecla que corresponde a um caractere que pode ser mostrado em tela uma tecla ANSI de c digo indicado na vari vel KeyA
31. 069 070 071 112 Drivers SUBSTATUS DESCRI O LIMITES SEM BAIXO ALTO CONSTANTE buscado poss vel de ser detectada Este erro associado falha de alguma fonte externa que iria atualizar o valorem um per odo aceit vel A idade do dado pode ser determinada atrav s da propriedade TimeStamp N A N o usado 072 079 Sensor sem precis o Ovalor est colado em um dos limites do sensor nesse caso o campo Limite deve estar ajustado para 10u2 ouo sensor est de algum modo conhecido fora de calibra o nesse caso Limite deve ser 0 080 081 082 083 Unidade de engenharia excedida Ovalor retornado est fora dos limites definidos para esse par metro Note que nesse caso o valor em Limite indica quais limites foram excedidos mas n o necessariamente implica que o valor n o possa ir al m da faixa especificada 084 085 086 087 Subnormal O valor derivado de m ltiplas fontes e h um n mero menor do que o requerido de boas fontes 088 089 090 091 N A N o usado 092 127 Drivers 113 Substatus para Qualidade Boa 192 255 SUBSTATUS DESCRI O LIMITE SEM BAIXO ALTO CONSTANTE N o especificado Ovalor bom mas 192 193 194 195 nenhuma raz o espec fica conhecida N o utili
32. 12 4 2 15 EnableDiscard FP Indica descarte dos dados dos alarmes ap s um certo tempo Se configurada para False os dados ser o armazenados indefinidamente na tabela do contr rio ser o descartados ap s determinado tempo O valor padr o dessa propriedade False 12 4 2 16 Logging P Cria o registro das informa es dos alarmes no banco de dados especificado pela propriedade DataSource Se configurado para False o registro n o criado do contr rio o registro feito O valor padr o desta propriedade False 12 4 2 17 TableName Define um nome para a tabela de alarmes O valor padr o Alarms Pode ser modificada em tempo de execu o e seu efeito ser imediato Alarmes 357 12 4 2 18 VerificationInternal 9 Esta propriedade trabalha em conjunto com a propriedade VerificationUnit para controlar o intervalo de tempo que o E3 verifica a antiguidade dos dados para depois descart los Ovalor padr o desta propriedade 1 uma unidade de tempo indicada em VerificationUnit 12 4 2 19 VerificationUnit Esta propriedade trabalha em conjunto com a propriedade VerificationInternal A propriedade VerificationUnit indica a unidade de tempo em que ser feita a verifica o para descarte dos dados As op es dispon veis s o 0 dtHour horas 1 dtDay dias e 2 dtMonth meses padr o e 3 dtMinute minutos 358 Alarmes CAP TULO E3Alarm Esta se o cont m informa es sobre event
33. 22 6 3 1 3 LineWeight 9 Especifica a largura da linha do objeto Configurando a largura para 1 a linha do objeto expandida em at 15 pontos se for 2 a linha expandida em at 30 pontos e assim por diante Quanto maior o n mero configurado na propriedade maior a largura do objeto O valor padr o desta propriedade 1 22 6 3 1 4 Shape P permite alterar a forma do objeto As op es dispon veis s o as seguintes Op es dispon veis para Shape OP O DESCRI O O ddSHRectangle Formato Retangular 1 ddSHEllipse Formato Eliptico ou Circular 2 ddSHRoundRect Formato de Ret ngulo Arredondado 22 6 4 Figura Esta se o cont m informa es sobre propriedades do objeto Figura do Relat rio Este objeto n o possui eventos nem m todos associados Relat rios 503 22 6 4 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Figura do Relat rio 22 6 4 1 1 DataField A Configura ou retorna o dado associado ao objeto Este dado associado pode ser um campo da tabela no Banco de Dados fornecido pelo objeto Consulta uma express o matem tica com campos da Consulta e fun es do VBScript neste caso o campo deve ser precedido do s mbolo de igual ou um tagou propriedade do E3 Neste caso o valor atual da vari vel ser mostrado ao realizar a impress o O valor padr o desta propriedade vazio 22 6 4 1 2 Forecolor E Espec
34. Ao simplesmente informar o nome de um filtro como exposto acima os dados ser o exportados utilizando se as propriedades em comum de cada filtro Pode se modificar as propriedades comuns de um filtro de exporta o atrav s do m todo GetExportFilter antes de exportar os dados O nome do arquivo deve ser informado no par metro strExportFileName Exemplo Sub Buttonl Click Set report application LoadReport Relat rio3 Select case App ication select Menu GEDEN ceTIHTHEIRTE Texto ITTERITEtO CN Case Report Export PDF C correio reports report pdf MsgBox Exportado para PDF Case 2 Report Export EXCEL C correio reports report XLS MsgBox Exportado para XLS Case 3 Report Export HTML C correio reports report html MsgBox Exportado para HTML Case 4 Report Export RTF C correio reports report rtf MsgBox Exportado para RTF Case 5 Report Export TEXT C correio reports report txt MsgBox Exportado para TXT Case 6 Report Export TIFF C correio reports report tiff MsgBox Exportado para TIFF Case 7 Set reportFilter report GetExportFilter TEXT reportFilter FileName C correio reports report2 txt reportFilter TextDelimiter report Export reportFilter MsgBox Exportado para TXT usando filtro End Select End Sub 22 2 2 GetExportFilter GetExportFilter FilterName Retorna um objeto que especifica a customiza o dos par metros de exporta o Este m todo possui o pa
35. Avon NC USA 27915 Fone 252 995 6885 Fax 252 995 5686 E mail infogelipse software com Alemanha D 67714 Waldfischbach Deutschland Fone 49 0 6333 4439 Fax 49 0 6333 2790045 E mail elipseGelipse de Consulte nosso website para informa es sobre o representante do seu estado www elipse com br elipsegelipse com br Microsoft GOLD CERTIFIED Partner Filial MG Av do Contorno 6594 17 andar Sala 01 30110 044 Belo Horizonte MG Fone 31 3555 3366 Fax 31 3555 3399 E mail elipse mgeelipse com br Filial PR Av Sete de Setembro 4698 1705 80240 000 Curitiba PR Fone 41 3342 0120 Fax 41 3342 0120 E mail elipse preelipse com br Taiwan 15F 1 No 56 Minsheng 1 st Rd 800 Kaohsiung City Taiwan Fone 886 7 2221582 Fax 886 7 2225909 E mail evanQelipse com br
36. End sub Os comandos anteriores s o equivalentes o primeiro indicando o ndice da pena na cole o e o segundo indicando o nome 2 6 Comando Set O VBScript implementa o conceito de polimorfismo das linguagens orientadas a objeto permitindo que uma vari vel do tipo Variant assuma a forma de um objeto qualquer atrav s do comando Set Deste modo a vari vel funciona como um ponteiro do objeto desejado permitindo acessar seus m todos e propriedades Exemplo Programando no E3 41 Sub CommandButtonl clickQO set E3Chart Screen Item E3Chart1 E3chart Pens Item 2 Color RGB 212 208 20 End sub Neste exemplo foi feita a mesma tarefa que na se o anterior por m a parte referente a como chegar at o objeto espec fico havia sido omitida Sem o comando Set a mesma chamada teria que ser Screen Item E3cChart1 Pens Item 2 Color RGB 212 208 20 Aparentemente n o existe vantagem neste caso pois pode se fazer tudo em uma nica linha de c digo Por m se logo abaixo no mesmo script outras opera es forem necess rias o processo se torna mais simples e r pido se a chamada do m todo Item n o tiver sido colocada em todas as linhas Sub CommandButtonl clickQO Exemplo ruim Screen Item E3Chart1 Pens Item 0 Color Screen Item E3Chart1 Pens Item 1 Color Screen Item E3Chart1 Pens Item 2 Color End sub RGB 212 208 20 RGB 200 208 20 RGB 100 208 20 Sub CommandButton2 Click
37. MaxLimit Screen Item Texto6 value End sub 6 2 7 2 6 MinLimit 9 Cont m o valor m nimo permitido no objeto a propriedade EnableLimits deve ser True Exemplo Sub commandButton2 click Screen Item Textol MinLimit screen Item Texto5 value End sub 6 2 7 2 7 Multiline PI A propriedade Multiline indica se o texto ter m ltiplas linhas True ou se ser uma caixa de texto simples False Isto pode ser visualizado quando o objeto Viewer est em execu o O valor padr o desta propriedade False Exemplo Sub Telal OnStartRunningO Screen Item TextBox1 Multiline True End sub 6 2 7 2 8 SetPointDataType a Determina o tipo de valor que enviado do SetPoint para o tag Op es dispon veis para SetPointDataType OP O DESCRI O 0 stCurrentType Mant m otipo do valor atual no SetPoint ver a seguir 1 stChar Valor inteiro de 8 bits com sinal 2 stByte Valor inteiro de 8 bits sem sinal 3 stWord Valor inteiro de 16 bits sem sinal 4 stinteger Valor inteiro de 16 bits com sinal 5 stLong Valor inteiro de 32 bits com sinal Telas e Objetos de Tela 161 OP O DESCRI O 6 stDWord Valor inteiro de 16 bits sem sinal 7 stSingle Valor de ponto flutuante de 32 bits 8 stDouble Valor de ponto flutuante de 64 bits 9 stDateTime Valor de data hora 10 stString Texto Quando o t
38. O valor padr o desta propriedade 5 6 2 8 1 22 TickPercentSize 9 Determina o tamanho das linhas que dividem o objeto Escala Conforme for o valor especificado nesta propriedade maior ou menor ficar o tamanho da linha da divis ria padr o da escala O valor padr o desta propriedade 20 6 2 9 Animar com Transla o Esta se o cont m informa es sobre propriedades do objeto Animar com Transla o Este objeto n o possui eventos nem m todos associados 6 2 9 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Animar com Transla o 6 2 9 1 1 Angle 9 Apropriedade Angle define o ngulo de rota o em graus no sentido anti hor rio que o objeto deve ser rotacionado Isto tamb m se aplica aos filhos que este objeto tiver respeitando as limita es de rota o de cada objeto filho O objeto rotacionar de acordo com o seu centro que pode ser editado durante a opera o de rota o O valor padr o desta propriedade O sem rota o Exemplo sub Arcol Click Angle 180 End Sub 6 2 9 1 2 Detents 9 atrav s da propriedade Detents determinado o n mero de passos do movimento no objeto Exemplo Sub CommandButton1 clickQO MsgBox Screen Item DynamicRotatel Detents End Sub 172 Telas e Objetos de Tela 6 2 9 1 3 EnableOverrideLineColor P Esta propriedade habilita ou desabilita o objeto a sobrescrever a cor original da linha da imagem pela cor defini
39. P Esta propriedade determina a aplica o de extens o stretch ao texto do objeto Escala caso a largura ou altura da escala seja alterados o texto acompanha esta varia o Se a propriedade estiver habilitada o objeto acompanha as varia es de altura e largura do objeto conforme for transformado Caso contr rio o texto permanece com as configura es iniciais Ovalor padr o desta propriedade False 6 2 8 1 18 TextAlignment aP A propriedade TextAlignment determina o alinhamento do texto no objeto Op es dispon veis para TextAlignment OP O DESCRI O 0 leftAlignment Oalinhamento do texto ser esquerda padr o 1 centerAlignment Oalinhamento do texto ser centralizado 2 rightAlignment Oalinhamento do texto ser direita 6 2 8 1 19 TextColor E Determina a cor da fonte aplicada na legenda com n meros do objeto Escala Para determinar a cor da linha com as marcas divis rias e subdivis rias da escala utilize a propriedade LineColor O valor padr o desta propriedade preto RGB 0 0 0 6 2 8 1 20 TextFont A A propriedade TextFont determina a fonte que ser aplicada na escala Afonte escolhida ser aplicada em todo o objeto Escala Esta propriedade n o pode ser utilizada em scripts ou associa es e configurada somente via Studio Telas e Objetos de Tela 171 6 2 8 1 21 Ticks 9 Determina a quantidade de divis rias que a escala ter
40. Value End If End sub 286 Associa es 9 6 1 3 BlinkOn FI Quando esta propriedade estiver configurada para True a propriedade conectada ir alternar periodicamente entre os valores da propriedade OnValue e BlinkOnValue caso a fonte retorne True Exemplo sub Blinkon Change O On Error Resume Next Dim Bind set Bind screen Item Retangulo1 Links Item Foregroundcolor If Bind Is Nothing Then MsgBox Retangulol n o tem associa o se MsgBox Retangulol est associado a amp Bind Source amp MsgBox Mudando Blinkon de amp Bind Blinkon amp para amp value Bind Blinkon Value End If End sub 9 6 1 4 BlinkOnValue Especifica o valor alternativo a ser assumido periodicamente pela propriedade quando a express o da fonte resultar em True e a propriedade BlinkOn estiver configurada para True Exemplo Sub Blinkonvalue Click On Error Resume Next Dim Value If application showpPickColor value Foregroundcolor 400 300 Then Dim Bind set Bind Screen Item Retangulo1l Links Item Foregroundcolor If Bind Is Nothing Then AE eSA Retangulol n o tem associa o Else MsgBox Retangulol est associado a amp Bind Source amp MsgBox Mudando Blinkonvalue de amp Bind Blinkonvalue amp para amp Value Bind Blinkonvalue Value End If Foregroundcolor Value End If End sub 9 6 1 5 OffValue Especifica o valor assumido pela propriedade quando a express o da
41. o OPC Esta se o cont m informa es sobre as propriedades do objeto Bloco de Comunica o OPC Este objeto n o possui eventos nem m todos associados 3 7 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Bloco de Comunica o OPC 3 7 1 1 AdviseType P Controla o modo Advise As op es dispon veis s o Op es dispon veis para AdviseType OP O DESCRI O 0 AlwayslnAdvise Otag mantido atualizado se a propriedade AllowRead do Bloco OPC for True e a propriedade Enabled do Grupo OPC tamb m for True 1 AdviseWhenLinked Otags atualizado se a propriedade AllowRead do Bloco OPC e a propriedade Enabled do Grupo OPC forem True e o tagestiver associado a algum objeto ativo por exemplo um Display de uma Tela aberta um Alarme habilitado entre outros Aassocia o do tag para esse prop sito pode ser feita nas seguintes propriedades Value RawValue Quality e BitOO at Bit31 de Elementos de Bloco OPC e Quality e TimeStamp de Blocos OPC Exemplo Sub CommandButton3 clickQO MsgBox Application Getobject DriverOPC GrupooPC SCRIPT1 AdviseType End sub 100 Drivers 3 7 1 2 AllowRead FI configure esta propriedade para definir se este bloco dever ou n o ser lido pelo driver OPC Caso a propriedade AllowRead esteja configurada para True ent o o driver automaticamente atualizar as propriedades
42. o com outros objetos Driver de Comunica o Esta propriedade n o pode ser modificada ap s iniciada a comunica o O valor padr o desta propriedade False 3 1 3 12 WriteFeedbackMode aP Esta propriedade permite controlar a confirma o ou feedback das escritas em tags aplic vel somente a tags que possam ser lidos ou seja possuam a propriedade AllowRead em True Atrav s desta propriedade poss vel tornar mais imediata a leitura de tags que recebem escritas Esta propriedade possui as seguintes op es de configura o 60 Drivers Op es dispon veis para WriteFeedbackMode OP O DESCRI O 0 wfWaitNextRead Aleitura do tag ser feita normalmente no pr ximo scan 1 wflmmediateReadAfterWrite Ap s cada escrita uma leitura de confirma o ser feita o mais cedo poss vel 2 wfTrustWriteSuccess Se o driver indicar sucesso na escrita o valor escrito assumido diretamente pelo tag sem l lo do PLC Ovalor padr o desta propriedade 1 wflmmediateReadAfterWrite Aplica es anteriores exist ncia desta propriedade assumem o valor O wfWaitNextRead quando carregadas Exemplo sub commandButtonl Click Dim modo modo Application Getobject Driver1 writeFeedbackmode MsgBox modo select case modo Case 0 MsgBox A leitura do tag ser feita no pr ximo scan Case MsgBox Ap s cada escrita uma leitura de confirma o _ ser feita
43. value Screen Item Texto10 value Application Loginuser a b End sub 10 2 21 Logout Logout Mode Executa o logout sa da do usu rio atual da aplica o do Viewer Caso n o haja um usu rio logado este m todo n o tem efeito A partir deste momento ser considerado que um usu rio an nimo est utilizando a aplica o Pode se utilizar o evento OnLogout para executar um script para ir para a Tela inicial ou finalizar a aplica o Este m todo possui o par metro opcional Mode que um booleano que determina se uma mensagem de confirma o ou falha da opera o dever ser mostrada o padr o False Exemplo Sub TelaInicial onPreshow varg Application Logout True End Sub 10 2 22 PasswordConfirm PasswordConfirm Mode O m todo abre um di logo solicitando a reconfirma o da senha do usu rio atualmente logado O m todo retorna True se a senha for confirmada ou False caso contr rio O par metro booleano Mode determina se deve ser dado um logout em caso de falha na confirma o True ou n o False Se a caixa de di logo for fechada atrav s do bot o Cancelar o m todo retorna False Caso n o haja usu rio logado o m todo retorna False mas sem abrir a caixa de di logo Caso a senha digitada n o esteja correta a solicita o repetida at no m ximo tr s vezes Se o usu rio digitar a senha incorreta nestas tr s vezes a caixa de di logo fechada e o m todo retorna False
44. 12 3 3 1 19 LoLoMessageText A Ajusta a mensagem de texto do limite do alarme de tipo LoLo 12 3 3 1 20 LoLoSeverity a Indica o n vel de import ncia do alarme de tipo LoLo As op es s o e O Alta e 1 M dia e 2 Baixa 12 3 3 1 21 LoMessageText A Ajusta a mensagem de texto do limite do alarme de tipo Lo 12 3 3 1 22 LoSeverity a Indica o n vel de import ncia do alarme de tipo Lo As op es s o e O Alta e 1 M dia e 2 Baixa Alarmes 347 12 3 4 Fonte de Alarme Digital Esta se o cont m informa es sobre propriedades do objeto Fonte de Alarme Digital Este objeto n o possui eventos nem m todos associados 12 3 4 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Fonte de Alarme Anal gico 12 3 4 1 1 Digital F Habilita ou desabilita a verifica o de alarme digital 12 3 4 1 2 DigitalAckRequired FI Necessidade de reconhecimento para o alarme digital 12 3 4 1 3 DigitalLimit 9 Limite para o alarme digital 12 3 4 1 4 DigitalMessageText Texto da mensagem de alarme digital 12 3 4 1 5 DigitalReturnMessageText A Mensagem de retorno do alarme digital 12 3 4 1 6 DigitalSeverity P severidade do alarme digital Conjunto de valores e O Alta e 1 M dia e 2 Baixa 348 Alarmes 12 3 5 Fonte de Alarme Banda Morta Esta se o cont m informa es sobre propriedades do objeto Fonte de Alarme Banda Morta Este objeto n o possui eventos nem m todo
45. 12 3 3 1 3 HiHi P Habilita ou desabilita a verifica o de alarmes do tipo HiHi 12 3 3 1 4 HiHiAckRequired F Indica que o alarme do tipo HiHi requer reconhecimento 12 3 3 1 5 HiHiLimit 9 Indica o n vel em que o alarme HiHi ser ativado 12 3 3 1 6 HiHiMessageText A Ajusta a mensagem de texto do limite do alarme de tipo HiHi 12 3 3 1 7 HiHiSeverity a Indica o n vel de import ncia do alarme de tipo HiHi As op es s o e O Alta e 1 M dia e 2 Baixa 12 3 3 1 8 HiLimit 9 Indica o n vel em que o alarme Hi ser ativado 12 3 3 1 9 HiMessageText A Ajusta a mensagem de texto do limite do alarme de tipo Hi Alarmes 345 12 3 3 1 10 HiSeverity a Indica o n vel de import ncia do alarme de tipo Hi As op es s o e O Alta e 1 M dia e 2 Baixa 12 3 3 1 11 LevelDeadBand 9 Banda morta para os limites do n vel do alarme 12 3 3 1 12 LevelReturnMessageText A Ajusta a mensagem de retorno do n vel do alarme 12 3 3 1 13 Lo P Habilita ou desabilita a verifica o de alarmes do tipo Lo 12 3 3 1 14 LoAckRequired FP Indica que o alarme do tipo Lo requer reconhecimento 12 3 3 1 15 LoLimit 9 Indica o n vel em que o alarme Lo ser ativado 12 3 3 1 16 LoLo P Habilita ou desabilita a verifica o de alarmes do tipo LoLo 346 Alarmes 12 3 3 1 17 LoLoAckRequired P Indica que o alarme do tipo LoLo requer reconhecimento 12 3 3 1 18 LoLoLimit 9 Indica o n vel em que o alarme LoLo ser ativado
46. 18 5 1 3 Connect Connect O m todo Connect faza pena conectar se ao servidor para receber os dados de tempo real associando as propriedades XLinke YLink Se a pena j estiver conectada o m todo fica inativo Exemplo Sub CommandButtonl clickO set Pen1 Screen Item E3Chart1 Pens Item Pen1 Penl Disconnect O Penl Connect O End sub 18 5 1 4 Disconnect Disconnect O m todo Disconnect limpa os dados atuais e faz com que a pena n o receba mais os dados de tempo real do seu tagassociado Se a pena j estiver desconectada o m todo fica inativo Quando o m todo Disconnect usado em uma pena mista DataSourceType 2 ele remove a parte de tempo real permanecendo a parte hist rica Em tempo de execu o para que os dados de tempo real sejam mostrados novamente preciso chamar o m todo Connect Exemplo sub CommandButton1 Click Set Pen1 Screen Item E3Chart1 Pens Item Pen1 Penl Disconnect O Penl Connect O End sub 432 E3Chart 18 5 1 5 GetCursorPos GetCursorPos X Y Retorna a posi o em que o cursor interceptou a pena no E3Chart Este m todo possui os par metros X e Y que correspondem s coordenadas xe y do cursor Se o m todo for bem sucedido retorna True caso contr rio retorna False Exemplo Sub CommandButtonl clickQO For Each pen In Chart Pens If pen GetcursorPos aa bb Then strResult strRresult amp pen name amp amp csTr CDate aa _ y cstr bb
47. 9 A propriedade TopIndex define ou retorna o item da lista que aparece na posi o mais pr xima do topo na lista Esta propriedade retorna o valor 1 se a lista est vazia ou n o exibida 7 3 4 3 45 Value o valor da propriedade BoundColumn das linhas atualmente selecionadas Uma mudan a de valor na propriedade Value n o implica em mudan a de valor na propriedade BoundColumn Para adicionar ou apagar entradas em uma lista de sele o pode se usar os m todos Additem ou Removeltem 7 3 5 Bot o de Comando Esta se o cont m informa es sobre eventos e propriedades do objeto Bot o de Comando Este objeto n o possui m todos associados 7 3 5 1 Eventos Esta se o cont m informa es sobre os eventos do objeto Bot o de Comando 7 3 5 1 1 MouseMove MouseMove Ocorre quando o ponteiro do mouse movimentado sobre o bot o de comando 7 3 5 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Bot o de Comando 208 ActiveX 7 3 5 2 1 Accelerator Define ou recupera a tecla aceleradora do objeto Esta tecla aceleradora uma tecla de atalho que usada em conjunto com a tecla ALT d o foco ao objeto O valor padr o desta propriedade vazio 7 3 5 2 2 AutoSize Fi A propriedade AutoSize ajusta a largura do texto caso a rea dispon vel para o mesmo ultrapasse o tamanho do objeto Para o objeto Bot o de Comando Command Button quando a propriedade estiver configur
48. 9 Determina a largura da linha da pena no E3Chart Exemplo Sub CommandButton1 clickQO Set Pen1 Screen Item E3Chart1 Pens Item Pen1 Penl width 10 End sub 18 5 2 32 XField Nome do campo da consulta usado para plotar o dado em uma escala horizontal usada para penas hist ricas 18 5 2 33 XLink Nome do link usado para plotar o dado em uma escala horizontal Quando o valor desta propriedade alterado a pena automaticamente desconectada Ap s a configura o preciso chamar o m todo Connect para que a pena comece a receber os dados relativos a este link usada para penas de tempo real 18 5 2 34 XMaxY 9 Informa o valor X relativo ao ponto MaxY Esta propriedade somente de leitura 18 5 2 35 XMinY 9 Informa o valor X relativo ao ponto MinY Esta propriedade somente de leitura E3Chart 441 18 5 2 36 YField Nome do campo da consulta usado para plotar o dado em uma escala vertical usada para penas hist ricas 18 5 2 37 Y Link Nome do link usado para plotar o dado em uma escala vertical Quando o valor desta propriedade alterado a pena automaticamente desconectada Ap s a configura o preciso chamar o m todo Connect para que a pena comece a receber os dados relativos a este link usada para penas de tempo real 18 6 Cole o de Eixos Esta se o cont m informa es sobre m todos e propriedades do objeto Cole o de Eixos Este objeto n o possu
49. Caso contr rio otag atualizar a propriedade Value conforme a configura o das propriedade Period e Scan O valor padr o desta propriedade True 122 Servidor de Dados 5 3 2 2 Maximum 9 Apropriedade Maximum determina o valor m ximo do tag O valor padr o desta propriedade 100 Exemplo Sub CommandButton2 clickQO Ao clicar no bot o abre uma caixa de mensagens indicando o valor da propriedade Maximum do TagDemo6 MS gBOX Application Getobject Dados TagDemo6 Maximum End Su 5 3 2 3 Minimum 9A propriedade Minimum determina o valor m nimo do tag O valor padr o desta propriedade 0 Exemplo Sub CommandButton2_ClickO Ao clicar no bot o abre um messagebox indicando o valor da propriedade Minimum do TagDemo6 ido Application Getobject Dados TagDemo6 Minimum nd Su 5 3 2 4 Period 9 Define o comprimento da forma de onda em milissegundos N o se aplica quando a propriedade Type estiver configurada para 0 Random ou 3 CurrentTime O valor padr o desta propriedade 10000 ms Exemplo Sub TagDemol onStartRunning O Period 1000 End sub 5 3 2 5 Scan 9 A propriedade Scan define o intervalo de tempo em milissegundos entre duas varia es da propriedade Value Utilize esta propriedade se voc desejar maior ou menor quantidade de dados gerados pelo tag Demo Ovalor padr o desta propriedade 1000 O valor do scan deve ser maior que 0 Exemplo Sub Linhal clickQO Application
50. DDStatldle Indica que o relat rio est fechado 1 DDStartRunning Indica que o relat rio est sendo executado 2 DDStartCompleted Indica que o relat rio est completo 3 DDStartCanceled Indica que o relat rio foi cancelado Relat rios 481 22 4 1 15 TOCEnabled P Habilita ou desabilita o ndice do relat rio Se a propriedade estiver configurada para True o ndice do relat rio habilitado do contr rio o relat rio n o ter ndice Ovalor padr o desta propriedade True 22 4 1 16 TOCVisible FI Determina a visibilidade do ndice do relat rio Se a propriedade estiver configurada para True o ndice do relat rio mostrado do contr rio o ndice fica invis vel Ovalor padr o desta propriedade True 22 4 1 17 ToolbarVisible F Habilita ou desabilita a Barra de Ferramentas da janela de pr via de impress o do relat rio Se a propriedade estiver configurada para True a barra habilitada do contr rio n o haver barra de ferramentas nesta janela 22 4 1 18 UserData Configura ou retorna as informa es espec ficas do usu rio Esta propriedade similar propriedade Tag do Visual Basic mas ser exportada e salva em um arquivo rpx Pode ser usada para salvar e carregar qualquer informa o personalizada necess ria ao desenho do relat rio 22 4 1 19 Version Retorna o n mero da vers o do produto 482 Relat rios 22 4 1 20 WaterMark
51. Desabilita o Storage assim que iniciar Stopacquisition O End sub 15 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Storage 15 2 1 BackupDiscardInterval 9 Indica a quantidade de unidades de tempo durante o qual os dados de backup ser o mantidos na tabela principal e na tabela de backup at serem descartados por exemplo para manter os dados por 24 meses na tabela principal e mais seis meses na tabela de backup o valor da propriedade deve ser de 30 meses Esta propriedade trabalha em conjunto com a propriedade BackupDiscardTimeUnit O valor padr o desta propriedade 12 doze unidades de tempo indicadas em BackupDiscardTimeUnit NOTA O tempo total indicado pela combina o das propriedades BackupDiscardinterval e BackupDiscardTimeUnit deve ser maior que o tempo indicado pelas propriedades Discardinterval e DiscardTimeUnit Storage 381 15 2 2 BackupDiscardTimeUnit a A propriedade BackupDiscardTimeUnit indica a unidade de tempo em que os dados de backup ficar o armazenados at serem descartados As op es dispon veis s o e O dtHour horas e 1 dtDay dias e 2 dtMonth meses padr o e 3 dtMinute minutos Esta propriedade trabalha em conjunto com a propriedade BackupDiscardInterval 15 2 3 CacheSize 9 Define o tamanho do bloco de registros que deve ser lido pelo Storage antes de ser enviado para o banco de dados Por exemplo se CacheSize igual a 4 ser o env
52. Determina o nome da consulta que a pena est utilizando Esta propriedade utilizada se a propriedade DataSourceType estiver configurada para 1 Hist rico Exemplo Sub CommandButton1 clickQO Set Pen1 Screen Item E3Chart1 Pens Item Pen1 Penl QueryName Consultal2 End sub 18 5 2 24 ScaleX e ScaleY 9 As propriedades ScaleX e ScaleY indicam a quais escalas X e Y do E3Chart a pena est associada respectivamente Aescala configurada para ScaleX tem orienta o horizontal ou seja pode estar posicionada no topo ou na base do E3Chart Aescala configurada para ScaleY tem orienta o vertical estando posicionada esquerda ou direita do objeto Exemplo Sub CommandButtonl clickQO set Chart Screen Item E3Chart1 Set Pen Chart Pens AddPen PenaDoTagDemo 2 Pen yLink Dados TagDemo2 Pen UseTimeStamp True A escala deve existir previamente Pen scaley EscalaParaTagDemo2 Pen Connect End sub E3Chart 439 18 5 2 25 ScanValue 9 Define o tempo de leitura esperado do tag da pena de tempo real Este valor levado em conta no modo de desenho anal gico Quando o valor ultrapassa o valor determinado por ScanValue considera se que o valor do tag n o foi alterado no intervalo De outra forma quando o ScanValue igual a zero os dados da pena s o sempre conectados com uma reta ligando os dois pontos como se o valor estivesse variando de forma linear A unidade desta propriedade milissegundos
53. E Quando a propriedade EnableOverrideLineColor estiver configurada para True a propriedade OverrideLineColor ser usada para definir a cor a ser usada na cor da linha da figura ao inv s da cor original Nos scripts utilize a fun o do VBScript RGB para montara cora ser associada a esta propriedade Ovalor padr o desta propriedade vermelho RGB 255 0 0 Exemplo Sub Drawpicturel Click overrideLineColor RGB O 0 255 End sub 6 2 6 1 11 Shadow P Indica a presen a do efeito de sombra no objeto Se True o objeto possui uma sombra cujas coordenadas s o estabelecidas pelas propriedades ShadowX e ShadowY Do contr rio o objeto n o possui o efeito de sombra O valor padr o desta propriedade False 6 2 6 1 12 ShadowColor E Especifica a cor do preenchimento da sombra do objeto Esta cor utilizada quando a propriedade Shadow est configurada para True Nos scripts utilize a fun o do VBScript RGB para montar a cora ser associada a esta propriedade O valor padr o desta propriedade cinza escuro RGB 128 128 128 Exemplo Sub Botaol Click Troca a cor de fundo do botao para cinza claro quando se clica no objeto Shadowcolor RGB 192 162 192 End sub 6 2 6 1 13 ShadowX 9 Define a coordenada vertical esquerda da sombra deste objeto em unidades Himetric Esta sombra sempre relativa propriedade X do objeto Valores positivos indicam que a sombra estar direita do objeto e negati
54. End Sub 20 1 5 FindUnit FindUnit UnitName Verifica se uma determinada unidade existe no banco de dados das f rmulas Este m todo possui o par metro UnitName que determina o nome da unidade a ser encontrada O m todo retorna True se conseguir realizar a opera o caso contr rio retorna False Exemplo sub Botaol Click Dim val A Quando clica no bot o aparece uma caixa de mensagem MessageBox com o resultado MsgBox Application Getobject Formulal Findunit unit2 End Sub 20 1 6 FindValue FindValue ValueName Verifica se um determinado conjunto de valores existe no banco de dados de f rmulas Este m todo possui o par metro ValueName que informa o nome do conjunto a ser verificado Retorna True se conseguir realizar a opera o caso F rmulas 463 contr rio retorna False Exemplo Sub Botaol click Dim val Quando clica no bot o aparece uma caixa de mensagem MessageBox com o Pes do MsgBox CStr Application Getobject Formulal Findvalue Modelo5 End sub 20 1 7 GetUnitData GetUnitData UnitName TemplateName Val Coloca na vari vel indicada em Val o tag associado unidade UnitName do template TemplateName Retorna True se a opera o foi bem sucedida ou False caso contr rio Exemplo Sub Botaol Click Dim qualTag qualFormula Appli ication Getobj ect Formulal GetUnitData _ Unidadel Template2 varl End sub 20 1 8 GetValueData GetValueData
55. Esta propriedade ser considerada somente ap s a conex o da pena Para maiores informa es veja o m todo Connect O valor padr o desta propriedade 1000 e deve ser sempre maior que 0 Exemplo 434 E3Chart Sub CommandButtonl Click Set Pen1 Screen Item E3Chart1 Pens Item Pen1 Penl Disconnect Penl Buffersize 5000 Penl Connect O End sub 18 5 2 5 Color E Determina a cor da linha da pena no E3Chart O valor padr o desta propriedade vazio Exemplo Sub CommandButton1 clickQO Set Pen1 Screen Item E3Chart1 Pens Item Pen1 Peni Color RGB 212 208 20 End sub 18 5 2 6 DataSourceType P Determina a origem dos dados da pena As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para DataSourceType OP O DESCRI O 0 Tempo Real Indica conex o da pena a um tag atualizado em tempo real 1 Hist rico Indica conex o da pena aos dados vindos de uma consulta 2 PenaMista Indica conex o da pena a tags de tempo real e dados hist ricos simultaneamente Quando a propriedade DataSourceType for igual a O Tempo Real as propriedades XLinke YLink informam os links utilizados ou ent o a propriedade UseTimeStamp informa que a propriedade XLink n o ser usada estando em seu lugar o timestamp da propriedade YLink Quando a propriedade DataSourceType for igual a 1 Hist rico as propriedades XField e YF
56. O valor padr o dessa propriedade 6600 7 4 6 1 15 LowLimit 9 Ovalor m nimo dessa propriedade 0 1 e o m ximo limitado pela propriedade HiLimit O valor padr o dessa propriedade 0 62 7 4 6 1 16 LowLimitVisible P Habilita ou desabilita a exibi o do limite Baixo 7 4 6 1 17 LowLowColorLegend E Define a cor da legenda para o limite Muito Baixo O valor padr o desta propriedade verde RGB O 255 0 ActiveX 259 7 4 6 1 18 LowLowDiv 9 Marca o in cio da escala para o limite Muito Baixo O valor padr o dessa propriedade 3300 7 4 6 1 19 LowLowLimitVisible F Habilita ou desabilita a exibi o do limite Muito Baixo 7 4 6 1 20 Maximum 9 Define o valor m ximo da escala do E2Gauge 7 4 6 1 21 Minimum 9 Define o valor m nimo da escala do E2Gauge 7 4 6 1 22 NeedleColor E Define a cor do ponteiro do E2Gauge O valor padr o desta propriedade branco RGB 255 255 255 7 4 6 1 23 NeedleThickness 9 Define a espessura do ponteiro do E2Gauge em pixels Ovalor padr o dessa propriedade 2 e s s o aceitos os valores 1 ou 2 7 4 6 1 24 NormalColor E Define a cor da legenda para o limite Normal O valor padr o desta propriedade oliva RGB 128 128 0 7 4 6 1 25 NumberOfPoints 9 Define o n mero de subdivis es que estar o vis veis na escala do objeto 260 ActiveX 7 4 6 1 26 Orientation a Define a orienta o do objeto E2Gauge Os valores poss veis de
57. Set Chart Screen Item E3Chart1 MsgBox Chart axes Count End Sub 18 6 2 2 HorAxis 9 Retorna o eixo horizontal principal Este eixo tamb m participa da lista de eixos Exemplo Sub CommandButtonl clickQO Set Chart Screen Item E3Chart1 MsgBox Chart axes Item 0 Name amp amp Chart axes Item 1 Name MsgBox Chart axes Horaxis Name amp amp Chart axes Item NomeDoE i xo Name End sub 18 6 2 3 Item 9 Retorna o eixo atrav s de seu nome ou ndice O ndice O sempre o eixo horizontal principale o ndice 1 sempre o eixo vertical principal Exemplo Sub CommandButton1 clickQO Set Chart Screen Item E3cChart MsgBox Chart axes Item 0 Name amp amp Chart axes Item 1 Name MsgBox Chart axes Horaxis Name amp amp Chart axes Item NomeDoEixo Name End Sub E3Chart 443 18 6 2 4 VerAxis 9 Retorna o eixo vertical principal Este eixo tamb m participa da lista de eixos Exemplos sub commandButtonl Click Set Chart Screen Item E3chart1 MsgBox Chart axes Item 0 Name amp amp Chart axes Item 1 Name MsgBox Chart axes Item NomeDoEixo Name amp amp Chart axes VerAxis Name End sub 18 7 Eixos Esta se o cont m informa es sobre m todos e propriedades do objeto Eixo Este objeto n o possui eventos associados 18 7 1 M todos Esta se o cont m informa es sobre os m todos do objeto Eixo 18 7 1 1 G
58. ShowPickColor ColorValue Color Left Top Abre a caixa de di logo Cores do Windows para a escolha de uma cor O valor decimal da cor escolhida retornado no par metro ColorValue O par metro Color indica uma cor previamente selecionada na paleta de cores Se este par metro n o for informado ele assume O preto A posi o da caixa de di logo pode ser configurada atrav s dos par metros Left e Top que indicam respectivamente a dist ncia da margem esquerda e do topo da tela em pixels Caso estes par metros n o sejam informados a caixa de di logo fica centralizada Exemplo Sub CommandButton Click Dim novaCor Dim corPadrao corPadrao 65280 verde Claro If Application showPickColor novacor corPadrao 90 90 Then Screen Item Retangulo1 Foregroundcolor novacor Screen Item Textol value novaCor End If End sub 312 Viewer 10 2 29 Stopsound Stopsound P ra um som que esteja tocando Exemplo Sub CommandButton2 click Application SstopsoundO End sub 10 2 30 ToggleValue ToggleValue TagName Vala ValB O m todo ToggleValue busca o valor do objeto ou propriedade sendo executado no servidor e compara com os par metros ValA e ValB Se o valor buscado for igual ao ValB o objeto ou propriedade especificado em TagName receber o valor de Vala Caso contr rio receber o valor de ValB Caso o valor de TagName n o seja nem Vala nem ValB o m todo ToggleValue atribuir o valor especificado em V
59. ativa o Esta propriedade somente de leitura O valor padr o desta propriedade False 12 3 2 2 Alarm P se ajustada para True indica a condi o ativa do alarme O valor padr o desta propriedade False 12 3 2 3 AlarmVerify FP se ajustada para True habilita a verifica o da fonte de alarme ou seja a gera o do alarme 12 3 2 4 CurrentSeverity P Indica a ltima severidade do alarme ativo a saber e O Alta e 1 M dia e 2 Baixa Ovalor padr o desta propriedade 1 indicando que a Fonte de Alarme n o est ativa Alarmes 341 12 3 2 5 CurrentSubConditionName Determina o nome da ltima condi o de alarme ativa As op es dispon veis para esta propriedade s o Op es dispon veis para CurrentSubConditionName OP O DESCRI O LOLO Alarme Anal gico na faixa LOLO LO Alarme Anal gico na faixa LO HI Alarme Anal gico na faixa HI HIHI Alarme Anal gico na faixa HIHI BM Alarme de Banda Morta TV Alarme Taxa de Varia o DIG Alarme Digital Ovalor padr o desta propriedade uma String vazia 12 3 2 6 Delay 9 Especifica um tempo de atraso para o alarme em ms tanto na entrada quanto na sa da da condi o Quando essa propriedade estiver em 0 que ser sempre o valor padr o n o aplicado nenhum atraso Quando for diferente de 0 o alarme s ser ativado ou desativado se permanecer na mesma condi o p
60. fmPicturePositionBelowLeft Afigura aparece abaixo da legenda A legenda alinhada com a extremidade esquerda da figura 10 fmPicturePositionBelowCenter Afigura aparece abaixo da legenda A legenda centralizada acima da figura 11 fmPicturePositionBelowRight Afigura aparece abaixo da legenda A legenda alinhada com a extremidade direita da figura 7 3 3 1 11 SpecialEffect aP A propriedade SpecialEffect especifica a apar ncia de um objeto As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para SpecialEffect OP O DESCRI O 0 fmButtonEffectFlat Oobjeto aparece plano e possui um destaque na borda uma altera o de cor ou ambos 2 fmButtonlEffectSunken O objeto possui uma sombra na parte superior esquerda e um destaque na parte inferior direita como se estivesse afundado na Tela 7 3 3 1 12 TextAlign aP Especifica como o texto alinhado no objeto As op es dispon veis s o as seguintes e 1 fmTextAlignLeft alinha o texto com a extremidade esquerda do objeto e 2 fmTextAlignCenter centraliza o texto com a extremidade direita do objeto e 3 fmTextAlignRight alinha o texto com a extremidade direita do objeto 192 ActiveX 7 3 3 1 13 TripleState F A propriedade TripleState determina at tr s estados de valores para o objeto Se a propriedade estiver configurada para True o
61. o desta propriedade 0 Exemplo Sub CommandButton9 click screen Item arcol ArcBeginangle 12 End sub 6 2 5 1 2 ArcEndAngle 9 Esta propriedade configura o ngulo final do arco do objeto em graus Ointervalo aceito por essa propriedade vai de O at 359 O estilo e forma do arco depender o tamb m das configura es das propriedades ArcBeginAngle e ArcStyle O valor padr o desta propriedade 270 Exemplo Sub CommandButton9 clickQO screen Item arcol ArcEndangle 12 End sub 6 2 5 1 3 ArcStyle a Esta propriedade especifica o estilo da borda ou linha do objeto Aborda do objeto ser desenhada conforme o estilo definido utilizando a cor especificada em BorderColor com a espessura BorderWidth A seguinte tabela cont m os valores v lidos para a propriedade ArcStyle Op es dispon veis para ArcStyle OP O DESCRI O O arc O estilo do desenho ser um arco 1 chord O estilo do desenho ser uma corda unindo o ponto inicial e final 2 pie O estilo do desenho ser uma pizza padr o Exemplo Sub commandButton9 click screen Item arcol arcstyle 1 End sub 150 Telas e Objetos de Tela 6 2 6 Figura Esta se o cont m informa es sobre propriedades do objeto Figura Este objeto n o possui eventos nem m todos associados 6 2 6 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Figura 6 2 6 1 1 Backgr
62. o desta propriedade True 7 3 9 3 16 IMEMode aP A propriedade IMEMode especifica o modo IME Input Method Editor de um objeto Essa propriedade aplica se apenas a programas escritos em idiomas asi ticos chin s simplificado chin s tradicional coreano e japon s e ignorada em outros aplicativos Foi mantida por motivos de compatibilidade com a especifica o padr o dos objetos Microsoft Forms As op es dispon veis s o as seguintes Op es dispon veis para IMEMode OP O DESCRI O 0 fmiMEMoOdeNocControl N o controla IME padr o 1 fmIMEMoOdeOn IME ativado 2 fmIMEModeOff IME desativado Modo ingl s 3 fmIMEModeDisable IME desativado O usu rio n o pode ativar IME pelo teclado 4 fmIMEModeHiragana IME ativado com modo Hiragana de largura total 5 fmIMEModeKatakanaFull IME ativado com modo Katakana de largura total 6 fmIMEModeKatakana IME ativado com modo Katakana de meia largura 7 fmIMEModeAlphaFull IME ativado com modo Alfanum rico de largura total 8 fmIMEModeAlpha IME ativado com modo Alfanum rico de meia largura 236 ActiveX OP O DESCRI O 9 fnIMEMode HangulFull IME ativado com modo Hangul de largura total 10 fnIMEMode Hangul IME ativado com modo Hangul de meia largura 11 fnIMEMOode HanziFull IME ativado com modo Hanzi de largura total 12 fmIMEMode Hanzi IME ativado
63. o texto acompanha as varia es de altura e largura do objeto Caso contr rio este permanece com as configura es iniciais O valor padr o desta propriedade True 22 6 9 1 2 CanShrink FI Determina a aplica o do efeito de encolhimento ao texto do objeto Caso a largura ou altura do objeto sejam diminu das o texto acompanha esta varia o Se a propriedade estiver configurada para True o texto acompanha as varia es de altura e largura do objeto Caso contr rio este permanece com as configura es iniciais O valor padr o desta propriedade True 22 6 9 1 3 CloseBorder FP Esta propriedade habilita ou desabilita a visualiza o da linha da borda da base da tabela caso a mesma ultrapasse mais de uma p gina no relat rio Relat rios 517 22 6 9 1 4 left 9 Apropriedade left retorna o valor do posicionamento esquerdo do objeto no relat rio O valor padr o desta propriedade vazio 22 6 10 E3Chart Esta se o cont m informa es sobre propriedades do objeto E3Chart do Relat rio 22 6 10 1 Propriedades Exemplo de utiliza o das propriedades do E3Chart em um relat rio Os scripts abaixo devem ser criados na se o PageHeader do relat rio utilizando o evento OnBeforePrint Exemplos Sub OnBeforePrint Usando um E3Chart em um relat rio Set chart Report sections PageHeader Controls E3Chart1 chart LoadData chart Fital End sub Sub OnBeforePrint Este script faz a c pia d
64. ocupar toda a rea de impress o O tamanho da rea de impress o deve tamb m incluir a largura das margens para que o relat rio n o fique maior que o tamanho do papel Se isto acontecer o erro ser assinalado por uma linha pontilhada vermelha impressa em cada p gina do relat rio 480 Relat rios 22 4 1 10 RulerVisible FI Quando configurado como True indica que ser o mostradas uma r gua vertical e outra horizontal na janela de visualiza o do relat rio Do contr rio as r guas ficar o invis veis 22 4 1 11 ScriptDebuggerEnabled F Habilita ou desabilita o depurador do ActiveReports JIT para depurar os scripts associados aos relat rios Este depurador n o est dispon vel em todo o E3 apenas nos relat rios 22 4 1 12 ScriptLanguage Indica a linguagem usada para interpretar os scripts associados a um relat rio A linguagem padr o VBScript mas JScript tamb m pode ser utilizada 22 4 1 13 ShowParameterUl F Habilita ou desabilita os par metros da caixa de di logo da Consulta que aparece quando o relat rio est sendo executado Se a propriedade estiver configurada para True os par metros da caixa de di logo da consulta ser o mostrados Caso contr rio estes par metros n o s o mostrados 22 4 1 14 Status P Retorna o status do relat rio As op es dispon veis para esta propriedades s o as seguintes Op es dispon veis para Status OP O DESCRI O 0
65. rico independente do valor especificado na propriedade ScanTime Agrava o por per odo fica desabilitada at o m todo StartAcquisition ser chamado O comportamento padr o do objeto Hist rico iniciar a aplica o com a grava o habilitada Exemplo Sub Hist OnStartRunning O o Desabilita o Hist rico assim que iniciar Stopacquisition End sub 374 Hist ricos 14 1 3 WriteRecord WriteRecord Insere uma nova linha de informa o no banco de dados Os valores s o obtidos a partir dos valores atuais de cada uma das vari veis especificadas como fontes de dados dos campos do hist rico Utiliza se este m todo em duas situa es e Para gravar uma nova linha de dados antes do tempo previsto para a pr xima grava o quando o Hist rico est habilitado por tempo e Para gravar um novo conjunto de dados quando o Hist rico est desabilitado Exemplo Sub Tagl onvalueChange O Grava uma nova linha em um hist rico quando um tag muda de valor Application Getobject Hist1 writerecord O End sub 14 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Hist rico 14 2 1 BackupDiscardiInterval 9 Indica a quantidade de unidades de tempo durante o qual os dados de backup ser o mantidos na tabela principal e na tabela de backup at serem descartados por exemplo para manter os dados por 24 meses na tabela principal e mais seis meses na tabela de backup o valor da prop
66. rico vai usar o valor de qualidade da fonte do tag caso contr rio ser utilizado o m todo antigo de avalia o 0 valor duvidoso 1 valor bom 14 2 16 VerificationInternal 9 Esta propriedade trabalha em conjunto com a propriedade VerificationUnit para controlar o intervalo de tempo que o E3 verifica a antiguidade dos dados para depois descart los Ovalor padr o desta propriedade 1 uma unidade de tempo indicada em VerificationUnit 378 Hist ricos 14 2 17 VerificationUnit Esta propriedade trabalha em conjunto com a propriedade VerificationInternal A propriedade VerificationUnit indica a unidade de tempo em que ser feita a verifica o para descarte dos dados As op es dispon veis s o 0 dtHour horas 1 dtDay dias e 2 dtMonth meses padr o 3 dtMinute minutos Hist ricos 379 CAP TULO Storage Esta se o cont m informa es sobre m todos e propriedades do objeto Storage Este objeto n o possui eventos associados 15 1 M todos Esta se o cont m informa es sobre os m todos do objeto Storage 15 1 1 CreateNewSession CreateNewSession DefaultType DefaultMinRecTime DefaultMaxRecTimel DefaultDeadBand DefaultUnit Gera uma sess o que tem a capacidade de incluir dados de um E3Storage de forma independente da aquisi o normal Os par metros opcionais s o utilizados nas configura es dos tags da sess o caso n o informados em suas cria es S
67. se for um tag o Size 1 Errorinfo Element ndice do elemento de bloco que causou o erro Errorinfo Nx Par metros Nxou Bx x 1 2 3 4 da opera o que causou o erro Errorinfo ParamDevice Par metro ParamDevice string da opera o que causou o erro Errorinfo Paramitem Par metro Paramitem string da opera o que causou o erro 3 1 1 7 OnTagRead OnTagRead Tag Ocorre na leitura de um tag sempre que um novo valor ou um erro for retornado pelo driver de comunica o Ou seja se o valor ou a qualidade do tag n o mudarem o evento n o ser disparado Para que o evento funcione a propriedade EnableDriverEvent deve obrigatoriamente estar habilitada Al m disso a propriedade PercentDeadband tamb m pode exercer influ ncia sobre a ocorr ncia do evento caso a propriedade EnableDeadband esteja habilitada Exemplo Drivers 55 Sub Tags OnTagRead Tag Set Obi Application Getobject Dados1 TagName Oobj value Tag Name Set Obi Application Getobject Dados1 TagRead obj value True Set pi Application Getobject Dados1 TagType Obj value TypeName Tag End Sub 3 1 1 8 OnTagWrite OnTagWrite Tag Succeeded User Ocorre quando uma escrita for disparada em qualquer tag do driver Vari veis do evento OnTagWrite NOME DESCRI O Tag Uma refer ncia para o objeto do Tag que est sofrendo a escrita Por exemplo pode se acessar a propr
68. tem quatro n veis de alarme 336 Alarmes Propriedades do Alarme Anal gico ITEM DESCRI O 9 LevelDeadBand Banda morta para o alarme de n veis A LevelReturnMessageText Mensagem de retorno de alarme ALARME LOLO MUITO BAIXO ITEM DESCRI O Pi LoLo Habilita ou desabilita a verifica o de alarme Muito Baixo 9 LoLoLimit Limite para o n vel de alarme Muito Baixo A LoLoMessageText Texto da mensagem de alarme Muito Baixo aP LoLoSeverity Import ncia do n vel de alarme Muito Baixo Conjunto de valores e O Alta e 1 M dia e 2 Baixa Pi LoLoAckRequired Necessidade de reconhecimento para este n vel de alarme Muito Baixo ALARME LO BAIXO ITEM DESCRI O Fito Habilita ou desabilita a verifica o de alarme Baixo 9 LoLimit Limite para o n vel de alarme Baixo A LoMessageText Texto da mensagem de alarme Baixo aP LoSeverity Import ncia do n vel de alarme Baixo Conjunto de valores e O Alta e 1 M dia e 2 Baixa Alarmes 337 ITEM DESCRI O Fi LoackRequired Necessidade de reconhecimento para este n vel de alarme Baixo ALARME HI ALTO ITEM DESCRI O P Hi Habilita ou desabilita a verifica o de alarme Alto 9 HiLimit Limite para o n vel de alarme Alto A HiMessageText Texto da mensagem de alarme Alto aP HiSeverity Im
69. todo Exemplo 272 Quadros e Divisores Sub BotaoFecha Click Quando BotaoFecha for clicado fecha a janela screen Close 0 End sub 8 1 4 FlashWindow FlashWindow Number Time Este m todo faz com que cone do Viewer comece a piscar na barra de tarefas do Windows O par metro Number determina o n mero de vezes que a barra de tarefas deve piscar e Time determina o tempo em milissegundos entre um piscar e outro Exemplo Sub Textol Click Set quadro application GetFrame top uadro Flashwindow 50 500 End sub 8 1 5 MaximizeFrame MaximizeFrame Maximiza um quadro ou Tela modal Exemplo Sub CcommandButton4 click Application GetFrame outro maximizeFrame End Sub 8 1 6 MinimizeFrame MinimizeFrame Minimiza um quadro ou Tela modal Exemplo Sub CommandButton4 clickQO Application GetFrame outro MinimizeFrame End Sub 8 1 7 MoveFrame MoveFrame PosxX PosY SizeX SizeY Move e redimensiona um Divisor Frame para uma coordenada e um tamanho espec ficos Os par metros PosX e PosYinformam a nova posi o em pixels com rela o esquerda e ao topo respectivamente Os par metros SizeX e SizeYinformam o novo comprimento e a nova altura respectivamente em pixels ou em HIMETRIC Todos os par metros s o opcionais Exemplo Sub Tela2 OnPreshow varg Quando a Tela2 aberta no frame Teste altera a posi o e o tamanho do frame Application GetFrame Teste
70. 0 63 RUIM Ovalor n o utiliz vel pelas raz es indicadas em substatus Drivers 109 FAIXA QUALIDADE DESCRI O 64 127 INCERTA Aqualidade do valor incerta pelas raz es indicadas em substatus 128 191 N A N o usado pelo padr o OPC 192 255 BOA Aqualidade do valor boa Op es poss veis para Limite LIMITE DESCRI O Sem limite Ovalor livre para mover se acima ou abaixo Baixo Ovalor est limitado em algum valor inferior Alto O valor est limitado em algum valor superior Constante Ovalor uma constante e n o pode mover se Substatus para Qualidade Ruim 0 63 SUBSTATUS DESCRI O LIMITES SEM BAIXO ALTO CONSTANTE N o especificado Ovalor ruim mas 000 001 002 003 nenhuma raz o espec fica conhecida Erro de configura o H algum problema 004 005 006 007 de configura o no servidor Por exemplo oitem em 110 Drivers SUBSTATUS DESCRI O LIMITES SEM BAIXO ALTO CONSTANTE quest o pode ter sido apagado N o conectado Aentrada deveria estar logicamente conectada a algo mas n o est Esta qualidade pode refletir que n o h valor dispon vel neste momento porque o mesmo pode n otersido fornecido pela fonte de dados por exemplo 008 0
71. 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Ret ngulo Arredondado 6 2 4 1 1 RoundAspectX 9 A propriedade RoundAspectX define o tamanho da dimens o das laterais do ret ngulo no eixo X Sendo assim de acordo com o valor definido na propriedade os cantos do ret ngulo ir o mudar a sua forma desde um ret ngulo at uma elipse Esta propriedade pode variar seu valor de 0 1 at 1 0 Exemplo sub Retanguloarred Click RoundaspectX 0 5 End sub 6 2 4 1 2 RoundAspectY 9 A propriedade RoundAspectY define o tamanho da dimens o da altura do ret ngulo no eixo Y Sendo assim de acordo com o valor definido na propriedade os cantos do ret ngulo ir o mudar a sua forma desde um ret ngulo at uma elipse Esta propriedade pode variar seu valor de 0 1 at 1 0 Exemplo sub Retanguloarred Click RoundaspectY 0 5 End sub 6 2 5 Arco de Elipse Esta se o cont m informa es sobre propriedades do objeto Arco de Elipse Este objeto n o possui eventos nem m todos associados 6 2 5 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Arco de Elipse Telas e Objetos de Tela 149 6 2 5 1 1 ArcBeginAngie 9 Esta propriedade configura o ngulo inicial do arco do objeto em graus Ointervalo aceito por essa propriedade vai de O at 359 O estilo e forma do arco depender o tamb m das configura es das propriedades ArcEndAngle e ArcStyle O valor padr
72. 100 EULow O End sub 96 Drivers 3 6 1 11 EUHigh 9 Define qual o valor m ximo que dever ser atribu do propriedade Value ajustando a escala ao valor do equipamento ou do dispositivo antes desta atribui o Da mesma forma no momento da escrita feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a propriedade EnableScaling est configurada para True O valor padr o desta propriedade 1000 Exemplo Sub Tag OnStartRunningO Faz o ajuste de escala de um tag de temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub 3 6 1 12 EULow 9 Define qual o valor m nimo que dever ser atribu do propriedade Value ajustando a escala ao valor do equipamento ou do dispositivo antes desta atribui o Da mesma forma no momento da escrita feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a propriedade EnableScaling est configurada para True O valor padr o desta propriedade 0 Exemplo Sub Tag OnStartRunningO Faz o ajuste de escala de um tag de temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub Drivers 97
73. 3 27 TitleBar FI se a op o estiver habilitada True a barra de t tulo do Viewer mostrada conforme as especifica es da propriedade Caption Do contr rio ela escondida O valor padr o desta propriedade True 10 3 28 User Cont m o nome do usu rio que est utilizando o Viewer Esta propriedade somente para leitura 10 3 29 WindowBorder FI Habilita ou desabilita uma borda na janela do Viewer O valor padr o dessa propriedade verdadeiro Essa propriedade de leitura e escrita mas alterar seu valor em tempo de execu o n o altera a configura o do Viewer j aberto apenas das janelas que forem abertas utilizando a configura o do Viewer 10 3 30 WindowhHeight Determina a altura da janela do Viewer em pixels O valor padr o dessa propriedade 300 320 Viewer 10 3 31 WindowMovable P Indica se a janela pode ser movida O valor padr o dessa propriedade verdadeiro Essa propriedade de leitura e escrita mas alterar seu valor em tempo de execu o n o altera a configura o do Viewer j aberto apenas das janelas que forem abertas utilizando a configura o do Viewer 10 3 32 WindowResizable P Indica se a janela pode ser redimensionada Esta propriedade s tem efeito se a propriedade WindowBorder for verdadeira O valor padr o dessa propriedade verdadeiro Essa propriedade de leitura e escrita mas alterar seu valor em tempo de execu o n o altera a configura
74. 3 Linha da Conex o M ltipla Esta se o cont m informa es sobre propriedades da Linha da Conex o M ltipla Este objeto n o possui eventos nem m todos associados 294 Associa es 9 9 3 1 Propriedades Esta se o cont m informa es sobre as propriedades da Linha da Conex o M ltipla 9 9 3 1 1 Max 9 Intervalo m ximo para o valor da associa o indicada na propriedade Source 9 9 3 1 2 Min 9 Intervalo m nimo para o valor da associa o indicada na propriedade Source Associa es 295 CAP TULO Viewer Esta se o cont m informa es sobre eventos m todos e propriedades do objeto Viewer 10 1 Eventos Esta se o cont m informa es sobre os eventos do objeto Viewer 10 1 1 Onlnactive Onlnactive Este evento ocorre enquanto o Viewer estiver inativo se a propriedade Enablelnactivity estiver em True Ele inicia quando constatado que o usu rio est sem utilizar o Viewer por um per odo de tempo igual ou superior ao valor da propriedade InactivityTime Em um script para esse evento o usu rio pode programar o que deseja fazer quando o Viewer estiver inativo por um determinado per odo de tempo Por exemplo poss vel determinar que ap s 20 minutos sem uso ser feito logout do Viewer Exemplo Sub Viewer OnInactive Logout false A A Eai If MsgBox Essa sess o do Viewer foi fechada devido inatividade 0 Then SA ication GetFrame OpenScreen TelaIni
75. 460 E3Play back 19 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto E3Playback 19 2 1 CurrentTime Mostra a data e a hora atual do objeto E3Playback Esta propriedade est dispon vel somente em tempo de execu o 19 2 2 DBServer Indica o nome do objeto Banco de Dados que cont m os dados hist ricos do aplicativo 19 2 3 InitialScreen Indica a Tela que ser mostrada inicialmente no E3Playback Se essa propriedade for deixada em branco ser utilizada a tela inicial do objeto Viewer 19 2 4 PlaybackState a Informa o estado atual do objeto E3Playback Esta propriedade est dispon vel somente em tempo de execu o e as op es s o as seguintes Op es da propriedade PlaybackState OP O DESCRI O O Parado O rel gio de playback est parado 1 Reproduzindo O rel gio de playback est se movendo 2 Pausado O rel gio de playback est pausado E3Play back 461 CAP TULO F rmulas Esta se o cont m informa es sobre m todos e propriedades do objeto F rmula Este objeto n o possui eventos associados 20 1 M todos Esta se o cont m informa es sobre os m todos do objeto F rmula 20 1 1 CreateUnit CreateUnit UnitName Cria uma unidade na tabela de f rmulas Este m todo possui o par metro UnitName que determina o nome da unidade a ser criada Retorna True se conseguir realizar
76. As op es dispon veis s o Op es dispon veis para NetLibrary OP O DESCRI O 0 Default Biblioteca do tipo padr o 1 NamedPipes Biblioteca do tipo Named Pipes 2 Tcplp Biblioteca do tipo Winsock TCP IP 3 Spxlpx Biblioteca do tipo SPX IPX 4 BanyanVines Biblioteca do tipo Banyan Vines 5 MultiProtocol Biblioteca do tipo Multi protocolo RPC NOTA a propriedade NetLibrary somente est dispon vel no Banco de Dados do tipo SQL Server 11 2 5 ReconnectDelay 9 Apropriedade ReconnectDelay determina o tempo de espera em milissegundos para osistema fazer uma tentativa de restabelecer uma conex o perdida com o banco de dados O valor padr o desta propriedade 2000 2 segundos 330 Banco de Dados 11 2 6 SourceDatabase Caso o Banco de Dados seja Access este o nome do arquivo mdb Caso o Banco de Dados seja SQL Server este o nome do servidor SQL concatenado com o banco de dados escolhido no formato Servidor Banco de Dados Caso o Banco de Dados seja Oracle este o nome da conex o criada Esta propriedade somente para leitura 11 2 7 SourceType P Indica o banco de dados utilizado pelo objeto As op es dispon veis s o e O stOracle Banco de dados Oracle e 1 stAccess Banco de dados Access e 2 stSQLServer Banco de dados SQL Server Exemplo sub Grupol Click op Application selectMenu oracle Access SQL
77. Assim pode se ter v rios objetos trabalhando em conjunto para prover caracter sticas de um outro objeto derivado Tome como exemplo o objeto E3Chart Ele composto internamente de v rios objetos como t tulos legendas escalas divis es consultas e penas Note que cada objeto contribui para a funcionalidade do todo as escalas ajudam a localizar os valores dos pontos no E3Chart as legendas a identificar a pena e seus valores e a pena realiza o desenho dos valores no E3Chart 6 Introdu o Atrav s da manipula o de objetos dentro do E3Chart pode se criar duas inst ncias deste objeto bastante diferentes entre si Para se manipular um objeto espec fico deve se acess lo atrav s de uma hierarquia Se os dois objetos E3Chart estiverem na mesma Tela deve se acessar primeiro a Tela depois o E3Chart desejado depois uma de suas propriedades ou objetos filhos Quando h v rios objetos de um mesmo tipo geralmente eles podem ser acessados atrav s de uma cole o collection Uma cole o um objeto especial que gerencia um conjunto de objetos semelhantes Um exemplo no objeto E3Chart a cole o Pens que permite o acesso a todas as penas do E3Chart 1 2 Scripts Alinguagem que o E3 Studio usa em seus scripts o VBScript um subconjunto da linguagem Visual Basic desenvolvida pela Microsoft O VBScript possui um interpretador r pido leve e port vel desenvolvido para uso em navegadores para a Internet e outras
78. DESCRI O Number N mero inteiro identificador do erro Description String com a descri o do erro SCode Inteiro com o c digo de erro do subsistema OLE n o utilizado Source String com o objeto que originou o erro HelpFile String com o nome e o caminho do arquivo de ajuda HelpContext N mero de contexto do t pico de ajuda referente ao erro inteiro 184 ActiveX NOME DESCRI O CancelDisplay Booleano Indica se o erro deve ser mostrado em uma MessageBox 7 3 1 5 KeyPress KeyPress KeyAscii Ocorre quando o objeto tem o foco de teclado e o usu rio pressiona uma tecla que corresponde a um caractere que pode ser mostrado em tela uma tecla ANSI de c digo indicado na vari vel KeyAscii Ou seja o evento ocorre quando alguma das teclas a seguir s o pressionadas e Qualquer caractere do teclado que possa ser impresso e Tecla CTRL combinada com qualquer caractere do alfabeto padr o e Tecla CTRL combinada com qualquer caractere especial e Tecla BACKSPACE e Tecla ESC Este evento n o ocorre nas seguintes condi es e Pressionando a tecla TAB e Pressionando a tecla ENTER e Pressionando a tecla DEL essa tecla n o ANSI e Pressionando as setas do teclado e Quando uma tecla faz com que o foco v de um objeto a outro Enquanto um usu rio pressiona uma tecla que produz um c digo ANSI o objeto recebe os eventos KeyDown e KeyPr
79. Em caso de falha User e Comment s o configurados para uma string vazia Os coment rios pr definidos s o guardados no registro do Windows Apenas os ltimos 26 coment rios s o salvos Cada vez que a janela criada os ltimos coment rios s o buscados no registro e usados para preencher a lista de sele o Se um novo coment rio for informado pelo usu rio ele ser salvo e o mais antigo ser descartado caso n o haja posi o livre Se for utilizado um coment rio pr definido este passa a ser o primeiro da lista de mais recentes Exemplo Sub Buttonl Click Dim Tag User Comment set Tag application Getobject IO Inputs 1001 If application Esign Tag Pathname Altera o do Valor _ Tag Value 1 User Comment Then If Tag writeEx 1 Then App ication TrackEvent _ aa IO Inputs 1001 alterado para 1 amp pelo usu rio amp User Comment End If End If End sub Viewer 301 10 2 5 ExecuteExternalApp ExecuteExternalApp AppPath Arguments InitialDir CndShow Processid Este m todo executa um aplicativo externo de nome e caminho AppPath com os argumentos Arguments iniciando no diret rio de trabalho InitialDir Quando especificado um documento em AppPath o aplicativo associado a este documento executado e o documento passado como um dos par metros do aplicativo ProcessiD recebe o n mero que identifica o processo esse n mero utilizado no m todo IsAppRunning e o mesmo valor que
80. End If Cada evento pode ter v rios scripts e v rios picks associados chamados A es do Evento Alista das a es pode ser vista na parte superior da janela de edi o de scripts Cada objeto pode possuir qualquer quantidade de eventos com scripts ou picks associados Introdu o 11 1 3 Picks Os Picks implementam uma forma mais amig vel de realizar procedimentos mais comuns poupando tempo de configura o Entre eles est o a es como troca de Tela ou atribui o de valores bastante comuns na cria o de um projeto Aseguir s o descritos os picks dispon veis na aba Scripts 1 3 1 Abrir Tela Abre uma determinada Tela ou Quadro ITetatnicial aj b x E Telatnicial E click nosdara x E 8 ERTE Click Fires when screen is dicked on EB Abrir Tela Abre a Tela no Quadro principal Abrir Tela Abrir a Tela I No guado Pod Zoom inicial 100 X Bar metro 9o S T Habilitar scroll da tela J Especificar a posi o da tela J Especificar o tamanho da tela Es pixels 0 Largura pixels himetric Topo pixels 0 a Altura pixel himetric OBS Use hm para especificar tamanho em HIMETRIC Para pixels use apenas n meros Ex 1000hm 3500 hm 100 400 l Estilo da janela Mensagens aj 4 gt ja N Desin Scripts Configura es do pick Abrir Tela Op es dispon veis no pick Abrir Tela
81. Exemplo Sub Textol Click If application Passwordconfirm True Then MsgBox ConfirmPassword retornou True Else 308 Viewer MsgBox Confirmpassword retornou False End If End sub 10 2 23 Playsound Playsound Filename Toca um arquivo de som cujo caminho e nome est o indicados no par metro Filename Oarquivo deve seguir as seguintes especifica es Dever estar no formato de som do Windows extens o wav Se o arquivo estiver no projeto adicionado atrav s do comando Inserir recurso o nome do arquivo dever estar entre colchetes Se foi criada uma pasta no projeto e o arquivo foi adicionado atrav s do comando Inserir recurso o caminho dever ser especificado entre aspas por exemplo c isomiding wav Se o arquivo estiver no diret rio local o nome n o precisa de aspas basta colocar o caminho por exemplo c ilsomiding wav Exemplo Sub TelaInicial onAlarmO Se existir um alarme ativo ser tocado um som de alerta Quando o alarme reconhecido o som p ra Set Alarme Application Getobject configalarmes1 areal Fontealarmel If Alarme activeNackalarms True Then Application Playsound ringin wav End If End sub 10 2 24 SelectMenu SelectMenu Menu Left Top Este m todo mostra um menu pop up conforme especificado pelo par metro Menu Este par metro um texto que consiste em v rias op es delimitadas pela barra vertical sendo que cada um destes strings ser uma
82. MoveFrame 100 100 200 200 End Sub Quadros e Divisores 273 8 1 8 OpenScreen OpenScreen ScreenName Arg O m todo OpenScreen abre uma Tela dentro de um divisor O par metro ScreenName determina o nome da Tela a ser aberta poss vel tamb m especificar o percentual de zoom da Tela e a habilitar a barra de rolagem atrav s da chave como o modelo a seguir lt nome da tela gt lt zoom gt lt habi litar rolagem gt onde lt nome da tela gt o nome da Tela a ser aberta lt zoom gt o percentual de zoome lt habi litar ro lagem gt habilita ou desabilita a rolagem O percentual de zoom da Tela pode assumir os seguintes valores 1 toda a p gina e 2 a largura da Tela ocupa 100 da largura do divisor com altura proporcional 3 a altura da Tela ocupa 100 da altura do divisor com largura proporcional 4 a Tela preenche totalmente o divisor 5 a 100 equivale ao percentual de zoom da Tela propriamente dito Ahabilita o de rolagem pode assumir os seguintes valores e O desabilita a rolagem e 1 habilita a rolagem O par metro Arg permite repassar o valor especificado Tela atrav s do evento OnPreShow Exemplo sub Botaol click Quando clica no botao abre a Tela2 no frame Teste e passa o valor 1 que ser usado no evento OnPreshow Application GetFrame Teste Openscreen Tela2 10070 Isso um teste End sub sub Tela2 OnPreshow varg A caixa de mensagem vai mostrar a Msg
83. OPC onde este objeto est inserido e considerando a propriedade Index que especifica a posi o do elemento no vetor do bloco Otipo desta propriedade n mero inteiro ponto flutuante texto etc depende do driver ao qual ele est associado e da sua parametriza o Esta propriedade somente ser atualizada desta forma se a propriedade AllowRead do objeto Bloco OPC ao qual o elemento pertence estiver configurada para True e de acordo com o tempo de varredura definido na propriedade Scan do Grupo OPC que cont m o bloco Se a propriedade AllowWrite do objeto Bloco OPC estiver configurada em True pode se escrever valores no equipamento ou no dispositivo simplesmente atribuindo um novo valor para a propriedade Value Esta tamb m a propriedade padr o do objeto Elemento de Bloco OPC Sendo assim uma refer ncia por valor a um objeto Elemento de Bloco OPC n o necessita obrigatoriamente explicitar a propriedade Value para acessar o valor Caso esta propriedade n o esteja sendo atualizada verifique se a propriedade Index est corretamente configurada seu valor deve ser zero at o tamanho do Bloco OPC menos um Exemplo Sub Botaol Click Acessa um elemento e mostra o valor atual elml um objeto tipo Elemento de Bloco OPC Set Gi Application Getobject opCDriverl Grupol BlocoorC1 elm1 MsgBox valor atual de elml amp obj Value Isto tamb m pode ser feito de outra forma sem mostrar a propriedade value no padr
84. Posiciona o cursor de cada pena do E3Chart Equivale ao comportamento de chamar o m todo SetCursorPos de cada Pena 18 4 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Cole o de Penas 18 4 2 1 Count 9 Cont m o n mero total de penas inseridas no E3Chart Esta propriedade somente de leitura 18 5 Penas Esta se o cont m informa es sobre m todos e propriedades do objeto Pena Este objeto n o possui eventos associados 18 5 1 M todos Esta se o cont m informa es sobre os m todos do objeto Pena 18 5 1 1 AddPoint AddPoint ValueX ValueY Quality Adiciona um ponto ao final do buffer de tempo real Otamanho do buffer s v lido ap s a conex o da pena Se a pena for criada no Studio a conex o autom tica mas se for criada via script necess rio chamar o m todo Connect ap s sua cria o Este E3Chart 431 m todo deve ser usado com penas de tempo real e com a propriedade UseTimeStamp em False O par metro opcional Quality indica a qualidade do ponto a ser inserido Se este par metro n o for informado a qualidade do ponto ser considerada boa 192 O n mero de pontos que podem ser adicionados a uma pena est relacionado ao tamanho do buffer propriedade BufferSize da Pena 18 5 1 2 Clear Clear Apaga os dados do buffer de tempo real sem diminuir seu tamanho Este m todo n o desconecta associa es nem tampouco remove dados hist ricos
85. Renameunit Unit2 Unit3 End sub 20 1 11 RenameValue RenameValue ValueName NewValueName Renomeia um determinado conjunto de valores existente na tabela de f rmulas Retorna True se conseguir realizar a opera o ou False caso contr rio Este m todo possui os par metros ValueName que informa o nome do conjunto de valores e NewValueName que informa o novo nome do conjunto de valores Exemplo Sub Botaol Click Appl eea on Getobject Formulal Renamevalue Modelo5 ModeloABC End Su 20 1 12 SaveFormulaValues SaveFormulaValues UnitName ValueName IgnoreErrors Este m todo salva os valores atuais dos Tags de uma unidade de origem em um conjunto de valores na tabela de f rmulas Este m todo n o faza verifica o dos limites caso o template tenha uma restri o do tipo absoluta O par metro UnitName o nome da unidade de origem e o par metro ValueName o conjunto de valores que ser salvo Retorna True se conseguir realizar a opera o Do contr rio retorna False O par metro IgnoreErrors quando em True faz com que todos os valores sejam gravados independente de haver erros de associa es na F rmula Seu valor padr o False no entanto Exemplo sub Botaol click App a on Getobject Formulal SaveFormulaValues unidade1 vValor1 End Su F rmulas 465 20 1 13 SetUnitData SetUnitData UnitName TemplateName Data Carrega para a tabela de f rmulas o Tag identificado para um cer
86. Retorna a Tela pai do objeto Esta propriedade acess vel apenas em tempo de execu o 7 2 9 TabStop PI Esta propriedade determina a utiliza o da tecla TAB no sistema Se o campo estiver em True poss vel utilizar a tecla caso contr rio a tecla n o pode ser utilizada 7 2 10 Tip A Apropriedade Tip mostra um texto popup quando o mouse estiver por um breve momento sobre o objeto em execu o Exemplo sub Retangul oArrl MouseUp nButton nshiftstate x y Tip Isto um teste End Sub 7 2 11 Visible PI Esta propriedade define a visibilidade do objeto Se configurada como True o objeto fica vis vel desde que tamb m sejam obedecidos os seguintes fatores o objeto pai deste objeto tamb m deve estar vis vel e a propriedade Layer deste objeto tamb m deve estar presente na camada da Tela 7 2 12 Width 9 Determina a largura do objeto ActiveX 179 7 2 13 X 9 Apropriedade X define a coordenada horizontal esquerda em unidades Himetric do objeto 7 2 14 Y 9 Esta propriedade define a coordenada vertical superior em unidades Himetric do objeto 7 3 Microsoft Forms Esta se o cont m informa es sobre eventos e propriedades comuns de objetos Microsoft Forms Estes objetos n o possuem m todos comuns associados 7 3 1 Eventos Comuns Esta se o cont m informa es sobre os eventos comuns aos objetos Microsoft Forms 7 3 1 1 BeforeDragOver BeforeDragOver Index Cancel Data
87. Se esta propriedade estiver configurada para True o driver automaticamente atualizar as propriedades Value e Bits de Bit00 at Bit31 deste objeto em intervalos de tempo definidos pela propriedade Scan Caso contr rio este tag de comunica o n o ser lido Esta propriedade pode ser modificada em execu o O valor padr o desta propriedade True Exemplo Sub Botaol click Faz com que seja parada a leitura do tag Set Phi Application Getobject Driver1 tag obj AllowRead False End Sub 3 2 3 3 AllowWrite PI Configure esta propriedade para definir se este tag dever ou n o ser escrito automaticamente quando for modificada a propriedade Value ou qualquer propriedade Bit de BitO0 at Bit31 Se esta propriedade estiver configurada para True as modifica es ser o enviadas para o equipamento ou dispositivo associado ao driver de comunica o Caso contr rio as modifica es ser o ignoradas Ovalor padr o desta propriedade True Exemplo Sub Botaol Click Faz com que seja desabilitada a escrita do tag Set obj application Getobject Driverl tag obj Allowwrite False End Sub Drivers 65 3 2 3 4 BitOO Bit31 P As propriedades de bit BitOO at Bit31 representam juntas os 32 bits do valor presente na propriedade Value do objeto tag de comunica o sendo Bit00 o bit menos significativo e Bit31 o bit mais significativo Modificar cada um destes bits implica na igual modifica o da propriedade
88. Se omitido assumida a data hora do momento da opera o de escrita Quality indica a qualidade de 0 a 255 Se omitido assumida a qualidade Boa 192 WriteStatus recebe um valor retornado pelo driver que indica o status da escrita se suportado pelo driver de acordo com sua documenta o pr pria O par metro WriteSyncMode permite utilizar o modo de escrita diferente do utilizado no driver As op es dispon veis para este par metro s o 0 usa o modo de escrita configurado no driver 1 faz uma escrita s ncrona 2 faz uma escrita ass ncrona sem confirma o Se o par metro for omitido ser tamb m utilizado o modo de escrita configurado no driver Exemplo Drivers 79 Sub Tagl onRead O m todo writeEx pode ser usado para transferir valores de vari veis de um driver para outro application Getobject Driver2 Tag writeEx Value TimeStamp Quality End sub 3 4 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Elemento de Bloco de Comunica o 3 4 2 1 BitOO Bit31 Fi As propriedades de bit Bit00 at Bit31 representam juntas os 32 bits do valor presente na propriedade Value do elemento de bloco sendo Bit00 o bit menos significativo e Bit31 o bit mais significativo Modificar cada um destes bits implica na igual modifica o da propriedade Value do elemento e vice versa mas isto somente ocorre quando a propriedade UseBitFields estiver configurada para True O v
89. SetVariableValue da Consulta 16 3 8 GroupBy A Texto correspondente ao argumento da cl usula GROUP BY do c digo SQL da consulta Esta propriedade somente de leitura mas pode ser modificada em tempo de execu o 16 3 9 HasFocus PI Esta propriedade determina que o objeto selecionado est com o foco Esta propriedade acess vel apenas em tempo de execu o 396 Consultas 16 3 10 Having A Texto correspondente ao argumento da cl usula HAVING do c digo SQL da consulta Esta propriedade normalmente utilizada com a propriedade GroupBy Esta propriedade somente de leitura mas pode ser modificada em tempo de execu o 16 3 11 MouseOver Fi A propriedade MouseOver informa se o ponteiro do mouse encontra se em cima da Tela Caso afirmativo a propriedade MouseOver habilitada do contr rio ser False Esta propriedade somente de leitura e acess vel apenas em tempo de execu o O valor padr o desta propriedade False 16 3 12 MouseOverChild Fi A propriedade MouseOverChild informa se o ponteiro do mouse encontra se em cima de um dos objetos inseridos na Tela Caso afirmativo a propriedade MouseOverChild habilitada Caso contr rio para False Esta propriedade para somente leitura e acess vel apenas em tempo de execu o O valor padr o desta propriedade False 16 3 13 OrderBy A Texto correspondente ao argumento da cl usula ORDER BY do c digo SQL da consulta Esta propriedade
90. Tag1 Exemplo Sub Tagl OnRead Parent Parent Item Tag2 allowRead False End sub 28 Programando no E3 2 3 4 Acessando Objetos de uma Tela a partir de um Script na Tela Deve se usar somente o m todo Item j que os objetos s o filhos da Tela Exemplo Sub Telal OnPreshow varg Item Retangulo1 visible True End sub Organizer T E E Configura o H Bibliotecas de Objetos E Visualiza o E m Viewer e Quadros a Ly Telas a C Tela inicial ag Recursos Ea Objetos de Servidor H E Explorer Retangulo1 um item da Telalnicial Programando no E3 29 2 3 5 Acessando Objetos de uma Tela a partir de um Script em outro Objeto na Tela Pode se usar o m todo Parent ou o m todo Screen Organizer Dom nio Projeto E Configura o 5 Bibliotecas de Objetos m Visualiza o Viewer e Quadros E Telas 5 E C Retangulo1 C Retangulo2 m Relat rios Recursos El Objetos de Servidor E Explorer Telalnicial o objeto pai de Retangulo1 e Retangulo2 Exemplo Sub Retangulol click Parent Item Retangulo2 visible True End sub 2 3 6 Modificando a Tela ou Objetos de Tela a partir do Servidor Amodifica o de um comportamento qualquer em uma Tela s pode ser feita a partir de associa es o servidor reporta automaticamente para os Viewers todas as mudan as das vari v
91. Value e Bits de Bit00 at Bit31 dos elementos do bloco OPC em intervalos de tempo Caso contr rio este bloco OPC n o ser lido se a propriedade AllowRead estiver configurada para False Esta propriedade pode ser modificada em tempo de execu o O valor padr o desta propriedade True Exemplo Sub Botaol click Faz com que seja parada a leitura do tag Set obi Application Getobject Driver1 tag obj AllowRead False End Sub 3 7 1 3 AllowWrite PI Configure esta propriedade para definir se este tag dever ou n o ser escrito automaticamente quando a propriedade Value ou qualquer propriedade Bit de Bit00 at Bit031 for modificada Se a propriedade estiver em True as modifica es ser o enviadas para o equipamento ou dispositivo associado ao Driver OPC sen o as modifica es ser o ignoradas Estando esta propriedade configurada para True ent o o driver automaticamente atualizar as propriedades Value e Bits de Bit00 at Bit31 deste objeto em intervalos de tempo Caso contr rio este Bloco OPC n o ser lido O valor padr o desta propriedade True Exemplo Sub Botaol Click Set obj Application Getobject Driver1 tag obj Allowwrite False End sub 3 7 1 4 DataType aP Propriedade somente de leitura Determina o tipo de dado associado ao bloco OPC ver tabela a seguir Op es dispon veis para DataType OP O DESCRI O 0 Undefined Valor unidimensional n o defi
92. Value ou Quality Ele informa qual a data hora associada tanto ao valor quanto qualidade do tag de comunica o Esta uma propriedade somente para leitura O valor padr o desta propriedade 00 00 00 Drivers 71 3 2 3 24 UseBitFields Fi Caso a propriedade UseBitFields esteja configurada para True toda vez que o valor da propriedade Value for modificado ele atualizar os bits referentes s propriedades Bit00 at Bit31 Da mesma forma atualizar o valor de Value toda vez que alguma das propriedades Bit00 at Bit31 mudar de valor e posteriormente enviar para o equipamento ou para o dispositivo se a propriedade AllowWrite estiver configurada para True Caso contr rio os bits n o sofrer o nem acarretar o qualquer mudan a Esta propriedade pode ser atualizada ap s ter sido iniciada a comunica o NOTA Os valores dos bits Propriedades Bit00 at Bit31 n o s o afetados pelo ajuste de escala isto representam os bits do valor lido do equipamento antes da convers o 3 2 3 25 Value Atualizada sempre que uma nova leitura v lida de um valor do equipamento ou do dispositivo for feita utilizando se a parametriza o N1 at N4 O tipo desta vari vel n mero inteiro ponto flutuante texto depende do driver ao qual o tagest associado e da sua parametriza o Esta propriedade somente ser atualizada desta forma se a propriedade AllowRead estiver configurada para True e quando n o houver erros de comun
93. Visible P Habilita ou desabilita a visibilidade da se o no relat rio Se a propriedade estiver configurada para True a se o vis vel no relat rio Caso contr rio n o vis vel O valor padr o desta propriedade True 22 5 2 GroupHeader Esta se o cont m informa es sobre propriedades do objeto GroupHeader do Relat rio Este objeto n o possui eventos nem m todos associados 486 Relat rios 22 5 2 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto GroupHeader do Relat rio 22 5 2 1 1 ColumnLayout Fi Determina se o GroupHeader ir utilizar o mesmo layout das colunas configuradas na se o Detail Se a propriedade estiver configurada para True o n mero de colunas na se o Detail ser o mesmo do GroupHeader ou GroupFooter associados Caso contr rio ele permanece com as configura es padr o 22 5 2 1 2 DataField Retorna os dados dos campos do relat rio Define um campo obrigat rio para um grupo dentro do conte do da se o Detail Este valor ajustado ao nome de todos os campos na fonte de dados do relat rio ou ao nome de um campo customizado que est inserido na cole o de campos Quando esta propriedade ajustada o relat rio cria um grupo novo cada vez que o valor do campo muda nos registros de dados do detalhe 22 5 2 1 3 GrpKeepTogether P Determina se a se o GroupHeader ser impressa como um bloco nico na mesma p gina do rela
94. X medido a partir do lado esquerdo do objeto Y medido a partir do topo DragState Indica a condi o do mouse quando gerado o evento e O fmDragStateEnter o mouse est dentro do alcance do objeto e 1 fmDragStateLeave o mouse est fora do alcance do objeto e 2 fmDragStateOver o mouse est em uma nova posi o mas ainda est dentro do alcance do objeto Effect Indica as a es que o objeto alvo suporta ou seja o efeito de arrastar sobre o objeto em quest o e 0O fmDropEffectNone objeto alvo n o aceita copiar ou mover de alguma origem e 1 fmDropEffectCopy objeto alvo permite copiar de alguma origem para si e 2 fmDropEffectMove objeto alvo permite mover de alguma origem para si e 3 fmDropEffectCopyOrMove objeto alvo permite copiar ou mover de alguma origem para si Shift Inteiro cuja soma dos fatores indica o status das teclas SHIFT CTRL e ALT e 1 tecla SHIFT pressionada ActiveX 181 NOME DESCRI O e 2 tecla CTRL pressionada e 4 tecla ALT pressionada Por exemplo um valor igual a 5 indica que as teclas SHIFT e ALT estavam pressionadas 1 4 5 7 3 1 2 BeforeDropOrPaste BeforeDropOrPaste Index Cancel Ctrl Action Data X Y Effect Shift Disparado no momento imediatamente anterior a uma opera o de arrastar e soltar Normalmente isto ocorre logo ap s a ocorr ncia do evento
95. X Y DragState Effect Shift Ocorre quando h uma a o de arrastar e soltar drag and drop sobre o objeto Utiliza se este evento para monitorar se o mouse entrou deixou ou ficou sobre um objeto alvo O evento disparado quando o usu rio move o mouse ou pressiona ou solta algum bot o do mouse A posi o do ponteiro do mouse vai indicar qual o objeto que ir gerar o evento Pode se determinar o status do ponteiro do mouse examinando a vari vel DragState Muitos objetos n o suportam opera es de arrastar e soltar enquanto a vari vel Cancel False que o padr o Isso significa que o objeto rejeita qualquer tentativa de arrastar ou soltar algum outro objeto sobre si e consequentemente n o dispara o evento BeforeDropOrPaste A TextBox caixa de texto e a ComboBoxs o exce es elas aceitam opera es arrastar e soltar mesmo quando Cancel False Vari veis do evento BeforeDragOver NOME DESCRI O Index Indica o ndice da p gina em um objeto multi p ginas que 180 ActiveX NOME DESCRI O ser afetada pela opera o que gerou o evento Para outros objetos ignorada Cancel Status do evento O padr o False e indica que ser o objeto alvo que tratar o evento e n o a aplica o principal Data Dados sendo arrastados para o objeto alvo propriamente ditos X Y Posi o do mouse dentro do objeto alvo em pontos
96. a opera o caso contr rio retorna False Exemplo sub Botaol Click Dim val Y Quando clica no bot o cria uma nova Unit Application Getobject Formula1 Createunit unit2 End Sub 20 1 2 CreateValue CreateValue ValueName Cria um conjunto de valores na tabela de f rmulas Este m todo possui o par metro ValueName que determina o nome do conjunto a ser criado Retorna True se conseguir realizar a opera o caso contr rio retorna False Exemplo Sub Botaol_ClickO Dim val Quando clica no bot o cria um novo Valor App icati on Getobject Formulal Createvalue Modelo5 End Su 462 F rmulas 20 1 3 DeleteUnit DeleteUnit UnitName Apaga uma unidade na tabela de f rmulas Este m todo possui o par metro UnitName que informa o nome da unidade a ser apagada Retorna True se conseguir realizar a opera o caso contr rio retorna False Exemplo sub Botaol Click Dim val Quando clica no bot o apaga a unit Application Getobject Formu al Deleteunit Unit2 End sub 20 1 4 DeleteValue DeleteValue ValueName Apaga um conjunto de valores na tabela de f rmulas Este m todo possui o par metro ValueName que informa o conjunto de valores a ser apagado Retorna True se conseguir realizar a opera o caso contr rio retorna False Exemplo sub Botaol Click Dim val i E Quando clica no bot o apaga um conjunto de valores Application Getobject Formulal Deletevalue Modelo5
97. a 4294967295 232 1 8194 Arrinteger Array unidimensional de valores integer inteiros 8195 Arrlong Array unidimensional de valores inteiros de 32 bits sinalizados 8196 ArrSingle Array unidimensional de ponto flutuante de 32 bits 8197 ArrDouble Array unidimensional de valor de ponto flutuante de 64 bits 8198 ArrCurrency Array unidimensional de valor monet rio com 4 casas decimais 8199 ArrDate Array unidimensional de valor de data hora Drivers 93 OP O DESCRI O 8200 ArrString Array unidimensional de valor literal Texto 8201 ArrObject Array unidimensional de valor de refer ncia a um objeto 8202 ArrError Array unidimensional de valor de c digo de erro 8203 ArrBoolean Array unidimensional de valor booleano verdadeiro ou falso 8204 ArrVariant Array de dados de qualquer tipo usados para objetos e outros valores para os quais otipo de dados desconhecido 8205 ArrUnkObject Array unidimensional de valor de refer ncia a um objeto 8206 ArrDecimal Array unidimensional de valor de ponto flutuante de 96 bits 8228 ArrRecord Array unidimensional de valor record 8208 ArrChar Array unidimensional de valor char 8209 ArrByte Array unidimensional de bytes que s o valores utilizados para cria o de DLLs e para OLE Ocupa 1 byte
98. a Adiciona uma imagem de fundo ao relat rio marca d gua As marcas d gua s o textos ou figuras que aparecem sob o texto do documento Normalmente elas tornam o documento visualmente mais interessante Exemplo de marca d gua Ovalor padr o desta propriedade vazio sem imagem 22 4 1 21 WaterMarkAlignment a Determina o alinhamento marca d gua no relat rio As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para WaterMarkAlignment OP O DESCRI O 0 ddPATopLeft Alinha a imagem ao topo e esquerda 1 ddPATopRight Alinha a imagem ao topo e direita 2 ddPACenter Alinha a imagem ao centro padr o 3 ddPABottomLeft Alinha a imagem base e esquerda 4 ddPABottonRight Alinha a imagem base e direita Relat rios 483 22 4 1 22 WaterMarkPrintOnPages 9 Indica o n mero das p ginas do relat rio que receber o a marca d gua Asintaxe utilizada pode incluir uma nica p gina uma extens o de p ginas ou mesmo uma combina o de ambos Exemplo 1 5 8 9 10 15 22 4 1 23 WaterMarkSizeMode 9 Configura o efeito do tamanho da marca d gua na p gina do relat rio As op es dispon veis s o as seguintes Op es dispon veis para WaterMarkSizeMode OP O DESCRI O 0 ddSMClicp Amarca d gua mostrada no relat rio no seu tamanho original 1 d
99. a propriedade BorderStyle esteja configurada para 1 fmBorderStyleSingle O valor padr o desta propriedade preto RGB 0 0 0 7 3 4 3 6 BorderStyle aP A propriedade BorderStyle determina o estilo de borda que ser aplicada ao objeto As op es dispon veis s o e 0 fmBorderStyleNone sem borda e 1 fmBorderStyleSingle com borda simples 7 3 4 3 7 BoundColumn Determina a coluna da lista onde os dados ser o armazenados Por exemplo se cada linha cont m 8 itens e a propriedade BoundColumn 3 o sistema armazena as informa es na terceira coluna da linha atualmente selecionada Se o valor for igual a O este valor passado para a propriedade Listindex do objeto Se o valor for 1 ou superior o dado indicado atribu do coluna referente ao valor especificado na propriedade As colunas s o numeradas a partirde 1 7 3 4 3 8 CanPaste P A propriedade CanPaste especifica se a rea de transfer ncia cont m os dados aos quais o objeto d suporte Se a op o estiver configurada para True o objeto pode receber informa es coladas da rea de transfer ncia Se os dados da rea de transfer ncia estiverem em um formato ao qual o objeto n o d suporte a propriedade CanPaste ser False Por exemplo ao tentar colar um bitmap em um objeto que s d suporte a texto CanPaste ser False Esta propriedade acess vel apenas em tempo de execu o ActiveX 197 7 3 4 3 9 Column Especifica a linha e a colu
100. a sua refer ncia atrav s dos itens dessa cole o Ovalor padr o desta propriedade vazio Exemplo 402 E3Browser Sub E3Browserl Click Troca a cor do campo Campol Set fields Screen Item E3Browser Fields Set campol fields Item Campol campol BkColor RGB 255 0 0 vermelho Mostra quantos campos tem o E3Browser MsgBox fields Count Mostra o nome dos campos do E3Browser For Each field In fields MsgBox field Name Next End sub 17 3 8 FixedBkColor a Especifica a cor do fundo da primeira coluna do E3Browser O valor padr o desta propriedade a cor bege RGB 236 233 216 17 3 9 FixedColumnWidth 9 Determina a largura da primeira coluna do E3Browser em pixels O valor padr o desta propriedade 30 pixels 17 3 10 FixedRowFont Determina a fonte texto utilizada na linha de cabe alho do E3Browser Esta propriedade n o pode ser utilizada em scripts ou em associa es sendo configurada somente via Studio O valor padr o desta propriedade a fonte Arial 17 3 11 FixedRowHeight 9 Determina a altura em pixels da linha de cabe alho do E3Browser O valor padr o desta propriedade 20 17 3 12 FixedTextColor E Muda a cor do cabe alho do E3Browser 17 3 13 Frame 5 Retorna o quadro pai do objeto Esta propriedade acess vel apenas em tempo de execu o E3Browser 403 17 3 14 GridBkColor E Determina a cor de fundo da rea de dados do E3Browser O valor
101. alarmes ser o mostrados ou n o de acordo com a sua severidade Quando estiver em True ser o mostrados os alarmes de severidade baixa do contr rio estes alarmes n o ser o mostrados O valor padr o desta propriedade True 13 3 34 ShowMediumPriority P Filtra quais alarmes ser o mostrados ou n o de acordo com a sua severidade Quando estiver em True ser o mostrados os alarmes de severidade m dia do contr rio estes alarmes n o ser o mostrados O valor padr o desta propriedade True 13 3 35 SimpleAreaFilter Fi Quando esta propriedade for True o comportamento de filtragem pelo nome de rea de alarmes baseado apenas na coincid ncia da parte inicial do nome Quando for False o comportamento leva em conta todo o nome da rea mas permite o uso de caracteres coringa e m ltiplos filtros de rea que devem ser separados por dois pontos Vertamb m a propriedade Filter que especifica o filtro por nome de rea 372 E3Alarm 13 3 36 TabStop PI Esta propriedade determina a utiliza o da tecla TAB no sistema Se o campo estiver True poss vel utilizar a tecla caso contr rio a tecla n o pode ser utilizada 13 3 37 Tip A Apropriedade Tip mostra um texto popup quando o mouse estiver por um breve momento sobre o objeto em execu o 13 3 38 Visible FP Esta propriedade define se o objeto deve ou n o estar vis vel Se a propriedade estiver configurada para True o objeto fica vis vel desde que os
102. altura em pixels ou HIMETRIC da datela Tela Estilo da janela Permite configurar o estilo da janela a ser mostrada definindo t tulo e a disponibilidade das bordas e bot es de fechar entre outros ver a Caixa de Di logo Estilo de Janela 1 3 3 Executar Aplica o Executa uma aplica o espec fica Ielatmicial aj b x E Telatn cial dadas x Click Fires when screen is dicked on 88 Executar aplica o Executa com os argumentos a partir do diret rio Executar no diret rio Modo de exibi o Normal E Mensagens ore o EE Configura es do pick Executar Aplica o Op es dispon veis no pick Executar Aplica o CAMPO DESCRI O Aplica o Apertando se o bot o _ navegar no disco para indicar o arquivo da aplica o a ser executada Argumentos Permite especificar argumentos para a chamada da aplica o 16 Introdu o CAMPO DESCRI O Executar no Determina o diret rio de trabalho da aplica o que ser diret rio executada Modo de Determina o tipo de janela de execu o da aplica o normal exibi o minimizado ou maximizado 1 3 4 Carregar Valor Carrega um valor em um tag M Telalnicial al bjx E Telatnicial E dick ova drRa xX a Click Fires when screen is dicked on
103. amp evt ActorID amp Chr 13 str str amp area amp evt Area amp Chr 13 str str amp alarmsourceName amp evt Alarmsourcename amp Chr 13 E3Alarm 365 SER stre Ful lAlarmSourceName amp evt FullAlarmSourceName amp Chr 13 str str amp ConditionName amp evt ConditionName amp Chr 13 ser SSE Ai EventCategory amp evt DR amp chr 13 SER sena EventType E evt EventType amp chr 13 str str amp Message amp evt Message amp Chr 13 str str amp Quality amp evt Quality amp Chr 13 str str amp Source amp evt Source amp Chr 13 str str amp subConditionName amp evt subConditionName amp Cchr 13 str str amp Formattedvalue amp evt Formattedvalue amp Chr 13 str str amp userField 1 amp evt UserField 1 amp chr 13 str str amp UserField 2 amp evt UserField 2 amp chr 13 str str amp userField 3 amp evt UserField 3 amp chr 13 str str amp UserField 4 amp evt UserField 4 amp chr 13 str str amp severity amp evt Severity amp Chr 13 str str amp acked amp evt acked amp Chr 13 str str amp ackRequired amp evt AckReguired amp chr 13 str str amp conditionactive amp evt Conditionactive amp Chr 13 SERES ERES Enabled amp evt Enabled amp chr 13 str str amp EventCLSID amp evt EventCLSID amp Chr 13 MsgBox str Else
104. antes desta atribui o Da mesma forma no momento da escrita feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a propriedade EnableScaling est configurada para True O valor padr o desta propriedade 0 Exemplo sub Elemento OnsStartRunning O Faz o ajuste de escala de um elemento temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EULow 100 EULow O End sub 82 Drivers 3 4 2 9 Index 9 Especifica a posi o que o elemento de bloco ocupa entre os elementos configurados pela propriedade Size do bloco de comunica o no qual ele est inserido Esta propriedade aceita valores de O at um n mero menor do que a valor definido em Size Por exemplo configurando um bloco de comunica o para ter Size igual a 20 o n mero m ximo v lido para a propriedade Index ser 19 e o m nimo ser O Esta propriedade pode ser alterada ap s iniciada a comunica o O valor padr o desta propriedade 0 por m ao mapear os elementos de um bloco o E3 Studio automaticamente ajusta o par metro Index para um valor de acordo com o especificado Exemplo Sub Elemento OnStartRunningO Index 15 End sub 3 4 2 10 PercentDeadBand 9 Apropriedade PercentDeadBand determina a varia o m nima do valor banda morta de um elemento de bloco para que seu v
105. bind Set bind screen Item TableBind Links Item 1 megeox bind Type amp Conex o por Tabela End Su 9 3 Conex o Simples Esta se o cont m informa es sobre as propriedades da Conex o Simples 9 3 1 Propriedades A Conex o Simples n o possui nenhuma propriedade associada 284 Associa es 9 4 Conex o Bidirecional Esta se o cont m informa es sobre propriedades da Conex o Bidirecional Este objeto n o possui eventos nem m todos associados 9 4 1 Propriedades Esta se o cont m informa es sobre as propriedades da Conex o Bidirecional 9 4 1 1 BiDirectional Fi True se a conex o for bidirecional False se a conex o for reversa ou simples Exemplo Sub CommandButton29 click Dim bind Set bind screen Item simpleBind Links Item 1 bind BiDirectional True End sub 9 5 Conex o Reversa Esta se o cont m informa es sobre propriedades da Conex o Reversa Este objeto n o possui eventos nem m todos associados 9 5 1 Propriedades Esta se o cont m informa es sobre as propriedades da Conex o Reversa 9 5 1 1 Reverse Fi True se a conex o for reversa False se a conex o for bidirecional ou simples Exemplo Sub CommandButton29 click Dim bind Set bind screen Item simpleBind Links Item 1 bind Reverse True End sub Associa es 285 9 6 Conex o Digital Esta se o cont m informa es sobre propriedades da Conex o Digital Este objeto
106. come ou 386 Storage CAP TULO Consultas Esta se o cont m informa es sobre eventos m todos e propriedades do objeto Consulta 16 1 Eventos Esta se o cont m informa es sobre os eventos do objeto Consulta 16 1 1 OnAsyncQueryFinish OnAsyncQueryFinish Recordset Error Ocorre quando o m todo GetAsyncADORecordset retornado O par metro Recordset o ADO Recordset gerado pela consulta e o par metro Error um booleano que quando verdadeiro mostra que o objeto n o conseguiu ser gerado Exemplo Sub Consultal OnasyncQueryFinish Recordset Error MsgBox Retornou Cstr Recordset RecordCount registros End Sub 16 2 M todos Esta se o cont m informa es sobre os m todos do objeto Consulta 16 2 1 AddField AddField Name Table O m todo AddField adiciona um novo campo da tabela na consulta O par metro Name determina o nome do novo campo que ser adicionado consulta O par metro Table determina o nome da tabela a qual o campo pertence Este m todo foi desenvolvido apenas para manter a compatibilidade com o antigo objeto Consulta do E3Chart Exemplo sub Botaol click Sereen Item E3Browser Item Consulta addField Campo1 End Su Consultas 387 16 2 2 AddStorageTag AddStorageTag Name FieldType Adiciona um tag pertencente ao Storage a ser adicionado consulta O par metro Name recebe o nome do taga ser adicionado O par metro FieldType indi
107. comunica o que cont m o bloco Se a propriedade EnableDriverEvent do tag estiver configurada para True ser habilitada a gera o do evento OnTagRead por este tag Caso contr rio n o ocorre Os tr s tipos de elementos de comunica o Tag de Comunica o Bloco de Comunica o e Elemento de Bloco podem gerar este evento O evento ocorre no driver e n o no bloco 3 3 3 10 ParambDevice Define o endere o do equipamento acessado pelo bloco Esta propriedade herdada do driver mas seu valor pode ser sobrescrito se necess rio 3 3 3 11 Paramitem Identifica o dado que o bloco acessa dentro de um equipamento 3 3 3 12 Quality 9 Apropriedade Quality informa qual a qualidade do valor contido na propriedade Value Cada vez que o Driver atribui um novo valor para o Bloco ele tamb m configura a qualidade daquele dado Esta propriedade somente para leitura O valor padr o desta propriedade O Qualidade Ruim NOTA Para maiores informa es sobre qualidade consulte o t pico Propriedade Quality ou o t pico Qualidade no Manual do Usu rio Drivers 77 3 3 3 13 Scan 9 Especifica qual tempo de varredura ser utilizado pelo servidor para atualizar o bloco Esta propriedade representada em milissegundos e pode ser modificada ap s iniciada a comunica o sendo utilizada apenas quando a propriedade AllowRead estiver habilitada Ao configurar esta propriedade nos diversos blocos presentes na aplica o r
108. de mem ria 8210 ArrWord Array unidimensional de valor inteiro de 32 bits 8211 ArrDWord Array unidimensional de valor inteiro de 32 bits 8212 ArrLonglong Array unidimensional de valor inteiro de 16 bits 8213 ArrDDWord Array unidimensional de valor inteiro de 32 bits sinalizado 8214 Arrinteger Array unidimensional de Inteiro de 16 bits sinalizado 8215 ArrUlnteger Array unidimensional de n mero inteiro sem sinal no caso equivale a um DWORD que vai de 0 a 4294967295 232 1 94 Drivers 3 6 1 6 DeviceHigh 9A propriedade DeviceHigh define o valor m ximo atingido por um tag no equipamento ou no dispositivo Esta propriedade ser utilizada para fazer o ajuste de escala do valor proveniente do equipamento ou do dispositivo antes de ser atribu do propriedade Value Da mesma forma no momento da escrita feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a propriedade EnableScaling estiver configurada para True sen o os valores permanecem os mesmos O valor padr o desta propriedade 1000 Exemplo Sub Tag OnStartRunningO Faz o ajuste de escala de um tag de temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub 3 6 1 7 DeviceLow aP A proprie
109. diante O layout determinado conforme a op o configurada 490 Relat rios Op o 0 ddCDDownAcross Op o 1 ddCDAcrossDown Lorem A 22 5 3 1 3 ColumnSpacing FI Determina o espa amento da coluna na se o Detail O valor padr o desta propriedade 0 Relat rios 491 22 5 3 1 4 KeepTogether P Determina se as se es do relat rio ser o impressas como um nico bloco na mesma p gina As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para KeepTogether OP O DESCRI O 0 ddGrpNone H uma quebra de p gina depois do relat rio 1 ddGrpFirstDetail O relat rio imprimir a se o Detail na mesma p gina ou coluna 22 5 3 1 5 NewColumm a Insere uma nova quebra de coluna antes ou depois da impress o da se o no relat rio As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para NewColumn OP O DESCRI O 0 ddNPNone N o h quebra de p gina na se o 1 ddNBefore Inicia a impress o da se o em uma nova p gina 2 ddNPA ter Inicia uma nova p gina depois de imprimir a se o 3 ddNPBeforeAfter Inicia a impress o em uma nova p gina e uma nova p gina depois de imprimir a se o 22 5 3 1 6 NewPage P Insere uma quebra de p gina no relat rio As op es dispon veis para es
110. digital Configure a propriedade OverrideFillMode para 2 SolidFill 2 Para exibir a velocidade a propriedade Value do Display deve ser associada propriedade Velocidade do XControl 3 O Bot o Liga Desliga troca o valor da propriedade Estado atrav s de uma associa o simples Note que e As associa es dentro da biblioteca s o internas e seu formato Nome do Controle Nome da Propriedade e Oobjeto depois de inserido na Tela dever ter essas propriedades associadas aos tags verdadeiros para cada um dos motores e Uma associa o de um tag para a propriedade Estado ter que ser feita para cada Motora Programando no E3 37 Aplica o E3 Viewer Screen Title lol x m E Viewer Outra possibilidade mais abrangente utiliza um XObject para o motor Desta forma todas as informa es relativas aos motores residem em objetos que ficam no servidor Assim podemos construir v rios tipos de interface para o motor XControls que trazem do servidor atrav s do XObject somente as informa es necess rias Desta maneira o objeto Motor A teria que ser modificado para apontar para um XObject ao inv s de declarar em si mesmo todas as propriedades 1 Crie um XObject chamado Motor ADados e declare nele as propriedades Estado e Velocidade 2 Crie um XControl MotorA que possua apenas uma propriedade chamada MeusDados do tipo Motor ADados 3 MotorADados dever ser inserido numa p
111. e PosYinformam a nova posi o em pixels com rela o esquerda e ao topo respectivamente Os par metros SizeX e SizeYinformam o novo comprimento e a nova altura respectivamente em pixels ou em HIMETRIC Todos os par metros s o opcionais Exemplo Sub Tela2 OnPreshow varg Quando a Tela2 aberta no objeto top altera a posi o e o tamanho do frame Appl ication itema top D Noverrame 100 100 200 200 End su 10 4 1 7 OpenScreen OpenScreen ScreenName Arg O m todo OpenScreen abre uma Tela dentro de um divisor O par metro ScreenName determina o nome da Tela a ser aberta poss vel tamb m especificar o percentual de zoom da Tela e a habilitar a barra de rolagem atrav s da chave como o modelo a Viewer 323 seguir lt nome da tela gt lt zoom gt lt habi litar rolagem gt onde lt nome da tela gt o nome da Tela a ser aberta lt Zoom gt o percentual de zoome lt habilitar rolagem gt habilita ou desabilita a rolagem O percentual de zoom da Tela pode assumir os seguintes valores 1 toda a p gina e 2 a largura da Tela ocupa 100 da largura do divisor com altura proporcional 3 a altura da Tela ocupa 100 da altura do divisor com largura proporcional 4 a Tela preenche totalmente o divisor e 5a 100 equivale ao percentual de zoom da Tela propriamente dito Ahabilita o de rolagem pode assumir os seguintes valores e O desabilita a rolagem e 1 habilita a rolagem O pa
112. e o objeto aparece esmaecido Al m disso se o objeto exibir um bitmap o bitmap fica esmaecido sempre que este objeto estiver desabilitado As propriedades Enabled e Locked s o interligadas Quando as propriedades Enabled e Locked forem ambas True o objeto pode receber foco e aparecer normalmente na Tela e os dados podem ser copiados mas n o editados Quando Enabled for True mas Locked for False os dados podem ser n o s copiados mas tamb m editados No entanto quando Enabled for False o objeto n o recebe foco e fica esmaecido na Tela independentemente do status de Locked Al m disso os dados n o podem ser copiados nem tampouco editados poss vel combinar as configura es das propriedades Enabled e TabStop para impedir que o usu rio selecione um bot o de comando com a tecla TAB embora ainda seja permitido ao usu rio clicar no bot o Definir a propriedade TabStop como False significa que o bot o de comando n o aparecer na ordem de tabula o Entretanto se Enabled for True o usu rio ainda poder clicar no bot o de comando desde que a propriedade TakeFocusOnClick esteja definida como True 186 ActiveX 7 3 2 3 ForeColor E Especifica a cor do preenchimento do fundo do objeto Nos scripts utilize a fun o do VBScript RGB para formar a cor a ser associada a esta propriedade O valor padr o desta propriedade para todos os objetos MSForms a cor preta RGB 0 0 0 7 3 2 4 Mouselcon 4 A propr
113. em branco pvargindex o ndice do texto na lista se for omitido pvargitem adicionado como ltimo item da lista Exemplo sub CommandButton1 Click EntryCount EntryCount 1 ComboBox1 AddTtem EntryCount amp selection End sub 7 3 4 2 2 Clear Clear Limpa o texto do objeto Exemplo Sub ClearTextButton Click ComboBox1 Clear End sub 7 3 4 2 3 Copy Copy Copia o texto previamente selecionado para a rea de transfer ncia Utilize o m todo Paste para colar o texto no local indicado Exemplo Sub CommandButtonl clickO Screen Item comboBox1 Copy O End sub 7 3 4 2 4 Cut Cut Recorta o texto previamente selecionado para a rea de transfer ncia Utilize o m todo Paste para colar o texto no local indicado Exemplo Sub CommandButtonl clickO screen Item comboBox1 cut O End sub 194 ActiveX 7 3 4 2 5 DropDown DropDown O m todo DropDown abre a lista de itens de uma Lista de Sele o Achamada deste m todo tem o mesmo efeito que clicar em tempo de execu o no bot o com a seta ao lado direito do objeto Exemplo Sub CommandButtonl Click Dim ComboBox1 ComboBox1 AddTtem Abacaxi ComboBox1 AddTtem Morango ComboBox1 AddItem uva ComboBox1 AddItem Laranja ComboBox1 DropDown O End sub 7 3 4 2 6 Paste Paste Insere no objeto o conte do da rea de transfer ncia Exemplo Sub CommandButtonl clickQO Screen Item comboBox1 Paste End sub
114. escala de um tag de temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub 3 2 3 11 EUHigh 9 Define qual o valor m ximo que dever ser atribu do propriedade Value ajustando a escala ao valor do equipamento ou do dispositivo antes desta atribui o Da mesma forma no momento da escrita feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a propriedade EnableScaling est configurada para True O valor padr o desta propriedade 1000 Exemplo Sub Tag OnStartRunning O Faz o ajuste de escala de um tag de temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub NOTA Os valores dos bits Propriedades Bit00 at Bit31 n o s o afetados pelo ajuste de escala Isto representam os bits do valor lido do equipamento antes da convers o 68 Drivers 3 2 3 12 EULow 9 Define qual o valor m nimo que dever ser atribu do propriedade Value ajustando a escala ao valor do equipamento ou do dispositivo antes desta atribui o Da mesma forma no momento da escrita feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a
115. fonte resultar em False Exemplo Associa es 287 Sub offvalue Click On Error Resume Next Dim Value If sai ication showpickcolor value Foregroundcolor 400 300 Then Dim Bind Set Bind Screen Item Retangulo1l Links Item Foregroundcolor If Bind Is Nothing Then E nRor Retangulol n o tem associa o Else MsgBox Retangulol est associado a amp Bind Source amp MsgBox Mudando Offvalue de amp Bind offvalue amp para amp Value Bind offvalue value End If Foregroundcolor Value End If End sub 9 6 1 6 OnValue Especifica o valor assumido pela propriedade quando a express o da fonte for True Exemplo sub onvalue click On Error Resume Next Dim Value If application showpickcolor Value Foregroundcolor 400 300 Then Dim Bind Set Bind Screen Item Retangulo1l Links Item Foregroundcolor If Bind Is Nothing Then ERR Retangulol n o tem associa o se MsgBox Retangulol est associado a amp Bind Source amp MsgBox Changing Onvalue from amp Bind onValue amp to amp value Bind onvalue Value End If Foregroundcolor Value End If End sub 9 7 Conex o Anal gica Esta se o cont m informa es sobre propriedades da Conex o Anal gica Este objeto n o possui eventos nem m todos associados 9 7 1 Propriedades Esta se o cont m informa es sobre as propriedades da Conex o Anal gica 288 Associa es 9 7 1 1 DstHiVa
116. maiores informa es veja o evento Onlnactive do objeto Viewer O valor padr o desta propriedade 5 cinco minutos Exemplo Sub CommandButton3 clickQO MsgBox A aplica o ficar inativa em amp Application Inactivitytime amp minuto s End su 10 3 13 InitialScreen Indica a Tela ou Quadro inicial que dever ser mostrado quando o Viewer chamado Atrav s da propriedade WindowsStyle poss vel determinar se a janela dever iniciar maximizada janelada ou minimizada O valor padr o desta propriedade Telalnicial 10 3 14 IsPlaybackMode FI se True indica que o Viewer est rodando dentro de um E3Playback em modo playback Esta propriedade somente de leitura e s est dispon vel em tempo de execu o 10 3 15 IsReadOnly P se ajustada para True indica que o Viewer est no modo Somente Leitura acesso restrito Viewer 317 10 3 16 LoginRetries 9 Especifica o n mero de retentativas de login do Viewer isto quantas vezes a caixa de di logo de login ser exibida al m da primeira vez Ovalor padr o desta propriedade 2 10 3 17 MaximizeButton FI se a op o estiver habilitada True o bot o Maximizar habilitado no Viewer e poss vel utilizar esse bot o Caso contr rio esse bot o n o aparece na janela Ovalor padr o desta propriedade True 10 3 18 MinimizeButton FI se a op o estiver habilitada True o bot o Minimizar habilitado no Viewer e poss
117. metro s o 0 usa o modo de escrita configurado no driver 1 faz uma escrita s ncrona 2 faz uma escrita ass ncrona sem confirma o Se o par metro for omitido ser tamb m utilizado o modo de escrita configurado no driver Para maiores detalhes consulte a documenta o do driver Este m todo retorna um booleano que indica o sucesso ou n o da opera o Drivers 63 3 2 2 2 WriteEx WriteEx Value Timestamp Quality WriteStatus WriteSyncMode Faza escrita de um valor no equipamento Todos os seus par metros s o opcionais se omitidos o comportamento do m todo igual ao do m todo Write Este m todo retorna um booleano que indica o sucesso ou n o da opera o O par metro Value define o valor a ser escrito no driver Otipo de dado depende do driver se omitido assumido o valor corrente do tag Timestamp especifica a data hora a ser escrita no tag se suportada pelo equipamento Se omitido assumida a data hora do momento da opera o de escrita Quality indica a qualidade de 0 a 255 Se omitido assumida a qualidade Boa 192 WriteStatus recebe um valor retornado pelo driver que indica o status da escrita se suportado pelo driver de acordo com sua documenta o pr pria O par metro WriteSyncMode permite utilizar o modo de escrita diferente do utilizado no driver As op es dispon veis para este par metro s o 0 usa o modo de escrita configurado no driver 1 faz uma escrita s ncr
118. ncrona o evento OnTagWrite ser gerado apenas quando o servidor enviar a resposta indicando o efetivo sucesso ou n o da escrita Nesse caso o evento ser gerado apenas se a propriedade EnableDriverEvent for True nesse momento e n o no momento do envio da escrita O valor padr o dessa propriedade False 3 7 1 6 ItemlD AA propriedade ItemlID determina o caminho que identifica o Bloco OPC no servidor ao qual o Driver OPC se conecta A defini o deste caminho flex vel e depende do servidor espec fico Normalmente os servidores especificam um espa o de ID com itens hier rquicos do tipo ItemPai ltemFilho Tag1 A propriedade ItemlD funciona como uma chave nica para os dados considerando o onde ou o qu que permite ao servidor OPC se conectar fonte dos dados Apesar de o valor padr o ser vazio necess rio especificar algum valor para que o Bloco OPC seja v lido Exemplo Sub BlocooPc1 OnstartRunningO MsgBox ItemID End Sub 104 Drivers 3 7 1 7 Quality 9 A propriedade Quality informa qual a qualidade do valor contido na propriedade Value Cada vez que o Driver atribui um novo valor para o Bloco ele tamb m configura a qualidade daquele dado Esta propriedade somente para leitura O valor padr o desta propriedade O Qualidade Ruim 3 7 1 8 Size 9 Define o tamanho do conjunto de valores do bloco Consulte a documenta o do driver utilizado para conhecer qual o limite para esta propriedade de acord
119. o MsgBox valor atual de elml amp ol End Sub Drivers 115 CAP TULO Objetos em Tempo de Execu o do Servidor Esta se o cont m informa es sobre objetos que s podem ser utilizados em tempo de execu o o Servidor Application e as Pastas de Aplicativo 4 1 Servidor Esta se o cont m informa es sobre m todos espec ficos do objeto Server Application Este objeto possui os m todos gerais Item e Save al m das propriedades Name e Count descritos na se o Eventos M todos e Propriedades Gerais dos Objetos O objeto n o possui eventos associados 4 1 1 M todos Esta se o cont m informa es sobre os m todos espec ficos do objeto Servidor NOTA Os m todos aqui descritos s podem ser utilizados em tempo de execu o n o estando dispon veis no Studio 4 1 1 1 ClearFailure ClearFailure FailureName Este m todo deve ser chamado para indicar que uma falha reportada por ReportFailure n o est mais ativa O par metro FailureName cont m o nome da falha definido pelo usu rio e deve ser passado para o m todo ReportFailure quando de sua chamada 116 Objetos em Tempo de Execu o do Servidor 4 1 1 2 ReportFailure ReportFailure FailureName FailureDescription FailureWeight Este m todo permite que o aplicativo reporte falhas para o E3 Server que podem ser visualizadas clicando com o bot o direito sobre o cone do E3 na rea de Notifica o Quando o m todo u
120. o cont m informa es sobre os eventos comuns a todos os Objetos de Tela Telas e Objetos de Tela 141 6 2 1 1 Click Click Ocorre quando o bot o esquerdo do mouse pressionado sobre o objeto Este evento n o ocorrer se o objeto n o estiver vis vel ou se sua propriedade Enabled estiver configurada para False Avisibilidade do objeto depende de tr s fatores propriedade Visible igual a True objeto pai vis vel e propriedade Layer do objeto presente na camada da Tela Exemplo Sub Botao Click Mostra uma caixa de mensagem quando o usu rio clica no objeto MsgBox voc clicou sobre o objeto End Sub 6 2 1 2 DbClick DbClick Ocorre quando h um duplo clique ou seja o bot o esquerdo do mouse pressionado rapidamente duas vezes sobre o objeto Este evento n o ocorrer se o objeto n o estiver vis vel ou se sua propriedade Enabled estiver configurada para False Avisibilidade do objeto depende de tr s fatores propriedade Visible igual a True objeto pai vis vel e propriedade Layer do objeto presente na camada da Tela Exemplo sub Botao DbClick Mostra uma caixa de mensagem quando o usu rio realiza um duplo clique no objeto MsgBox voc clicou duas vezes sobre o objeto End Sub 6 2 1 3 KeyDown KeyDown KeyCode Shift Ocorre no momento em que uma tecla pressionada e o objeto est com o foco do teclado Note que este evento n o ser gerado se o objeto n o estiver habilitado pro
121. o do Viewer j aberto apenas das janelas que forem abertas utilizando a configura o do Viewer 10 3 33 WindowSmallTitle FP Indica se a janela do Viewer deve ter a barra de t tulo pequena Esta propriedade s tem efeito se a propriedade TitleBar for verdadeira O valor padr o dessa propriedade falso Essa propriedade de leitura e escrita mas alterar seu valor em tempo de execu o n o altera a configura o do Viewer j aberto apenas das janelas que forem abertas utilizando a configura o do Viewer 10 3 34 WindowStayOnTop F Indica se a janela do Viewer deve sempre se sobrepor s outras janelas O valor padr o dessa propriedade falso Essa propriedade de leitura e escrita mas alterar seu valor em tempo de execu o n o altera a configura o do Viewer j aberto apenas das janelas que forem abertas utilizando a configura o do Viewer 10 3 35 WindowStyle P Define o estilo inicial de janela do Viewer As op es dispon veis s o e 0O Maximized inicia o Viewer maximizado e 1 Windowed inicia o Viewer janelado e 2 Minimized inicia o Viewer minimizado Viewer 321 10 3 36 WindowWidth 9 Determina a largura da janela do Viewer em pixels Ovalor padr o dessa propriedade 400 10 4 Objeto top Esta se o cont m informa es sobre m todos e propriedades do objeto top Este objeto n o possui eventos associados 10 4 1 M todos Esta se o cont m informa es sobre os m t
122. o eles respectivamente tipo do dado intervalo m nimo de tempo entre grava es intervalo m ximo de tempo sem grava es banda morta e unidade da banda morta do tag Como usar Cria o de uma sess o set da Application Getobject storagel Createnewsession 0 O 3600 dO Adi o de um tag sess o m todo AddField result session addrField TemprTag O O 100000 15 1 Adi o de valores m todo AddValue result session Addvalue TemptTag Now 192 10 380 Storage 15 1 2 StartAcquisition StartAcquisition Inicia ou retoma a gera o de dados que v o para o Banco de Dados O Storage recebe notifica es sobre quais tags cadastrados sofreram modifica o e quando isto acontece ele verifica se os registros ser o gravados ou n o Quando este m todo chamado a notifica o de mudan a e a gera o de grava es ser o iniciadas ou retomadas Exemplo Sub Botaol Click Quando clica no bot o habilita o Storage application Getobject Storagel StartacquisitionO End Sub 15 1 3 StopAcquisition StopAcquisition P ra a gera o de dados que v o para o Banco de Dados O Storage recebe notifica es sobre quais tags cadastrados sofreram modifica o e quando isto acontece ele verifica se os registros ser o gravados ou n o Quando este m todo chamado a notifica o de mudan a e a gera o de grava es s o paralisadas Exemplo Sub Storagel OnStartRunning O
123. o evento OnTagWrite ser gerado apenas quando o servidor enviar a resposta indicando o efetivo sucesso ou n o da escrita Nesse caso o evento ser gerado apenas se a propriedade EnableDriverEvent for True nesse momento e n o no momento do envio da escrita O valor padr o dessa propriedade False 3 6 1 9 EnableScaling Fi se esta propriedade estiver configurada para True todo valor proveniente do equipamento ou do dispositivo sofrer ajuste de escala conforme as propriedades EUHigh e EULow antes de ser atribu do propriedade Value Caso a propriedade EnableScaling tenha o valor configurado para False nenhum ajuste de escala ser efetuado em nenhum dos dois sentidos tanto para escrita como para leitura O valor padr o desta propriedade False Exemplo Sub Tag OnStartRunningO Faz o ajuste de escala de um tag de temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub 3 6 1 10 EU Identifica a unidade de engenharia representada pelo valor como por exemplo graus metros KW h etc O valor desta propriedade vazio Exemplo Sub Tag OnStartRunningO Faz o ajuste de escala de um tag de temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh
124. o mais cedo poss vel Case 2 MsgBox se o driver indicar sucesso na escrita _ o valor escrito assumido diretamente pelo tag _ sem l lo do PLC End select End sub Drivers 61 3 1 3 13 WriteRetries 9 Indica o n mero de re tentativas de escrita do driver em caso de erro Se for igual a 2 indica que o driver vai tentar duas vezes mais uma comunica o falhada sem contar a tentativa original 3 1 3 14 WriteSyncMode P Determina como as escritas ser o enviadas para o IOServer modo s ncrono ou ass ncrono Esta propriedade possui as seguintes op es de configura o Op es dispon veis para WriteSyncMode OP O DESCRI O 0 wsmDefault Modo s ncrono padr o 1 wsmSync Modo s ncrono Sempre que um valor escrito em algum tag o E3Run envia a escrita para o IOServer e aguarda o retorno da escrita 2 wsmAsyncUnconfirmed Modo ass ncrono sem confirma o Todas as escritas s o enviadas para o IOServer sem aguardar o retorno e assume se sempre que a escrita funcionou Quando em modo ass ncrono os m todos de escrita dos tags Write WriteEx sempre retornam True imediatamente e o status da escrita nos m todos que retornam este status fica sempre vazio Empty O evento OnTagWrite do driver executado assim que a escrita enviada para o IOServer e o par metro Succeeded fica sempre em True As escritas ass ncronas ser o executadas pelo
125. objeto do tipo Driver de Comunica o DriverLocation c MERENI dm P1 2 p2 P3IS 3600 End Sub 58 Drivers 3 1 3 5 P2 9 Utilize a propriedade P2 para configurar o driver Consulte a documenta o do driver para sua correta parametriza o Esta propriedade n o pode ser modificada ap s iniciada a comunica o O valor padr o desta propriedade 0 Exemplo sub Driverl Beforestart Driverl um obj jeto do tipo Driver de Comunica o DriverLocation tes driver pic dm 2 2 P2 28 9600 End sub 3 1 3 6 P3 9 Utilize a propriedade P3 para configurar o driver Consulte a documenta o do driver para sua correta parametriza o Esta propriedade n o pode ser modificada ap s iniciada a comunica o Exemplo sub Driverl Beforestart Driverl um obj jeto do tipo Driver de Comunica o DriverLocation va driveripie di di PISZE E dl P3 9600 End sub 3 1 3 7 P4 9 Utilize a propriedade P4 para configurar o driver Consulte a documenta o do driver para sua correta parametriza o Esta propriedade n o pode ser modificada ap s iniciada a comunica o Exemplo sub Driverl Beforestart Driverl um obj jeto do ae Driver de Comunica o DriverLocation Hes driver plc dl1 ls 2 Ep E P3 9600 P4 500 End sub 3 1 3 8 ParambDevice Define o endere o do equipamento acessado pelo driver Esta propriedade herdada pelos tags filhos do driver que podem sobrescreve
126. op o do menu Caso haja um conjunto de dois delimitadores sucessivos um separador ser inserido Use os caracteres de abre e fecha chaves para criar um submenu Um asterisco na frente de um stringindica que a op o estar marcada J um sinal de exclama o far com que a op o esteja desabilitada A posi o da caixa de di logo pode ser configurada atrav s dos par metros Left e Top que indicam a dist ncia da margem esquerda e do topo da tela em pixels respectivamente Caso estes par metros n o sejam informados o menu posicionado de acordo com o local onde o clique do mouse foi acionado Este m todo retornar 0 se nenhuma op o foi selecionada ou o n mero da op o sendo que 1 seria para a primeira op o contida no texto 2 para a segunda e assim por diante Exemplo Sub Botaol Click Viewer 309 op Application selectMenu op ol op o2 1 op o2 Op o3 Op o4 op oS If op 1 Then MsgBox op o 1 foi escolhida ElseIf op 2 Then MsgBox op o 2 foi escolhida ElseIf op 3 Then MsgBox Op o 3 foi escolhida ElseIf op 4 Then MsgBox op o 4 foi escolhida ElseIf op O Then MsgBox Nenhuma op o foi escolhida End If End sub 10 2 25 SetValue SetValue TagName NewvVal Este m todo configura o valor de um objeto dentro do servidor O m todo SetValue procura por um objeto ou propriedade sendo executado no servidor e atribui o valor especificado
127. ou ser uma caixa de texto simples False Isto pode ser visualizado quando o objeto Viewer est em execu o O valor padr o desta propriedade False 7 3 9 3 22 PasswordChar Converte o texto do objeto para um caractere especial configurado na propriedade Utilize esta propriedade para proteger informa es sens veis como senhas ou c digos de seguran a O valor de PasswordChar o caractere normalmente um asterisco que aparece em um objeto ao inv s dos caracteres reais que o usu rio digita Se n o for especificado um caractere o controle exibe os caracteres que o usu rio digita 7 3 9 3 23 ScrollBars aP Especifica se o objeto possui barras de rolagem verticais horizontais ou ambas As op es dispon veis s o as seguintes e 0 fmScrollBarNone n o exibe barras de rolagem e 1 fmScrollBarHorizontal exibe uma barra de rolagem horizontal e 2 fmScrollBarVertical exibe uma barra de rolagem vertical Ovalor padr o desta propriedade 0 fmScrollBarNone 7 3 9 3 24 SelectionMargin FI Habilita ou desabilita a margem de sele o do objeto Se esta propriedade estiver configurada para True ao clicar na margem do objeto o texto ser selecionado Caso contr rio ao clicar na margem o texto n o ser selecionado NOTA Se a propriedade SelectionMargin estiver configurada para True quando o objeto for impresso a margem de sele o tamb m ser impressa 238 ActiveX 7 3 9 3 25 SelLength 9 Retorna
128. ou zero 30 12 1899 enquanto o alarme n o for reconhecido No caso de alarmes que n o pedem reconhecimento o campo assume a data hora do E3 no momento em que o alarme fica ativo E3Alarm 361 NOME DESCRI O ActorlD Nome do operador que reconheceu o alarme Pode ser e Ousu rio logado no Viewer quando o reconhecimento feito no E3Alarm ou Sem usu rio se n o h usu rio logado e System quando o reconhecimento autom tico ou seja para alarmes que pedem reconhecimento e Um nome passado por Scripts por exemplo usando AckArea AckAlIAlarms LogTrackingEvent do Servidor de Alarmes ou Ack da Fonte de Alarmes O limite deste campo quando armazenado no Banco de Dados de 50 caracteres AlarmSource Name Registra o nome da fonte de alarme O limite deste campo quando amarzenado no Banco de Dados de 100 caracteres Por exemplo FonteAlarme1 Area Para eventos de alarmes o nome da rea a qual a fonte de alarmes pertence Para outros eventos por exemplo usando o m todo LogTrackingEvent do Servidor de Alarmes pode ser um texto definido pelo usu rio O limite deste campo quando armazenado no Banco de Dados de 100 caracteres ConditionActive Indica se a fonte de alarmes est em alarme Este campo apresenta os estados 0 condi o n o ativa e 1 condi o ativa ConditionName Nome da condi o se for um eve
129. polegada a terceira coluna possui 90 pontos 6 cm 0 6 cm A primeira coluna possui 6 cent metros a segunda coluna est oculta a terceira coluna possui 6 cent metros Como parte da terceira coluna vis vel uma barra de rolagem horizontal aparece 1 5 pol 0 2 5 pol A primeira coluna possui 1 5 polegadas a segunda coluna 198 ActiveX OP O DESCRI O est oculta e a terceira coluna possui 2 5 polegadas 2 pol 2 pol A primeira coluna possui 2 polegadas a segunda coluna possui 1 polegada padr o e a terceira coluna possui 2 polegadas Como somente metade da terceira coluna vis vel uma barra de rolagem horizontal aparece Vazio Todas as tr s colunas possuem a mesma largura 1 33 polegadas Ovalor padr o desta propriedade vazio o E3 ir utilizar o valor padr o do sistema 7 3 4 3 13 CurTargetX 9 Retorna a posi o horizontal de inser o de um texto no objeto Esta posi o medida em unidades him tricas um himetro igual a 0 0001 de um metro Pode se usar CurTargetX e CurX para mover o ponto de inser o de um texto conforme o usu rio percorre o conte do do objeto Quando o usu rio move o ponto de inser o para outra linha do texto a propriedade CurTargetX especifica a posi o mais indicada para o ponto de inser o do texto desejado A propriedade CurX definida neste valor se a linha do texto f
130. por Format DADOS DESCRI O Num rico Sa da decimal cient fica hexadecimal bin ria e octal Texto Textos em geral Booleano Valores boleanos Data Hora Calend rio Gregoriano 6 2 7 2 3 IsSetPoint Fi A propriedade IsSetPoint utilizada para determinar se o objeto tem comportamento de SetPoint ou seja permite edi o da propriedade Value A propriedade Value consiste em um Variant que pode assumir valores de todo e qualquertipo A propriedade IsSetPoint booleana e assume o seguinte comportamento se a op o for True ser permitida a edi o j se a op o estiver False a edi o n o ser permitida Isto pode ser visualizado quando o objeto Viewer est em execu o O valor padr o desta propriedade False 6 2 7 2 4 KeepFormatWhenEditing P permite que o valor do objeto seja editado com ou sem formata o As op es dispon veis s o e O kfNever neste caso o valor sempre editado sem formata o padr o e 1 kfAutomatic permite que o valor seja editado no valor formatado caso o E3 detecte que o texto formatado pass vel de ser interpretado como um valor Caso o formato seja considerado incompat vel o valor editado sem formata o 160 Telas e Objetos de Tela 6 2 7 2 5 MaxLimit 9 Cont m o valor m ximo permitido no objeto a propriedade EnableLimits deve ser True Exemplo Sub CommandButton3 clickQO Screen Item Texto1
131. propriedade EnableScaling est configurada para True O valor padr o desta propriedade O Exemplo Sub Tag OnStartRunning O Faz o ajuste de escala de um tag de temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuLow 100 End sub 3 2 3 13 N1 9 Especifica a vari vel do equipamento ou do dispositivo a que este tagestar associado Consulte a documenta o do driver para sua correta parametriza o Esta propriedade pode ser modificada a p s iniciada a comunica o O valor padr o desta propriedade 0 Exemplo Sub Tag OnStartRunningO N1 10 End sub 3 2 3 14 N2 9 Especifica a vari vel do equipamento ou do dispositivo a que este tagestar associado Consulte a documenta o do driver para sua correta parametriza o Esta propriedade pode ser modificada a p s iniciada a comunica o O valor padr o desta propriedade 0 Exemplo sub Tag onstartRunni ng N2 End sub Drivers 69 3 2 3 15 N3 9 Especifica a vari vel do equipamento ou do dispositivo a que este tagestar associado Consulte a documenta o do driver para sua correta parametriza o Esta propriedade pode ser modificada a p s iniciada a comunica o O valor padr o desta propriedade 0 Exemplo Sub Tag OnStartRunningO N1 10 N3 5 N4 20 End sub 3 2 3 16 N4 9 Especifica a vari vel do equipa
132. propriedade estiver em True as modifica es ser o enviadas para o equipamento ou dispositivo associado ao driver OPC do contr rio as modifica es ser o ignoradas O valor padr o desta propriedade True Exemplo Sub Botaol click Faz com que seja desabilitada a escrita do tag Set obi Application Getobject Driverl tag obj Allowwrite False End Sub Drivers 91 3 6 1 4 BitOO Bit31 FI As propriedades de bit BitOO at Bit31 representam juntas os 32 bits do valor presente na propriedade Value do objeto Tag de Comunica o OPC sendo Bit00 o bit menos significativo e Bit31 o bit mais significativo Modificar cada um destes bits implica na igual modifica o da propriedade Value do tag e vice versa mas isto somente ocorre quando a propriedade UseBitFields estiver configurada para True O valor padr o destas propriedades False NOTA Os valores dos bits Propriedades Bit00 at Bit31 n o s o afetados pelo ajuste de escala Isto representam os bits do valor lido do equipamento antes da convers o 3 6 1 5 DataType ropriedade somente de leitura Determina o tipo de dado associado ao tag P propriedad de lei D i ipo de dad iad OPC ver tabela a seguir Op es dispon veis para DataType OP O DESCRI O 0 Undefined Valor unidimensional n o definido Vazio 1 Null Valor nulo 2 Integer Valor unidimensional inteiro de 16 bits sinalizado 3 Long Va
133. somente de leitura 12 4 2 7 ActiveMedNACKAlarms 9 Indica o n mero de alarmes n o reconhecidos com severidade m dia Esta propriedade somente de leitura 12 4 2 8 ActiveNACKAlarms 9 Indica o n mero total de alarmes que est o sem reconhecimento no sistema ativos ou n o Esta propriedade somente de leitura 12 4 2 9 BackupDiscardInterval 9 Indica a quantidade de unidades de tempo durante o qual os dados de backup ser o mantidos na tabela principal e na tabela de backup at serem descartados por exemplo para manter os dados por 24 meses na tabela principal e mais seis meses na tabela de backup o valor da propriedade deve ser de 30 meses Esta propriedade trabalha em conjunto com a propriedade BackupDiscardTimeUnit O valor padr o desta propriedade 12 doze unidades de tempo indicadas em BackupDiscardTimeUnit Alarmes 355 NOTA O tempo total indicado pela combina o das propriedades BackupDiscardinterval e BackupDiscardTimeUnit deve ser maior que o tempo indicado pelas propriedades Discardinterval e DiscardTimeUnit 12 4 2 10 BackupDiscardTimeUnit aP A propriedade BackupDiscardTimeUnit indica a unidade de tempo em que os dados de backup ficar o armazenados at serem descartados As op es dispon veis s o 0 dtHour horas 1 dtDay dias e 2 dtMonth meses padr o e 3 dtMinute minutos Esta propriedade trabalha em conjunto com a propriedade BackupDiscardInterval 12 4 2 11 DataSourc
134. valores retornados ser o os da linha sendo desenhada e n o os da linha selecionada 17 1 3 MouseMove MouseMove Ocorre quando o ponteiro do mouse se move sobre o objeto E3Browser 17 2 M todos Esta se o cont m informa es sobre os m todos do objeto E3Browser 17 2 1 ClearFields ClearFields Limpa a formata o de colunas e linhas do E3Browser Exemplo Sub CommandButton1 clickQO Screen Item E3Browser1 ClearFieldsQO End sub 400 E3Browser 17 2 2 GetColumnValue GetColumnValue Index Retorna o valor de uma c lula na coluna informada e na linha selecionada Este m todo possui o par metro ilndex que determina o ndice da coluna desejada Exemplo sub E3Browserl DblclickO Screen Item Texto1 vValue GetColumnvalue 0 Screen Item Texto2 value GetColumnvalue 1 screen Item Texto3 value GetColumnvalue 2 screen Item Texto4 value GetColumnvalue 3 End sub 17 2 3 Requery Requery O m todo Requery atualiza a consulta utilizando a configura o atual da consulta e retorna os dados para o E3Browser Exemplo Sub CommandButton1 clickQO Screen Item E3Browser1 Requery End sub 17 2 4 RetrieveE3QueryFields RetrieveE3QueryFields O m todo RetrieveE3QueryFields l a estrutura de dados da consulta e atualiza a formata o do E3Browser com os campos definidos na consulta Se for bem sucedido retorna True Caso contr rio retorna False Este m todo
135. vari veis KeyCode e Shift O E3 ir atribuir valores a essas vari veis automaticamente no momento da ocorr ncia do evento Nesse caso KeyCodeir receber o c digo da tecla pressionada e Shift ser verdadeiro ou falso conforme a tecla SHIFT esteja pressionada ou n o 2 7 1 2 OnStartRunning OnStartRunning Ocorre t o logo um objeto seja iniciado Exemplo Meses um Tag Interno e utiliza o evento OnStartRunning para inicializar o vetor Sub Meses OnStartRunning O Value Array Janeiro Fevereiro Mar o abril Maio Junho Julho Agosto setembro outubro Novembro Dezembro End sub NOTA Para acessar este array necess rio copiar a propriedade Value para uma vari vel local 2 7 1 3 OnStopRunning OnStopRunning Ocorre quando termina a execu o de uma inst ncia deste objeto Utilize o evento OnStopRunning para fazer opera es de finaliza o para o objeto Exemplo Sub TagInternol OnstopRunning O Quando finaliza o objeto TagInternol atribui False ao TagInterno Set tag application Getobject Dados TagInterno2 tag2 value False End Sub Programando no E3 43 2 7 2 M todos Neste cap tulo s o listados os diversos m todos pr definidos no E3 agrupando os portipos de objetos iniciando pelos m todos padr o dos objetos da aplica o Cada entrada mostra o nome do m todo com seus respectivos par metros na sintaxe correta e um ex
136. vel de evento Arg recebe o conte do do par metro Arg do m todo OpenScreen que gera esse evento Logo ap s gerado o evento OnShow Exemplo Telas e Objetos de Tela 133 Sub screenl onPreshow arg O t tulo da Tela Screenl a ser mostrada foi passado como par metro na chamada do m todo OpenScreen que gerou o evento Caption Arg End sub 6 1 1 9 OnShow OnShow Ocorre no momento exato que uma Tela mostrada Utilize o evento OnPreShow para efetuar alguma opera o antes que esta seja exibida Exemplo Sub TelaPrincipal onshow MsgBox Seja bem vindo ao sistema End Sub 6 1 2 M todos Esta se o cont m informa es sobre os m todos do objeto Tela 6 1 2 1 Close Close Code Utilize o m todo Close para fechar a Tela Este m todo gera o evento OnHide antes de ser efetivamente executado O par metro Codeter o valor de retorno para o m todo DoModal se a Tela em quest o tiver sido chamada por este m todo Exemplo Sub BotaoFecha Click Quando BotaoFecha for clicado fecha a janela screen Close 0 End sub 6 1 2 2 SetFocus SetFocus Utilize o m todo SetFocus para mover o foco do mouse ou do teclado para um objeto determinado Exemplo Sub screeni onshow Ao abrir a Tela move o foco para o Bot ol Item Button1 setFocus End sub 134 Telas e Objetos de Tela 6 1 2 3 ToPixelX ToPixelX Converte a coordenada X da Tela de Himetric para pixels 6 1 2 4
137. vel utilizar esse bot o Caso contr rio esse bot o n o aparece na janela Ovalor padr o desta propriedade True 10 3 19 Params A Esta propriedade um vetor de pares chave valor que retorna os par metros passados para o Viewer atrav s da op o de linha de comando params Todos os valores s o retornados como Strings Por exemplo se a linha de comando do Viewer contiver os seguintes par metros Viewer params Idioma PTB Pode se utilizar o seguinte c digo para verificar qual o idioma de inicializa o do Viewer Sub TelaInicial OnStartRunningO select Case application Params Idioma Case PTB Item Textol value Portugu s do Brasil Case Else Item Texto1 value End select End sub Idioma n o reconhecido 318 Viewer 10 3 20 ReconnectDialogDelaySec 9 Indica o n mero de segundos que o Viewer ir esperar durante uma poss vel reconex o ao servidor antes de mostrar uma mensagem avisando o usu rio desta a o esta propriedade n o afeta a primeira conex o Se for igual a 0 a mensagem de reconex o sempre ser mostrada Para evitar que a mensagem seja mostrada recomend vel colocar um n mero muito grande 1 bilh o por exemplo 10 3 21 TargetDPIX 9 Define o valor de pontos por polegada na horizontal do monitor do computador de destino O valor padr o desta propriedade 1 que faz com que seja assumido o valor do computador atual 10 3 22 TargetDPIY 9 Define o valor d
138. 09 010 011 Falha de dispositivo Uma falha de dispositivo foi detectada 012 013 014 015 Falha de sensor Uma falha de sensor foi detectada o campo Limite pode prover informa o adicional 016 017 018 019 ltimo valor conhecido Comunica o em falha mas o ltimo valor conhecido est dispon vel A idade do valor pode ser determinada atrav s da propriedade TimeStamp 020 021 022 023 Drivers 111 SUBSTATUS DESCRI O LIMITES SEM BAIXO ALTO CONSTANTE Falha de comunica o Comunica o em falha mas n o h valor conhecido dispon vel 024 025 026 027 Fora de servi o O bloco est fora de scan ou trancado 028 029 030 031 N A N o usado 032 063 Substatus para Qualidade Incerta 64 127 SUBSTATUS DESCRI O LIMITES SEM BAIXO ALTO CONSTANTE N o especificado Ovalor incerto mas nenhuma raz o espec fica conhecida 064 065 066 067 ltimo valor utilizado O dispositivo que estava providenciando o valor parou de faz lo O valor deve ser considerado velho Note que isso difere de um valor ruim com o substatus ltimo Valor Conhecido Esse estado associado com uma falha de comunica o num valor 068
139. 1 Param2 N2 Param3 N3 e Param4 N4 Size Quantidade de valores sendo escritos ou lidos Element ndice do elemento que estava sendo lido ou escrito dentro do bloco N1 Par metro 1 da opera o de leitura escrita que gerou o erro N2 Par metro 2 da opera o de leitura escrita que gerou o erro N3 Par metro 3 da opera o de leitura escrita que gerou o erro N4 Par metro 4 da opera o de leitura escrita que gerou o erro Exemplo Sub Driverl OnCommError Type Size Element N1 N2 N3 N4 Application Getobject Dados TagInterno1 Value _ Application Getobject Dados TagInterno1 vValue 1 Application Application Application Application Application Application Application End Sub Getobject Dados EvtType Value EvtType Getobject Dados Size Value Size Getobject Dados Element value Element Getobject Dados N1 Value N1 Getobject Dados N2 Value N2 Getobject Dados N3 Value N3 GetOobject Dados N4 vValue N4 54 Drivers 3 1 1 6 OnCommErrorEx OnCommeErrorEx Errorinfo Ocorre logo a p s a execu o do m todo OnComm rror Informa es do par metro Errorinfo NOME DESCRI O Errorinfo EvtType Indica o tipo de opera o que causou o erro e O leitura de tag e 1 escritaemtag e 2 leitura de bloco e 3 escrita em bloco Errorinfo Size Tamanho do bloco que ocasionou o erro
140. 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub 3 4 2 6 EU A Esta propriedade utilizada para identificar qual unidade de engenharia seu valor representa como por exemplo graus metros KW h etc Exemplo Drivers 81 sub ElementodeBlocol OnStartRunning O Faz o ajuste de escala de um tag de temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub 3 4 2 7 EUHigh 9 Define qual o valor m ximo que dever ser atribu do propriedade Value ajustando a escala ao valor do equipamento ou do dispositivo antes desta atribui o Da mesma forma no momento da escrita feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a propriedade EnableScaling est configurada para True O valor padr o desta propriedade 1000 Exemplo sub Elemento OnsStartRunning O Faz o ajuste de escala de um elemento temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub 3 4 2 8 EULow 9 Define qual o valor m nimo que dever ser atribu do propriedade Value ajustando a escala ao valor do equipamento ou do dispositivo
141. 2 2 Retentive Fi A propriedade Retentive determina se o valor do tag interno deve ser armazenado automaticamente caso o dom nio seja parado Se esta propriedade estiver configurada para True o valor do taginterno ser armazenado automaticamente no caso de troca de servidor do dom nio ativo Isso garante que o valor do tagser sincronizado com um servidor standby Assim quando o servidor for executado o valor do tag ser o mesmo do servidor que parou Caso contr rio o valor do tagser ajustado para o valor inicial sempre que o dom nio for executado ou ocorrer troca do servidor ativo Esta propriedade n o tem efeito se for alterada em tempo de execu o Exemplo sub CommandButtonl Click Dim status p A f status Application Getobject Dados TagInternol Retentive MsgBox status Select Case status Case True k MsgBox O valor do tag interno ser _ armazenado automaticamente Case False AER MsgBox O valor do tag ser ajustado para o valor _ inicial sempre que o dom nio for executado ou _ ocorrer troca do servidor ativo End Select End Sub 5 4 2 3 TimeStamp ER Apropriedade TimeStamp informa a data hora associada ao valor contido na propriedade Value Esta propriedade de leitura e escrita mas sempre que o valor do Tag Interno for modificado seja por script ou por uma associa o ela ser atualizada de acordo 5 4 2 4 Value A propriedade Value do tipo Variant o que permite armazenar valores de todo
142. 2 3 HasFocus PI Esta propriedade determina que o objeto selecionado est com o foco Esta propriedade acess vel apenas em tempo de execu o 7 2 4 Height 9 Determina a altura do objeto 7 2 5 Layer 9 Esta propriedade define em quais camadas o objeto deve aparecer Ovalor representa uma m scara de 32 bits um bit para cada camada Portanto podem ser definidas at 32 camadas individuais Assim objetos podem ser agrupados logicamente e mostrados ou escondidos apenas com a modifica o da m scara da propriedade Layer Para que o objeto apare a na tela pelo menos uma das suas camadas precisa estar vis vel ou seja pelo menos 1 bit configurado na sua m scara tamb m precisa estar configurado na propriedade Layer da Tela 7 2 6 MouseOver Fi A propriedade MouseOver informa se o ponteiro do mouse encontra se em cima da Tela Caso afirmativo a propriedade MouseOver habilitada do contr rio ser False Esta propriedade apenas de leitura e acess vel apenas em tempo de execu o O valor padr o desta propriedade False 178 ActiveX 7 2 7 MouseOverChild Fi A propriedade MouseOverChild informa se o ponteiro do mouse encontra se em cima de um dos objetos inseridos na Tela Caso afirmativo a propriedade MouseOverChild habilitada do contr rio ser False Esta propriedade apenas de leitura e acess vel apenas em tempo de execu o O valor padr o desta propriedade False 7 2 8 Screen 58
143. 2 Pastas de Aplicativo Oobjeto Pasta de Aplicativo semelhante ao objeto Pasta de Dados do objeto Servidor de Dados permitindo agrupar objetos do Servidor dentro de pastas Contudo existem diferen as importantes e Oobjeto Pasta de Aplicativo s est dispon vel em tempo de execu o 118 Objetos em Tempo de Execu o do Servidor e Oobjeto possuias propriedades gerais Application Count Name Parent e PathName al m dos m todos gerais Item e Save e Oobjeto permite utilizar o comando For Each do VBScript para enumerar seus objetos filhos mas este acesso leva em conta apenas os objetos do Servidor n o listando por exemplo telas e recursos que estejam dentro das pastas e Apasta raiza partir da qual poss vel enumerar os objetos sempre o objeto Servidor Objetos em Tempo de Execu o do Servidor 119 CAP TULO Servidor de Dados Esta se o cont m informa es sobre eventos m todos e propriedades dos seguintes objetos Pasta de Dados Tag Contador Tag Demo Tag Interno e Tag Timer 5 1 Pasta de Dados Oobjeto Pasta de Dados n o cont m eventos m todos ou propriedades espec ficos somente gerais Estes podem ser visualizados na se o Eventos M todos e Propriedades Gerais dos Objetos 5 2 Tag Contador Esta se o cont m informa es sobre eventos e propriedades do objeto Tag Contador Este objeto n o possui m todos associados 5 2 1 Eventos Esta se o cont m informa e
144. 22 MouseOvercChild Fi A propriedade MouseOverChild informa se o ponteiro do mouse encontra se em cima de um dos objetos inseridos na Tela Caso afirmativo a propriedade MouseOverChild habilitada Caso contr rio ser False Esta propriedade somente de leitura e acess vel apenas em tempo de execu o O valor padr o desta propriedade False 17 3 23 RefreshTime Em Especifica o tempo de atualiza o da consulta em rela o ao banco de dados Atrav s desta propriedade poss vel verificar as atualiza es dos dados no hist rico relacionado referente a um determinado tempo estipulado em milissegundos Quando a propriedade RefreshTime for igual a 0 n o h atualiza o dos dados e eles permanecem inalterados 17 3 24 RowHeight 9 Define a altura das linhas da E3Browser em pixels Ovalor padr o desta propriedade 20 E3Browser 405 17 3 25 Screen Cont m uma refer ncia para o objeto Tela onde o E3 Browser est inclu do 17 3 26 SelectRow FP Estabelece a possibilidade de sele o das linhas do E3 Browser Se estiver configurada para True ser poss vel selecionar as linhas do contr rio as linhas n o podem ser selecionadas 17 3 27 SourceQuery Cont m a refer ncia para o objeto Query ao qual o E3Browser est associado 17 3 28 TabStop P Indica se o objeto E3Browser receber o foco do teclado quando o usu rio utiliza a tecla TAB para trocar entre os diversos campos em uma Te
145. 3 6 1 13 ItemlD A A propriedade ItemlD determina o caminho que identifica o tag OPC no servidor OPC ao qual o driver OPC se conecta A defini o desse caminho flex vel e depende do servidor espec fico Normalmente os servidores especificam um espa o de ID com itens hier rquicos do tipo ItemPai ltemFilho Tag1 Esta propriedade funciona como uma chave nica para os dados considerando o onde ou o qu permite o servidor OPC se conectar fonte dos dados Apesar de o valor padr o ser vazio necess rio especificar algum valor para que o tag OPC seja v lido Exemplo Sub Tagorcl click MsgBox ItemID End Sub 3 6 1 14 Quality 9 Apropriedade Quality informa qual a qualidade do valor contido na propriedade Value Cada vez que o Driver atribui um novo valor para o Tag ele tamb m configura a qualidade daquele dado Esta propriedade somente para leitura O valor padr o desta propriedade O Qualidade Ruim 3 6 1 15 RawValue Acessa o valor original do tag anterior escala ou seja independentemente da configura o da propriedade EnableScaling Ent o se esta propriedade for False as propriedades Value e RawValue apresentam o mesmo comportamento 3 6 1 16 SyncWrite Fi A propriedade SyncWrite determina o tipo de escrita usada por um tag OPC Se a propriedade estiver configurada para True a escrita ser s ncrona isto o driver OPC espera o resultado da escrita do servidor Caso contr rio a escrita ass nc
146. 31 FI As propriedades de bit BitOO at Bit31 representam juntas os 32 bits do valor presente na propriedade Value do objeto Elemento de Bloco OPC sendo Bit00 o bit menos significativo e Bit31 o bit mais significativo Modificar cada um destes bits implica na igual modifica o da propriedade Value do elemento e vice versa mas isto somente ocorre quando a propriedade UseBitFields estiver configurada para True Ovalor padr o destas propriedades False 3 8 1 2 DeviceHigh 9 Apropriedade DeviceHigh define o valor m ximo atingido por um elemento de bloco no equipamento ou no dispositivo Esta propriedade ser utilizada para fazer o ajuste de escala do valor proveniente do equipamento ou dispositivo antes de ser atribu do propriedade Value Da mesma forma no momento da escrita feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a propriedade EnableScaling est configurada para True O valor padr o desta propriedade 1000 Exemplo Sub Elemento OnStartRunning Faz o ajuste de escala de um elemento temperatura que varia de O a 255 no OPC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub 106 Drivers 3 8 1 3 DeviceLow 9 Apropriedade DeviceLow define o valor m nimo atingido por um elemento no equipamento ou no dispositivo Esta propriedade ser utilizada p
147. 426 E3Chart 18 3 48 VerGridColor E Determina a cor da linha do eixo vertical principal da grade O valor padr o desta propriedade cinza RGB 192 192 192 Exemplo sub Retanguloarrl Click screen Item E3chart1 vergridcolor RGB 255 0 0 End sub 18 3 49 VerMinorTicks 9 Determina o n mero de subdivis es entre as marcas do eixo vertical principal da grade Ovalor padr o desta propriedade 1 Exemplo sub Retanguloarrl Click Screen Item E3Chart1 verminorTicks 3 End sub 18 3 50 VerScaleBegin 9 Determina o valor no topo no eixo vertical principal da grade do E3Chart O valor padr o desta propriedade 100 Exemplo sub Retanguloarrl Click MsgBox Screen Item E3Chart1 verscaleBegin End Sub 18 3 51 VerScaleEnd 9 Determina o valor na base do eixo vertical principal da grade O valor padr o desta propriedade 100 Exemplo sub Retanguloarrl Click MsgBox Screen Item E3Chart1 verscaleEnd End Sub 18 3 52 VerScaleFormat Cont m um texto que representa uma m scara dentro da qual os valores da escala vertical ser o mostrados Esta m scara pode representar v rios tipos de valores e Geral N o possui formata o especifica adaptando se automaticamente ao valor especificado e N mero Apresenta n meros com parte inteira e fracion ria O usu rio pode optar por at 15 casas decimais por usar ou n o um separador de milhares e por apresentar n meros negativos co
148. 61 462 462 466 468 468 470 471 471 474 478 479 484 495 519 CAP TULO Introdu o Os Scripts s o m dulos de linguagem de programa o nos quais se pode criar procedimentos associados a eventos espec ficos permitindo uma maior flexibilidade no desenvolvimento de aplica es Cada objeto item de um aplicativo do E3 possui uma lista de eventos previamente definidos mas tamb m poss vel definir novos eventos pr prios do usu rio 1 1 Objetos Os Objetos s o componentes de software reutiliz veis que permitem maximizar o uso e aumentar a qualidade e produtividade em seus aplicativos Um objeto no E3 encapsula ou cont m tr s diferentes partes propriedades m todos e eventos que podem ser manipuladas para a utiliza o das vantagens de sua funcionalidade na aplica o Propriedades definem atributos de um objeto como a apar ncia de um objeto de Tela ou o valor inicial de um objeto quando o aplicativo iniciado M todos s o fun es que realizam uma a o espec fica dentro ou com um objeto Eventos s o notifica es geradas por um objeto em resposta a alguma ocorr ncia em particular como um clique de mouse ou uma mudan a no valor de um tag entre outros Uma das principais caracter sticas dos objetos e das linguagens orientadas a objeto a capacidade de heran a entre eles ou seja estes podem herdar as caracter sticas de um ou mais objetos tendo as mesmas funcionalidades espec ficas
149. 7 3 4 2 7 Removeltem Removeltem pvargindex Remove itens de uma Lista ou de uma Lista de Sele o Este m todo possui o par metro pvargindex que especifica a linha que ser exclu da iniciando em zero Ou seja o primeiro elemento 0 o segundo 1 e assim por diante Exemplo sub CcommandButton2 clickQO ComboBox1 SetFocus verifica se a lista cont m dados selecionados If ComboBox1 ListCount gt 1 Then Se n o h nenhuma sele o escolher o ltimo dado da lista If ComboBox1 ListIndex 1 Then compono iis tindex ComboBox1 ListCount 1 End I ComboBox1 RemoveItem ComboBox1 ListIndex End If End sub 7 3 4 3 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Lista de Sele o ActiveX 195 7 3 4 3 1 AutoSize Fi A propriedade AutoSize ajusta a largura do texto caso a rea dispon vel para o mesmo ultrapasse o tamanho do objeto Para o objeto Lista de Sele o Combo Box quando a propriedade estiver configurada para True a largura do texto reajustada para a mesma do objeto 7 3 4 3 2 AutoTab Fi A propriedade AutoTab habilita ou desabilita a tabula o autom tica no objeto Se a propriedade estiver configurada para True a tabula o autom tica ocorre Caso contr rio n o utilizada Ap s o usu rio digitar o n mero m ximo de caracteres em um objeto utilizando a propriedade MaxLength o foco se move automaticamente para o pr ximo objeto da ordem de tabu
150. 8 3 35 ShowGridBackground F Habilita ou desabilita a visualiza o do fundo da grade Se a propriedade for igual a True padr o o fundo da grade mostrado Caso contr rio a grade fica com o fundo transparente Acor escolhida na propriedade GridBkColor n o aparece se esta propriedade estiver em False Exemplo sub CommandButton1 Click Set Chartl Screen Item E3chart1 Chart T shonctidiackground Not Chart1 ShowGridBackground End Su 18 3 36 ShowLeftScale P Se a propriedade estiver configurada para True o eixo vertical principal ser mostrado esquerda da grade Caso contr rio fica invis vel Exemplo Sub CommandButton1 clickQO Set Chart Screen Item E3Chart1 Chart showLeftscale Not Chart showLeftscale End sub 18 3 37 ShowRightScale Fi Se a propriedade estiver configurada para True o eixo vertical principal da escala ser mostrado direita da grade Caso contr rio fica invis vel Exemplo Sub CommandButtonl clickQO Set Chart Screen Item E3Chart1 Chart showRightscale Not Chart showRightscale End sub 18 3 38 ShowPopupMenu F Habilita ou desabilita a op o de mostrar o menu de runtime do E3Chart Se o valor for igual a True o menu ser mostrado quando o usu rio clicar com o bot o direito do mouse sobre o gr fico do E3Chart Se o valor for igual a False o menu n o mostrado Ovalor padr o dessa propriedade True 18 3 39 ShowTitle F se a propriedade estiver configurada p
151. BeforeDragOver Vari veis do evento BeforeDropOrPaste NOME DESCRI O Index Indica o ndice da p gina em um objeto multi p ginas que ser afetada pela opera o que gerou o evento Para outros objetos ignorada Cancel Status do evento O padr o False e indica que ser o objeto alvo que tratar o evento e n o a aplica o principal Ctrl Objeto alvo Data Dados sendo arrastados para o objeto alvo propriamente ditos Action Indica o resultado baseado nas configura es do teclado de uma opera o arrastar e soltar pendente e 2 fmActionPaste cola o objeto selecionado no objeto alvo e 3 fmActionDragDrop indica que o usu rio arrastou o objeto selecionado de sua origem e soltou o sobre o objeto alvo X Y Posi o do mouse dentro do objeto alvo em pontos X medido a partir do lado esquerdo do objeto Y medido a partir do topo DragState Indica a condi o do mouse quando gerado o evento 182 ActiveX NOME DESCRI O e 0 fmDragStateEnter o mouse est dentro do alcance do objeto e 1 fmDragStateLeave o mouse est fora do alcance do objeto e 2 fmDragStateOver o mouse est em uma nova posi o mas ainda est dentro do alcance do objeto Effect Indica as a es que o objeto alvo suporta ou seja o efeito de arrastar sobre o objeto em quest o e 0 fmDropEffectNone objeto alvo n o aceita copiar
152. Box vArg End Sub 274 Quadros e Divisores 8 1 9 Refresh Refresh Force O m todo Refresh permite for ar o redesenho do conte do de uma Tela ou divisor Ele deve ser usado em scripts de Viewer com processamento massivo por exemplo la os ou em chamadas de m todos que demandem muito tempo e exijam indica es visuais ao usu rio do progresso do processo Devido ao redesenho em geral ser uma opera o pesada a vers o padr o do m todo Refresh sem par metros otimizada de forma a ignorar pedidos de redesenho muito pr ximos incluindo redesenho do pr prio E3 Este comportamento padr o ideal para indica es de progresso em la os onde muitos redesenhos s o feitos em sequ ncia O par metro Force desabilita esta otimiza o garantindo que para cada chamada do m todo Refresh seja feito um redesenho Por m ao utilizar se esta op o o m todo Refresh n o pode ser chamado repetidamente como dentro de um la o por exemplo Exemplo Sub CommandButton1 clickQO Desenha uma barra de progresso de uma opera o while i lt 31 screen Item Retangulo2 _ HorizontalPercentFill i 30 100 Frame Refresh True lt alguma opera o demorada gt wend End Sub 8 1 10 RestoreFrame RestoreFrame Permite restaurar a janela do quadro para o seu tamanho original Exemplo Sub CommandButton1_ClickO Application GetFrame outro RestoreFrame End Sub 8 1 11 SetForegroundWnd SetForegroundW
153. Dados As op es dispon veis s o e O clServer a consulta ser gerada no SGBD servidor e 1 clClient a consulta ser gerada no E3 Server cliente Ovalor padr o desta propriedade 0 clServer Ver tamb m a propriedade CursorType 16 3 2 CursorType a Define otipo de consulta de acordo com a visualiza o dos dados O valor padr o desta propriedade 0 ctKeyset Todas as op es dispon veis est o na tabela a seguir Op es dispon veis para CursorType OP O DESCRI O 0 ctKeyset Qualquer mudan a nos registros inicialmente retornados pela consulta ser vis vel Padr o 1 ctStatic Nenhuma mudan a nos registros inicialmente retornados pela consulta ser vis vel 392 Consultas OP O DESCRI O 2 ctDynamic Todos os novos registros adicionados na consulta ser o vis veis al m das mudan as nos registros inicialmente retornados pela consulta 16 3 3 DataSource Indica o objeto Banco de Dados ou o objeto Storage que ser usado na consulta Esta propriedade somente de leitura mas pode ser modificada em tempo de execu o 16 3 4 Fields Texto com os campos a serem visualizados na consulta separados por v rgula Corresponde ao argumento da cl usula SELECT do c digo SQL da consulta Em branco vazio determina que a consulta deve mostrar todos os campos da tabela Esta propriedade so
154. ESCRI O 2 RightAlignment Oalinhamento horizontal do texto ser direita 6 2 7 2 11 TextColor E Esta propriedade especifica a cor da fonte do texto a ser exibido Nos scripts utilize a fun o do VBScript RGB para montar a cora ser associada a esta propriedade O valor padr o desta propriedade preto RGB 0 0 0 6 2 7 2 12 TextFont Define o tipo da fonte a ser utilizado pelo objeto Esta propriedade n o pode ser utilizada em scripts ou associa es e configurada somente via Studio 6 2 7 2 13 Value A propriedade Value consiste em um Variant que pode assumir valores de todo e qualquertipo e que ser exibido pelo objeto Geralmente esta propriedade conter um texto pois automaticamente preenchida quando ocorre a cria o de um novo objeto texto A propriedade IsSetPoint utilizada para determinar se o objeto texto vai ter comportamento de IsSetPoint ou seja permitir edi o da propriedade Value Exemplo Sub Drawstringl OnStartRunning O L o valor de um tag e mostra o Texto Dim obj Set E Application GetObject ana Dero ratio Value valor de DemoTagl amp obj Value End sub 6 2 7 2 14 VertTextAlignment P Determina o alinhamento vertical do texto do objeto Op es dispon veis para VertTextAlignment OP O DESCRI O 0 TopAlignment Alinhamento vertical do texto no topo do objeto 1 MidAlignment Alinhamento vertical
155. ESCRI O 0 NoOverride Preenchimento original do objeto 1 WireFrame Os objetos n o ser o preenchidos desenhar o somente suas bordas 2 SolidFill O preenchimento dos objetos contidos no grupo ser s lido Telas e Objetos de Tela 173 OP O DESCRI O coma cor especificada na propriedade OverrideFillColor 3 ByBrightness O preenchimento dos objetos contidos no grupo ser s lido coma cor especificada pela propriedade OverrideFillColor por m levar em conta qual era a intensidade da cor original de preenchimento de cada objeto Exemplo Sub DrawGroupl Click Ao clicar no objeto seta o modo override para s lido e troca a cor de preenchimento da imagem para azul overriderilIMode 2 overriderilicolor RGB O 0 255 End sub 6 2 9 1 7 OverrideLineColor E Quando a propriedade EnableOverrideLineColor estiver configurada para True a propriedade OverrideLineColor ser usada para definira cor a ser usada na cor da linha do objeto em movimento ao inv s da cor original Nos scripts utilize a fun o do VBScript RGB para montar a cora ser associada a esta propriedade Ovalor padr o desta propriedade vermelho RGB 255 0 0 Exemplo sub Grupol Click overrideLineColor RGB 255 0 0 End sub 6 2 9 1 8 RangeMax 9 atrav s da propriedade RangeMax determinado o alcance m ximo do movimento linear ou rotacional no
156. Eixo Visible End Sub 18 8 Cole o de Consultas Esta se o cont m informa es sobre m todos e propriedades do objeto Cole o de Consultas Este objeto n o possui eventos associados 18 8 1 M todos Esta se o cont m informa es sobre os m todos do objeto Cole o de Consultas 18 8 1 1 AddQuery AddQuery QueryName Isinternal Adiciona uma consulta na cole o de consultas do E3Chart Este m todo possui os par metros QueryName que determina o nome da consulta que est sendo adicionada e Isinternal que opcional obsoleto e n o deve ser informado Exemplo Sub CommandButton1l clickQO screen Item E3Chart1 Queries addQuery consultal End sub E3Chart 451 18 8 1 2 Item Item Index O m todo Item retorna um objeto Consulta da cole o de consultas especificado pelo ndice Este m todo possui o par metro Index que pode ser do tipo num rico se corresponder ao ndice da consulta ou texto se corresponder ao nome da consulta Exemplo Sub CommandButton1 clickQO Set query Screen Item E3Chart1 Queries Item 0 End sub 18 8 1 3 Remove Remove Index Remove o objeto Consulta especificado pelo nome ou pelo ndice da Cole o de Consultas Este m todo possui o par metro Index que pode ser do tipo num rico se corresponder ao ndice da consulta ou texto se corresponder ao nome da consulta Exemplo Sub CommandButton1_ClickO Screen Item E3Chart1 Queries R
157. Elemento OnStartRunningO Faz o ajuste de escala de um elemento temperatura que varia de O a 255 no OPC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub 3 8 1 5 EU Identifica a unidade de engenharia representada por seu valor como por exemplo graus metros KW h etc Exemplo Drivers 107 sub Elemento OnsStartRunning O Faz o ajuste de escala de um tag de temperatura que varia de O a 255 no OPC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub 3 8 1 6 EUHigh 9 Define qual o valor m ximo que dever ser atribu do propriedade Value ajustando a escala ao valor do equipamento ou do dispositivo antes desta atribui o Da mesma forma no momento da escrita feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a propriedade EnableScaling est configurada para True O valor padr o desta propriedade 1000 Exemplo sub Elemento OnsStartRunning O Faz o ajuste de escala de um elemento temperatura que varia de O a 255 no OPC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EULow 100 EULow O End sub 3 8 1 7 EULow 9 Define qua
158. Exemplo Sub CommandButtonl Click Set Pen1 Screen Item E3Chart1 Pens Item Pen1 Peni scanvalue 1000 End sub 18 5 2 26 ShowAverage P Habilita a exibi o da m dia da pena no E3Chart Esta propriedade s tem efeito caso a propriedade EnableCalc esteja habilitada 18 5 2 27 ShowBadPoints F Quando desabilitada os pontos com qualidade ruim n o ser o plotados Se a pena estiver tra ando linhas as linhas que passam pelos pontos de qualidade ruim n o ser o conectadas Para que a qualidade dos pontos seja levada em considera o na parte hist rica da pena o campo nomecampo quality deve estar selecionado na Consulta do E3Chart Quando habilitada todos os pontos s o plotados normalmente 18 5 2 28 ShowMinMax P Habilita a exibi o dos pontos m nimo e m ximo da pena no E3Chart Esta propriedade s tem efeito caso a propriedade EnableCalc esteja habilitada 18 5 2 29 UseTimeStamp aus Determina que ser utilizado para o eixo horizontal o valor do timestamp associado ao eixo vertical Veja exemplo na descri o da propriedade DataSourceType 440 E3Chart 18 5 2 30 Visible PI Determina se pena est vis vel no E3Chart Se a op o estiver configurada para True a pena vis vel em tempo de execu o Caso contr rio a pena fica invis vel Exemplo Sub CommandButton1 clickQO set Pen1 screen Item E3Chart1 Pens Item Pen1 Penl visible Not Penl visible End sub 18 5 2 31 Width
159. Exemplo melhor Set Penas Screen Item E3Chart1 Pens Penas Item 0 Color RGB 212 208 20 Penas Item 1 Color RGB 200 208 20 renas Trem color RGB 100 208 20 End Su 2 7 Eventos M todos e Propriedades Gerais dos Objetos Esta se o cont m informa es sobre eventos m todos e propriedades gerais dos objetos 2 7 1 Eventos Os Eventos s o ocorr ncias relacionadas a um objeto que permitem disparar a es programadas Existem basicamente dois tipos de eventos f sicos ou externos e internos Os eventos f sicos s o por exemplo a es do usu rio No caso do usu rio digitar algo no teclado a informa o relevante pode ser a tecla pressionada ou se o usu rio apontar e clicar com o mouse a informa o relevante a posi o do cursor e o status dos bot es Os eventos internos s o por exemplo mudan as de valor de uma vari vel tag no sistema Como o tag pode ser associado a um dispositivo externo diz se que os eventos internos podem ter associa es f sicas como a mudan a da temperatura de uma c mara por exemplo 42 Programando no E3 2 7 1 1 Vari veis de Evento Vari veis de Evento s o criadas quando o evento iniciado Para serem utilizadas devem ser associadas a par metros na chamada do script do evento O exemplo a seguir a chamada de um procedimento associado ao evento KeyDown de Algumobjeto Sub Algumobjeto KeyDown KeyCode Shift Note que na chamada tem se duas
160. Getobject Dados TagDemo2 scan 200 End sub 5 3 2 6 TimeStamp E A propriedade TimeStamp atualizada sempre que ocorrer alguma mudan a de valor ou estado nas propriedades Value ou Quality Ela informa qual a data hora associada tanto ao valor quanto qualidade do Tag Demo Esta uma propriedade somente para leitura O valor padr o desta propriedade 00 00 00 Servidor de Dados 123 5 3 2 7 Type P Determina otipo de onda do tag Modifique a propriedade conforme a tabela a seguir Quando a propriedade Type estiver configurado para 3 CurrentTime a propriedade Value ir conter a data hora atual do servidor Op es dispon veis para Type VALOR FORMA DE ONDA 0 Random aleat ria 1 Sine onda sen ide 2 Square onda quadrada 3 CurrentTime data hora 4 RampUp borda de subida 5 RampDown borda de descida 6 RampUpDown borda de subida e descida Exemplo Sub Linhal clickQO ABDI pes on Getobject Dados TagDemo2 Type 2 End su 5 3 2 8 Value A propriedade Value varia de acordo com o tipo da forma de onda estabelecida na propriedade Type Esta uma propriedade apenas de leitura O valor padr o desta propriedade 0 Exemplo Sub Figural Click naquaA Application Getobject Dados TagDemo2 value 10 nd Su 124 Servidor de Dados 5 4 Tag Interno Esta se o cont m informa es sobre m todos e propriedades do objeto Tag Int
161. IOServer assim que o driver ficar dispon vel quando a leitura atual tiver acabado Se v rias escritas ass ncronas forem enviadas para o IOServer o driver s retomar as leituras depois que todas as escritas ass ncronas forem executadas 62 Drivers 3 2 Tag de Comunica o Esta se o cont m informa es sobre eventos m todos e propriedades do objeto Tag de Comunica o 3 2 1 Eventos Esta se o cont m informa es sobre os eventos do objeto Tag de Comunica o 3 2 1 1 OnRead OnRead Ocorre quando efetuada uma leitura do tag pelo driver Utilize o evento OnRead quando for necess rio efetuar alguma opera o logo a p s algum dado ser modificado no tag como por exemplo as propriedades Value Quality ou TimeStamp Este evento gerado por uma leitura em background Exemplo Sub Ram Tai onReadO Ao ler o tag atribui o seu valor ao tag InternalTag1l set obj application Getobject Dataserverl InternalTag1 obj Value Valor de CommTagl End Sub 3 2 2 M todos Esta se o cont m informa es sobre os m todos do objeto Tag de Comunica o 3 2 2 1 Write Write WriteSyncMode Faza escrita do valor corrente do tag de comunica o no equipamento Normalmente este comando de script s usado quando a propriedade AllowWrite deste objeto for False O par metro WriteSyncMode permite utilizar o modo de escrita diferente do utilizado no driver As op es dispon veis para este par
162. Item E3Chart1 Legend visible False End Su 18 10 Colunas da Legenda Esta se o cont m informa es sobre propriedades do objeto Colunas da Legenda Este objeto n o possui eventos nem m todos associados 18 10 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Colunas da Legenda 18 10 1 1 Caption Permite definir um t tulo para a coluna E3Chart 457 18 10 1 2 Column a Retorna o identificador da coluna Veja a Tabela de Identifica o das Colunas Exemplo Sub CommandButton15 Click Set col Screen Item E3Chart1 Legend Item 1 MsgBox col Column End Sub 18 10 1 3 Format A Configura o formatador usado na coluna Exemplo Sub Commandsutton15 Click Set col Screen Item E3Chart1 Legend Item 1 MsgBox col Format 0 0 End Sub 18 10 1 4 Index 9 Retorna a posi o da coluna na Legenda Exemplo Sub CommandButton15 Click Set col Screen Item E3Chart1 Legend Item 1 MsgBox col Index End Sub 18 10 1 5 Name Determina o nome da coluna O nome das colunas pode ser visto na Tabela de Identifica o das Colunas Exemplo Sub CommandButton1 clickQO set Chart screen item E3Chart1 set query Chart Queries Item 0 MsgBox query Name MsgBox query TableName End Sub 18 10 1 6 TextAlign a Retorna o alinhamento do texto da coluna As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para TextAl
163. Manual de Refer ncia de Scripts do E3 elipse O 2010 Elipse S oftware e Todos os direitos reservados 28 01 2010 Ver S L e umario 1 Introdu o 1 1 Objetos 1 2 Scripts 1 3 Picks 1 4 Eventos Definidos pelo Usu rio 2 Programando no E3 2 1 Ambiente de Programa o 2 2 Declarando Vari veis 2 3 Obtendo refer ncias aos objetos 2 4 Acessando Objetos 2 5 Trabalhando com Cole es 2 6 Comando Set 2 7 Eventos M todos e Propriedades Gerais dos Objetos 3 Drivers 3 1 Driver de Comunica o 3 2 Tag de Comunica o 3 3 Bloco de Comunica o 3 4 Elemento de Bloco de Comunica o 3 5 Driver de Comunica o OPC 3 6 Tag de Comunica o OPC 3 7 Bloco de Comunica o OPC 3 8 Elemento de Bloco de Comunica o OPC 4 Objetos em Tempo de Execu o do Servidor 4 1 Servidor 4 2 Pastas de Aplicativo 5 Servidor de Dados 5 1 Pasta de Dados 5 2 Tag Contador 5 3 Tag Demo 5 4 Tag Interno 5 5 Tag Timer 6 Telase Objetos de Tela 6 1 Tela 6 2 Objetos de Tela 7 ActiveX 7 1 M todos Comuns 7 2 Propriedades Comuns 7 3 Microsoft Forms 7 4 E2Controls 8 Quadros e Divisores 8 1 M todos do Divisor 8 2 Propriedades do Divisor 20 23 23 24 24 39 40 41 42 52 52 63 73 78 85 90 100 106 116 116 118 120 120 120 122 125 127 129 129 141 177 177 178 180 245 272 272 277 8 3 Propriedades do Quadro 9 Associa es 9 1 M todos Comuns 9 2 Propriedades Comuns 9 3 Conex o Simples 9 4 Conex o Bidirecional 9 5 Cone
164. MsgBox Nenhum evento selecionado End If 13 3 Propriedades Esta se o cont m informa es sobre as propriedades do objeto E3Alarm NOTA O E3 utiliza para defini o de coordenadas e espessura o sistema HIMETRIC Neste sistema cada unidade l gica equivale a um mil simo de cent metro ou seja cada 1000 unidades equivalem a 1 cent metro Assim este o padr o adotado na descri o das propriedades do E3 quando aplic vel 13 3 1 ActiveAlarms 9 Determina o n mero total de alarmes ativos do objeto Esta propriedade somente de leitura 13 3 2 ActiveHighAlarms 9 Indica o n mero de alarmes ativos com severidade alta Esta propriedade somente de leitura 13 3 3 ActiveHighNACKAlarms 9 Indica o n mero de alarmes n o reconhecidos com severidade alta Esta propriedade somente de leitura 366 E3Alarm 13 3 4 ActiveLowAlarms 9 Indica o n mero de alarmes ativos com severidade baixa Esta propriedade somente de leitura 13 3 5 ActiveLowNACKAlarms 9 Indica o n mero de alarmes n o reconhecidos com severidade baixa Esta propriedade somente de leitura 13 3 6 ActiveMedaAlarms 9 Indica o n mero de alarmes ativos com severidade m dia Esta propriedade somente de leitura 13 3 7 ActiveMedNACKAlarms 9 Indica o n mero de alarmes n o reconhecidos com severidade m dia Esta propriedade somente de leitura 13 3 8 ActiveNACKAlarms 9 Indica o n mero total de alarmes que est o sem
165. ND i lt 10 strDatas strDatas amp CStr rec Fields Item E3Timestamp value amp _ 1 wen MsgBox strDatas End Sub ChrC10 amp Chr 13 a rec MoveNext d 16 2 6 GetAsyncADORecordSet GetAsyncADORecordSet Cria uma consulta e quando ela estiver finalizada gera o evento OnAsyncQueryFinish do pr prio objeto passando para este evento o resultado Recordset gerado pela consulta 16 2 7 GetE3QueryFields GetE3QueryFields O m todo GetE3QueryFields retorna a cole o de campos colunas de uma consulta Cada um destes campos possui as seguintes propriedades que podem ser modificadas a saber Propriedades dos campos da consulta Nome Tipo Descri o ColumnName Texto Nome da coluna Este nome deve existir nas tabelas adicionadas nesta consulta TableName Texto Nome da tabela a que pertence a coluna Esta tabela deve ter sido adicionada na configura o da consulta Alias Texto Apelido da coluna na consulta Criteria Texto Filtro sobre a coluna OrderBy Texto Ordena o dos dados da coluna Os valores v lidos s o ASC ordena o ascendente DESC ordena o descendente ou sem Consultas 389 Nome Tipo Descri o ordena o Qualquer valor diferente significa que o campo n o possui ordena o OrderNumber Num ric N mero de ordem da coluna em rela o s o outras colunas que comp
166. O 7 fmMousePointerSizeNS Seta dupla apontando para norte e sul 8 fmMousePointerNWse Seta dupla apontando para noroeste e sudeste 9 fmMousePointerWE Seta dupla apontando para oeste e leste 10 fmMousePointerUpArrow Seta para cima 11 MousePointerStarHourGlassring Ampulheta 12 fmMousePointerHelpNoDrop S mbolo de Not c rculo com uma linha diagonal na parte superior do objeto sendo arrastado Indica um destino de soltar inv lido 13 fmMousePointerAppStarting Seta com uma ampulheta 14 fmMousePointerHelp Seta com um ponto de interroga o 15 fmMousePointerSizeAll Dimensiona todo o cursor setas apontando para norte sul leste e oeste 99 fmMousePointerCustom Usa o cone especificado pela propriedade Mouselcon Use a propriedade MousePointer para indicar altera es de funcionalidade conforme o ponteiro do mouse passar sobre os objetos em uma Tela Por exemplo a configura o de ampulheta op o 11 til para indicar que o usu rio precisa esperar algum tempo um processo ou opera o ser finalizado Alguns cones podem variar dependendo das configura es do sistema como os cones associados aos temas da rea de trabalho O valor padr o desta propriedade 0 fmMousePointerDefault 188 ActiveX 7 3 3 Caixa de Sele o e Bot o de Op o Esta se o cont m informa es sobre propri
167. O valor padr o desta propriedade 1440 1 pol ou 2 54 cm Relat rios 479 22 4 1 4 PageTopMargin 9 Determina a margem superior do relat rio em twips 1 twip 1 1440 polegada O valor padr o desta propriedade 1440 1 pol ou 2 54 cm 22 4 1 5 AllowSplitters FI Permite que a tela de visualiza o do relat rio seja dividida em duas partes Essa propriedade s est dispon vel em tempo de execu o Se a propriedade estiver configurada para False valor padr o a barra para divis o n o aparece na tela 22 4 1 6 documentName Determina o nome do documento para o relat rio Este nome aparece no gerenciador de impress o e pode ser usado para identificar mais facilmente o relat rio O valor padr o desta propriedade ActiveReports Document 22 4 1 7 MaxPages 9 Estabelece o n mero m ximo de p ginas para o relat rio Quando este n mero alcan ado o E3 p ra de processar o documento O valor padr o desta propriedade 10 22 4 1 8 ParentReport A Esta propriedade uma vari vel de uso interno do sistema e cont m uma refer ncia para o objeto relat rio A propriedade somente de leitura e v lida apenas para os eventos OnDatalnitialize e OnReportEnd 22 4 1 9 PrintWidth 9 Determina a largura da rea de impress o do relat rio em twips Se o tamanho do relat rio for mudado em tempo de execu o a largura de impress o tamb m dever ser ajustada para garantir que o relat rio ir
168. O valor padr o desta propriedade vazio 22 6 6 1 4 ClassName A A propriedade ClassName permite especificar uma classe CSS global indicada em uma folha de estilos CSS externa a ser aplicada ao texto Uma classe CSS um padr o de formata o que determina tipo e tamanho de letra ou alinhamento e espa amento do par grafo entre outras caracter sticas Atrav s de CSS pode se aplicar um padr o de formata o pr definido a um texto agilizando e unificando a apresenta o dos textos Para aplicar um estilo espec fico pode se utilizar a propriedade Style O valor padr o dessa propriedade o estilo Normal 22 6 6 1 5 Font A Esta propriedade indica o nome da fonte tipo das letras do texto O valor padr o desta propriedade vazio o E3 ir usar o padr o do sistema NOTA Esta propriedade n o pode ser utilizada em scripts ou associa es configurada somente via Studio e s pode ser modificada em tempo de configura o 22 6 6 1 6 ForeColor E A propriedade Forecolor especifica a cor de preenchimento do fundo do objeto Nos scripts utilize a fun o RGB do VBScript para montar a cor a ser associada a esta propriedade O valor padr o desta propriedade preto RGB 0 0 0 Relat rios 513 22 6 6 1 7 hyperLink A A propriedade hyperLink determina um link que ser atribu do ao objeto Para utilizar este recurso use o evento OnHyperLink O valor padr o desta propriedade vazio 22 6 6 1 8 Mu
169. ONE A O FUN O deste objeto objeto Aordem de execu o das a es de cima para baixo Para alterar a ordem pode se utilizar os bot es e Utilize o bot o E para verificar se n o h erros no script especificado para o evento As mensagens de erro do compilador s o apresentadas no painel Mensagens na parte inferior da aba Scripts D um duplo clique no erro caso deseje que ele seja selecionado no script m 4 Click Nenhum erro em Executar Script M 4 MS Design Scripts Mensagem do compilador Introdu o 9 1 2 1 Adicionando um Script Para adicionar um script a um objeto siga estes passos 1 Selecione o objeto para o qual se deseja criar o script e clique na aba Scripts Aba Scripts 2 Clique sobre o cone ES O editor de scripts aberto conforme a figura a seguir 10 Introdu o Z Telatnicial ai pf x C Tetatmiciat E cick nnndo a x Jeans SA e Click Fires when screen is dicked on FR sciet Coloque um coment rio na linha 2 do script para descrev lo gt Ei Sub TelaInicial Click E E End Sub mi Design Scripts Adicionando um script ao objeto 3 Entre com os comandos VBScript desejados na caixa de edi o de texto Por exemplo If intTemperaturacaldeira3 gt 120 and _ intTemperaturaCaldeira4 gt 120 Then bEnviaralarme True balarmeLigado True
170. OPC for True e a propriedade Enabled do Grupo OPCtamb m for True 1 AdviseWhenLinked Otags atualizado se a propriedade AllowRead do Tag OPCe a propriedade Enabled do Grupo OPC forem True e o tag estiver associado a algum objeto ativo por 90 Drivers OP O DESCRI O exemplo um Display de uma Tela aberta um Alarme habilitado entre outros Aassocia o do tag para esse prop sito pode ser feita nas seguintes propriedades Value RawValue TimeStamp Quality e Bit00 at Bit31 de Tags OPC Exemplo Sub commandButton3 clickQO MsgBox Application a Erbi ect DriveroPC GrupooPc TagoPC1 AdviseType End su 3 6 1 2 AllowRead FI Define se este tag dever ou n o ser lido pelo driver OPC Caso a propriedade esteja configurada para True o driver automaticamente atualizar as propriedades Value e Bits de Bit0O at Bit31 deste objeto em intervalos de tempo Caso contr rio este tag OPC n o ser lido Esta propriedade pode ser modificada em tempo de execu o O valor padr o desta propriedade True Exemplo Sub Botaol click Faz com que seja parada a leitura do tag Set obi Application Getobject Driver1 tag obj AllowRead False End Sub 3 6 1 3 AllowWrite PI Define se este tag dever ou n o ser escrito automaticamente quando a propriedade Value ou qualquer propriedade Bit de Bit00 at Bit31 for modificada Se a
171. ReportFailure FALHA Coml Falha de _ amp comunica o na coml 100 Else o valor do tag FALSE limpa a falha indica que est OK Application ClearFailure FALHA COM1 End If End sub 4 1 1 3 Trace Trace MessageText LogTimeStamp BreakLine Este m todo permite registrar mensagens em um arquivo texto As mensagens s o gravadas em um arquivo com o mesmo nome e caminho do arquivo de Dom nio com a extens o txt Por exemplo se a aplica o de Dom nio for c lteste dom as mensagens ser o registradas no arquivo cilteste txt Cada nova mensagem adicionada sempre no final do arquivo Caso haja falha no registro no arquivo como por exemplo direito de acesso negado falta de espa o em disco etc ocorrer um erro de script Este m todo pode ser usado por exemplo para registrar mensagens de depura o de scripts que n o sejam executados no Viewer haja vista que neste caso n o poss vel utilizar o m todo MsgBox Par metros do m todo Trace NOME DESCRI O MessageText Mensagem de texto definida pelo usu rio LogTimeStamp Opcional Booleano que indica se cada registro deve ter a data e a hora timestamp Se omitido assume True BreakLine Opcional Booleano que indica a presen a ou n o de uma quebra de linha ao final de cada mensagem Em False faz com que o arquivo tenha todos os registros em uma s linha Se omitido assume True 4
172. Retorna a largura do campo em unidades Himetric E3Browser 409 CAP TULO E3Chart Esta se o cont m informa es sobre eventos m todos e propriedades do objeto E3Chart 18 1 Eventos Esta se o cont m informa es sobre os eventos do objeto E3Chart 18 1 1 OnCursorChange OnCursorChange Ocorre quando o cursor do E3Chart muda de posi o Por exemplo pode se criar um script para este evento quando for necess rio mostrar os valores de posi o do cursor na Tela Exemplo Sub E3Chart1 oncursorchange O set Chart application GetFrame screen Item E3Chart1 Set Pena Chart Pens Item 0 O objeto Text1 deve mostrar a posi o atual do cursor Set Texto Application GetFrame screen Item Text1 If Pena GetCursorPos aa bb Then Texto Value Posi o X amp aa amp Posi o Y amp bb End If End sub 18 1 2 OnLegendClick OnLegendClick Row Col RowData Ocorre quando o usu rio clica em uma linha da legenda Os par metros Rowe Col indicam respectivamente a linha e a coluna clicadas O par metro RowbData o ndice da pena da legenda onde ocorreu o clique Exemplo Sub E3Chart1 onLegendclick Row Col RowData Set texto Screen Item Textol texto value Legend Item col Name amp amp Pens Item RowData name End Sub 410 E3Chart 18 1 3 OnQueryFinish OnQueryFinish Ocorre quando uma ou mais consultas s o encerradas no objeto Quando o even
173. Se esta propriedade estiver configurada para True a altura da rea de edi o do texto reajustada para coincidir com o tamanho atual do objeto permitindo assim a exibi o completa do conte do do texto Caso contr rio a rea de edi o do texto continua com seu tamanho original Se os textos s o maiores que o espa o dispon vel este n o exibido no objeto 7 3 7 2 11 List Retorna ou define as entradas da linha e da coluna na lista do objeto A numera o de linha e de coluna come a com zero Isto o n mero de linha da primeira linha na lista zero o n mero de coluna da primeira coluna zero O n mero da segunda linha ou coluna 1 e assim por diante Esta propriedade acess vel apenas em tempo de execu o 7 3 7 2 12 ListCount 9 Retorna o n mero de itens contidos na lista do objeto Esta propriedade acess vel apenas em tempo de execu o 7 3 7 2 13 Listindex Identifica o item atualmente selecionado na lista chamado de ndice Os valores de Listindex v o de 1 ao n mero total de linhas em uma lista menos um isto ListCount 1 Quando nenhuma linha selecionada Listindex retorna 1 Quando o usu rio seleciona uma linha em uma Lista de Sele o o sistema define o valor da propriedade Listindex O valor da propriedade Listindex da primeira linha de uma lista 0 o valor da segunda linha 1 e assim por diante Esta propriedade acess vel apenas em tempo de execu o Active
174. Server If op 1 Then Application Getobject servidorDB SourceType O MsgBox Est sendo usado um servidor Oracle ElseIf op 2 Then Application Getobject servidorDB SourceType MsgBox Est sendo usado um servidor Access ElseIf op 3 Then Application Getobject servidorDB SourceType 2 MsgBox Est sendo usado um servidor SQL Server End If End sub 11 2 8 TimeOutCommand H E 9 Cont mo tempo de espera para qualquer opera o do banco de dados antes que o sistema gere um erro por timeout O valor padr o 180 3 minutos 11 2 9 TimeOutConnection 9 Cont mo tempo de espera pela realiza o da conex o com o Banco de Dados antes que o sistema gere um erro por timeout O valor padr o 15 segundos Banco de Dados 331 11 2 10 TotalFailedWrites 9 Cont m o n mero total de erros em opera es de banco de dados que aconteceram at o momento 11 2 11 UserName A Login utilizado para se conectar ao Banco de Dados Esta propriedade somente para leitura 11 2 12 UseTransaction FI Define se o DBServer ir utilizar as transa es do banco de dados ou n o Se True cada bloco de opera es 200 opera es de DB opera es do Hist rico Storage Formulas e Alarmes ser o executadas de uma vez s ou seja em uma transa o 332 Banco de Dados CAP TULO Alarmes Esta se o cont m informa es sobre eventos m todos e propriedades dos objetos Configura o de Alarmes
175. ShowDropButtonWhen especifica quando mostrar o bot o suspenso tecla de navega o do objeto As op es dispon veis para esta propriedade s o as seguintes e 0 fmShowDropButtonWhenNever n o mostra o bot o suspenso em nenhuma circunst ncia e 1 fmShowDropButtonWhenFocus mostra o bot o suspenso quando o objeto possui o foco e 2 fmShowDropButtonWhenaAlways sempre mostra o bot o suspenso 7 3 4 3 38 SpecialEffect aP A propriedade SpecialEffect especifica a apar ncia de um objeto As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para SpecialEffect OP O DESCRI O 0 fmSpecialEffectFlat Oobjeto aparece plano e possui um destaque na borda uma altera o de cor ou ambos 1 fmSpecialEffectRaised O objeto possui um destaque na parte superior esquerda e uma sombra na parte inferior direita como se estivesse em relevo 2 fmSpecialEffectSunken Oobjeto possui uma sombra na parte superior esquerda e um destaque na parte inferior direita Oobjetoe a sua borda aparecem afundados na Tela 3 fmSpecialEffectEtched Aborda parece estar esculpida ao redor da extremidade do objeto 6 fmSpecialEffectBump O objeto possui um ressalto na parte inferior direita e parece plano na parte superior esquerda 206 ActiveX 7 3 4 3 39 Style P Determina o estilo do objeto As op es dispon veis s o as
176. TagAttributeEU Unidades de engenharia 4 fsTagAttributeLowEng Limite inferior 5 fsTagAttributeHighEng Limite superior 6 fsTagAttributeDeadBand Banda Morta para grava o 7 fsTagAttributeDeadBandUnit Unidade da Banda Morta valor absoluto ou porcentagem 8 fsTagAttributeMinRecTime Tempo m nimo para grava o varia es menores que esse intervalo s o desprezadas 9 fsTagAttributeMaxRecTime Tempo m ximo para grava o a aus ncia de varia o nesses intervalos for a uma grava o 394 Consultas Subtipos para fun o CalculatedData FunctionType 6 SUBTIPO DESCRI O O fsTotalCalculatedData Total dos valores 1 fsMinimumcCalculatedData Valor m nimo 2 fsSMaximumcCalculatedData Valor m ximo 3 fsStandardCalculatedData Desvio padr o 4 fsRangeCalculatedData Amplitude dos valores 5 ffMeanCalculatedData M dia dos valores 6 fsMedianCalculatedData Mediana dos valores 16 3 7 FunctionType aP Esta propriedade v lida quando um objeto Storage fonte da Consulta isto indicado pela propriedade DataSource Ela especifica a fun o que ir definir os dados gerados pela Consulta Algumas fun es possuem subfun es que podem ser indicadas na propriedade FunctionSubType A propriedade FunctionType pode assumir os seguintes valores Op es dispo
177. ToPixelY ToPixelY Converte a coordenada Y da Tela de Himetric para pixels 6 1 3 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Tela 6 1 3 1 BackgroundColor a Especifica a cor de preenchimento do fundo da Tela Nos scripts utilize a fun o do VBScript RGB para montar a cora ser associada a esta propriedade O valor padr o desta propriedade cinza RGB 192 192 192 6 1 3 2 Caption Apropriedade Caption define o t tulo da Tela a ser mostrado na barra de t tulo no Viewer Telas e Objetos de Tela 135 6 1 3 3 FillStyle a Esta propriedade especifica o estilo do preenchimento da Tela Aseguinte tabela cont m os valores v lidos para a propriedade FillStyle Op es dispon veis para FillStyle OP O DESCRI O O bkSolid O preenchimento ser s lido padr o 2 bkHorizontal O preenchimento ser com listras horizontais 3 bkVertical O preenchimento ser com listras verticais 4 bkDownward O preenchimento ser com listras descendo da esquerda para a direita em ngulo de 45 graus 5 bkUpward O preenchimento ser com listras subindo da esquerda para a direita em ngulo de 45 graus 6 bkCross O preenchimento ser com listras horizontais e verticais 7 bkDiagonalCross O preenchimento ser com listras descendo e subindo da esquerda para a direita em ngulo de 45 graus 8 bkGradient O preen
178. Value do tag e vice versa mas isto somente ocorre quando a propriedade UseBitFields estiver configurada para True O valor padr o destas propriedades False 3 2 3 5 DeviceHigh 9 A propriedade DeviceHigh define qual o valor m ximo atingido pelo tag no equipamento ou dispositivo Esta propriedade ser utilizada para fazer o ajuste de escala do valor proveniente do equipamento ou dispositivo antes de ser atribu do propriedade Value Da mesma forma no momento da escrita feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a propriedade EnableScaling est configurada para True O valor padr o desta propriedade 1000 Exemplo Sub Tag OnStartRunningO Faz o ajuste de escala de um tag de temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub NOTA Os valores dos bits Propriedades Bit00 at Bit31 n o s o afetados pelo ajuste de escala Isto representam os bits do valor lido do equipamento antes da convers o 3 2 3 6 DeviceLow 9 Apropriedade DeviceLow define o valor m nimo atingido por este tagno equipamento ou no dispositivo Esta propriedade ser utilizada para fazer o ajuste de escala do valor proveniente do equipamento ou do dispositivo antes de ser atribu do propriedade Value Da mesma forma no momento da escrit
179. ValueName TemplateName Val Coloca na vari vel Val o valor do conjunto de valores ValueName que est associado ao template TemplateName Retorna True se a opera o foi bem sucedida ou False caso contr rio Exemplo Sub Botaol click Dim Valor qualFormula Appli ication Getobj ect Formulal GetValueData _ valores4 Template2 varl End sub 20 1 9 LoadFormulaValuesQuiet LoadFormulaValuesQuiet UnitName ValueName Carrega um conjunto de valores para uma unidade de destino sem apresentar nenhuma mensagem Este m todo possui os par metros UnitName que determina o nome da unidade e ValueName que determina o nome do conjunto de valores Retorna True quando executado com sucesso e False quando falha o que n o significa um erro de script necessariamente Exemplo sub Botaol Click Appli ication AV ee Cramm al LoadFormulavaluesQuiet _ Unidade3 va End Sub NOTA Este m todo tamb m acessado atrav s do objeto Viewer 464 F rmulas 20 1 10 RenameUnit RenameUnit UnitName NewUnitName Renomeia uma determinada unidade existente na tabela de f rmulas Retorna True se conseguir realizar a opera o ou False caso contr rio Este m todo possui os par metros UnitName que determina o nome da unidade a ser encontrada e NewUnitName que informa o novo nome da unidade Exemplo sub Botaol Click O Dim val Quando clica no bot o renomeia uma unit Application Getobject Formulal
180. X 221 7 3 7 2 14 ListStyle P A propriedade ListStyle determina o estilo da lista do objeto As op es dispon veis para esta propriedade s o as seguintes e 0 fmListStylePlain listagem com os itens do plano de fundo em destaque e 1 fmListStyleOption exibe bot es de op o ou caixas de sele o para uma lista de v rias op es Quando o usu rio seleciona um item do grupo o bot o de op o associado ao item selecionado e os bot es de op o para outros itens no grupo s o desmarcados Ovalor padr o desta propriedade 0 fmListStylePlain NOTA A op o 1 fmListStyleOption s pode ser habilitada se a propriedade MultiSelect estiver configurada como 1 fnMultiselectMulti 7 3 7 2 15 Locked Fi A propriedade Locked habilita ou desabilita a edi o do objeto Se esta propriedade estiver configurada para True a edi o n o permitida Caso contr rio poss vel editar o objeto Os valores configurados na propriedade Enabled influenciam o comportamento de Locked Para maiores detalhes consulte a propriedade Enabled O valor padr o desta propriedade False 7 3 7 2 16 MatchEntry ar Procura atrav s do texto digitado pelo usu rio por uma entrada de texto que coincida com os dados existentes no objeto Ao encontrar uma incid ncia do texto a linha contendo a mesma selecionada e o conte do da coluna exibido As op es dispon veis s o as seguintes e 0 fmMatchEntryFirstLetter procura pel
181. Y 9 Define a coordenada horizontal superior da sombra deste movimento em unidades Himetric Este sombra sempre relativa a propriedade Y do objeto Valores positivos indicam que a sombra estar abaixo do objeto e negativos acima O valor padr o desta propriedade 200 6 2 9 1 14 Value o valor inicial do movimento Deve ser um valor entre os valores nas propriedades RangeMax e RangeMin Telas e Objetos de Tela 175 6 2 10 Animar com Rota o Esta se o cont m informa es sobre propriedades do objeto Animar com Rota o Este objeto n o possui eventos nem m todos associados 6 2 10 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Animar com Rota o 6 2 10 1 1 RotationAngle 9 Esta propriedade determina o ngulo de rota o do movimento no objeto Exemplo Sub CommandButton1 pbclick a reen ue Tm Movel Rotationangle 180 End Su 6 2 10 1 2 RotationDirection P atrav s da propriedade RotationDirection determinada a dire o do ngulo de rota o do movimento no objeto Op es dispon veis para RotationDirection OP O DESCRI O 0 Clockwise Direciona o ngulo de rota o a direita do objeto 1 CounterClockWise Direciona o ngulo de rota o a esquerda do objeto Exemplo Sub CommandButton1_clickO Direciona o ngulo de rota o direita do objeto Screen Item DynamicMovel RotationDirect
182. a Ovalor padr o desta propriedade 0 fmEnterFieldBehaviorSelectAlI 7 3 4 3 18 Font Apropriedade Font utilizada para determinar a fonte do objeto Esta propriedade n o pode ser utilizada em scripts ou em associa es sendo configurada unicamente via Studio 7 3 4 3 19 HideSelection Fi A propriedade HideSelection especifica se o texto selecionado continua em destaque quando um objeto n o tiver mais o foco Se a propriedade estiver configurada para True o texto selecionado somente se mant m em destaque caso o objeto tenha o foco Caso contr rio o texto selecionado sempre aparece em destaque independente do foco no objeto O valor padr o desta propriedade True 7 3 4 3 20 IMEMode PA propriedade IMEMOde especifica o modo IME Input Method Editor de um objeto As op es dispon veis s o as seguintes ActiveX 201 Op es dispon veis para IMEMode OP O DESCRI O 0 fmIMEMOdeNoControl N o controla IME padr o 1 fmIMEMoOdeOn IME ativado 2 fmIMEModeoff IME desativado Modo ingl s 3 fmIMEMOde Disable IME desativado O usu rio n o pode ativar IME peloteclado 4 fmIMEMOdeHiragana IME ativado com modo Hiragana de largura total 5 fmiMEMoOdeKatakanaFull IME ativado com modo Katakana de largura total 6 fmIMEMOdeKatakana IME ativado com modo Katakana de meia largura 7 fmIMEMOdeAlphaFull IME ativado com mod
183. a feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a propriedade EnableScaling est configurada para True Exemplo 66 Drivers Sub Tag OnStartRunningO Faz o ajuste de escala de um tag de temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub NOTA Os valores dos bits Propriedades Bit00 at Bit31 n o s o afetados pelo ajuste de escala isto representam os bits do valor lido do equipamento antes da convers o 3 2 3 7 EnableDeadBand Fi A propriedade EnableDeadBand habilita ou desabilita a propriedade PercentDeadBand Se esta propriedade estiver configurada para True o valor do tag atualizado somente se este mudar e o novo valor exceder o limite definido pela propriedade PercentDeadBand Caso contr rio o tag sempre atualizado e o limite de deadband banda morta n o verificado Sempre mantenha a banda morta deadband habilitada pois ela melhora a performance da aquisi o de dados e processamento Voc deve desabilitar o deadband somente em casos onde o Driver de Comunica o estiver retornando eventos de tags digitais ou anal gicos e seja necess rio processar estes eventos via script no evento OnRead do tag O valor padr o desta propriedade True 3 2 3 8 EnableDriverEvent PI Esta propriedade
184. a Tela pai do objeto Esta propriedade acess vel apenas em tempo de execu o Telas e Objetos de Tela 147 6 2 3 9 TabStop P Esta propriedade determina a utiliza o da tecla TAB no sistema Se o campo estiver em True poss vel utilizar a tecla caso contr rio a tecla n o pode ser utilizada 6 2 3 10 Tip A A propriedade Tip mostra uma texto popup quando o mouse estiver por um breve momento sobre o objeto em execu o Exemplo Sub Retanguloarri Mouseup nButton nshiftstate x y Tip Este um teste End sub 6 2 3 11 Visible FP Esta propriedade define se o objeto deve ou n o estar vis vel Se a propriedade estiver configurada para True o objeto fica vis vel desde que os seguintes itens sejam tamb m obedecidos obrigatoriamente o objeto pai deste objeto tamb m deve estar vis vel e a propriedade Layer do objeto deve estar presente na camada de Tela Do contr rio o objeto fica invis vel 6 2 3 12 Width 9 Apropriedade Width define a largura em unidades Himetric do objeto 6 2 3 13 X 9 Apropriedade X define a coordenada horizontal esquerda em unidades Himetric do objeto 6 2 3 14Y 9 Esta propriedade define a coordenada vertical superior em unidades Himetric do objeto 148 Telas e Objetos de Tela 6 2 4 Ret ngulo Arredondado Esta se o cont m informa es sobre propriedades do objeto Ret ngulo Arredondado Este objeto n o possui eventos nem m todos associados 6 2 4
185. a a moldura do objeto 7 4 1 2 Frame BorderEnabled F Habilita ou desabilita a moldura do objeto 7 4 1 3 Frame BorderThickness 9 Define a espessura da moldura do objeto em pixels 7 4 1 4 Frame Color E Define a cor de fundo da rea de t tulo do objeto O valor padr o desta propriedade cinza RGB 192 192 192 ActiveX 245 7 4 1 5 Frame Enable F Habilita ou desabilita a exibi o da moldura do objeto O valor padr o desta propriedade verdadeiro exceto para o objeto EZButton 7 4 1 6 Frame Enable3D F Habilita ou desabilita o efeito 3D para a moldura do objeto 7 4 1 7 Frame Separator F Habilita ou desabilita a exibi o de uma linha separadora entre o t tulo e o objeto 7 4 1 8 Frame Set3DlInset FI se esta propriedade estiver ajustada para verdadeiro a borda do objeto aparecer rebaixada Se estiver em falso valor padr o a borda do objeto aparecer ressaltada 7 4 1 9 Frame Thickness3D 9 Define a espessura da borda 3D da moldura do objeto em pixels 7 4 1 10 Frame Title A Esta propriedade define o t tulo da moldura do objeto 7 4 1 11 Frame TitleColor E Define a cor da fonte do t tulo da moldura O valor padr o desta propriedade preto RGB 0 0 0 7 4 1 12 Frame TitleEnabled F Habilita ou desabilita a exibi o do t tulo da moldura O valor padr o desta propriedade verdadeiro 246 ActiveX 7 4 1 13 Frame TitleFont AA propriedade Frame TitleFont utilizada pa
186. a cor dos divisores da escala O valor padr o desta propriedade preto RGB 0 0 0 7 4 6 1 36 TicksVisible F Habilita ou desabilita a exibi o das divis es da escala 7 4 6 1 37 TickValues Pl Habilita ou desabilita a exibi o dos valores das divis es da escala 7 4 6 1 38 TotalNumber OfSubTicks 9 Define o n mero total de subdivis es que ser o mostradas na escala 7 4 6 1 39 Value Esta propriedade define um valor entre as propriedades Maximum e Minimum da escala do objeto 262 ActiveX 7 4 6 1 40 ValueVisible P Habilita ou desabilita a exibi o do valor contido na propriedade Value O valor padr o dessa propriedade falso 7 4 7 E2Setpoint Esta se o cont m informa es sobre propriedades do objeto E2Setpoint Este objeto n o possui eventos nem m todos associados 7 4 7 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto E2Setpoint 7 4 7 1 1 AutoSend FI se esta propriedade estiver em True valor padr o o valor definido na propriedade Value atualizado nas associa es assim que o objeto perder o foco Caso contr rio as associa es s recebem o valor quando for usada a tecla ENTER 7 4 7 1 2 BackgroundColor E Esta propriedade define a cor de fundo do objeto O valor padr o desta propriedade cinza RGB 192 192 192 7 4 7 1 3 EnableMaxLimit F Habilita ou desabilita a defini o de um limite m ximo para o valor do E2Setpoint 7 4 7 1 4 Ena
187. a dos valores dentro do intervalo de totais especificado grupo p gina ou relat rio 6 VarP Calcula a vari ncia populacional dos valores dentro do intervalo de totais especificado grupo p gina ou relat rio 7 Dev Calcula o desvio padr o dos valores dentro do intervalo de totais especificado grupo p gina ou relat rio 8 DevP Calcula o desvio padr o populacional dos valores dentro do intervalo de totais especificado grupo p gina ou relat rio 9 DSum Calcula a soma de todos os valores distintos dentro do intervalo de totais especificado grupo p gina ou relat rio 10 DAvg Calcula a m dia baseada nos valores distintos dentro do intervalo de totais especificado grupo p gina ou relat rio 11 DCount Conta o n mero dos valores distintos dentro do intervalo de totais especificado grupo p gina ou relat rio 12 DVar Calcula a vari ncia dos valores distintos dentro do intervalo de totais especificado grupo p gina ou relat rio 13 DVarP Calcula a vari ncia populacional dos valores distintos dentro do intervalo de totais especificado grupo p gina ou relat rio 14 DDev Calcula o desvio padr o dos valores dentro do intervalo de totais especificado grupo p gina ou relat rio 15 DDevP Calcula o desvio padr o populacional dos valores distintos dentro do intervalo de totais especificado grupo p gina ou relat rio 22 6 5 1 14 SummaryGroup A Esta propriedade s v
188. a entrada de texto que coincida com o primeiro caractere digitado no objeto Se for digitada repetidamente a mesma letra passada para a pr xima entrada de texto que comece com esta letra e assim por diante e 1 fmMatchEntryComplete conforme cada caractere digitado o objeto procura por uma entrada de texto que coincida com os caracteres digitados e 2 fmMatchEntryNone n o faza procura no objeto 222 ActiveX Ovalor padr o desta propriedade 1 fmMatchEntryComplete 7 3 7 2 17 MultiSelect P A propriedade MultiSelect indica se o objeto permite m ltiplas sele es As op es dispon veis para esta propriedade s o as seguintes e 0 fmMultiSelectSingle somente um item pode ser selecionado e 1 fmMultiSelectMulti permite selecionar um item atrav s da barra de espa o ou clique com o mouse fazendo com que marque ou desmarque um item na lista e 2 fmMultiSelectExtended permite selecionar um item atrav s da tecla SHIFT clicando com o mouse ou pressionando SHIFT e uma das teclas de seta estendendo a sele o para o item atual Pressionando a tecla CTRL e clicando com o mouse marca ou desmarca um item Ovalor padr o desta propriedade 0 fmMultiSelectSingle 7 3 7 2 18 Selected FP seleciona ou desseleciona um item e verifica se um item est selecionado quando a propriedade Multiline est configurada como True Para saber se um determinado item est selecionado o ndice do item a ser consultado deve
189. a n o tem efeito no E3 e foi mantida por motivos de compatibilidade com a especifica o padr o dos objetos Microsoft Forms As op es dispon veis s o as seguintes Op es dispon veis para IMEMode OP O DESCRI O 0 fmIMEMOdeNoControl N o controla IME padr o 1 fmIMEMoOdeOn IME ativado 2 fmIMEModeoff IME desativado Modo ingl s 3 fmIMEMOde Disable IME desativado O usu rio n o pode ativar IME pelo teclado 4 fmIMEMOdeHiragana IME ativado com modo Hiragana de largura total 5 fmiMEMoOdeKatakanaFull IME ativado com modo Katakana de largura total 6 fmIMEMOdeKatakana IME ativado com modo Katakana de meia largura 7 fmIMEMOdeAlphaFull IME ativado com modo Alfanum rico de largura total 8 fmIMEMOdeAlpha IME ativado com modo Alfanum rico de meia largura 9 fmIMEMOode HangulFull IME ativado com modo Hangul de largura total 10 fmIMEMOde Hangul IME ativado com modo Hangul de meia largura 220 ActiveX OP O DESCRI O 11 fnIMEMOode HanziFull IME ativado com modo Hanzi de largura total 12 fmIMEMode Hanzi IME ativado com modo Hanzi de meia largura 7 3 7 2 10 IntegralHeight F A propriedade IntegralHeight ajusta a altura da rea de edi o do texto caso a rea dispon vel para o mesmo ultrapasse o tamanho do objeto
190. a ordena o do campo secund rio 13 3 13 AlarmServer Nome do servidor de alarmes nico existente na aplica o 13 3 14 ColumnHeader F Quando configurada como True esta propriedade habilita a visualiza o do cabe alho do E3Alarm O cabe alho tamb m permite que seja feita a reordena o dos dados da tabela visualmente ver propriedade AllowColumncClick O valor padr o desta propriedade True 13 3 15 Domain A Especifica o dom nio ao qual o E3Alarm ir se conectar O padr o desta propriedade vazio ou seja o E3Alarm se conecta ao mesmo dom nio do Viewer onde ele se encontra Por exemplo AWNomeDeoOutroServidor 13 3 16 Enabled Pl Habilita o objeto ActiveX no projeto O valor padr o desta propriedade True 368 E3Alarm 13 3 17 Font Determina a fonte tipo de letra do cabe alho e das linhas do E3Alarm Esta propriedade somente de leitura e s pode ser modificada via Studio n o em tempo de execu o 13 3 18 Filter Controla as reas de alarmes vis veis no E3Alarm Se seu valor n o for vazio ser o apresentados eventos cujo nome das reas comecem com o texto indicado Por exemplo se Filter Ana ser o mostrados os alarmes de reas como Analogicos Producao ou Analise mas n o Digitais Analise ou Digitais Producao Quando a propriedade SimpleAreaFilter for False a rea de alarme tamb m permitir o uso de coringas para a filtragem ou e permitir m ltipl
191. a propriedade determina o valor m nimo requerido pela escala O valor padr o desta propriedade O Exemplo Sub CommandButtonl clickQO Ao clicar no bot o abre um MessageBox indicando o valor da propriedade Minimum do Escalal MsgBOX _ f Supp ication Getobject Dados Escala1 Minimumvalue End Su 6 2 8 1 13 MinorTicks 9 Esta propriedade determina a quantidade de marcas da escala Ovalor padr o desta propriedade 3 Exemplo Sub CommandButtonl clickQO Mostra o total de marcas da escala MsgBox Cstr Screen Item Escalal minorTicks End sub 6 2 8 1 14 MinorTicksPercentSize 9 Esta propriedade determina o tamanho das marcas que subdividem cada medida do objeto Escala O valor padr o desta propriedade 10 Exemplo Sub CommandButton1 clickQO RegRaA cstr screen Item Escalal minorTicksPercentsize End Su 6 2 8 1 15 ScaleAlignment aP Esta propriedade determina o tipo de alinhamento que ser atribu do escala e O RightSide direita valor padr o e 1 LeftSide esquerda Exemplo Sub CommandButtonl clickQO 170 Telas e Objetos de Tela screen Item Escalal scalealignment 1 End sub 6 2 8 1 16 ShowText P Esta propriedade determina a visibilidade do texto na legenda do objeto Escala Se a op o estiver habilitada o texto mostrado Caso contr rio o objeto mostra somente as linhas e subdivis es da escala O valor padr o desta propriedade True 6 2 8 1 17 StretchText
192. a tecla pressionada juntamente com o mouse e 4 Tecla SHIFT e 8 Tecla CTRL e 12 Teclas CTRL SHIFT Exemplo Sub Telal Kkeyup Keycode shift Mostra uma caixa de mensagem quando o usu rio soltar uma tecla MsgBox c digo da tecla amp KeyCode End Sub 6 1 1 5 MouseDown MouseDown Button ShiftState MouseX MouseY Ocorre quando se pressiona qualquer bot o do mouse sobre a Tela Utilize o evento MouseDown para determinar a es espec ficas quando a Tela for clicada pelo usu rio Vari veis do evento MouseDown NOME DESCRI O Button i Mostra o bot o do mouse pressionado e 1 Obot o do mouse pressionado o esquerdo Telas e Objetos de Tela 131 NOME DESCRI O e 2 0Obot o do mouse pressionado o direito ShiftState Mostra a tecla pressionada juntamente com o mouse e 4 Tecla SHIFT e 8 Tecla CTRL e 12 Teclas CTRL SHIFT MouseX Mostra a coordenada X onde o mouse foi clicado na Tela MouseY Mostra a coordenada Y onde o mouse foi clicado na Tela Exemplo Sub TelaInicial MouseDown Button Shiftstate MouseX MouseY Encerra a aplica o quando houver um clique de mouse no objeto TelaInicial application ExitO End sub 6 1 1 6 MouseUp MouseUp Button ShiftState MouseX MouseY Ocorre quando se solta qualquer bot o do mouse previamente clicado Utilize o
193. acejada 4 dashdotdot O estilo da linha da grade tra o ponto ponto 5 invisible N o h linhas vis veis na grade invis vel Exemplo Sub CommandButton1 clickQO Set Chart Screen Item E3Chart1 Solid O dash 1 dot 2 dashdot 3 dashdotdot 4 invisible 5 For i 0Tos MsgBox Clique para mudar o estilo da linha no grid Chart axes Item NomeDoEixo Gridstyle i Next End sub 18 7 2 5 Inverse FI inverte a ordem dos valores m nimo e m ximo na escala num rica Normalmente em escalas verticais o valor m nimo parece abaixo e o valor m ximo acima Nas escalas horizontais o valor m nimo aparece na esquerda e o valor m ximo na direita Quando a propriedade Inverse estiver configurada para True no entanto esta ordem ser invertida valores m ximos abaixo ou esquerda valores m nimos acima ou direita Exemplo Sub CommandButton1 clickQO Set Chart Screen Item E3Chart1 Chart Axes Item NomeDoEixo Inverse Not _ Chart axes Item NomeDoEixo Inverse End sub 448 E3Chart 18 7 2 6 MinorTicks 9 Determina o n mero total de subdivis es entre as escalas Exemplo Sub CommandButton1 clickQO Set Chart Screen Item E3Chart1 Chart axes Item NomeDoEixo MinorTicks _ Chart axes Item NomeDoEixo MinorTicks 1 End sub 18 7 2 7 Mirror FP Indica o espelhamento do eixo Se a propriedade estiver configurada para True o eixo ser espelhado no
194. ada para True a largura do texto reajustada para a mesma do objeto O conte do do texto cortado quando ele excede a rea do objeto 7 3 5 2 3 BackStyle aP A propriedade BackStyle define o estilo do plano de fundo para os objetos As op es dispon veis para esta propriedade s o as seguintes e 0O fmBackStyleTransparent define o objeto como transparente isto nenhum fundo deste objeto ser desenhado e 1 fmBackStyleOpaque define o objeto como opaco isto o fundo ser desenhado valor padr o 7 3 5 2 4 Caption Define o texto que ser mostrado no objeto 7 3 5 2 5 Font Apropriedade Font utilizada para determinar a fonte do objeto Esta propriedade n o pode ser utilizada em scripts ou em associa es sendo configurada unicamente via Studio ActiveX 209 7 3 5 2 6 Locked Fi A propriedade Locked habilita ou desabilita a edi o do objeto Se esta propriedade estiver configurada para True a edi o n o permitida Caso contr rio poss vel editar o objeto Os valores configurados na propriedade Enabled influenciam o comportamento de Locked Para maiores detalhes consulte a propriedade Enabled O valor padr o desta propriedade False 7 3 5 2 7 Picture a Apropriedade Picture especifica a figura bitmap atribu da ao objeto Um arquivo com imagem pode ser selecionado de duas maneiras atrav s da Lista de Propriedades ouvia scripts utilizando se a fun o LoadPicture para especif
195. ada para True e o relat rio contiver um PageFooter o GroupFooter e o ReportFooter do relat rio ser o impressos acima da se o PageFooter Configurando mais de uma se o para imprimir o p da p gina do relat rio far com que as se es seguintes do rodap sejam impressas em p ginas separadas 22 6 Objetos Esta se o cont m informa es sobre propriedades dos objetos do Relat rio Estes objetos n o possuem eventos nem m todos associados 22 6 1 Propriedades Comuns Esta se o cont m informa es sobre as propriedades comuns aos objetos do Relat rio 22 6 1 1 BackColor E Especifica a cor de fundo do objeto no relat rio O efeito desta propriedade s ser vis vel se a propriedade BackStyle estiver habilitada para a op o 1 ddBKNormal O valor padr o desta propriedade branco RGB 255 255 255 NOTA esta propriedade n o v lida para os objetos Linha e Quebra de P gina 22 6 1 2 BackStyle aP Especifica o estilo do fundo dos objetos do relat rio As op es dispon veis para esta propriedade s o as seguintes e 0 ddBKTransparent transparente mostra a cor definida pela propriedade BackColor da se o e 1 ddBKNormal normal mostra a cor definida pela propriedade BackColor do objeto Ovalor padr o 0 ddBKTransparent Relat rios 495 22 6 1 3 height 9 Esta propriedade determina a altura do objeto no relat rio 22 6 1 4 left 9 Retorna o valor do posicionament
196. ade Quando este par metro est em zero significa que autom tico Aunidade n o utilizada quando a escala num rica As op es dispon veis no par metro TimeUnit s o as mesmas demonstradas na tabela do m todo GetRealTimePeriod Exemplo Sub CommandButton1 clickQO Set Chart Screen Item E3Chart1 Unitvalue Chart Axes Item NomeDoEixo GetTickspacing Tickspacing MsgBox valor amp cstr Tickspacing amp _ unidade amp cstr unitvalue End sub 18 7 1 5 SetHistoricPeriod SetHistoricPeriod Begin End Configura o per odo de tempo para a escala hist rica O par metro Begin determina o per odo inicial da escala e End determina o per odo final da escala Exemplo E3Chart 445 Sub CommandButton1 clickQO Set Chart Screen Item E3Chart2 Chart axes Item NomeDoEixo ScaleType 2 Mostra o ultimo per odo hart axes TrenCNomeDoEixo O serias enic rea now 1 now End Su 18 7 1 6 SetMinMax SetMinMax Min Max Configura os valores m nimo e m ximo da escala num rica O valor m nimo determinado pelo par metro Min e o m ximo por Max Exemplo Sub circulol click Set Chart Screen Item E3Chart2 Chart axes Item NomeDoE ixo SetMinMax 10 500 End sub 18 7 1 7 SetRealTimePeriod SetRealTimePeriod Times TimeUnit Ajusta o intervalo de tempo na unidade definida pelo par metro TimeUnit As op es dispon veis neste par metro s o as mesmas demonstradas na tab
197. ade Value do SetPoint Exemplo Sub Textol Validate Cancel Newvalue ui Mostra um MessageBox que pergunta ao usu rio se ele deseja usar o novo valor digitado no SetPoint message Valor atual amp value amp vbnewline amp _ valor novo amp Newvalue amp vbnewline amp vbnewline amp _ aceita o novo valor f If MsgBox message vbQuestion vbYesNo _ Cancel True End If End Sub 6 2 7 2 Propriedades Esta se o cont m informa es sobre as propriedades dos objetos Texto Display e SetPoint 6 2 7 2 1 EnableLimits P Indica se ser feita a verifica o de limites no texto Quando EnableLimits for True e o usu rio inserir um valor n o num rico ou colocar um valor fora dos limites definidos em MinLimit e MaxLimit uma mensagem de erro mostrada a propriedade IsSetPoint deve ser True Exemplo sub CommandButton1 Click screen Item Texto1 EnableLimits Not screen Item Textol EnableLimits End sub Telas e Objetos de Tela 159 6 2 7 2 2 Format AA propriedade Format especifica que tipo de formato ser atribu do ao objeto Permite mudar a forma como os dados s o apresentados sem mudar o valor que existe por tr s deles Esta propriedade pode ser editada manualmente ou configurada atrav s da janela de formata o Seu uso semelhante aos formatadores usados nas planilhas de dados seguindo a mesma sintaxe S o suportados os seguintes tipos de dados Tipos de dados suportados
198. adeira ou falsa 4 Conex o por Tabela Na conex o por tabela pode se estabelecer condi es entre a vari vel os valorese o destino Na tabela s o especificados os valores m nimos e m ximos e demais configura es 5 Conex o Reversa Aconex o reversa uma associa o unidirecional da propriedade para a fonte 6 Conex o M ltipla A conex o m tipla semelhante a uma associa o por tabela exceto que cada linha da associa o permite buscar seu valor de uma fonte diferente Exemplo Associa es 281 Sub CommandButtonl clickQO On Error Resume Next Dim Bind Set Bind Screen Item Textol Links Item value If Bind Is Nothing Then MsgBox Textol n o est associado a nenhum objeto Dim Source Source Dados TagInternol Value MsgBox Criando uma conex o em amp Source amp Set Bind Screen Item Textol Links CreateLink value Source 0 Bind BiDirectional Screen Item BiDirectional value Bind Reverse Screen Item Reverse Value MsgBox Tipo amp TypeName Bind Else MsgBox Textol j est ligado amp Bind Ssource amp End If End sub 9 1 2 Item Item Property Index Este m todo retorna um objeto Conex o de uma determinada propriedade de um objeto Se for um texto Property especifica o nome da propriedade cuja conex o se deseja acessar Aconex o tamb m pode ser acessada numericamente pelo ndice Inde
199. ado corretamente na tela retorna True Caso o usu rio aperte o bot o Cancel ou aconte a algum erro retorna False Exemplo Sub CommandButtonl clickQO Set report application LoadReport Relat riol In cio App ication Getobject Dados Grafico datai value Final application Getobject Dados Grafico dataf value report Item Consultal Setvariablevalue Ini Inicio report Item Consultal setvariablevalue Fim Final report PrintPreview End sub Relat rios 477 22 2 5 Query Query Retorna o objeto Consulta atualmente selecionado no relat rio informado atrav s da propriedade SourceQuery pode haver mais de uma consulta no relat rio Exemplo sub Rect Click Set Query Application oadRepor IRo aieeao O Z Query SetVariablevalue chavel XY End su 22 3 Propriedades Para criar um script no relat rio utiliza se o Editor de Scripts do Relat rio acessado atrav s do bot o Editor de Scripts e para visualizar o relat rio utiliza se o bot o Gerar Relat rio ambos localizados na Barra de Ferramentas do Relat rio Os scripts do relat rio utilizam alguns procedimentos dependendo do objeto ou da se o que se deseja incluir o c digo Por exemplo Report Sections PageHeader Controls E3Chart1 GridBkcolor RGB 255 O 255 onde e PageHeader o nome da se o onde o objeto est incluso no relat rio e E3Chartl o nome do objeto que est de
200. adr o desta propriedade False 420 E3Chart 18 3 26 MouseOverChild Fi A propriedade MouseOverChild informa se o ponteiro do mouse encontra se em cima de um dos objetos inseridos na Tela Caso afirmativo a propriedade MouseOverChild habilitada Caso contr rio ser False Esta propriedade somente de leitura e acess vel apenas em tempo de execu o O valor padr o desta propriedade False 18 3 27 Padding 9 Esta propriedade determina a dist ncia em pixels entre o gr fico e a borda do objeto E3Chart conforme pode ser observado nas figuras seguintes atrav s das setas vermelhas O valor padr o desta propriedade 10 Exemplo 100 75 10 59 40 10 59 50 11 00 00 11 00 10 11 00 20 11 00 30 Propriedade Padding igual a 10 E3Chart 421 Propriedade Padding igual a 30 18 3 28 Pens Retorna o objeto Cole o de Penas do E3Chart O objeto Cole o de Penas utilizado para inserir remover ou acessar as penas dispon veis no E3Chart Esta propriedade somente de leitura Exemplo Sub CommandButton1l click For Each pen In Screen Item E3Chart1 Pens pen vVisible True Next End sub 18 3 29 Queries Retorna o objeto Cole o de Consultas dentro do E3Chart O objeto Cole o de Consultas utilizado para inserir remover ou acessar as consultas dispon veis no E3 Chart Esta propriedade somente de leitura 422 E3Chart 18 3 30 RefreshTime 9 Esta propriedade determina o
201. adr o desta propriedade False 7 3 4 3 29 MatchEntry P Procura atrav s do texto digitado pelo usu rio por uma entrada de texto que coincida com os dados existentes no objeto Ao encontrar uma incid ncia do texto a linha contendo a mesma selecionada e o conte do da coluna exibido As op es dispon veis s o as seguintes e 0 fmMatchEntryFirstLetter procura pela entrada de texto que coincida com o primeiro caractere digitado no objeto Se for digitada repetidamente a mesma letra passada para a pr xima entrada de texto que comece com esta letra e assim por diante e 1 fmMatchEntryComplete conforme cada caractere digitado o objeto procura por uma entrada de texto que coincida com os caracteres digitados e 2 fmMatchEntryNone n o faza procura no objeto Ovalor padr o desta propriedade 1 fmMatchEntryComplete 7 3 4 3 30 MatchFound P Indica se o texto que o usu rio digitou no objeto coincide com qualquer entrada na lista Se a propriedade estiver configurada para True o conte do da propriedade Value coincide com um dos registros na lista Caso contr rio o conte do da propriedade Value n o coincide com nenhum dos registros na lista padr o Esta propriedade acess vel apenas em tempo de execu o n o sendo aplic vel quando a propriedade MatchEntry definida como 2 O valor padr o desta propriedade False 204 ActiveX 7 3 4 3 31 MatchRequired P Especifica se o texto digitado d
202. adr o desta propriedade O Exemplo Sub CommandButton1 clickQO screen Item Escalal Borderwidth 120 End sub Telas e Objetos de Tela 165 6 2 8 1 6 FilStyle a Esta propriedade especifica o estilo do preenchimento do objeto Aseguinte tabela cont m os valores v lidos para a propriedade FillStyle Op es dispon veis para FillStyle OP O DESCRI O 0 Solid O preenchimento ser s lido 1 Hollow N o haver preenchimento 2 Horizontal O preenchimento ser com listras horizontais 3 Vertical O preenchimento ser com listras verticais 4 Downward O preenchimento ser com listras descendo da esquerda para a direita em ngulo de 45 graus 5 Upward O preenchimento ser com listras subindo da esquerda para a direita em ngulo de 45 graus 6 Cross O preenchimento ser com listras horizontais e verticais 7 DiagonalCross O preenchimento ser com listras descendo e subindo da esquerda para a direita em ngulo de 45 graus 8 Gradient O preenchimento ser em degrad utilizando tanto ForegroundColor quanto BackgroundColor O efeito ser definido pela propriedade GradientStyle 9 SemiTransparent Deixa o objeto transl cido 10 MouseArea O preenchimento ser vazio mas o objeto continua sens vel aos eventos Padr o 166 Telas e Objetos de Tela 6 2 8 1 7 ForegroundColor
203. al principal da grade Este valor pode ser num rico para E3Charts XY ou Data para E3Charts com escala de tempo fixa Para E3Charts de tempo real esta propriedade n o aplicada sendo ent o utilizada a propriedade TimeSpan Exemplo Sub ComboBox1 Change O Define qual consulta deseja mostrar current query index ListIndex Set Rosh Screen Item E3Chart1 i For Each query In E3Chart1 Queries If i current_query_index Then query FieldFilter 0 Traz tudo Set current_query query Else query FieldFilter 0 lt 0 N o traz nada para n o ficar lento End If i i 1 Next S mostra as penas que usam a consulta atual For Each pen In E3Chart1 Pens pen visible pen QueryName current query Name Next atualiza as consultas E3Chart1 Queries UpdateData Screen Item E3Chart1 HorscaleBegin Now 0 001 screen Item E3Chart1 HorscaleEnd Now End sub 418 E3Chart 18 3 20 HorScaleF ormat Cont m um texto que representa uma m scara dentro da qual os valores da escala horizontal ser o mostrados Esta m scara pode representar v rios tipos de valores Geral N o possui formata o espec fica adaptando se automaticamente ao valor especificado N mero Apresenta n meros com parte inteira e fracion ria O usu rio pode optar por at 15 casas decimais por usar ou n o um separador de milhares e por apresentar n meros negativos com sinal ou entre par nteses Para n meros muito g
204. alA Exemplo Sub Botaol click Ao clicar no Bot o atribui o valor a um tag sendo executado em um DatasServer atribui o valor 20 para o tag Application setvalue Teea InternalTag1 20 J que o valor do InternalTagl j 20 o m todo Togglevalue al ternar o valor para 30 Application ToggleValue DataServer1 InternalTag1 30 20 End Sub 10 2 31 TrackEvent TrackEvent EventMessage Comment TimeStamp O m todo TrackEvent permite gerar eventos via script manualmente Estes eventos podem ser gerados tanto no Viewer como no Servidor e s o registrados em uma tabela no banco de dados do aplicativo Par metros do m todo TrackEvent NOME DESCRI O EventMessage Cont m a mensagem do evento m ximo 200 caracteres Comment Opcional Cont m coment rios adicionais sobre o evento m ximo 200 caracteres TimeStamp Opcional Indica a data hora em que o evento ocorreu Se n o for especificado o E3 assume a data hora atual Viewer 313 O m todo TrackEvent s vai registrar os eventos caso a op o de Registro de Eventos nas Op es do Dom nio esteja habilitada Os eventos s o registrados numa tabela de um banco de dados que definida tamb m nas configura es de Registro de Eventos Para maiores informa es sobre o Registro de Eventos do Dom nio consulte o Manual do Usu rio Exemplo sub Buttonl click Dim Tag User Comment set aa A
205. alor Pick Inverter Valor Adiciona o pick Inverter Valor Pick Imprimir Relat rio g Adiciona o pick Imprimir Relat rio Remover script pick selecionado Remove o script ou o pick selecionado na Lista de A es Mover script pick t Move a a o selecionada para cima na selecionado para cima ordem da Lista de A es para o evento Mover script pick selecionado para baixo Move a a o selecionada para baixo na ordem da Lista de A es para o evento AppBrowser Abre a janela do AppBrowser Procurar Busca por ocorr ncias de um determinado texto Procurar anterior E Seleciona na lista de resultados a ocorr ncia anterior LAN lt u Procurar pr xima n Seleciona na lista de resultados a ocorr ncia seguinte itui A E Ara Substituir A Substitui as ocorr ncias encontradas por outro texto especificado n Le 4 Criar evento do usu rio Eq Cria um evento de usu rio Remover evento do rN Remove o evento de usu rio selecionado usu rio rai 4 a pet E Editar evento do usu rio 73 Edita o evento de usu rio selecionado Compila o script selecionado Compila o script selecionado mostrando os erros no painel Mensagens Compilar todos os scripts deste evento Compila todos os scripts associados ao evento Compila todos os eventos Compila todos os eventos associados ao Introdu o CAMPO C
206. alor padr o destas propriedades False 3 4 2 2 DeviceHigh 9 Apropriedade DeviceHigh define o valor m ximo atingido pelo elemento de bloco no equipamento ou no dispositivo Esta propriedade ser utilizada para fazer o ajuste de escala do valor proveniente do equipamento ou do dispositivo antes de ser atribu do propriedade Value Da mesma forma no momento da escrita feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a propriedade EnableScaling est configurada para True O valor padr o desta propriedade 1000 Exemplo Sub Elemento OnStartRunning O Faz o ajuste de escala de um elemento temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub 3 4 2 3 DeviceLow 9 Apropriedade DeviceLow define qual o valor m nimo atingido por este elemento no equipamentoou no dispositivo Esta propriedade ser utilizada para fazer o ajuste de escala do valor proveniente do equipamento ou do dispositivo antes de ser atribu do propriedade Value Da mesma forma no momento da escrita feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a propriedade EnableScaling est configurada para True O valor padr o desta 80 Drivers propriedade 0 Exemplo Sub Elemento OnStartRunning O F
207. alor no E3 seja atualizado Este valor especificado como um percentual da diferen a entre as propriedades DeviceHigh e DeviceLow Esta propriedade s ser utilizada caso a propriedade EnableDeadBand do mesmo elemento esteja configurada para True Se a propriedade PercentDeadband for igual a 0 o elemento de bloco n o ter banda morta e qualquer varia o no seu valor ser repassada para o E3 Caso contr rio s ser enviado para o E3 um novo valor cuja diferen a em rela o ao valor atual no E3 seja maior que a banda morta O valor padr o desta propriedade O 3 4 2 11 Quality 9 Apropriedade Quality informa qual a qualidade do valor contido na propriedade Value Cada vez que o Driver atribui um novo valor para o Elemento ele tamb m configura a qualidade daquele dado Esta propriedade somente para leitura O valor padr o desta propriedade O Qualidade Ruim NOTA Para maiores informa es sobre qualidade consulte o t pico Propriedade Quality ou o t pico Qualidade no Manual do Usu rio Drivers 83 3 4 2 12 RawValue Acessa o valor original do elemento anterior escala ou seja independentemente da configura o da propriedade EnableScaling Ent o se esta propriedade for False as propriedades Value e RawValue apresentam o mesmo comportamento 3 4 2 13 UseBitFields FI se esta propriedade estiver configurada para True toda vez que o valor da propriedade Value for modificada ele atualizar os bits
208. alores 2 e 8 Isto faz com que a rea restante utilize a cor de fundo para preenchimento Nos scripts utilize a fun o do VBScript RGB para montar a cora ser associada a esta propriedade O valor padr o desta propriedade cinza RGB 192 192 192 6 2 8 1 3 BorderColor E Esta propriedade determina a cor da borda que ser aplicada no objeto Escala Com esta propriedade poss vel aplicar a cor padr o ou personaliz la atrav s da sua edi o Ovalor padr o desta propriedade branco RGB 255 255 255 Exemplo Sub Escalal Click Bordercolor RGB 255 0 0 End sub 164 Telas e Objetos de Tela 6 2 8 1 4 BorderStyle a Apropriedade BorderStyle determina o estilo de borda que ser aplicada ao objeto Escala Op es dispon veis para BorderStyle OP O DESCRI O O Normal Aplica uma borda s lida na grade vertical da escala padr o 1 Dash Aplica uma borda linha tracejada na escala 2 Dot Aplica uma borda pontilhada na escala 3 Dashdot Aplica uma borda tra o e ponto na escala 4 Dashdotdot Aplica uma borda tra o ponto ponto na escala 5 Null O objeto n o ter borda Exemplo Sub Escalal click Borderstyle 1 End sub 6 2 8 1 5 BorderWidth 9 Esta propriedade determina a largura em pixels da borda do objeto Escala Atrav s desta propriedade poss vel configurar a largura da borda sem ter que mexer na sua estrutura O valor p
209. an a da cor partindo de ForegroundColor e indo para BackgroundColor Op es dispon veis para GradientStyle OP O DESCRI O 0 LeftToRight Degrad vertical da esquerda para a direita 1 RightToLeft Degrad vertical da direita para a esquerda 2 VerFromCenter Degrad vertical do centro para as bordas 3 VerToCenter Degrad vertical das bordas para o centro 4 BottomUp Degrad horizontal de baixo para cima 5 TopDown Degrad horizontal de cima para baixo 6 HorzFromCenter Degrad do centro para as bordas 7 HorzToCenter Degrad das bordas para o centro 8 DiagUpRight Degrad diagonal para cima coma cor de frente na direita padr o 9 DiagUpLeft Degrad diagonal para cima coma cor de frente na esquerda 10 DiagUpFromCenter Degrad diagonal para cima do centro para as bordas 11 DiagUpToCenter Degrad diagonal para cima das bordas para o centro 12 DiagDownLeft Degrad diagonal para baixo com cor de frente na esquerda 13 DiagDownRight Degrad diagonal para baixo com cor de frente na direita 168 Telas e Objetos de Tela OP O DESCRI O 14 DiagDownFromCenter Degrad diagonal para baixo do centro para as bordas 15 DiagDownToCenter Degrad diagonal para baixo das bordas para o centro 16 Spo
210. ao objeto 22 6 5 1 18 VerticalAlignment P Determina o alinhamento vertical do objeto a saber e 0O Top alinhamento pelo topo e 1 Middle alinhamento ao centro e 2 Bottom alinhamento pela base 22 6 5 1 19 WordWrap F Habilita ou desabilita uma quebra de linha no texto caso a rea dispon vel para o texto ultrapasse os limites determinados no objeto Para que esta propriedade funcione a propriedade Multiline deve ser obrigatoriamente igual a True Se for False a configura owhite space nowrap ir aparecer na propriedade Style 22 6 6 Texto Esta se o cont m informa es sobre propriedades do objeto Texto do Relat rio Este objeto n o possui eventos nem m todos associados 22 6 6 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Texto do Relat rio 22 6 6 1 1 Alignment aP A propriedade Alignment determina o alinhamento do texto a saber e 0 ddtxLeft alinhamento esquerda e 1 ddtxRight alinhamento direita e 2 ddtxCenter alinhamento centralizado valor padr o 512 Relat rios 22 6 6 1 2 Angle 9 Apropriedade Angle indica o ngulo do texto O valor da propriedade deve ser especificado em d cimos de graus ou seja para que o texto seja mostrado em um ngulo de 45 graus o valor deve ser igual 450 O valor padr o desta propriedade O posicionamento horizontal 22 6 6 1 3 Caption A A propriedade Caption cont m o texto do objeto propriamente dito
211. aparece no Gerenciador de Tarefas do Windows na coluna PID O par metro CmdShow especifica o modo de abertura da janela do aplicativo como na tabela a seguir Op es dispon veis para o par metro CmdShow OP O DESCRI O 0 Esconde a janela e ativa outra janela 1 Ativa e mostra a janela Se a janela estiver maximizada ou minimizada ela ser restaurada para o tamanho e posi o originais Uma aplica o deve especificar esse valor quando estiver mostrando uma janela pela primeira vez 2 Ativa a janela e mostra a minimizada 3 Ativa a janela e mostra a maximizada 4 Mostra a janela com seu tamanho e posi o mais recentes A janela ativa permanece ativa 5 Ativa a janela e mostra a com seu tamanho e posi o atuais 6 Minimiza a janela e ativa a pr xima janela de n vel superior 7 Mostra a janela minimizada Ajanela ativa permanece ativa 8 Mostra a janela em seu estado atual Ajanela ativa permanece ativa 9 Ativa e mostra a janela Se a janela estiver maximizada ou minimizada ela ser restaurada para o tamanho e posi o originais Uma aplica o deve especificar esse valor quando estiver restaurando uma janela que estava minimizada 302 Viewer Exemplo sub CommandButtonl Click Dim ret Application ExecuteExternalapp calc exe 5 pal App i cation Getobject Dados TagInterno1 Value ret End Su ret 10 2 6 Exit Exit
212. aplica es que usam ActiveX Controls Automation Servers e Java Applets Conforme visto anteriormente os scripts s o associados a eventos de um objeto Entretanto para facilitar e aumentar a velocidade de desenvolvimento o E3 j incorpora algumas a es mais comuns que poderiam ser realizadas com scripts atrav s de assistentes chamados Picks Pode se portanto definir que um determinado evento executar um script um pick ou uma combina o deles numa sequ ncia tamb m pr definida Cada view do E3 Studio apresenta pelo menos duas abas na parte inferior Design e Scripts com exce o dos objetos Banco de Dados e Servidor de Alarmes que n o possuem a aba Design Os objetos e seus filhos podem ser manipulados na aba Design para manipular seus scripts utilize a aba Scripts Os bot es dispon veis nesta ltima s o Op es dispon veis na aba Scripts CAMPO CONE A O FUN O Lista de Objetos Testos Seleciona o objeto cujo script ser manipulado Lista de Eventos BI Ci Seleciona o evento a ser aplicado ao objeto Script E Adiciona um script associado ao evento Pick Abrir Tela E Adiciona o pick Abrir Tela Pick Abrir Tela Modal Adiciona o pick Abrir Tela Modal Introdu o 7 CAMPO CONE A O FUN O Pick Executar Aplica o 2 Adiciona o pick Executar Aplica o Pick Carregar Valor gh Adiciona o pick Carregar V
213. aption Define o texto que ser mostrado no objeto 7 3 3 1 6 Font A Apropriedade Font utilizada para determinar a fonte do objeto Esta propriedade n o pode ser utilizada em scripts ou em associa es sendo configurada unicamente via Studio 7 3 3 1 7 GroupName Apropriedade GroupName utilizado para criar um grupo de objetos mutuamente exclusivos 7 3 3 1 8 Locked P A propriedade Locked habilita ou desabilita a edi o do objeto Se esta propriedade estiver configurada para True a edi o n o permitida Caso contr rio poss vel editar o objeto Os valores configurados na propriedade Enabled influenciam o comportamento de Locked Para maiores detalhes consulte a propriedade Enabled O valor padr o desta propriedade False 7 3 3 1 9 Picture 4 Apropriedade Picture especifica a figura bitmap atribu da ao objeto Um arquivo com imagem pode ser selecionado de duas maneiras atrav s da Lista de Propriedades ou via scripts utilizando se a fun o LoadPicture para especificar o caminho e o nome do arquivo que cont m a figura Para remover a figura clique no valor da propriedade Picture e pressione a tecla DEL Atecla BACKSPACE tecla de espa o do teclado n o remove a figura Exemplo sub CommandButtonl Click 190 ActiveX Screen Item checkBox1 Picture End sub 7 3 3 1 10 PicturePosition LoadPicture c Naba gif a Apropriedade PicturePosition especifica a posi o da figura a
214. ara True o t tulo principal do E3Chart vis vel Caso contr rio fica invis vel A propriedade Title cont m o t tulo que ser mostrado no E3Chart Exemplo Sub CommandButtonl clickQO Set E3chartl Screen Item E3Chart1 oldtitle E3Chartl Title oldshowritle E3Chart1 showTitle E3Chartl Title Teste MsgBox Mostrar E3Chartl SshowTitle True MsgBox Esconder 424 E3Chart E3Chartl showTitle False MsgBox voltar E3Chartl Title oldTitle E3Chartl showTitle oldshowTitle End sub 18 3 40 ShowTopScale F se a propriedade estiver configurada para True o eixo horizontal principal mostrado no topo da grade Caso contr rio n o mostrado O valor padr o False Exemplo Sub CommandButtonl clickQO Set Chart Screen Item E3Chart1 Chart showTopscale Not Chart showTopscale End sub 18 3 41 TabStop P Esta propriedade determina a utiliza o da tecla TAB no sistema Se o campo estiver True poss vel utilizar a tecla caso contr rio a tecla n o pode ser utilizada 18 3 42 TimeSpan Fem Indica a escala de tempo que aparece no eixo horizontal principal do E3Chart quando esta for configurada para mostrar a escala de tempo real Ovalor desta propriedade sempre em segundos O valor padr o desta propriedade 60 Exemplo sub Retanguloarrl Click MsgBox Screen Item E3Chart1 Timespan End Sub 18 3 43 Tip Cont m um texto de ajuda apresentado como dica quando o usu r
215. ara fazer o ajuste de escala do valor proveniente do equipamento ou dispositivo antes de ser atribu do propriedade Value Da mesma forma no momento da escrita feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a propriedade EnableScaling est configurada para True O valor padr o desta propriedade O Exemplo Sub Elemento OnStartRunning Faz o ajuste de escala de um elemento temperatura que varia de O a 255 no OPC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub 3 8 1 4 EnableScaling FI A propriedade EnableScaling habilita ou desabilita a escala de valor para o valor enviado e recebido do equipamento ou dispositivo Se esta propriedade estiver configurada para True todo valor proveniente do equipamento ou dispositivo sofrer ajuste de escala conforme as propriedades DeviceHigh DeviceLow EUHigh e EULow antes de ser atribu do propriedade Value O mesmo ocorrer quando uma escrita for necess ria quando o valor presente em Value sofrer ajuste de escala sem com isso alterar a propriedade Value e posteriormente ser enviado para o equipamento ou dispositivo Caso a propriedade EnableScaling tenha o valor False nenhum ajuste de escala ser efetuado em nenhum dos dois sentidos escrita e leitura O valor padr o desta propriedade False Exemplo sub
216. arras ANSI 3 de 9 C digo 39 Utilize letras n meros etc 2 ddbcAnsi39x Estilo de c digo de barras ANSI estendido 3 de 9 C digo estendido 39 Utilize caracteres completos ASCII 3 ddbcCode_2_of_5 Estilo de c digo de barras 2 de 5 Utilize somente n meros 4 ddbcCode25intlv Estilo de c digo de barras intercalado 2 de 5 Utilize somente n meros 5 ddbcCode25mat Estilo de c digo de barras Matriz 25 6 ddbcCode39 Estilo de c digo de barras C digo 39 utilize letras n meros etc 7 ddbcCode39x Estilo de c digo de barras C digo 39 estendido Utilize caracteres completos ASCII 8 ddbcCode 128 a Estilo de c digo de barras 128 A Utilize n meros pontua es ouletras 9 ddbcCode 128 b Estilo de c digo de barras 128 B Utilize strings n meros pontua es ou letras 10 ddbcCode 128 c Estilo de c digo de barras 128 C Utilize somente 500 Relat rios OP O DESCRI O n meros 11 ddbcCode 128auto Estilo de c digo de barras 128 Autom tico Utilize caracteres completos ASCII Seleciona automaticamente c digos entre 128 A Be C para setar no c digo de barras o valor menor 12 ddbcCode 93 Estilo de c digo de barras C digo 93 Utilize letras n meros etc 13 ddbcCode 93x Estilo de c digo de barras C digo 93 estend
217. as configura es do objeto E3Chart N para o E3Chart chart que ser utilizado no relat rio set chartfrom _ Application GetFrame screen Item E3Chart1 Set chart Report sections PageHeader Controls E3Chart2 chart Copyconfig chartfrom chart LoadData chart Fital End sub NOTA A descri o das propriedades do E3Chart no relat rio s o as mesmas explicadas no t pico Propriedades do E3Chart 518 Relat rios CAP TULO D vidas Mais Frequentes Como fazer para que uma Tela janelada mostre a barra de t tulo com bot es de minimizar maximizar e fechar Para isto deve se utilizar o m todo SetFrameOptions do Divisor O par metro Iflags especifica caracter sticas da janela Ovalor 127 define uma janela com os bot es Minimizar Maximizar e Fechar vis veis Como abrir uma Tela modal Para abrir uma Tela modal utilize o m todo DoModal do Viewer Por exemplo Application DoModal Tela1 T tulo1 0 0 400 200 0 1 abre uma Tela de nome Telal como t tulo T tulo1 na posi o 0 0 com 400 pixels de largura e 200 pixels de altura passa o valor O como par metro para a Tela e habilita a barra de t tulo da janela Como fa o para copiar valores de uma linha do E3Browser para um tag Primeiro selecione a linha ou o registro desejada no E3Browser Depois utilize o m todo GetColumnValue do E3Browser O par metro IndexCampo o ndice da coluna a ser copiada iniciando em 0 Como
218. asta de dados no servidor e corresponder a cada um dos motores MOtOrA por sua vezir apontar para o MotorADados desejado n o sendo necess ria a cria o de novos tags 38 Programando no E3 Motora giMoioraDados RE aeae ERES Nome Tpo a var naa Texto de Ajuda EF MeusDados MotorADados a ToggleButton1 ToggleButton valve Motora Estado Figurai Drawficture ov verrideFiiColor Motora Estado E eto DrawString value Motora Velocidade ef aT nossa Propriedades Scrip q Motora fiiMotoraDados a pj x x Jo valor inical Texto de Ajuda E AJ EIN Propriedades ASEPE Configura o na view do XObject 4 Apropriedade Estado associada propriedade OverrideFillColor do motor fica MotorA MeusDados Estado 5 Apropriedade Velocidade associada ao Display fica MotorA MeusDados Velocidade 2 4 Acessando Objetos Seguindo o conceito de encapsulamento de programa o orientada a objetos os m todos e propriedades ficam associados a seus objetos de origem Isto significa que sempre se deve indicar o objeto do qual se est acessando o m todo ou propriedade 2 4 1 Propriedades Para referenciar as propriedades de um objeto deve se usar o m todo GetObject do E3 Asintaxe a seguinte Application Getobject lt objeto gt lt propriedade gt onde lt objeto
219. astas onde esta possa estar inserida Por exemplo Pastal ConfigAlarmes1 Area1 FonteAlarmel InTime Registra a data hora do valor no momento em que ele entra na condi o de alarme Message o texto configurado na fonte de alarme ou especificado por um outro evento por exemplo usando o m todo LogTrackingEvent do Servidor de Alarmes O limite deste campo quando armazenado no Banco de Dados de 200 caracteres OutTime Registra a data hora do valor no momento em que ele sai da condi o de alarme ou zero 30 12 1899 enquanto o alarme ainda n o tenha sa do da condi o ativa Quality Qualidade do valor de fonte do alarme no momento do evento Este campo assume os valores num ricos e 0 63 qualidade ruim e 64 127 qualidade incerta e 128 191 valor n o definido e 192 255 qualidade boa Se o evento n o for um alarme por exemplo se ele estiver usando o m todo LogTrackingEvent do Servidor de Alarmes este campo ser igual a uma string vazia Exemplo Ruim 0 Incerta 64 128 Boa 192 Severity o valor de severidade configurado na fonte de alarmes Este campo pode assumir os valores 0 alta 1 m dia 2 baixa Ele pode tamb m assumir outro valor definido pelo usu rio se for um evento como por exemplo quando estiver usando o 364 E3Alarm NOME DESCRI O m todo LogTrackingEvent Source Para eventos de alarme i
220. ate MouseX MouseY Ocorre quando se pressiona qualquer bot o do mouse sobre o objeto Vari veis de evento MouseDown NOME DESCRI O Button Mostra o bot o do mouse pressionado e 1 Obot o do mouse pressionado o esquerdo e 2 Obot o do mouse pressionado o direito ShiftState Mostra a tecla pressionada juntamente com o mouse e 4 Tecla SHIFT e 8 Tecla CTRL e 12 Teclas CTRL SHIFT MouseX Mostra a coordenada X onde o mouse foi clicado na Tela MouseY Mostra a coordenada Y onde o mouse foi clicado na Tela Exemplo Encerra a aplica o quando houver um clique do mouse no objeto TelaInicial Sub TelaInicial MouseDown Button Shiftstate MouseX MouseY application ExitO End Sub 6 2 1 6 MouseUp MouseUp Button ShiftState MouseX MouseY Ocorre quando se solta qualquer bot o do mouse previamente clicado sobre o objeto Utilize o evento MouseUp para especificar a es que ser o disparadas somente quando o bot o do mouse for solto 144 Telas e Objetos de Tela Vari veis do evento MouseUp NOME DESCRI O Button Mostra o bot o do mouse pressionado e 1 Obot o do mouse pressionado o esquerdo e 2 0Obot o do mouse pressionado o direito ShiftState Mostra a tecla pressionada juntamente com o mouse e 4 Tecla SHIFT e 8 Tecla CTRL e 12 Teclas CTRL SHIFT MouseX Mostra a coordenada X onde o mous
221. az o ajuste de escala de um elemento temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub 3 4 2 4 EnableDriverEvent P Esta propriedade utilizada para controlar a gera o do evento OnTagRead que ocorre no driver de comunica o que cont m o bloco Se a propriedade EnableDriverEvent do tag estiver configurada para True ser habilitada a gera o do evento OnTagRead por este tag Caso contr rio n o ocorre Os tr s tipos de elementos de comunica o Tag de Comunica o Bloco de Comunica o e Elemento de Bloco podem gerar este evento O evento ocorre no driver e n o no bloco 3 4 2 5 EnableScaling Fi A propriedade EnableScaling habilita ou desabilita a escala de valor para o valor enviado e recebido do equipamento ou do dispositivo Se esta propriedade estiver configurada para True todo valor proveniente do equipamento ou do dispositivo sofrer ajuste de escala conforme as propriedades DeviceHigh DeviceLow EUHigh e EULow antes de ser atribu do propriedade Value Caso contr rio nenhum ajuste de escala ser efetuado em nenhum dos dois sentidos escrita e leitura O valor padr o desta propriedade False Exemplo Sub Elemento OnStartRunningO Faz o ajuste de escala de um elemento temperatura que varia de O a 255 no PLC mas significam na pr tica de O a
222. b 3 3 3 3 AllowWrite P Define se este bloco dever ou n o ser escrito quando for modificada a propriedade Value de seus Elementos do Bloco de Comunica o Se esta propriedade estiver configurada para True as modifica es ser o enviadas para o equipamento ou dispositivo associado ao Driver de Comunica o Caso contr rio as modifica es ser o ignoradas Os elementos de comunica o n o aceitar o valores caso esta propriedade esteja configurada para False a n o ser que a propriedade AllowRead tamb m esteja configurada para False Exemplo Sub Botaol click Faz com que seja desabilitada a escrita do bloco Set ob Application Getobject Driverl blocol obj allowwrite False End Sub Drivers 75 3 3 3 4 B1 9 Especifica a qual conjunto de dados no equipamento ou no dispositivo este tag estar associado Consulte a documenta o do driver para sua correta parametriza o Esta propriedade pode ser modificada ap s iniciada a comunica o Exemplo sub Blocol Beforestart O Bi B2 B3 End sub 3 3 3 5 B2 1 9600 9 Especifica a qual conjunto de dados no equipamento ou no dispositivo este tag estar associado Consulte a documenta o do driver para sua correta parametriza o Esta propriedade pode ser modificada ap s iniciada a comunica o Exemplo Sub Blocol_BeforestartO Bi B2 B3 End sub 3 3 3 6 B3 1 9600 9 Especifica a qual conjunto de dados no equipamento ou no dispositivo
223. bjeto Driver de Comunica o Drivers 57 3 1 3 1 DriverLocation Define qual ser o driver utilizado pelo driver de comunica o para efetuar a comunica o com o equipamento ou dispositivo Esta propriedade aceita um string com o caminho completo do driver Ap s isso a propriedade DriverName mudar para a descri o do driver Esta propriedade n o pode ser modificada ap s iniciada a comunica o Ovalor padr o desta propriedade vazio Exemplo Sub Driverl Beforestart O Configura o DriverLocation como c NAN er Iv diiis DriverLocation c drivers amp Name amp dl1 End sub 3 1 3 2 DriverName A A propriedade DriverName cont m o string que descreve o driver associado ao objeto Driver de Comunica o Para isso deve se antes configurar a propriedade DriverLocation Esta propriedade somente para leitura O valor padr o desta propriedade vazio Exemplo Sub Driverl Beforestart MsgBox DriverName End Sub 3 1 3 3 EnableReadGrouping PI permite otimiza es de leitura agrupamento autom tico de tags Esta propriedade n o pode ser alterada em tempo de execu o Seu valor padr o False n o permite otimiza es de leitura 3 1 3 4 P1 9 Utilize a propriedade P1 para configurar o driver Consulte a documenta o do driver para sua correta parametriza o Esta propriedade n o pode ser modificada ap s iniciada a comunica o Exemplo sub Driverl Beforestart Driverl um
224. bleMinLimit F Habilita ou desabilita a defini o de um limite m nimo para o valor do E2Setpoint ActiveX 263 7 4 7 1 5 Format Cont m um texto que representa uma m scara dentro da qual os valores do objeto ser o mostrados Esta m scara pode representar v rios tipos de valores Geral N o possui formata o espec fica adaptando se automaticamente ao valor especificado e N mero Apresenta n meros com parte inteira e fracion ria O usu rio pode optar por at 15 casas decimais por usar ou n o um separador de milhares e por apresentar n meros negativos com sinal ou entre par nteses Para n meros muito grandes ou muito pequenos recomenda se utilizar o formato Cient fico e Data Apresenta valores num ricos de data e hora quando v lidos Para representar apenas a hora use o formato equivalente e Hora Apresenta valores num ricos de hora e data quando v lidos Para representar apenas a data use o formato equivalente e Porcentagem Multiplica o n mero por 100 e adiciona o s mbolo de porcentagem Admite at 15 casas decimais e Cient fico Apresenta o n mero em nota o de mantissa e expoente Ideal para n meros de magnitude variada Admite at 15 casas decimais e Especial Permite formatar n meros inteiros em bases n o decimais hexadecimal octal ou bin ria por exemplo e Outro Permite editar diretamente o c digo de formata o desejado ou selecionar um formato criado anterio
225. bled retorna a True Quando desabilitada o contador reinicia a contagem de onde ela foi interrompida anteriormente Servidor de Dados 121 5 2 2 7 Value 9 Mostra a contagem do contador em segundos Propriedade somente de leitura Essa propriedade recebe valores m ltiplos de Increment exceto quando a propriedade Enabled ajustada para False Nesse caso o valor ser o do momento em que o tag foi desabilitado Ao reiniciar a contagem o valor da propriedade ser o pr ximo m ltiplo de Increment O valor m ximo dessa propriedade 2147483647 0x7 FFFFFFF 5 3 Tag Demo Esta se o cont m informa es sobre m todos e propriedades do objeto Tag Demo Este objeto n o possui eventos associados 5 3 1 M todos Esta se o cont m informa es sobre os m todos do objeto Tag Demo 5 3 1 1 Reset Reset Zera a fase deslocamento em tempo da forma de onda do tag Afase da onda somente ser zerada quando o tag estiver habilitado Este m todo quando o tag estiver habilitado n o tem efeito nos tags do tipo CurrentTime e Random que n o s o peri dicos Quando o tag estiver desabilitado seu valor simplesmente zerado independentemente dotipo de tag 5 3 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Tag Demo 5 3 2 1 Enabled F A propriedade Enabled habilita ou desabilita a varia o do tag Demo Se Enabled estiver configurado para False a varia o estar desabilitada
226. booleano que indica o sucesso ou n o da opera o 3 3 2 2 WriteEx WriteEx Value Timestamp Quality WriteStatus WriteSyncMode Faza escrita de um valor no equipamento Todos os seus par metros s o opcionais se omitidos o comportamento do m todo igual ao do m todo Write Este m todo retorna um booleano que indica o sucesso ou n o da opera o O par metro Value define o valor a ser escrito no driver Otipo de dado depende do driver se omitido assumido o valor corrente do tag Timestamp especifica a data hora a ser escrita no tag se suportada pelo equipamento Se omitido assumida a data hora do momento da opera o de escrita Quality indica a qualidade de 0 a 255 Se omitido assumida a qualidade Boa 192 WriteStatus recebe um valor retornado pelo driver que indica o status da escrita se suportado pelo driver de acordo com sua documenta o pr pria O par metro WriteSyncMode permite utilizar o modo de escrita diferente do utilizado no driver As op es dispon veis para este par metro s o 0 usa o modo de escrita configurado no driver 1 faz uma escrita s ncrona 2 faz uma escrita ass ncrona sem confirma o Se o par metro for omitido ser tamb m utilizado o modo de escrita configurado no driver Exemplo sub Tagl OnRead S O m todo writeEx pode ser usado para transferir valores de vari veis de um driver para outro Application Getobject Driver2 Tag writeEx Valu
227. ca o OPC e Elemento de Bloco de Comunica o OPC 3 1 Driver de Comunica o Esta se o cont m informa es sobre eventos m todos e propriedades do objeto Driver de Comunica o 3 1 1 Eventos Esta se o cont m informa es sobre os eventos do objeto Driver de Comunica o 3 1 1 1 AfterStart AfterStart Ocorre depois que o driver de comunica o iniciou a comunica o comum fazer se um script para este evento utilizando o m todo Write para fazer configura es em equipamentos Exemplo Sub Driverl Afterstart Ap s iniciada a comunica o manda escrever valores para o eanipamento dispositivo weite 2055 25088 write 0 3 55 20 Metal End sub 3 1 1 2 AfterStop AfterStop Ocorre depois que o driver finalizou a comunica o Utilize o evento AfterStop para fazer alguma a o que seja necess ria ap s terminada a comunica o do driver 52 Drivers 3 1 1 3 BeforeStart BeforeStart Ocorre quando o driver est prestes a iniciar a comunica o Utilize o evento BeforeStart para fazer alguma a o que seja necess ria antes de iniciar a comunica o como por exemplo a configura o de par metros do driver Exemplo Sub Driverl Beforestart Faz a inicializa o dos par metros do driver antes e iniciar a comunica o P1 0 e D v w MONEN o 3 1 1 4 BeforeStop BeforeStop Ocorre quando o driver est prestes a finalizar a comunica o Utiliz
228. ca 1 atLastPeriod Mostra ltimo per odo Tempo Real 2 atPeriod Intervalo de tempo Hist rica Exemplo Sub CommandButton1 clickQO Set Chart Screen Item E3Chart1 Set newaxis Chart Axes Addaxis For 0To2z MsgBox clique OK para mudar o tipo de escala newaxis ScaleType i Next MsgBox Remover o eixo Chart Axes Remove newaxi s Name End sub 18 7 2 11 ShowGrid Fl Determina a visualiza o das linhas da grade Se a propriedade estiver configurada para True as linhas da grade s o mostradas Caso contr rio as linhas s o escondidas Exemplo Sub CommandButton Click Set Chart Screen Item E3Chart1 Chart axes Item NomeDoE ixo showGrid Not _ Chart axes Item NomeDoE i xo showGrid 450 E3Chart End sub 18 7 2 12 Title Determina o t tulo do eixo Exemplo Sub CommandButton1 clickQO Set Chart Screen Item E3Chart1 Chart Axes Item NomeDoEixo Title _ Chart axes Item NomeDoE i xo Name MsgBox clique para remover o t tulo Retira o t tulo Chart Axes Item NomeDoEixo Title End Sub 18 7 2 13 Visible nn PI Determina a visibilidade do eixo na grade Se a propriedade estiver configurada para True o eixo vis vel na grade Caso contr rio o eixo fica invis vel Exemplo Sub CommandButton1_ClickO Set Chart Screen Item E3Chart1 Chart Axes Item NomeDoEixo visible Not _ Chart Axes Item NomeDo
229. ca o tipo deste tag 0 Double 1 Bit 2 String Retorna um booleano indicando o sucesso ou n o da opera o 16 2 3 AddTable AddTable Name Adiciona uma tabela do banco de dados na consulta O par metro Table determina o nome da tabela a ser adicionada 16 2 4 Execute Execute ImmediateExecute O m todo Execute executa um comando SQL que n o tenha retorno como DELETE UPDATE ou INSERT configurado no SQLQuery O par metro ImmediateExecute indica se a opera o passar pelas filas de opera es do DB arquivos e3ie e30 antes de chegar ao banco caso esteja configurada como False ouse ser enviada diretamente para o Banco de Dados caso esteja configurada como True A vantagem de se utilizar a consulta para executar comandos a utiliza o de vari veis como em uma consulta simples Exemplo de comandos SQL DELETE FROM teste WHERE cod gt 10 UPDATE teste SET cod 10 WHERE cod gt 10 INSERT INTO teste cod VALUES 10 Exemplo Sub CommandButtonl click 2 Screen Item consultal Execute End sub 16 2 5 GetADORecordSet GetADORecordSet O m todo GetADORecordSet retorna um Recordset do tipo ADO ActiveX Data Object resultante da execu o da consulta configurada Exemplo 388 Consultas Sub Botaol click Set rec Sc strDatas i 0 reen Item consultal GetaDORecordset Mostra uma mensagem com os 10 primeiros registros da coluna E3TimeStamp while NOT rec EOF A
230. chimento ser em degrad utilizando tanto ForegroundColor quanto BackgroundColor O efeito ser definido pela propriedade GradientStyle 11 bkBackground Preenche a Tela com a cor de fundo 12 bkPicture Preenche a Tela com a figura selecionada na propriedade PictureFile 6 1 3 4 ForegroundColor E Especifica a cor do preenchimento da frente da Tela Nos scripts utilize a fun o do VBScript RGB para montar a cora ser associada a esta propriedade Ovalor padr o para esta propriedade preto RGB 0 0 0 Aplica es anteriores introdu o desta propriedade ter o ambas as propriedades ForegroundColor e BackgroundColor configuradas com a cor antes armazenada na propriedade BackgroundColor e o estilo de preenchimento configurado como 11 bkBackground que pinta toda a Tela com a cor de fundo comportamento antigo anterior cria o dos estilos Exemplo 136 Telas e Objetos de Tela sub Telal click Troca a cor de fundo da Tela Foregroundcolor RGB O O 255 End su 6 1 3 5 Frame pata azul 58 Retorna o quadro pai do objeto Esta propriedade acess vel apenas em tempo de execu o 6 1 3 6 GradientStyle aP Esta propriedade especifica o estilo de preenchimento degrad da Tela Esta propriedade s ser utilizada quando o valor da propriedade FillStyle estiver configurada para 8 Gradient Os degrad s consideram a mudan a da cor partindo de Foregr
231. cial O End su 10 1 2 Eventos de Usu rio Esta se o cont m informa es sobre eventos de usu rio do objeto Viewer 296 Viewer 10 1 2 1 OnLogin OnLogin Ocorre quando um usu rio executa um login de sistema autentica o de usu rio com sucesso O login de sistema pode ser feito atrav s da execu o do m todo Login ou quando um objeto que s pode ser acessado por usu rios com um determinado n vel de autoriza o exige autentica o Exemplo sub Viewer OnLogin0 MsgBox Usu rio autorizado Seja bem vindo ao sistema End Sub 10 1 2 2 OnLogout OnLogout Ocorre quando executado um logout ou seja a sa da do usu rio do sistema O logout feito atrav s da chamada do m todo Logout Exemplo sub Viewer OnLogout MsgBox O usu rio saiu do sistema End Sub 10 2 M todos Esta se o cont m informa es sobre os m todos do objeto Viewer 10 2 1 CaptureScreen CaptureScreen Filename O m todo CaptureScreen captura a Tela atual e a salva em um arquivo Este m todo semelhante ao efeito realizado pela tecla PRINTSCREEN no Windows O par metro Filename determina o nome do arquivo no qual a Tela ser salva NOTA O formato final do arquivo Bitmap bmp mesmo que no par metro Filename seja informada outra extens o gif jpg etc Exemplo Sub CommandButton1 clickQO Screen Frame Capturescreen c temp tela bmp End sub Viewer 297 10 2 2 ChangePasswor
232. com modo Hanzi de meia largura 7 3 9 3 17 IntegralHeight F A propriedade IntegralHeight ajusta a altura da rea de edi o do texto caso a rea dispon vel para o mesmo ultrapasse o tamanho do objeto Se esta propriedade estiver configurada para True a altura da rea de edi o do texto reajustada para coincidir com o tamanho atual do objeto permitindo assim a exibi o completa do conte do do texto Caso contr rio a rea de edi o do texto continua com seu tamanho original Se os textos s o maiores que o espa o dispon vel estes n o s o exibidos no objeto 7 3 9 3 18 LineCount 9 A propriedade LineCount retorna o n mero de linhas do objeto Esta propriedade acess vel apenas em tempo de execu o 7 3 9 3 19 Locked Fi A propriedade Locked habilita ou desabilita a edi o do objeto Se esta propriedade estiver configurada para True a edi o n o permitida Caso contr rio poss vel editar o objeto Os valores configurados na propriedade Enabled influenciam o comportamento de Locked Para maiores detalhes consulte a propriedade Enabled O valor padr o desta propriedade False 7 3 9 3 20 MaxLensth 9 Apropriedade MaxLength determina o n mero m ximo de caracteres no objeto Configurando esta propriedade como 0 n o h limite de caracteres no objeto ActiveX 237 7 3 9 3 21 Multiline Fi A propriedade Multiline indica se o texto ter m ltiplas linhas True
233. cript acima seria sub Retangulol Click set obj Application Getobject Driverl obj Item tag001 ATlowread False obj Item tag002 aTlowread False End Sub Neste caso a vari vel obj est apontando para o objeto Driver 1e na pr xima vez que se quiser acessar algum objeto que descende de Driver dentro do script pode se utilizar a vari vel obj diretamente Isso traz um ganho de performance j que cada chamada do m todo GetObject faz um acesso ao servidor Atrav s dessa t cnica chamadas desnecess rias ao servidor s o evitadas Este exemplo usa o comando Set que ser explicado mais adiante Note que a utiliza o de vari veis tamb m torna o c digo mais claro e de modifica o mais f cil Caso seja necess rio alterar o objeto no qual queremos executar comandos basta mudar a linha de atribui o dessa vari vel A palavra Application nos scripts pode indicar tanto fun es que s o executadas no E3 Viewer quanto no servidor No caso o objeto Application sabe de antem o quais fun es devem ser executadas tanto para um quanto para outro caso N o poss vel entretanto executar fun es de E3 Viewer dentro do servidor assim como tamb m n o poss vel executar fun es de servidor dentro do E3 Viewer 26 Programando no E3 2 3 2 Acessando Propriedades do Studio Para acessar um objeto de servidor qualquer num script que roda no Studio pode se usar a diretiva Application GetObject A palavra Appl
234. d ChangePassword O m todo abre uma caixa de di logo para permitir a troca de senha do usu rio atual O m todo retorna True se o usu rio atual tiver permiss o para trocar a senha Caso contr rio retorna False indicando que houve falha na opera o ou que n o poss vel trocar a senha porque o usu rio n o tem autoriza o Exemplo sub Textol clickQ If application ChangePassword Then MsgBox A senha pode ser trocada Else E MsgBox N o foi poss vel trocar a senha End If End sub 10 2 3 DoModal DoModal Screen Title Left Top Width Height Arg Flags Abre uma Tela modal Uma Tela modal uma janela que n o permite clicar em outras Telas ou janelas enquanto ela n o for fechada O par metro de t tulo passado neste m todo s ser utilizado se a propriedade Caption estiver vazia do contr rio o par metro deste m todo ser ignorado Este m todo possui os seguintes par metros e Screen determina o nome da Tela e Title determina o t tulo da janela modal e Left Top posi o XY da janela modal em pixels e Width largura da janela modal em pixels ou HIMETRIC e Height altura da janela modal em pixels ou HIMETRIC e Arg determina a vari vel a ser usada no evento OnPreShow da Tela e Flags determina a combina o utilizada na janela modal Tal combina o feita somando se os valores da tabela correspondentes as op es que o usu rio deseja Quando o valor especificado for 1
235. da legenda Alegenda centralizada relativamente imagem 2 fmPicturePositionLeftBottom Afigura aparece esquerda da legenda Alegenda alinhada coma parte inferior da figura 3 fmPicturePositionRightTop Afigura aparece direita da legenda A legenda alinhada coma parte superior da figura 4 fmPicturePositionRightCenter Afigura aparece direita da legenda A legenda centralizada relativamente figura 5 fmPicturePositionRightBottom Afigura aparece direita da legenda A legenda alinhada com a parte inferior da figura 6 fmPicturePositionAboveLeft Afigura aparece acima da legenda A legenda alinhada com a extremidade esquerda da figura 7 fmPicturePositionAboveCenter Afigura aparece acima da legenda A legenda centralizada abaixo da figura padr o 8 fmPicturePositionAboveRight Afigura aparece acima da legenda A legenda alinhada com a extremidade direita da figura 214 ActiveX OP O DESCRI O 9 fmPicturePositionBelowLeft Afigura aparece abaixo da legenda A legenda alinhada com a extremidade esquerda da figura 10 fmPicturePositionBelowCenter Afigura aparece abaixo da legenda A legenda centralizada acima da figura 11 fmPicturePositionBelowRight Afigura aparece abaixo da legenda A legenda alinhada com a extremidade direita da figura
236. da na propriedade OverrideLineColor Se a propriedade EnableOverrideLineColor estiver habilitada faz com que seja modificada a cor original da linha do objeto pela cor de OverrideLineColor Caso contr rio o objeto Figura exibir a cor original O valor padr o desta propriedade False 6 2 9 1 4 EnableSlider P A propriedade EnableSlider habilita o slider no movimento do objeto Se a propriedade estiver habilitada o slider do movimento habilitado Caso contr rio isto n o ocorre 6 2 9 1 5 OverrideFillColor E Quando a propriedade OverrideFillMode estiver especificada para os valores 2 ou 3 a propriedade OverrideFillColor ser usada para definira cora ser usada no preenchimento dos objetos no movimento ao inv s da cor original Nos scripts utilize a fun o do VBScript RGB para montar a cora ser associada a esta propriedade O valor padr o desta propriedade vermelho RGB 255 0 0 Exemplo sub DrawGroupl Click Ao clicar no objeto seta o modo override para s lido e troca a cor de preenchimento da imagem para azul overrideFillmode 2 overriderilicolor RGB O 0 255 End sub 6 2 9 1 6 OverrideFilMode aP A propriedade OverrideFillMode especifica o modo do preenchimento dos objetos que est o em movimento Ela altera o modo original de preenchimento da imagem sem alterar a configura o original de preenchimento dos objetos Op es dispon veis para OverrideFillMode OP O D
237. da p gina do relat rio Caso a largura ou a altura da p gina sejam diminu das o texto acompanha esta varia o Se a propriedade estiver configurada para True o texto acompanha as varia es de altura e largura do objeto Caso contr rio este permanece com as configura es iniciais O valor padr o desta propriedade True 22 5 1 5 height 9 Determina a altura da se o da p gina do relat rio O valor padr o desta propriedade 360 22 5 1 6 IsRepeating FI Determina a repeti o da se o na ltima p gina do relat rio Se a propriedade estiver configurada para True a se o ser repetida na ltima p gina Caso contr rio n o haver esta repeti o Relat rios 485 22 5 1 7 Name Indica o nome da se o do relat rio 22 5 1 8 Type P Retorna o tipo da se o As op es dispon veis s o Op es dispon veis para Type OP O DESCRI O 0 ReportHeader Se o tipo ReportHeader cabe alho de relat rio 1 ReportFooter Se o tipo ReportFooter rodap de relat rio 2 PageHeader Se o tipo PageHeader cabe alho de p gina 3 PageFooter Se o tipo PageFooter rodap de p gina 4 GroupHeader Se o tipo GroupHeader cabe alho de grupo 5 GroupFooter Se o tipo GroupFooter rodap de grupo 6 Detail Se o tipo Detail rea para conte do do relat rio 22 5 1 9
238. dade DeviceLow define o valor m nimo atingido por um tag no equipamento ou no dispositivo Esta propriedade ser utilizada para fazer o ajuste de escala do valor proveniente do equipamentoou do dispositivo antes de ser atribu do propriedade Value Da mesma forma no momento da escrita feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a propriedade EnableScaling est configurada para True sen o as configura es permanecem as mesmas O valor padr o desta propriedade 0 Exemplo Sub Tag_OnStartRunningO Faz o ajuste de escala de um tag de temperatura que varia de O a 255 no PLC mas significam na pr tica de 0 a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow 0 EUHigh 100 EULow O End Sub Drivers 95 3 6 1 8 EnableDriverEvent Pl Esta propriedade utilizada para controlar a gera o do evento OnTagRead que ocorre no Driver de Comunica o OPC que cont m o tag Se a propriedade EnableDriverEvent do tag estiver configurada para True a cada leitura vinda do servidor OPC seja com erro ou n o ser gerado o evento OnTagRead no objeto Driver OPC que contem este tag Caso contr rio o evento n o ocorre Tamb m quando a propriedade EnableDriverEvent tiver o valor True a cada escrita que seja enviada para o servidor OPC ser gerado o evento OnTagWrite no objeto OPCDriver que contem a tag Se a escrita for ass ncrona
239. dade Orientation utilizada para determinar a orienta o do objeto na Tela As op es dispon veis para esta propriedade s o as seguintes e 1 fmOrientationAuto determina automaticamente a orienta o com base nas dimens es do objeto isto conforme ele foi criado e 0 fmoOrientationVertical o objeto disposto verticalmente e 1 fmoOrientationHorizontal o objeto disposto horizontalmente Ovalor padr o desta propriedade 1 fmOrientationAuto 7 3 10 2 5 SmallChange 9 A propriedade SmallChange especifica a quantidade de movimento que ocorre quando o usu rio clica em uma seta de rolagem no objeto O valor padr o desta propriedade 1 242 ActiveX 7 3 10 2 6 Value N mero inteiro entre os valores definidos pelas propriedades Min e Max Indica a posi o inicial do incremento ou decremento N o aceita valores menores que o valor de Min nem maiores que o valor de Max 7 3 11 Barra de Rolagem Esta se o cont m informa es sobre eventos e propriedades do objeto Barra de Rolagem Este objeto n o possui m todos associados 7 3 11 1 Eventos Esta se o cont m informa es sobre eventos do objeto Barra de Rolagem 7 3 11 1 1 Scroll Scroll Gerado quando o ponteiro da barra de rolagem movido para alguma dire o 7 3 11 2 Propriedades Esta se o cont m informa es sobre propriedades do objeto Barra de Rolagem 7 3 11 2 1 Delay 9 Especifica um tempo de espera para o objeto A
240. dade daquele dado Esta propriedade somente para leitura O valor padr o desta propriedade O Qualidade Ruim NOTA Para maiores informa es sobre qualidade consulte o t pico Propriedade Quality ou o t pico Qualidade no Manual do Usu rio 3 2 3 21 RawValue Acessa o valor original do tag anterior escala ou seja independentemente da configura o da propriedade EnableScaling Ent o se esta propriedade for False as propriedades Value e RawValue apresentam o mesmo comportamento 3 2 3 22 Scan 9 Utilize a propriedade Scan para especificar o tempo de varredura que ser utilizado pelo servidor para atualizar a propriedade Value Esta propriedade representada em milissegundos e pode ser modificada a p s iniciada a comunica o sendo utilizada apenas quando a propriedade AllowRead estiver configurada para True Ao configurar esta propriedade nos diversos tags presentes na aplica o recomenda se aumentar o valor da propriedade Scan para aqueles tags que n o variam muito no equipamento ou no dispositivo possibilitando assim que outros tags de maior prioridade sejam lidos com maior frequ ncia aumentando assim a performance geral do sistema O valor padr o desta propriedade 1000 1 segundo O valor do scan deve ser maior que 0 Exemplo Sub Tag OnStartRunningO scan 1500 End sub 3 2 3 23 TimeStamp E A propriedade TimeStamp atualizada sempre que ocorrer alguma mudan a de valor ou estado nas propriedades
241. de assumir valores definidos pelo usu rio O limite deste campo quando armazenado no Banco de Dados de 100 caracteres EventCLSID Identificador nico para toda a vida de um alarme Quando um alarme novo ocorre em uma Fonte gerado um novo n mero de EventCLSID assim ele ir manter esse mesmo CLSID no banco de dados enquanto n o sair da lista de alarmes ativos e n o reconhecidos EventTime Data hora do valor da fonte do alarme no momento do evento EventTimeUTC Data hora do valor da fonte do alarme no momento do evento com rela o ao hor rio de Greenwich O valor o mesmo do campo EventTime sendo mantido no E3 por quest es de compatibilidade EventType Tipo do evento Para eventos de alarme sempre Condition Para outros eventos pode ser um texto definido pelo usu rio como por exemplo usando o m todo LogTrackingEvent do Servidor de Alarmes Tracking Simple etc O limite deste campo quando armazenado no Banco de Dados de 100 E3Alarm 363 NOME DESCRI O caracteres FormattedValue Mostra o valor formatado da fonte de alarme que vai para oseu evento O limite deste campo quando armazenado no Banco de Dados de 100 caracteres NOTA Este campo somente de leitura FullAlarmSource Na me Registra o caminho completo da fonte de alarme incluindo reas nome da configura o de alarmes e de poss veis p
242. de Conjuntos e o nome do Primeiro Conjunto 304 Viewer Set obj Application GetFormulavalueDataobj Formulal MsgBox CStr Obj Count MsgBox Cstr obJ Name 1 End Sub 10 2 12 IsAppRunning IsAppRunning Processid Indica se uma aplica o iniciada pelo m todo ExecuteExternalApp est sendo executada Retorna True se o aplicativo identificado no sistema operacional por Processid estiver rodando Caso contr rio retorna False Exemplo Sub CommandButtonl clickQO Applicati on ExecuteExternalApp ds waw elipse com br 1 processID while application ISAppRunning processID Espera pelo final da aplica o wend MsgBox Terminou a aplica o End Sub NOTA O par metro Processid o mesmo valor que aparece no Gerenciador de Tarefas do Windows na coluna PID 10 2 13 IsUserMemberOfGroup IsUserMemberOfGroup GroupName Este m todo verifica se o usu rio logado no Viewer corrente pertence a um determinado grupo Este m todo possui o par metro Group Name que determina o nome do grupo de usu rios que se quer verificar O m todo retorna True se o usu rio pertencer ao grupo GroupName ou False caso contr rio Exemplo Sub CommandButton1 clickQO TE Application IsUserMemberofGroup suporte Then MSgBOX o usu rio amp aplication User amp _ membro do grupo Suporte Else MsgBox O usu rio amp aplication User amp _ n o membro do grupo Suporte End If End sub 10 2 14 IsWebViewer
243. des espec ficas exceto pelas propriedades Property Source e Type comuns a todos os tipos de conex o 9 2 1 Count 9 Informa a quantidade de links do objeto Retorna o valor O zero se o objeto n o possuir links Exemplo Sub CommandButtonl clickQO MsgBox Screen Item scroliBar1 Links Count End Sub 9 2 2 Property A Especifica o nome da propriedade que est conectada Ao ser modificada permite deslocar a conex o para outra propriedade do mesmo objeto Exemplo Sub CommandButtonl Click Dim bind Set bind Screen ItemC TableBind Links Item 1 Pind Property Caption En 9 2 3 Source A Especifica a fonte da conex o que pode ser o nome de outro objeto da aplica o ou uma express o mais complexa acessando v rios objetos Exemplo Sub CommandButton25 Click Dim bind Set bind screen Item TableBind Links Item 1 bind source Dados TagDemol Value End sub Associa es 283 9 2 4 Type a Esta propriedade apenas para leitura e informa o tipo de conex o Os valores dispon veis s o os seguintes Op es dispon veis para Type OP O DESCRI O 0 bsSimples Conex o simples 1 bsSimpleBiDir Conex o bidirecional 2 bsAnalog Conex o anal gica 3 bsAnimation Conex o digital 4 bsTable Conex o por tabela 5 bsReverse Conex o reversa 6 bsMultiSource Conex o m ltipla Exemplo Sub CommandButtonl clickQO Dim
244. dica o n mero de alarmes ativos com severidade m dia Esta propriedade somente de leitura 12 2 1 7 ActiveMedNACKAlarms 9 Indica o n mero de alarmes n o reconhecidos com severidade m dia Esta propriedade somente de leitura 12 2 1 8 ActiveNACKAlarms 9 Indica o n mero de alarmes que est o sem reconhecimento dentro da rea Esta propriedade somente de leitura 12 2 1 9 Alarm P Estabelece a exist ncia de alarmes ativos dentro da rea Se a op o estiver True o sistema tem pelo menos um alarme ativo dentro da rea e a propriedade ActiveAlarms far a leitura no sistema indicando a quantidade de alarme ativos Caso contr rio a propriedade Active NACKAlarms far a leitura dos alarmes sem reconhecimento Esta propriedade somente de leitura 334 Alarmes 12 2 1 10 AlarmVerify P Habilita a verifica o de todos os alarmes dentro da rea Depois de habilitada esta verifica o True se a propriedade ActiveAlarms possuir valor maior que 0 o sistema verifica tanto os alarmes ativos quanto os sem reconhecimento listando estes ltimos pela propriedade ActiveNACKAlarms Esta propriedade til para evitar se o efeito de avalanche de alguns sistemas onde o acontecimento de um evento gera uma grande quantidade de alarmes correlacionados 12 3 Fontes de Alarme Esta se o cont m informa es sobre m todos e propriedades comuns ao objeto Fonte de Alarme Este objeto n o possui eventos comuns associad
245. do objeto O valor padr o desta propriedade preto RGB 0 0 0 7 4 5 1 7 TextFont A A propriedade TextFont utilizada para determinar a fonte do objeto Esta propriedade n o pode ser utilizada em scripts ou em associa es sendo configurada unicamente via Studio 256 ActiveX 7 4 5 1 8 Value Esta propriedade cont m um Variant que pode assumir valores de todo e qualquer tipo de dados e a forma de apresenta o desses valores ser definida pela propriedade Format 7 4 5 1 9 VerticalAlignment a Define o alinhamento vertical do texto do E2Display Os valores desta propriedade s o os seguintes e 0 VerticalAlignmentTop alinha verticalmente com a parte superior do objeto e 1 VerticalAlignmentMiddle alinha verticalmente com o centro do objeto e 2 VerticalAlignmentBottom alinha verticalmente com a parte inferior do objeto Ovalor padr o desta propriedade 1 VerticalAlignmentMiddle 7 4 6 E2ZGauge Esta se o cont m informa es sobre propriedades do objeto E2Gauge Este objeto n o possui eventos nem m todos associados 7 4 6 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto E2Gauge 7 4 6 1 1 BackgroundColor E Esta propriedade define a cor de fundo do objeto O valor padr o desta propriedade cinza RGB 128 128 128 7 4 6 1 2 BulletsVisible FP Exibe ou esconde as marcas da escala em forma de bullet ActiveX 257 7 4 6 1 3 DecimalPlaces 9 Es
246. do objeto Bloco de Comunica o 3 3 1 1 OnRead OnRead Ocorre quando uma leitura do bloco de comunica o efetuada pelo driver Utilize o evento OnRead quando for necess rio efetuar alguma opera o logo ap s algum dado ter sido modificado no objeto bloco de comunica o como por exemplo as propriedades Quality TimeStamp ou ainda a propriedade Value de algum elemento do bloco Exemplo Sub IoBlocol onRead Ao ler o bloco atribui ao tag InternalTagl o valor do elemento de bloco elmi Set obj Application Getobject DataServerl InternalTag1 Set elm application Getobject Driverl IOBlocol elml obj value elm value End sub 3 3 2 M todos Esta se o cont m informa es sobre os m todos do objeto Bloco de Comunica o 3 3 2 1 Write Write WriteSyncMode Faza escrita do valor corrente do bloco de comunica o no equipamento Normalmente este comando de script s usado quando a propriedade AllowWrite deste objeto for False O par metro WriteSyncMode permite utilizar o modo de escrita diferente do utilizado no driver As op es dispon veis para este par metro s o 0 usa o modo de escrita configurado no driver 1 faz uma escrita s ncrona 2 faz uma escrita ass ncrona sem Drivers 73 confirma o Se o par metro for omitido ser tamb m utilizado o modo de escrita configurado no driver Para maiores detalhes consulte a documenta o do driver Este m todo retorna um
247. do texto no centro do objeto 2 BottomAlignment Alinhamento vertical do texto na base do objeto Telas e Objetos de Tela 163 6 2 7 2 15 WordWrap F Habilita ou desabilita uma quebra de linha no texto caso a rea dispon vel para o texto ultrapasse os limites determinados no objeto Para que esta propriedade funcione a propriedade Multiline deve ser obrigatoriamente igual a True 6 2 8 Escala Esta se o cont m informa es sobre propriedades do objeto Escala Este objeto n o possui eventos nem m todos associados 6 2 8 1 Propriedades Esta se o cont m informa es sobre propriedades do objeto Escala 6 2 8 1 1 Angle 9 Apropriedade Angle define o ngulo de rota o em graus no sentido anti hor rio que o objeto deve ser rotacionado Isto tamb m se aplica aos filhos que este objeto tiver respeitando as limita es de rota o de cada objeto filho O objeto rotacionar de acordo com o seu centro que pode ser editado durante a opera o de rota o O valor padr o desta propriedade O sem rota o 6 2 8 1 2 BackgroundColor E Esta propriedade especifica a cor de preenchimento do fundo do objeto Esta cor utilizada quando a propriedade BackgroundStyle est configurada para 1 opaco e umas das propriedades VerticalPercentFill ou HorizontalPercentFill est com valores diferentes de 100 Outro uso desta cor quando a propriedade FillStyle est configurada entre os v
248. dos associados 7 3 10 1 Eventos Esta se o cont m informa es sobre os eventos do objeto Bot o Incremento Decremento 7 3 10 1 1 SpinUp SpinUp Ocorre quando o usu rio pressiona a seta para cima Este evento incrementa a propriedade Value do objeto 7 3 10 1 2 SpinDown SpinDown Ocorre quando o usu rio pressiona a seta para baixo Este evento decrementa a propriedade Value do objeto 7 3 10 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Bot o Incremento Decremento ActiveX 241 7 3 10 2 1 Delay 9 Especifica um tempo de espera para o objeto A propriedade Delay afeta a dura o de tempo entre os eventos SpinUp SpinDown e Change consecutivos gerados quando o usu rio clica e mant m pressionado o bot o Incremento Decremento O primeiro evento ocorre imediatamente Otempo de espera at a segunda ocorr ncia do evento de cinco vezes o valor especificado na propriedade Delay Ap s o tempo inicial o intervalo entre os eventos o valor especificado para Delay Ovalor padr o de Delay 50ms Isto significa que o objeto inicia o primeiro evento depois de 250ms cinco vezes o valor especificado e inicia cada evento subsequente depois de 5Oms 7 3 10 2 2 Max 9 Apropriedade Max utilizada para determinar o limite m ximo do objeto 7 3 10 2 3 Min 9 Apropriedade Min utilizada para determinar o limite m nimo do objeto 7 3 10 2 4 Orientation aP A proprie
249. dr o e 3 dtMinute minutos 15 2 8 EnableBackupTable PI Cria uma tabela de backup onde os dados descartados permanecer o por seguran a Se configurada para True a tabela ser criada do contr rio n o haver tabela de backup O valor padr o desta propriedade False 15 2 9 EnableDiscard Pl Habilita o descarte dos dados ap s um certo tempo Se configurada para False os dados ser o armazenados indefinidamente na tabela do contr rio ser o descartados ap s determinado tempo O valor padr o dessa propriedade False Storage 383 15 2 10 Fields 5 Cole o que aponta para os campos criados no Storage Para cada campo poss vel visualizar as propriedades Name e Link e modificar as propriedades Type MinRecTime MaxRecTime DeadBand e DeadBandUnit 15 2 11 StringFieldSize 9 Esta propriedade especifica o tamanho m ximo que os campos do tipo String do objeto Storage poder o ter ser o tamanho utilizado na cria o do campo Value da tabela de strings 15 2 12 TableName Define o nome da tabela que ser utilizada no Storage 15 2 13 VerificationInternal 9 Esta propriedade trabalha em conjunto com a propriedade VerificationUnit para controlar o intervalo de tempo que o E3 verifica a antiguidade dos dados para depois descart los Ovalor padr o desta propriedade 1 uma unidade de tempo indicada em VerificationUnit 15 2 14 VerificationUnit aP Esta propriedade trabalha em conjunto com a
250. dsMStretch Amarca d gua ir preencher toda a p gina do relat rio 2 ddSMZoom Amarca d gua ser aumentada at ficar do tamanho da p gina do relat rio 22 5 Se o Esta se o cont m informa es sobre propriedades comuns do objeto Se o do Relat rio Este objeto n o possui eventos nem m todos associados 22 5 1 Propriedades Comuns Esta se o cont m informa es sobre as propriedades comuns do objeto Se o do Relat rio 22 5 1 1 BackColor E Especifica a cor de fundo da se o do relat rio O efeito desta propriedade s ser vis vel se a propriedade BackStyle estiver habilitada para a op o 1 ddBKNormal O valor padr o branco RGB 255 255 255 484 Relat rios 22 5 1 2 BackStyle P Especifica o estilo de fundo da se o do relat rio As op es dispon veis para esta propriedade s o as seguintes e 0 ddBKTransparent fundo transparente e 1 ddBKNormal fundo normal 22 5 1 3 CanGrow PI Determina a aplica o de stretch ao texto da p gina do relat rio Caso a largura ou a altura da p gina sejam aumentadas o texto acompanha esta varia o Se a propriedade estiver configurada para True o texto acompanha as varia es de altura e de largura do objeto Caso contr rio este permanece com as configura es iniciais Ovalor padr o desta propriedade True 22 5 1 4 CanShrink Fi Determina a aplica o do efeito de encolhimento ao texto
251. e Quadros e Divisores 277 8 2 2 SplitBorder FI Habilita ou desabilita a borda do divisor e determina se a borda entre o divisor mandante e o divisor restante deve ser exibida em tempo de execu o Esta propriedade n o tem efeito no divisor restante O valor padr o desta propriedade True 8 2 3 SplitDockPosition P Indica a posi o do divisor desejado na Tela As op es dispon veis s o Op es dispon veis para SplitDockPosition OP O DESCRI O 0 dockRemaining Posiciona o divisor como restante ou seja ele ocupar o espa o que sobra na divis o horizontal ou vertical 1 dockTop Posiciona o divisor como mandante acima do restante 2 dockBottom Posiciona o divisor como mandante abaixo do restante 3 dockLeft Posiciona o divisor como mandante esquerda do restante 4 dockRight Posiciona o divisor como mandante direita do restante 8 2 4 SplitLink A A propriedade SplitLink cont m um ink que deve ser mostrado no divisor poss vel especificar uma Tela do projeto um execut vel ou um link na Internet No caso de Telas poss vel especificar um percentual de zoom e a habilita o das barras de rolagem usando a chave como no modelo lt nome da tela gt lt zoom gt lt barra de rolagem gt onde lt nome da tel a gt o nome da Tela a ser aberta lt Zoom gt o percentual de zoom e lt barra de ro lagem gt 1 para hab
252. e Define o objeto Banco de Dados que ser utilizado para grava o dos dados dos alarmes O valor padr o desta propriedade vazio ou seja n o h nenhum Banco de Dados para armazenar os dados 12 4 2 12 Discardinterval 9 Esta propriedade trabalha em conjunto com a propriedade DiscardTimeUnit A propriedade Discardinterval indica o intervalo de tempo durante o qual os dados do Hist rico ficar o armazenados na tabela do banco de dados at serem descartados Ovalor padr o desta propriedade 1 uma unidade de tempo indicada em DiscardTimeUnit Se esta propriedade for configurada com um valor menor ou igual ao valor da propriedade BackupDiscardInterval o E3 automaticamente ajusta o valor de BackupDiscardinterval como o dobro do valor de DiscardiInterval Esta propriedade pode ser modificada em tempo de execu o 356 Alarmes 12 4 2 13 DiscardTimeUnit a Esta propriedade trabalha em conjunto com a propriedade DiscardInterval A propriedade DiscardTimeUnit indica a unidade de tempo em que os dados da tabela ficar o armazenados at serem descartados As op es dispon veis s o e O dtHour horas e 1 dtDay dias e 2 dtMonth meses padr o e 3 dtMinute minutos 12 4 2 14 EnableBackupTable FI Cria uma tabela de backup onde os dados descartados permanecer o por seguran a Se configurada para True a tabela ser criada do contr rio n o haver tabela de backup O valor padr o desta propriedade True
253. e TimeStamp Quality End sub 3 3 3 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Bloco de Comunica o 74 Drivers 3 3 3 1 AdviseType P Controla o modo Advise As op es dispon veis s o Op es dispon veis para AdviseType OP O DESCRI O 0 AlwayslnAdvise Otag mantido atualizado se a propriedade AllowRead for True 1 AdviseWhenLinked O tag s atualizado se AllowRead for True e o tag estiver associado a algum objeto ativo por exemplo um Display de uma Tela aberta um Alarme habilitado entre outros A associa o do tag para esse prop sito pode ser feita nas seguintes propriedades Value RawValue Quality e de Bit00 a Bit31 de Elementos de Bloco e Quality e TimeStamp de Blocos de Comunica o 3 3 3 2 AllowRead P Define se este bloco dever ou n o ser lido pelo driver de comunica o Caso a propriedade AllowRead esteja habilitada ent o o driver automaticamente atualizar os elementos de comunica o inseridos neste bloco em intervalos de tempo definidos pela propriedade Scan Caso contr rio este bloco de comunica o n o ser lido ou atualizado Esta propriedade pode ser modificada em tempo de execu o O valor padr o desta propriedade True Exemplo Sub Botaol click Faz com que seja parada a leitura do bloco Set Pbi Application Getobject Driver1 bloco1 obj AllowRead False End Su
254. e qualquer tipo desde um inteiro at refer ncias para objetos veja o exemplo a seguir Utilize o para guardar valores dentro do Viewer ou Servidor e para trocar dados entre os diversos pontos da aplica o O valor padr o desta propriedade vazio Esta propriedade de leitura e escrita Exemplo 126 Servidor de Dados Sub Meses OnStartRunning O Meses um tag do tipo InternalTag Utiliza se o evento para inicializar o vetor value Array Janeiro Fevereiro Mar o _ Abrie Maio Junho Julho agosto E Setembro Outubro Novembro Dezembro End sub 5 5 Tag Timer Esta se o cont m informa es sobre eventos e propriedades do objeto Tag Timer Este objeto n o possui eventos associados 5 5 1 Eventos Esta se o cont m informa es sobre os eventos do objeto Tag Timer 5 5 1 1 OnPreset OnPreset Ocorre toda vez que o valor da propriedade NextExecTime alcan ado 5 5 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Tag Timer 5 5 2 1 Enabled P Habilita ou desabilita o Timer O valor padr o desta propriedade True 5 5 2 2 NextExecTime nes z E Exibe o pr ximo hor rio de disparo uma propriedade somente de leitura 5 5 2 3 Repeatinterval Ea utilizada sempre que o tag for do tipo cont nuo O valor padr o desta propriedade 00 00 01 Servidor de Dados 127 5 5 2 4 StartTime Data hora inicia
255. e H uma quebra de p gina depois do relat rio 1 ddGrpFirstDetail Orelat rio imprimir a se o Detail na mesma p gina ou coluna Relat rios 493 22 5 4 1 3 NewColumm a Insere uma nova quebra de coluna antes ou depois da impress o da se o no relat rio As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para NewColumn OP O DESCRI O 0 ddNPNone N o h quebra de p gina na se o 1 ddNBefore Inicia a impress o da se o em uma nova p gina 2 ddNPA ter Inicia uma nova p gina depois de imprimir a se o 3 ddNPBeforeAfter Inicia a impress o em uma nova p gina e uma nova p gina depois de imprimir a se o 22 5 4 1 4 NewPage a Insere uma quebra de p gina no relat rio As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para NewPage OP O DESCRI O 0 ddNPNone N o h quebra de p gina na se o padr o 1 ddNBefore Inicia a impress o em uma nova p gina 2 ddNPA ter Inicia uma nova p gina depois da impress o da se o 3 ddNPBeforeAfter Inicia a impress o em uma nova p gina e inicia uma nova p gina depois de imprimir a se o 494 Relat rios 22 5 4 1 5 PrintAtBottom F Determina se o GroupFooter ou o ReportFooter ser o impressos no p da p gina Se a propriedade estiver configur
256. e O Esta passagem de per odo especificando o estado buscada no servidor Caso o estado n o seja informado corretamente a propriedade pode manter o valor iguala 1 ou a desconex o pode ser detectada neste caso levando a propriedade ServerStatus para 0 Os valores s o baseados nos cinco status padr o definidos para servidores OPC Op es dispon veis para ReconnectPeriod diferente de zero OP O DESCRI O 1 ServerStatus Running Oservidor est rodando normalmente 2 ServerStatus Failed Oservidor n o est rodando Um erro n o especificado ocorreu no servidor 3 ServerStatus NoConfig Oservidor est rodando por m sem informa es de configura o 4 ServerStatus Suspended Oservidor foi suspenso temporariamente 5 ServerStatus Test Oservidor est em Modo de Testes 88 Drivers Exemplo sub CommandButtonl Click Dim status status Application Getobject Driveropc1 Serverstatus MsgBox O status do driver amp status select Case status Case 1 MsgBox O DriveroPC est conectado ao servidor OPC mas seu estado n o foi informado Case 0 M gBox o DriverOPC n o est conectado ao servidor OPC case MsgBox O servidor est rodando normalmente Case 2 MsgBox O servidor n o est rodando Case 3 MsgBox O servidor est rodando mas sem informa es de configura o Case 4 Heap o servidor foi suspenso t
257. e clique em Editar evento do usu rio a A janela anterior ser aberta novamente para a edi o de dados do evento 4 4 Para apagar este evento selecione o e clique em Remover evento do usu rio Ea 22 Introdu o CAP TULO Programando no E3 Apesar de a maioria dos aspectos do VBScript se aplicarem programa o de scripts no E3 algumas particularidades devem ser destacadas no que diz respeito s implementa es do conceito de orienta o a objetos no sistema O VBScript uma linguagem baseada no Visual Basic que traza capacidade de scripting roteiriza o para aplica es que rodam no sistema operacional Windows O VBScript troca informa es com as aplica es utilizando a tecnologia ActiveX Scripting Com o ActiveX Scripting navegadores e outras aplica es cliente como o E3 Viewer podem compilar scripts e chamar fun es dentre outros procedimentos Isso possibilita que scripts desenvolvidos para uma aplica o ou biblioteca que devam ser executados na interface gr fica possam ser executados tanto no E3 Viewer quanto em um navegador de Internet sem a necessidade de qualquer adapta o do aplicativo Mais informa es sobre o VBScript podem ser obtidas no manual Guia de Refer ncia do VBScript no Grupo de Programas do E3 2 1 Ambiente de Programa o Oambiente de programa o de scripts no E3 Studio pode ser acessado atrav s do clique com o bot o direito do mouse sobre qualquer objeto escolhe
258. e foi clicado na Tela MouseY Mostra a coordenada Y onde o mouse foi clicado na Tela Exemplo Encerra a aplica o apenas quando o usu rio soltar o bot o depois do clique sobre o objeto Retangulol Sub Retangulol Mouseup Button Shiftstate MouseX Mousey application ExitO End sub 6 2 2 M todos Comuns Esta se o cont m informa es sobre os m todos comuns a todos os Objetos de Tela 6 2 2 1 BringToFront BringToFront Faz com que o objeto se posicione frente de todos os outros objetos da tela Exemplo Sub Botaol Click Ao clicar em Botaol o sistema traz o objeto Retangulol para a frente Screen Item Retangulol BringToFront O End sub Telas e Objetos de Tela 145 6 2 2 2 SendToBack SendToBack Fazcom que o objeto se posicione atr s de todos os outros objetos da tela Exemplo sub Botao Click Ao clicar em Botao2 o sistema leva o objeto Retangulol para tr s screen Item Retangulo1 sendToBack End sub 6 2 3 Propriedades Comuns Neste t picos s o listadas as propriedades comuns a todos os Objetos de Tela As propriedades explicadas a seguir n o se aplicam nos seguintes objetos ActiveX MSForms E3Chart E3Browser e E3Alarm Estes s o citados posteriormente em cap tulos espec ficos para estes objetos 6 2 3 1 Enabled P Esta propriedade habilita ou desabilita o recebimento de eventos provenientes do teclado e do mouse O valor padr o desta propriedade True
259. e horizontal do E3Chart Exemplo Sub CommandButtonl clickQO set E3chartl Screen Item E3Chart1 old E3Chartl Horgrid For i 0 To 5 E3chartl Horgrid i MsgBox E3Chart1 HorGrid amp Cstr i Next MsgBox voltar E3Chartl Horcrid old End sub 18 3 16 HorGridColor E Determina a cor da grade horizontal do objeto E3Chart O valor padr o desta propriedade cinza RGB 192 192 192 Exemplo Sub CommandButton1 clickQO Set E3Chartl Screen Item E3Chart1 old E3chartl Horgridcolor RGB 255 0 0 MsgBox Pr xima E3Chartl Horgridcolor RGB 255 0 0 MsgBox Pr xima E3Chartl Horgridcolor RGB O 0 255 MsgBox voltar E3Chartl Horgridcolor old End sub E3Chart 417 18 3 17 HorMinorTicks 9 Determina o n mero de subdivis es das escalas horizontais da grade Ovalor padr o desta propriedade 1 Exemplo Sub CommandButtonl clickQO set E3chartl Screen Item E3Chart1 old E3Chartl HorMinorTicks For 1 0 To 5 E3chartl HorminorTicks i MsgBox Pr ximo valor Next E3Chartl HorMinorTicks old End sub 18 3 18 HorScaleBegin 9 Determina o valor inicial aplicado na escala horizontal principal da grade Este valor pode ser num rico para E3Charts XY ou Data para E3Charts com escala de tempo fixa Para E3Charts de tempo real esta propriedade n o aplicada sendo ent o utilizada a propriedade TimeSpan 18 3 19 HorScaleEnd 9 Determina o valor final aplicado na escala horizont
260. e linha no texto caso a rea dispon vel para o texto ultrapasse os limites determinados no objeto Para que esta propriedade funcione a propriedade Multiline deve ser obrigatoriamente igual a True 7 3 9 Editor de Texto Esta se o cont m informa es sobre eventos m todos e propriedades do objeto Editor de Texto 230 ActiveX 7 3 9 1 Eventos Esta se o cont m informa es sobre os eventos do objeto Editor de Texto 7 3 9 1 1 DropButtonClick DropButtoncClick Ocorre quando a lista de op es aparece ou desaparece aose clicar no objeto 7 3 9 2 M todos Esta se o cont m informa es sobre os m todos do objeto Editor de Texto 7 3 9 2 1 Copy Copy Copia para a rea de transfer ncia um texto previamente selecionado Utilize o m todo Paste para colar o texto em outro local Exemplo Sub CommandButtonl clickQO Screen Item TextBox1 Copy O End sub 7 3 9 2 2 Cut Cut Recorta para a rea de transfer ncia um texto previamente selecionado Utilize o m todo Paste para colar o texto em outro local Exemplo Sub CommandButtonl clickQO screen Item TextBox1 cut End sub 7 3 9 2 3 Paste Paste Insere no objeto de texto o conte do da rea de transfer ncia Exemplo Sub CommandButton1 clickQO Screen Item TextBox1 Paste End sub ActiveX 231 7 3 9 3 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Editor de Texto 7 3 9 3 1 Au
261. e manipular e Objetos do servidor atrav s do servidor 24 Programando no E3 e Objetos do servidor atrav s do s E3 Viewer s e Objetos do E3 Viewer atrav s do mesmo E3 Viewer No entanto n o se pode manipular diretamente e Objetos do E3 Viewer atrav s do servidor s poss vel atrav s da cria o de eventos no E3 Viewer ligados a vari veis que est o no servidor e Objetos de um E3 Viewer a partir de outro E3 Viewer s poss vel atrav s da cria o de eventos ligados a vari veis que est o no servidor Tais limita es s o decorrentes do fato de que por defini o existe uma independ ncia entre o que cada uma das esta es E3 Viewer est fazendo ou visualizando e o servidor e vice versa Por isso todas as atividades tanto do servidor como do E3 Viewer necessitam ser coordenadas de forma ass ncrona ou atrav s de eventos para operarem de forma harmoniosa Logo devido a esta independ ncia ao se criar um script primeiro deve se obter uma refer ncia correta dos objetos que se deseja manipular ou seja necess rio que o objeto seja primeiramente encontrado nos v rios m dulos do E3 Vale repetir que ao se editar um script o usu rio poder utilizar o AppBrowser que permite copiar para o script o caminho de um m todo ou propriedade de forma completa auxiliando o na cria o de scripts Portanto para acessar os objetos externos que est o sendo manipulados em um script s o utilizada
262. e o evento BeforeStop para fazer alguma a o que seja necess ria antes que a comunica o seja terminada como por exemplo escrever ou ler valores do equipamento ou dispositivo antes que a comunica o n o esteja mais dispon vel 3 1 1 5 OnCommError OnCommError EvtType Size Element N1 N2 N3 N4 Ocorre quando algum erro de escrita ou leitura detectado pelo driver de comunica o Utilize o evento OnCommError para saber quando ocorreu uma falha de escrita ou leitura no driver As vari veis de evento recebem informa es sobre o erro ocorrido Com estes valores poss vel rastrear quais tags est o apresentando problemas de comunica o Vari veis do evento OnCommError NOME DESCRI O EvtType Informa qual o tipo de opera o que o driver estava efetuando quando ocorreu o erro conforme as op es a seguir e O Erro de leitura de um s elemento Size 1 Param1 N1 Param2 N2 Param3 N3 e Param4 N4 e 1 Erro de escrita de um s elemento Size 1 Parami N1 Drivers 53 NOME DESCRI O Param2 N2 Param3 N3 e Param4 N4 e 2 Erro de leitura de um bloco bloco de comunica o Size determinado pelo n mero de elementos do bloco Parami N1 Param2 N2 Param3 N3 e Param4 N4 e 3 Erro de escrita de um bloco bloco de comunica o Size determinado pelo n mero de elementos do bloco Parami N
263. e pontos por polegada na vertical do monitor do computador de destino Ovalor padr o desta propriedade 1 que faz com que seja assumido o valor do computador atual 10 3 23 TargetMarginX 9 Define o n mero de pixels que devem ser descontados da resolu o horizontal da tela a rea til do Viewer O valor padr o da propriedade 1 que faz com que seja assumida a configura o da janela do Viewer com ou sema barra de t tulo com ou sem borda em conjunto com a configura o do computador atual largura de borda e barra de t tulo definidas pelo Windows 10 3 24 TargetMarginY 9 Define o n mero de pixels que devem ser descontados da resolu o vertical da tela a rea til do Viewer O valor padr o da propriedade 1 que faz com que seja assumida a configura o da janela do Viewer com ou sema barra de t tulo com ou sem borda em conjunto com a configura o do computador atual largura de borda e barra de t tulo definidas pelo Windows Viewer 319 10 3 25 TargetResolutionX 9 Define a resolu o horizontal da tela para a qual esta aplica o est destinada em pixels O valor padr o da propriedade 1 que faz com que seja assumida a resolu o do computador atual 10 3 26 TargetResolutionY 9 Define a resolu o vertical da tela para a qual esta aplica o est destinada em pixels O valor padr o da propriedade 1 que faz com que seja assumida a resolu o do computador atual 10
264. ecomenda se aumentar o valor da propriedade Scan para aqueles blocos que n o variam muito no equipamento ou no dispositivo possibilitando assim que outros blocos de maior prioridade sejam lidos com maior frequ ncia aumentando assim a performance geral do sistema O valor padr o desta propriedade 1000 1 segundo O valor do scan deve ser maior que zero Exemplo Sub Bloco de comunicacaol Beforestart scan 152 End sub 3 3 3 14 Size 9 Define o tamanho do conjunto de valores deste bloco Consulte a documenta o do driver utilizado para conhecer qual o limite para esta propriedade de acordo com os par metros B1 at B4 Criando os elementos de bloco possibilita se o acesso aos valores lidos e tamb m permite a escrita de valores para o equipamento ou dispositivo Esta propriedade n o pode ser modificada ap s a comunica o ser iniciada O valor padr o desta propriedade 0 Exemplo Sub Bloco de comunicacaol Beforestart Size 10 End Sub 3 3 3 15 TimeStamp sas E A propriedade TimeStamp atualizada sempre que ocorrer alguma mudan a de valor ou de estado nas propriedades Value ou Quality Ele informa qual a data hora associada tanto ao valor quanto qualidade do Bloco de Comunica o Esta uma propriedade somente para leitura O valor padr o desta propriedade 00 00 00 3 4 Elemento de Bloco de Comunica o Esta se o cont m informa es sobre m todos e propriedades do objeto Elemento de Bloc
265. edades do objeto Caixa de Sele o e do Bot o de Op o Estes objetos n o possuem eventos nem m todos associados 7 3 3 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Caixa de Sele o e do Bot o de Op o 7 3 3 1 1 Accelerator Define ou recupera a tecla aceleradora do objeto Esta tecla aceleradora uma tecla de atalho que usada em conjunto com a tecla ALT d o foco ao objeto O valor padr o desta propriedade vazio 7 3 3 1 2 Alignment aP A propriedade Alignment especifica a posi o do objeto relativa a sua legenda As op es dispon veis para esta propriedade s o as seguintes e 0 fmAlignmentLeft coloca a legenda esquerda do objeto e 1 fmAligmentRight coloca a legenda direita do objeto 7 3 3 1 3 AutoSize Fi A propriedade AutoSize ajusta a largura do texto caso a rea dispon vel para o mesmo ultrapasse o tamanho do objeto Quando a propriedade estiver configurada para True o texto ser redimensionado para coincidir com o tamanho atual do objeto 7 3 3 1 4 BackStyle aP A propriedade BackStyle define o estilo do plano de fundo para os objetos As op es dispon veis para esta propriedade s o as seguintes e O fmBackStyleTransparent define o objeto como transparente isto nenhum fundo deste objeto ser desenhado e 1 fmBackStyleOpaque define o objeto como opaco isto o fundo ser desenhado valor padr o ActiveX 189 7 3 3 1 5 C
266. eis escolhidas ou via busca expl cita do Viewer por informa es no servidor Toda a opera o de associa o da interface gr fica feita do cliente para o servidor e n o do servidor para o cliente Assim n o poss vel modificar Telas ou objetos a partir do servidor via scripts pois cada cliente de dados uma c pia diferente das Telas Um exemplo pr tico mudar a cor de um texto na Tela para verde quando um tag for 30 Programando no E3 ligado valor 1 e para vermelho quando for desligado valor 0 Neste caso deve se simplesmente criar uma associa o digital entre a propriedade TextColor do Textol como Tagl Associa es s o prefer veis devido rapidez de execu o e simplicidade de manuten o e constru o da aplica o Texto Propriedades de Textol PanelDrawString EF Item Posi o Formata o Associa es Propriedades Cone Fonte Value a TexiColor S Driverl Pastal Tagl 9 Ange i BackgroundColor aP BackgroundStyle i BorderColor aP BorderStyle 9 BorderWidth 9 Count A DocString aP Efect3D 9 Efect3D X 9 Efect3D Y i Effect3DColorBase mt Eftect3DColorTop Associando a cor do texto ao valor de Tag1 Uma outra forma de executar o procedimento anterior criar um script no Viewer que fique verificando constantemente se o Tag1 mudou ou n o de valor para ent o mudara cor do texto Este tipo de script poss vel de ser realizado mas degrada
267. el Click Ao clicar no objeto seta o modo override para s lido e troca a cor de preenchimento da imagem para azul overriderilimode 2 overriderilicolor RGB O 0 255 End sub NOTA Esta propriedade s funciona quando o objeto Figura est trabalhando com Telas e Objetos de Tela 153 6 2 6 1 9 OverrideFilMode aP A propriedade OverrideFillMode especifica o modo do preenchimento da imagem do objeto quando este est mostrando um arquivo Windows Metafile Ela altera o modo original de preenchimento da imagem sem alterar o arquivo definido pela propriedade Filename A seguinte tabela cont m os valores v lidos para a propriedade OverrideFillMode Op es dispon veis para OverrideFillMode OP O DESCRI O 0 NoOverride Aimagem manter seu preenchimento original padr o 1 WideFrame Aimagem n o ser preenchida 2 SolidFill Aimagem ser preenchida com a cor especificada pela propriedade OverrideFillColor 3 ByBrightness Aimagem ser preenchida coma cor especificada pela propriedade OverrideFillColor por m levar em conta qual era a intensidade da cor original da imagem Exemplo Sub Drawpicturel Click Ao clicar no objeto seta o modo override para s lido e troca a cor de preenchimento da imagem para azul overriderilimode 2 overriderFilicolor RGB O O 255 End sub 154 Telas e Objetos de Tela 6 2 6 1 10 OverrideLineColor
268. ela o par metro strClassName deve ser DrawRect O objeto criado fica contido no objeto que chamou o m todo AddObject e pode ser acessado atrav s do m todo Item O par metro Activate opcional e indica se o objeto ser ativado ap s a cria o Quando o objeto estiver ativado os links e os scripts ficam habilitados Se o objeto for criado com Activate em False mais tarde ele pode ser ativado pelo m todo Activate Oobjeto s ser criado se ele for de um tipo compat vel com o objeto que o cont m Para se ter certeza que o objeto foi criado pode se utilizar o m todo IsObject Exemplo Sub CommandButton Click Acrescenta um ret ngulo Drawrect na tela xc Visible True Set Retangulo Screen addobject DrawRect True Retangulo x 1000 Retangulo Y 1000 Retangulo width 10000 Retangulo Height 10000 End sub NOTA Apenas os objetos que possuem a op o Inserir no menu podem acessar este m todo 2 7 2 4 Deactivate Deactivate Este m todo desativa um objeto criado ou previamente ativado pelo m todo Activate Pode se desativar um objeto quando for preciso fazer uma configura o pr via inicia o de propriedades por exemplo ou quando se quiser fazer testes nos quais o objeto n o pode estar presente e ativo Exemplo Sub CommandButton1 clickQO Dim obj novo Set obj application Getobject Dados Set novo obj Addobject DemoTag True Desativa o objeto novo Deactivate End sub Pr
269. ela do m todo GetRealTimePeriod O par metro Times determina o intervalo de tempo e a unidade da escala especificado por TimeUnit Oeixo fica sempre sendo atualizado neste modo tempo real Exemplo Sub CommandButtonl clickQO Set Chart Screen Item E3Chart5 tuseconds 0 tuMinutes 1 tuHours 2 tuDays 3 tuweeks 4 tuMonths 5 tuvears 6 2 minutos Chart Axes Item NomeDoEixo SetRealTimePeriod 2 1 Chart Axes Item NomeDoEixo setTickspacing 30 O End sub 18 7 1 8 SetTickSpacing SetTickSpacing TickSpacing TimeUnit Configura o espa amento entre os ticks subdivis es da escala usando a unidade O espa amento entre os ticks determinado pelo par metro TickSpacing O par metro TimeUnit determina a unidade Caso a escala seja num rica a unidade n o considerada As op es dispon veis no par metro TimeUnit s o as mesmas demonstradas na tabela do m todo GetRealTimePeriod Exemplo Sub CommandButtonl clickQO Set Chart Screen Item E3Chart1 10 caso seja a escala num rica o valor da unidade n o considerado Chart axes Item NomeDoEixo setTickspacing 10 O chant axes Tem UNomEDoE ixo Seta 20 0 End Su 446 E3Chart 18 7 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Eixo 18 7 2 1 Color E Determina a cor principal do Eixo Exemplo sub CommandButtonl Click Set Chart Screen Item E3Chart1 Chart Aaxes Ho
270. elerator Define ou recupera a tecla aceleradora do objeto Esta tecla aceleradora uma tecla de atalho que usada em conjunto com a tecla ALT d o foco ao objeto O valor padr o desta propriedade vazio 7 3 6 1 2 AutoSize Fi A propriedade AutoSize ajusta a largura do texto caso a rea dispon vel para o mesmo ultrapasse o tamanho do objeto Para o objeto Texto Label quando a propriedade estiver configurada para True o texto redimensionado para coincidir com o tamanho atual o objeto permitindo assim a sua exibi o completa 7 3 6 1 3 BackStyle aP A propriedade BackStyle define o estilo do plano de fundo para os objetos As op es dispon veis para esta propriedade s o as seguintes e O fmBackStyleTransparent define o objeto como transparente isto nenhum fundo deste objeto ser desenhado e 1 fmBackStyleOpaque valor padr o define o objeto como opaco isto o fundo ser desenhado 212 ActiveX 7 3 6 1 4 BorderColor E Esta propriedade determina a cor da borda que ser aplicada no objeto Com esta propriedade poss vel aplicar a cor padr o ou personaliz la atrav s da sua edi o Para que esta propriedade seja aplic vel necess rio que a propriedade BorderStyle esteja configurada para 1 fmBorderStyleSingle O valor padr o desta propriedade preto RGB O 0 0 7 3 6 1 5 BorderStyle aP A propriedade BorderStyle determina o estilo de borda que ser aplicada ao obje
271. em E3Chart1 FitalTO End sub 18 2 3 FitPen FitPen Pen FitStyle Enquadra uma pena no E3Chart especificada pelo ndice ou pelo nome O par metro Pen define a pena que ser enquadrada no E3Chart ndice ou nome da pena O par metro opcional FitStyle indica o modo de enquadramento das penas em tempo de execu o e 0 enquadra ambos os eixos ao mesmo tempo e 1 enquadra apenas o eixo vertical e 2 enquadra apenas o eixo horizontal Exemplo Sub CommandButtonl clickQO Set Chart Screen Item E3Chart1 Chart FitPen 1 Chart FitPen Penl 1 Enquadra a Pen1 somente na vertical End sub 412 E3Chart 18 2 4 LoadData LoadData Carrega os dados no E3Chart Este m todo especialmente usado para carregar os dados antes de imprimir quando usado em um objeto Relat rio Exemplo sub CommandButton1 Click MsgBox Screen Item E3Chart1 LoadData O End Sub 18 2 5 ResetConfig ResetConfig Flags Remove todas as configura es ajustadas em um E3Chart devolvendo o ao estado inicial Exemplo Sub E3Chart1 OnstartRunning O i Ao iniciar E3Chart1 remove todas as configura es ResetConfigO End Sub 18 2 6 ShowCursor ShowCursor Ativa o modo Pesquisa de Intervalo Em tempo de execu o este recurso pode ser acessado atrav s do clique com o bot o direito do mouse sobre o objeto e selecionando a op o Pesquisar Intervalos do menu de contexto 18 2 7 Zoomin Zoomin O m todo Zo
272. em Pen1 Penl DigitalData True End sub 18 5 2 8 EnableCalc F Habilita ou desabilita o c lculo da m dia m nimos e m ximos dentro do intervalo 18 5 2 9 EnableHighLimit F Habilita ou desabilita a verifica o do limite alto 18 5 2 10 EnableLowLimit F Habilita ou desabilita a verifica o do limite baixo 436 E3Chart 18 5 2 11 EU A Esta propriedade utilizada para identificar a unidade de engenharia que o valor representa como por exemplo graus metros KW h etc 18 5 2 12 HighLimit 9 Determina o limite de alarme alto 18 5 2 13 InterpolatedBeginY 9 Informa o valor do ponto interpolado onde o cursor inicial cruza com a pena Esta propriedade somente de leitura 18 5 2 14 InterpolatedEndY 9 Informa o valor do ponto interpolado onde o cursor final cruza com a pena Esta propriedade somente de leitura 18 5 2 15 LimitPenBkColor E Determina a cor de fundo da pena quando em alarme 18 5 2 16 LimitPenColor E Determina a cor da pena quando em alarme 18 5 2 17 LowLimit 9 Determina o limite de alarme baixo 18 5 2 18 MaxY 9 Informa o valor m ximo da pena no intervalo caso a propriedade EnableCalc esteja habilitada Caso o E3Chart esteja no modo de Pesquisa de Intervalos mostra a m dia nesse intervalo do contr rio mostra a m dia no intervalo entre o in cio e o fim no eixo horizontal Valores com qualidade ruim n o s o considerados caso a propriedade ShowBadPoints esteja de
273. em a ordena o da consulta Este valor s ser aceito como maior que 0 se a coluna tiver um tipo de ordena o Este valor ter que ser menor ou igual ao n mero de campos que comp em a ordena o da consulta Function Texto Fun o para a qual a coluna pode ser passada como par metro GroupBy Boolean Em True indica que a coluna faz parte de um o agrupamento Visible Boolean Em True indica que a coluna est vis vel Exemplo Sub Botaol click Percorre a cole o Campos mostrando os em uma caixa de mensagem e ajustando os como vis veis na configura o da consulta Set Browser Screen Item E3Browser Set Consulta Browser Item Consulta Set Campos Consulta GetE3QueryFields O For Each campo In Campos MsgBox CStr campo TableName amp amp cstr campo ColumnName campo Visible TRUE Next Refaz a consulta do E3Browser que acabou de ser modificada para que todos os campos apare am Browser RetrieveE3QueryFields Browser Requery O End sub NOTA Para usar este m todo a consulta dever ser previamente criada em tempo de configura o 390 Consultas 16 2 8 RemoveField RemoveField FieldName Table O m todo RemoveField remove um campo previamente inclu do em uma consulta O par metro FieldName determina o nome do campo que ser removido O par metro Table determina o nome da tabela a qual o campo pertence Este m t
274. em scripts ouem associa es sendo configurada unicamente via Studio 7 4 4 2 12 TextFont1 AA propriedade TextFont1 utilizada para determinar a fonte do bot o quando est pressionado Esta propriedade n o pode ser utilizada em scripts ou em associa es sendo configurada unicamente via Studio 7 4 4 2 13 Type P Define o tipo do bot o Os valores poss veis para esta propriedade s o os seguintes e 0 ButtonTypeKey comportamento normal de um bot o e 1 ButtonTypeSwitchH o comportamento do bot o o de uma chave dividida horizontalmente e 2 ButtonTypeSwitchV o comportamento do bot o o de uma chave dividida verticalmente ActiveX 253 e 3 ButtonTypeLeverH o comportamento do bot o o de uma alavanca que se movimenta da esquerda para a direita e vice versa e 4 ButtonTypeLeverV o comportamento do bot o o de uma alavanca que se movimenta de cima para baixo e vice versa e 5 ButtonTypeTransparent o bot o transparente e 6 ButtonTypeUserBitmap o bot o alterna a exibi o das imagens definidas nas propriedades BitmapoO e Bitmap1 e 7 ButtonTypeCheckbox o comportamento do bot o o mesmo de uma Caixa de Sele o e 8 ButtonTypeRadio o comportamento do bot o o mesmo de um Bot o de Op es Ovalor padr o desta propriedade 0 ButtonTypekKey 7 4 4 2 14 Value Apropriedade Value um Variant que assume o valor contido na propriedade Value0 se o bot o n o est pressionad
275. em uma nova p gina e uma nova p gina depois de imprimir a se o 22 5 2 1 6 NewPage P Insere uma quebra de p gina no relat rio As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para NewPage OP O DESCRI O 0 ddNPNone N o h quebra de p gina na se o padr o 488 Relat rios OP O DESCRI O 1 ddNBefore Inicia a impress o numa nova p gina 2 ddNPA ter Inicia uma nova p gina depois da impress o da se o 3 ddNPBeforeAfter Inicia a impress o numa nova p gina e inicia uma nova p gina depois de imprimir a se o 22 5 2 1 7 Repeat P Determina se o GroupHeader ser impresso novamente depois de ser associado se o Detail quando h m ltiplas p ginas colunas ou quebras de p ginas no relat rio As op es dispon veis s o as seguintes Op es dispon veis para Repeat OP O DESCRI O O ddRepeatNone N o h reimpress o do grupo de cabe alho padr o 1 ddRepeatOnPage Imprime o grupo de cabe alhos no topo da p gina conforme as especifica es da se o Detail 2 ddRepeatOnColumn Imprime o grupo de cabe alhos no topo da coluna da p gina do relat rio conforme as especifica es da se o Detail 3 ddRepeatAll Imprime o grupo de cabe alhos e os demais objetos no topo da p gina do re
276. emove 0 End sub 18 8 1 4 UpdateData UpdateData Atualiza os dados de todas as consultas Exemplo Sub Textol Click Set E3Chartl Screen Item E3Chart1 E3Chart1 Queries UpdateData End sub 18 8 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Cole o de Consultas 18 8 2 1 Count 9 cont m o n mero total de consultas do E3Chart Esta propriedade somente de leitura 452 E3Chart 18 9 Legenda Esta se o cont m informa es sobre m todos e propriedades do objeto Legenda Este objeto n o possui eventos associados 18 9 1 M todos Na legenda podem ser selecionadas v rias colunas Cada coluna mostra um tipo de informa o e possui um nome e um valor correspondente A seguir tem se a tabela da descri o das colunas poss veis na legenda Op es dispon veis para identifica o das colunas OP O DESCRI O Cor da pena Mostra a cor da pena Descri o Mostra a propriedade DocString da pena DifX Mostra a diferen a entre os cursores inicial e final Dify Mmostra a diferen a entre os pontos interpolados inicial e final no eixo Y EscalaX Mostra o nome da escala associada ao tagX EscalaY Mostra o nome da escala associada ao tagyY Estado Mostra o status da pena FimX Mostra a posi o final do cursor FimY Mostra o ponto interpolado onde o cursor final cruza a pena InicioX Mostra a posi o in
277. emplo de utiliza o do m todo 2 7 2 1 Chamadas de M todos Muitos m todos pr definidos possuem par metros que podem ou devem ser passados na chamada do m todo Para isso o VBScript possui uma regra que deve ser seguida se o m todo for utilizado em uma atribui o seus par metros devem estar entre par nteses Por exemplo veja esta chamada do m todo GetObject obj application Getobject dados tag001 J se o m todo for chamado sozinho deve se retirar os par nteses Por exemplo veja esta chamada do m todo SetVariableValue screen Item Consulta setVariablevalue Valor 12 Os par nteses usados nas cita es de m todos neste manual servem apenas como indicativo para diferenci los das propriedades Nos scripts deve se seguir esta mesma regra 2 7 2 2 Activate Activate Ativa um objeto que est inativo no momento Exemplo Sub CommandButtonl clickQO Dim obj tag Set obj Application Getobject Dados Aeria o sopro novo e deixa desativado False set tag j Addobj ect DemoTag False E Meela os ETE do objeto novo tag Name tag001 tag Type 3 Ativa o objeto coloca em execu o tag Activate End Sub 44 Programando no E3 2 7 2 3 AddObject AddObject ClassName Activate O m todo AddObject adiciona um novo objeto aplica o Este m todo possui o par metro ClassName que indica o tipo de objeto que ser criado Por exemplo para se criar um ret ngulo na T
278. emporariamente Case MsgBox O servidor est em Modo de Testes End Select End sub 3 5 2 7 WriteFeedbackMode aP Esta propriedade permite controlar a confirma o ou feedback das escritas em tags As op es de configurac o dessa propriedade est o descritas na tabela a seguir Op es dispon veis para a propriedade WriteFeedbackMode OP O DESCRI O 0 wfWaitNextRead Ap s a escrita aguarda normalmente a pr xima leitura 1 For a uma leitura ass ncrona de dispositivo logo ap s cada wfimmediateReadAfte escrita rWrite 2 Ovalor escrito assumido pelo tag imediatamente caso a wiTrustWriteSuccess escrita tenha funcionado Drivers 89 Ovalor padr o dessa propriedade 0 wfWaitNextRead para aplicativos criados antes da implementa o desta propriedade e 1 wflmmediateReadAfterWrite para aplicativos criados a partir de sua implementa o 3 6 Tag de Comunica o OPC Esta se o cont m informa es sobre as propriedades do objeto Tag de Comunica o OPC Este objeto n o possui eventos nem m todos associados 3 6 1 Propriedades Esta se o cont m as propriedades do objeto Tag de Comunica o OPC 3 6 1 1 AdviseType a Controla o modo Advise As op es dispon veis s o Op es dispon veis para AdviseType OP O DESCRI O 0 AlwaysinAdvise Otag mantido atualizado se a propriedade AllowRead do Tag
279. en Connect End sub 18 4 1 2 ChangePenPos ChangePenPos Source Dest Modifica a ordem de desenho das penas no E3Chart Este m todo possui os seguintes par metros e Source determina o ndice da pena a ser movida come ando em 1 e Dest determina o destino da pena come ando em 1 Uma situa o em que este m todo especialmente til quando tem se uma pena com o desenho de linha e outra com o desenho de rea Se a pena de rea for desenhada depois da pena de linha ela poder esconder a ltima Asolu o ent o seria inverter a ordem de desenho destas penas Exemplo sub commandButton1 Click Move a pena 1 para a posi o 2 screen Item E3Chart1 Pens ChangePenPos 1 2 End sub 18 4 1 3 Item Item Index O m todo Item retorna um objeto Pena da cole o de penas especificado pelo ndice Este m todo possui o par metro Index que pode ser do tipo num rico se corresponder ao ndice da pena ou texto se corresponder ao nome da pena Exemplo Sub CommandButton1 clickQO Obt m a primeira pena Set Pen1 Screen Item E3Chart1 Pens Item 0 End sub 430 E3Chart 18 4 1 4 Remove Remove Name O m todo Remove a paga uma pena atrav s do nome especificado Este m todo possui o par metro Name que determina o nome da pena a ser removida Exemplo Sub CommandButton1 clickQO Screen Item E3Chart1 Pens Remove 1 End sub 18 4 1 5 SetCursorPos SetCursorPos X Range
280. erno Este objeto n o possui eventos associados 5 4 1 M todos Esta se o cont m informa es sobre os m todos do objeto Tag Interno 5 4 1 1 WriteEx Write Ex NewValue NewTimestamp NewQuality Permite modificar o valor a data hora e a qualidade de um Tag Interno em uma nica opera o Este m todo retorna um booleano que indica o sucesso ou n o da opera o O par metro NewValue especifica o novo valor do tag se omitido o valor do tag n o modificado O par metro NewTimestamp especifica a nova data hora dotag se omitido utiliza se a data hora do momento da chamada do m todo O par metro NewQuality especifica a nova qualidade do tag se omitida ser assumida a qualidade Boa 192 Todos estes par metros podem ser omitidos Exemplo sub CommandButton12 ClickO Dim Ret Ret Application Getobject Dados TagInternol writeEx 123 456 1 1 2001 193 If Ret Then MsgBox Funcionou Else MsgBox Falhou End If End sub 5 4 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Tag Interno 5 4 2 1 Quality 9 Informa a qualidade do valor contido na propriedade Value Esta propriedade de leitura e escrita mas sempre que o valor do Tag Interno for modificado seja por Script ou por uma associa o ela ser atualizada de acordo Exemplo Sub CommandButton1 clickQO io Application Getobject Dados TagInternol Quality End su Servidor de Dados 125 5 4
281. erro HelpFile String com o nome e caminho do arquivo de ajuda HelpContext N mero de contexto do t pico de ajuda referente ao erro inteiro CancelDisplay Booleano que indica se o erro deve ser mostrado em uma MessageBox 22 1 5 OnFetchData OnFetchData eof Disparado toda vez que um novo registro processado Este evento utilizado para executar um script que modifica os valores dos campos que foram adicionados ao relat rio em um script associado ao evento OnDatalnitialize A vari vel eoftem o valor padr o True e indica que ap s o script o processamento do registro atual do relat rio foi encerrado 472 Relat rios 22 1 6 OnFormat OnFormat Iniciado depois que os dados s o lidos e carregados no relat rio mas antes da se o ser preparada para a impress o Este evento pode ser utilizado para modificar o layout da se o do relat rio ou de qualquer outro objeto 22 1 7 OnHyperlink OnHyperlink Button Link Ocorre quando um link clicado no relat rio Pode se utilizar este evento para executar um script que redirecione um link ou para configurar um link no relat rio A vari vel Button indica qual bot o foi clicado normalmente 1 e a vari vel Link determina qual o endere o que ser seguido 22 1 8 OnNoData OnNoData Ocorre quando n o h dados a serem impressos no relat rio Pode se utilizar este evento para executar um script que mostre uma mensagem de erro
282. ervalo de ocorr ncia dever ser de 32 768 a 32 767 Ocupa 2 bytes 23 Uinteger N mero inteiro sem sinal no caso equivale a um 102 Drivers OP O DESCRI O DWORD que vai de 0 a 4294967295 232 1 8194 Arrinteger Array unidimensional de valores integer inteiros 8195 Arrlong Array unidimensional de valores inteiros de 32 bits sinalizados 8196 ArrSingle Array unidimensional de ponto flutuante de 32 bits 8197 ArrDouble Array unidimensional de va 64 bits or de ponto flutuante de 8198 ArrCurrency Array unidimensional de va casas decimais or monet rio com 4 8199 ArrDate Array unidimensional de va or de data hora 8200 ArrString Array unidimensional de va or literal Texto 8201 ArrObject Array unidimensional de va objeto or de refer ncia a um 8202 ArrError Array unidimensional de va or de c digo de erro 8203 ArrBoolean Array unidimensional de va ou falso or booleano verdadeiro 8204 ArrVariant Array de dados de qualquer tipo usados para objetos e outros valores para os quais otipo de dados desconhecido 8205 ArrUnkObject Array unidimensional de va objeto or de refer ncia a um 8206 ArrDecimal Array unidimensional de va 96 bits or de ponto flutuante de 8228 ArrRecord Array unidimensional de va or reco
283. especialmente til quando se precisa usar um nico E3Browser para exibir dados de diferentes tabelas ou consultas Exemplo sub CommandButton1 Click Screen Item E3Browser1 RetrieveE3QueryFields End sub 17 3 Propriedades Esta se o cont m informa es sobre as propriedades do objeto E3Browser E3Browser 401 17 3 1 AllowColumnResize F Habilita ou desabilita a configura o do tamanho das colunas da grade do objeto em tempo de execu o Se esta propriedade estiver configurada para False o tamanho das colunas fixo e n o poder ser modificado 17 3 2 AllowRowResize F Habilita ou desabilita a configura o do tamanho das linhas da grade do objeto em tempo de execu o Se esta propriedade estiver configurada para False o tamanho das linhas fixo e n o poder ser modificado 17 3 3 ColumnWidth 9 Determina a largura das colunas do E3Browser em pixels 17 3 4 Cursel 9 Indica a posi o atual do cursor do E3Browser ou seja o ndice da linha em que ele est posicionado 17 3 5 E3Query 58 Retorna o objeto Consulta do E3Browser para que se possa acessar suas propriedades 17 3 6 Enabled F Habilita ou desabilita o E3Browser Se configurado como True pode se usar o scroll e selecionar linhas do E3Browser Do contr rio nenhum clique do mouse no E3Browser ter efeito 17 3 7 Fields 58 Retorna o objeto cole o que cont m a lista com todos os campos da tabela tornando poss vel
284. esquerda da figura 7 fmPicturePositionAboveCenter Afigura aparece acima da legenda A legenda centralizada abaixo da figura padr o 8 fmPicturePositionAboveRight Afigura aparece acima da legenda A legenda alinhada com a extremidade direita da figura 9 fmPicturePositionBelowLeft Afigura aparece abaixo da legenda A legenda alinhada com a extremidade esquerda da figura 10 fmPicturePositionBelowCenter Afigura aparece abaixo da legenda A legenda centralizada acima da figura 11 fmPicturePositionBelowRight Afigura aparece abaixo da legenda A legenda alinhada com a extremidade direita da figura 7 3 5 2 9 TakeFocusOnClick P Especifica se o objeto recebe o foco quando clicado Se a propriedade estiver configurada para True o objeto recebe o foco quando clicado Caso contr rio o objeto n o recebe o foco quando clicado ActiveX 211 7 3 5 2 10 WordWrap F Habilita ou desabilita uma quebra de linha no texto caso a rea dispon vel para o texto ultrapasse os limites determinados no objeto Para que esta propriedade funcione a propriedade Multiline deve ser obrigatoriamente igual a True 7 3 6 Texto Esta se o cont m informa es sobre propriedades do objeto Texto Este objeto n o possui eventos nem m todos associados 7 3 6 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Texto 7 3 6 1 1 Acc
285. ess repetidamente Quando o usu rio libera a tecla o evento KeyUp ocorre Para monitorar o estado f sico do teclado ou manipular teclas n o reconhecidas pelo evento KeyPress como teclas de fun o navega o etc utiliza se os eventos KeyDown e KeyUp ActiveX 185 7 3 2 Propriedades Comuns Esta se o cont m informa es sobre as propriedades comuns aos objetos Microsoft Forms NOTA O E3 utiliza para defini o de coordenadas e espessura o sistema HIMETRIC Neste sistema cada unidade l gica equivale a um mil simo de cent metro ou seja cada 1000 unidades equivalem a 1 cent metro Assim este o padr o adotado na descri o das propriedades do E3 quando aplic vel 7 3 2 1 BackColor E Determina a cor de fundo do objeto Nos scripts utilize a fun o do VBScript RGB para montar a cora ser associada a esta propriedade O valor padr o desta propriedade para os objetos Lista de Sele o Lista e Editor de Texto a cor branca RGB 255 255 255 e para os demais objetos a cor bege RGB 236 233 216 7 3 2 2 Enabled Pl Habilita ou desabilita o objeto isto o foco e a resposta eventos gerados pelo usu rio Se a propriedade estiver configurada para True o objeto pode receber o foco responder a eventos gerados pelo usu rio e estar acess vel atrav s de scripts padr o Caso contr rio o usu rio n o poder interagir com o objeto usando o mouse pressionando teclas ou teclas de atalho
286. est com o foco Esta propriedade acess vel apenas em tempo de execu o 13 3 23 Height 9 A propriedade Height define a altura do E3Alarm em unidades Himetric 13 3 24 Layer 9 Esta propriedade define em quais camadas o objeto deve aparecer Ovalor representa uma m scara de 32 bits um bit para cada camada Portanto podem ser definidas at 32 camadas individuais Assim objetos podem ser agrupados logicamente e mostrados ou escondidos apenas com a modifica o da m scara da propriedade Layer 370 E3Alarm 13 3 25 MouseOver Fi A propriedade MouseOver informa se o ponteiro do mouse encontra se em cima da Tela Caso afirmativo a propriedade MouseOver habilitada do contr rio ser False Esta propriedade somente de leitura e acess vel apenas em tempo de execu o O valor padr o desta propriedade False 13 3 26 MouseOvercChild Fi A propriedade MouseOverChild informa se o ponteiro do mouse encontra se em cima de um dos objetos inseridos na Tela Caso afirmativo a propriedade MouseOverChild habilitada Caso contr rio ser False Esta propriedade somente de leitura e acess vel apenas em tempo de execu o O valor padr o desta propriedade False 13 3 27 PopupMenu Fl Habilita um menu pop up acessado ao clicar com o bot o direito do mouse sobre o E3Alarm O valor padr o desta propriedade True 13 3 28 PrimarySortAscending Fi Quando esta propriedade estiver configurada para Fa
287. este tag estar associado Consulte a documenta o do driver para sua correta parametriza o Esta propriedade pode ser modificada ap s iniciada a comunica o Exemplo Sub Blocol_BeforestartO Eila z B2 B3 End Sub 3 3 3 7 B4 1 9600 9 Especifica a qual conjunto de dados no equipamento ou no dispositivo este tag estar associado Consulte a documenta o do driver para sua correta parametriza o Esta propriedade pode ser modificada ap s iniciada a comunica o Exemplo Sub Blocol_BeforestartO B 2 ies B2 B3 9600 B4 524 End Sub 76 Drivers 3 3 3 8 EnableDeadBand Fi A propriedade EnableDeadBand habilita ou desabilita a propriedade PercentDeadBand Se esta op o estiver configurada para True o valor do bloco atualizado somente se este mudar e o novo valor exceder o limite definido pela propriedade PercentDeadBand Caso contr rio o bloco sempre atualizado e o limite de deadband banda morta n o verificado Sempre que poss vel recomendado manter a deadband banda morta habilitada pois ela melhora a performance da aquisi o e do processamento de dados Normalmente a banda morta ser desabilitada apenas para os tags que retornem valores que representem eventos que precisam ser tratados no evento OnRead do tag O valor padr o desta propriedade True 3 3 3 9 EnableDriverEvent P Esta propriedade utilizada para controlar a gera o do evento OnTagRead que ocorre no driver de
288. etHistoricPeriod GetHistoricPeriod Begin End Retorna o intervalo de tempo mostrada na escala hist rica O par metro Begin indica a data inicial da escala hist rica e End indica a data final Exemplo Sub commandsuttoni click set Chart Screen Item E3Chart Chart axes Item NomeDoE ixo GetHistoricPeriod min max Value Cstr dmin amp amp cstr dmax MsgBox Data inicial amp cstr min amp vbNewLine amp Data final amp Cstr max End sub 444 E3Chart 18 7 1 2 GetMinMax GetMinMax Min Max Retorna nos par metros Min e Max os valores m nimo e m ximo da escala num rica respectivamente Exemplo Sub CommandButton1 pBClick O Set Chart Screen Ttem E3Chart i Chart Axes Item NomeDoEi xo GetMinMax dmin dmax MsgBox Cstr dmin amp amp CStr max End Sub 18 7 1 3 GetRealTimePeriod GetRealTimePeriod Period Retorna a unidade de tempo configurada na escala de tempo real O par metro Period recebe o valor da escala de tempo Exemplo Dim Unidade Valor Unidade Screen Item E3Chart1 Axes Item EixoHorizontal GetRealTimePeriod Valor MsgBox valor amp cstr valor amp Unidade amp cstr Unidade 18 7 1 4 GetTickSpacing GetTickSpacing TickSpacing TimeUnit Retorna o espa amento entre os ticks subdivis es da escala e a unidade configurada O par metro TickSpacing determina o espa amento entre os ticks e TimeUnit determina a unid
289. etro Open indica o di logo a ser aberto se True abre Abrir Arquivo se False abre Salvar O par metro FileName indica a vari vel onde ser armazenado o nome do arquivo a ser salvo ou carregado caso o m todo retorne True Este par metro deve ser obrigatoriamente uma vari vel O par metro Extension opcional e informa a extens o do arquivo padr o a ser anexada ao nome do arquivo na caixa de entrada quando a extens o n o for informada Caso esteja vazio nenhuma extens o ser concatenada ao final do nome do arquivo Extens es m ltiplas podem ser especificadas usando se o caractere de ponto e v rgula como delimitador Ostring deve terminar com b O par metro Flags opcional e define o comportamento da caixa de di logo um n mero inteiro soma dos valores da tabela a seguir O par metro Filter opcional e define um conjunto de pares de strings que especificam filtros que podem ser aplicados aos arquivos O primeiro string descreve o filtro e o segundo indica otipo de extens o a ser utilizada Combina es poss veis para o par metro Flags VALOR DESCRI O 1 CREATEPROMPT Se o usu rio especificar um arquivo que n o existe este flag faz com que ele seja questionado sobre a cria o do arquivo Se ele escolher criar o arquivo a caixa de di logo fechada e o nome do arquivo retornado no par metro Filename Caso contr rio a caixa de di logo permanece aberta 2 FILEMUSTEXIST Espec
290. eve ou n o coincidir com os itens existente na Lista de Sele o Se a propriedade estiver configurada para True o usu rio n o pode sair da Lista de Sele o at que o texto inserido coincida com um item existente do objeto Caso contr rio o texto inserido na Lista de Sele o pode ser diferente de todos os dados existente da mesma 7 3 4 3 32 MaxLensth 9 Apropriedade MaxLength determina o n mero m ximo de caracteres no objeto Configurando esta propriedade como 0 n o h limite de caractere no objeto 7 3 4 3 33 SelectionMargin Pl Habilita ou desabilita a margem de sele o do objeto Se esta propriedade estiver configurada para True o texto ser selecionado ao se clicar na margem do objeto Caso contr rio o texto n o ser selecionado ao se clicar na margem NOTA Se a propriedade SelectionMargin estiver configurada para True quando o objeto for impresso a margem de sele o tamb m ser impressa 7 3 4 3 34 SelLength 9 Retorna o n mero de caracteres selecionados no objeto Esta propriedade acess vel apenas em tempo de execu o 7 3 4 3 35 SelStart 9 Indica o ponto inicial do texto selecionado ou o ponto de inser o se nenhum texto for selecionado Esta propriedade acess vel apenas em tempo de execu o 7 3 4 3 36 SelText Retorna o texto selecionado no objeto Esta propriedade acess vel apenas em tempo de execu o ActiveX 205 7 3 4 3 37 ShowDropButtonWhen a A propriedade
291. evento MouseUp para especificar a es que ser o disparadas somente quando o bot o do mouse for solto Vari veis do evento MouseUp NOME DESCRI O Button Mostra o bot o do mouse pressionado e 1 0O bot o do mouse pressionado o esquerdo e 2 Obot o do mouse pressionado o direito ShiftState Mostra a tecla pressionada juntamente com o mouse e 4 Tecla SHIFT 132 Telas e Objetos de Tela NOME DESCRI O e 8 Tecla CTRL e 12 Teclas CTRL SHIFT MouseX Mostra a coordenada X onde o mouse foi clicado na Tela MouseY Mostra a coordenada Y onde o mouse foi clicado na Tela Exemplo Sub TelaInicial Mouseup Button Shiftstate MouseX Mousey Encerra a aplica o apenas quando o usu rio soltar o bot o application ExitO End Sub 6 1 1 7 OnHide OnHide Ocorre quando uma Tela est prestes a ser fechada Utilize o evento OnHide quando for necess rio efetuar alguma opera o antes do objeto Tela ser fechado Este evento pode ocorrer de diversas maneiras e Quando a Tela for substitu da por outra atrav s do m todo OpenScreen e Quando o usu rio fechar a janela onde est a Tela e Quando for chamado o m todo Close do objeto Tela e Quando o Viewer for fechado ou encerrado Exemplo Sub TelaInicial onHideO application ExitO End sub 6 1 1 8 OnPreShow OnPreShow Arg Ocorre antes da Tela ser mostrada Avari
292. exto digitado enviado pelo SetPoint este primeiro tentar converter o valor para o tipo configurado Word String Double etc Se a convers o n o for poss vel ou seja o valor digitado inv lido para o tipo escolhido nenhum valor enviado por exemplo se o usu rio digitar 1 e o tipo for Byte J quando o valor da propriedade for O stCurrentType o tipo do dado enviado pelo SetPoint ser extra do do valor anterior presente no objeto Caso o valor anterior seja Empty ou Null nenhuma convers o ser feita e o valor digitado ser enviado como texto Exemplo sub Ccombobox1 Change O oreen TrendTe tolp setRoirtoaTaType CInt Left value 2 End Su 6 2 7 2 9 StretchText P Redimensiona o tamanho do objeto A partir do momento em que a propriedade StretchText for habilitada o objeto automaticamente redimensiona o tamanho da fonte do texto para que a rea ocupada por ele continue sempre a mesma De outra forma se a propriedade StretchText estiver configurada para False nenhum redimensionamento ser efetuado 6 2 7 2 10 TextAlignment aP Esta propriedade especifica o alinhamento horizontal do texto mostrado no objeto Op es dispon veis para TextAlignment OP O DESCRI O 0 LeftAlignment Oalinhamento horizontal do texto ser esquerda 1 CenterAlignment Oalinhamento horizontal do texto ser centralizado 162 Telas e Objetos de Tela OP O D
293. gnmentCenter Alinha o texto ao centro e 2 HorizontalAlignmentRight Alinha o texto direita Ovalor padr o desta propriedade 1 HorizontalAlignmentCenter 7 4 4 2 3 BackgroundColorO E Define a cor de fundo do bot o quando n o est pressionado O valor padr o desta propriedade cinza RGB 192 192 192 7 4 4 2 4 BackgroundColor1 E Define a cor de fundo do bot o quando est pressionado O valor padr o desta propriedade cinza RGB 192 192 192 7 4 4 2 5 Bitmap0 4 Define a imagem do bot o quando n o est pressionado O valor padr o desta propriedade vazio 7 4 4 2 6 Bitmap1 4d Define a imagem do bot o quando est pressionado O valor padr o desta propriedade vazio 7 4 4 2 7 TextO Define o texto do bot o quando n o est pressionado O valor padr o desta propriedade DESLIGADO 252 ActiveX 7 4 4 2 8 Text Define o texto do bot o quando est pressionado O valor padr o desta propriedade LIGADO 7 4 4 2 9 TextColor0 E Define a cor do texto do bot o quando n o est pressionado O valor padr o desta propriedade preto RGB 0 0 0 7 4 4 2 10 TextColor1 E Define a cor do texto do bot o quando est pressionado O valor padr o desta propriedade preto RGB O 0 0 7 4 4 2 11 TextFontO A A propriedade TextFont0 utilizada para determinar a fonte do bot o quando n o est pressionado Esta propriedade n o pode ser utilizada
294. gt o nome do objeto e lt propriedade gt a propriedade desejada Exemplo Programando no E3 39 Application Getobject Dados TempTanque2 Type Para facilitar a digita o aconselh vel sempre utilizar o AppBrowser que j traza sintaxe correta 2 4 1 1 Propriedade Value No E3 muitos objetos possuem uma propriedade em comum chamada Value Neste caso espec fico pode se acessar esta propriedade utilizando se o pr prio nome do objeto Buttonl False que equivalente a Buttonl value False 2 4 2 M todos Asintaxe a seguir exemplifica a chamada de um m todo que n o precisa de par metros aApplication Getobject lt objeto gt lt metodo gt onde lt objeto gt o objeto em quest o e lt metodo gt o m todo desejado Se o m todo aceita par metros use a sintaxe a seguir Application Getobject lt objeto gt lt metodo gt lt parametro gt onde lt parametro gt o par metro a ser passado para o m todo Quando houver mais de um par metro utilize v rgulas para separ los Se o m todo retorna um resultado e for desej vel guard lo ent o os par metros devem ser colocados obrigatoriamente entre par nteses lt v gt Application Getobject lt objeto gt lt metodo gt lt parametro gt onde lt V gt a vari vel que ir receber o resultado do m todo 2 5 Trabalhando com Cole es Uma cole o ou collection um objeto que gerencia um conjunto de obje
295. hVolume D Exemplo Projeto projeto prj 9 RefreshTime 0 5 A ScaleFont Arial PI ShowBackground False PI ShowBottomScale True P ShowGridBackGround True Ed Op es dispon veis na Lista de Propriedades Exemplo Sub Telal Click Layer 1 End Sub Telas e Objetos de Tela 139 6 1 3 10 MouseOver Fi A propriedade MouseOver informa se o ponteiro do mouse encontra se em cima da tela Caso afirmativo a propriedade MouseOver habilitada do contr rio ser False Esta propriedade somente de leitura e acess vel apenas em tempo de execu o O valor padr o desta propriedade False 6 1 3 11 MouseOverChild Fi A propriedade MouseOverChild informa se o ponteiro do mouse encontra se em cima de um dos objetos inseridos na Tela Caso afirmativo a propriedade MouseOverChild habilitada Caso contr rio ser False Esta propriedade somente para leitura e acess vel apenas em tempo de execu o O valor padr o desta propriedade False 6 1 3 12 PictureFile 4 Cont m o nome do arquivo da figura que ser utilizada como fundo na Tela Pode ser qualquer formato j suportado no E3 pelo objeto DrawPicture bmp gif jpg cur ico emf wmf O valor padr o desta propriedade uma String em branco Esta propriedade s ser v lida se a propriedade FillStyle estiver selecionada como 12 bkPicture 6 1 3 13 PicturePosition P Indica a posi o da figura selecionada na propriedade Pic
296. i lt 31 Application Item _top _ HorizontalPercentFill i 30 100 Frame Refresh True lt alguma opera o demorada gt i i l wend End sub 10 4 1 9 RestoreFrame RestoreFrame Permite restaurar a janela do quadro para o seu tamanho original Exemplo Sub CommandButtonl clickO Application Item top RestoreFrame End sub 10 4 1 10 SetForegroundWnd SetForegroundWnd O m todo SetForegroundWnd ativa e d o foco para a janela do Viewer Este m todo til quando se deseja chamar a aten o do operador para algum evento ocorrido quando a janela do Viewer encontra se escondida ou minimizada Exemplo Sub CommandButton1 clickO Application Item top setForegroundwynd O End Sub 10 4 1 11 SetFrameOptions SetFrameOptions Title Flags Utilizado para configurar o t tulo do frame na janela e o estilo da janela O par metro Title um String que cont m o t tulo da janela Este texto ser mostrado se a propriedade Caption da Tela estiver vazia O par metro Flags especifica o estilo da janela Se este par metro for omitido o valor padr o ser 1 Este valor usado para manter a configura o anterior da janela Quando o valor especificado n o for 1 pode se modificar o estilo da janela especificando a soma dos valores das seguintes combina es Viewer 325 Combina es poss veis para o par metro Flags
297. i eventos associados 18 6 1 M todos Esta se o cont m informa es sobre os m todos do objeto Cole o de Eixos 18 6 1 1 AddAxis AddAxis AxisName Adiciona um novo eixo com o nome determinado no par metro AxisName e retorna o eixo criado Caso se tente criar um eixo com um nome que j existe ser mostrada uma mensagem de erro Querendo se que o nome seja gerado automaticamente deve se passar o par metro AxisName em branco Exemplo Sub CommandButton1 clickQO Set Chart Screen Item E3Chart1 Set newaxis Chart Axes Addaxis newaxis Color RGB 255 0 0 End sub 18 6 1 2 Remove Remove Index Remove o eixo atrav s de seu nome ou ndice conforme especificado no par metro Index Os eixos principais 0 e 1 n o podem ser removidos Caso se tente remov los aparecer uma mensagem de erro Exemplos Sub CommandButtonl clickQO Este exemplo remove todos os eixos adicionais 442 E3Chart Set Chart Screen Item E3Chart while Chart Axes Count gt 2 Chart axes Remove 2 wend End sub Sub CommandButton1 clickQO Remove um eixo adicional se existir Set Chart Screen Item E3Chart1 Chart Axes Remove 2 End sub 18 6 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Cole o de Eixos 18 6 2 1 Count 9 Retorna o n mero total de eixos do E3Chart incluindo os dois eixos principais horizontal e vertical Exemplo CommandButtonl Click
298. iados blocos contendo quatro registros cada um para o DBServer associado O valor padr o desta propriedade 10 NOTA O bloco de registros enviado a cada 1 segundo mesmo que n o tenha atingido o tamanho configurado na propriedade CacheSize 15 2 4 CompressionRate 9 Mostra a taxa de compress o de dados obtida at o momento 15 2 5 DBServer Indica o objeto Banco de Dados utilizado no Storage para cria o de tabelas e registros de dados O valor padr o desta propriedade vazio 382 Storage 15 2 6 DiscardInterval 9 Esta propriedade trabalha em conjunto com a propriedade DiscardTimeUnit A propriedade Discardinterval indica o intervalo de tempo durante o qual os dados do Hist rico ficar o armazenados na tabela do banco de dados at serem descartados Ovalor padr o desta propriedade 1 uma unidade de tempo indicada em DiscardTimeUnit Se esta propriedade for configurada com um valor menor ou igual ao valor da propriedade BackupDiscardInterval o E3 automaticamente ajusta o valor de BackupDiscardinterval como o dobro do valor de DiscardiInterval Esta propriedade pode ser modificada em tempo de execu o 15 2 7 DiscardTimeUnit aP Esta propriedade trabalha em conjunto com a propriedade DiscardInterval A propriedade DiscardTimeUnit indica a unidade de tempo em que os dados ficar o armazenados at serem descartados As op es dispon veis s o 0 dtHour horas 1 dtDay dias e 2 dtMonth meses pa
299. ica es que est o rodando localmente esta propriedade pode ficar em branco padr o Caso contr rio ser necess rio especificar o caminho por exemplo WNomesServidor Esta propriedade s pode ser modificada quando o driver OPC estiver desconectado Exemplo Sub CommandButton1 clickQO Set opc application Getobject Driveropc1 opc Deactivate opc ServerId ElipsesCADA OPCsvr 1 opc ServerMachine server2 opc activate End sub 3 5 2 5 ServerName A A propriedade ServerName retorna o nome ou a descri o do servidor OPC Esta propriedade diferente da propriedade ServerlD que um c digo Exemplo Sub Driver OPC1 Afterstart MsgBOX _ Application Getobject Driveropcl Grupoopc1 serverName End sub Drivers 87 3 5 2 6 ServerStatus P Determina o estado da conex o com o servidor OPC As op es dispon veis s o as seguintes Op es dispon veis para ServerStatus OP O DESCRI O 1 ServerStatus Unknown O Driver OPC est conectado ao servidor OPC mas o estado n o informado ou o cliente OPC possui a propriedade ReconnectPeriod em 0 0 ServerStatus NoConnected O Driver OPC n o est conectado ao servidor OPC Isso acontece quando por exemplo o Driver OPC n o est ativo ou a conex o n o foi estabelecida por algum problema qualquer Os valores a seguir s o informados apenas quando a propriedade ReconnectPeriod diferente d
300. ica o neste caso somente as propriedades Quality e TimeStamp ser o atualizadas de acordo com o tempo de varredura definido em Scan Outra forma de utilizar esta propriedade para escrever valores no equipamento ou no dispositivo bastando para isto atribuir um novo valor propriedade Value ou a algum dos bits BitOO at Bit31 Neste caso a propriedade AllowWrite deve estar configurada para True Esta tamb m a propriedade padr o do objeto Tag de Comunica o Sendo assim uma refer ncia por valor a um Tag de Comunica o n o necessita obrigatoriamente explicitar a propriedade Value para acessar o valor Ovalor padr o desta propriedade vazio sem valor Exemplo Sub Botaol Click Acessa um tag e mostra o valor atual tagl um objeto tipo Tag de Comunica o Set ia Application Getobject Driver de Comunica ol tagl MsgBox valor atual de tagl amp obj Value Isto tamb m pode ser feito de outra forma sem mostrar a propriedade Value que o padr o MsgBox valor atual de tagl amp obj End Sub 72 Drivers NOTA Os valores dos bits Propriedades Bit00 at Bit31 n o s o afetados pelo ajuste de escala Isto representam os bits do valor lido do equipamento antes da convers o 3 3 Bloco de Comunica o Esta se o cont m informa es sobre eventos m todos e propriedades do objeto Bloco de Comunica o 3 3 1 Eventos Esta se o cont m informa es sobre os eventos
301. icar o caminho e o nome do arquivo que cont m a figura Para remover a figura clique no valor da propriedade Picture e pressione a tecla DEL Atecla BACKSPACE tecla de espa o do teclado n o remove a figura 7 3 5 2 8 PicturePosition aP A propriedade PicturePosition especifica a posi o da figura atribu da ao objeto em rela o a sua legenda As op es dispon veis para esta propriedades s o as seguintes Op es dispon veis para PicturePosition OP O DESCRI O O fmPicturePositionLeftTop Afigura aparece esquerda de sua legenda Alegenda alinhada com a parte superior da figura 1 fmPicturePositionLeftCenter Afigura aparece esquerda da legenda Alegenda centralizada relativamente imagem 2 fmPicturePositionLeftBottom Afigura aparece esquerda da legenda Alegenda alinhada coma parte inferior da figura 3 fmPicturePositionRightTop Afigura aparece direita da legenda A legenda alinhada coma parte superior da figura 210 ActiveX OP O DESCRI O 4 fmPicturePositionRightCenter Afigura aparece direita da legenda A legenda centralizada relativamente figura 5 fmPicturePositionRightBottom Afigura aparece direita da legenda A legenda alinhada coma parte inferior da figura 6 fmPicturePositionAboveLeft Afigura aparece acima da legenda A legenda alinhada com a extremidade
302. ication representa a aplica o como um todo e o m todo GetObject procura no Dom nio carregado no Studio por um objeto de servidor com o caminho fornecido Exemplo o evento CustomConfig disparado no Studio Sub xControl1 CustomConfig Appl ication GetObject Dados TagDemo1 DocString Documenta o End Su 2 3 3 Acessando Propriedades do Servidor de dentro do Servidor Caso seja necess rio acessar as propriedades de um Tag a partir de outro origem e destino est o no servidor ligados via um m dulo pai que Driver1 Nesta situa o deve ser usada a declara o Parent Isto faz com que seja acessado primeiro o objeto pai onde est o script para depois descer se na hierarquia em busca de outro elemento Organizer Dom nio Projeto E Configura o amp 5 Bibliotecas de Objetos m Visualiza o Objetos de Servidor Drivers e OPC e Tagi Tag hi Objetos de Dados UJ Banco de Dados Pa Names E Explorer DE E Driver1 o objeto pai de Tag1 e de Tag2 Exemplo Sub Tagl onRead Parent Item Tag2 AllTowread False End sub Programando no E3 27 Estando se dentro de um grupo e desejando se acessar o mesmo Tag2 pode se aninhar v rios comandos Parent Organizer E i Drivers e OPC EM Diverl RR od E T Objetos de Dados UJ Banco de Dados m Explorer Pasta1 o objeto pai de
303. icial do cursor InicioY Mostra o ponto interpolado onde o cursor inicial cruza a pena MaximoY Mostra o valor m ximo da pena no intervalo MediaY Mostra o valor m dio da pena no intervalo E3Chart 453 OP O DESCRI O MinimoY Mostra o valor m nimo da pena no intervalo Nome da pena Mostra o nome da pena Nome do tag X Mostra o nome do tagX associado pena Nome do tag Y Mostra o nome do tagY associado pena Unidade Mostra a unidade associada pena Valor do tag X Mostra o valor do tagX associado pena Este valor mostrado quando o gr fico est no modo de Pesquisa Valor do tag Y Mostra o valor do tagY associado pena Este valor mostrado quando o gr fico est no modo de Pesquisa 18 9 1 1 ChangeColumnPos ChangeColumnPos Source Dest Troca a posi o entre duas colunas Possui os seguintes par metros e Source ndice da coluna que ser movida para Dest e Dest ndice da coluna que ser movida para Source Exemplo Sub CommandButtonl clickQO Screen Item E3Chart1 Legend ChangecolumnPos 1 2 End sub 18 9 1 2 Count Count Retorna o n mero de colunas da legenda Exemplo Sub CommandButtonl Click MsgBox screen Item E3Chart1 Legend CountO End Su 454 E3Chart 18 9 1 3 InsertColumn InsertColumn Col Index Insere uma nova coluna na legenda Este m todo possui os segui
304. ido Utilize caracteres completos ASCII 14 ddbcMSI Estilo de c digo de barras C digo MSI Utilize somente n meros 15 ddbcPostNet Estilo de c digo de barras PostNet Utilize somente n meros com uma verifica o digital 16 ddbcCodabar Estilo de c digo de barras Utilize A B C D ou n meros 17 ddbcEAN 8 Estilo de c digo de barras EAN 8 Utilize somente n meros 7 n meros e verifica o digital 18 ddbcEAN 13 Estilo de c digo de barras EAN 13 Utilize somente n meros 12 n meros e verifica o digital 19 ddbcUPC A Estilo de c digo de barras UPC A Utilize somente n meros 11 n meros e verifica o digital 20 ddbcUPC EO Estilo de c digo de barras UPC E1 Utilize somente n meros Usado para s mbolos de compress o zero UPC Na propriedade Caption pode se entrar com 6 d gitos do c digo UPC E ou com 11 d gitos Se um c digo com 11 d gitos inserido o c digo de barras converte para 6 d gitos UPC E se poss vel Sen o converte se de 11 para 6 d gitos UPC Ee nada mostrado 21 ddbcUPC E1 Estilo de c digo de barras UPC E1 Utilize somente n meros Alargura da entrada de dados do UPC E1 de 6 caracteres num ricos Relat rios 501 OP O DESCRI O 22 ddbcRM4SCC Estilo de c digo de barras Royal Mail RM4SCC Utilize somente letras e n meros com verifica o dig
305. iedade maior a largura da barra do c digo de barras O valor padr o desta propriedade 1 22 6 2 1 3 Caption Cont m o texto do objeto propriamente dito O valor padr o desta propriedade vazio 22 6 2 1 4 CaptionPosition aP Especifica a posi o do texto da propriedade Caption no objeto As op es dispon veis para esta propriedade s o as seguintes e 0 ddbcCaptionNone o texto da propriedade Caption n o aparece no c digo de barras e 1 ddbcCaptionAbove o texto da propriedade Caption aparece acima do c digo de barras e 2 ddbcCaptionBelow o texto da propriedade Caption aparece abaixo do c digo de barras Ovalor padr o desta propriedade O ddbcCaptionNone 22 6 2 1 5 DataField A Configura ou retorna o dado associado ao objeto Este dado associado pode ser um campo da tabela no Banco de Dados fornecido pelo objeto Consulta uma express o matem tica com campos da Consulta e fun es do VBScript neste caso o campo deve ser precedido do s mbolo de igual ou um tag ou propriedade do E3 Neste caso o valor atual da vari vel ser mostrado ao realizar a impress o O valor padr o desta propriedade vazio NOTA O servidor deve estar sendo executado para que o valor da vari vel possa ser capturado 498 Relat rios 22 6 2 1 6 Direction P Determina a orienta o espacial dos c digos de barra As op es dispon veis nesta propriedade s o as seguintes Op es dispon veis para Direct
306. iedade Mouselcon atribui uma imagem ao ponteiro do mouse quando este movido sobre o objeto Esta propriedade v lida somente quando a propriedade MousePointer definida como 99 fnMousePointerCustom Um arquivo com imagem pode ser selecionado para o ponteiro do mouse de duas formas atrav s da Lista de Propriedades extens es cur ou ico ou via scripts utilizando se a fun o LoadPicture para especificar o caminho e o nome do arquivo que cont m o cone personalizado somente extens o cur Exemplo sub CommandButtonl Click F A atribuindo o item 99 fmMousePointercustom propriedade para que ela aceite a customiza o do cone do mouse screen Item checkBox1 mousePointer 99 screen Item checkBox1 MouseIcon LoadPicture c ha cur End sub 7 3 2 5 MousePointer ap Apropriedade MousePointer especifica o tipo de ponteiro do mouse que mostrado quando o usu rio posiciona o mesmo sobre um objeto As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para MousePointer OP O DESCRI O 0 fmMousePointerDefault Ponteiro padr o Aimagem determinada pelo objeto 1 fmMousePointerArrow Seta 2 fmMousePointerCross Ponteiro em forma de cruz 3 fmMousePointerBeam Em forma de 6 fnMousePointerSize Nesw Seta dupla apontando para nordeste e sudoeste ActiveX 187 OP O DESCRI
307. iedade do tag com a sintaxe Tag DocString Succeeded Um valor Booleano que indica o sucesso da escrita True sucesso False falha User Texto que retorna o usu rio que feza escrita 3 1 2 M todos Esta se o cont m informa es sobre os m todos do objeto Driver de Comunica o 3 1 2 1 Write Write N1 N2 N3 N4 Value WriteSyncMode Faza escrita s ncrona de um dado no equipamento Este m todo retorna um booleano que indica o sucesso ou n o da opera o Os par metros N1 a N4 correspondem aos par metros N do driver O par metro Value define o valor a ser escrito no driver O par metro WriteSyncMode permite utilizar o modo de escrita diferente do utilizado no driver As op es dispon veis para este par metro s o 0 usa o modo de escrita configurado no driver 1 faz uma escrita s ncrona 2 faz uma escrita ass ncrona sem confirma o Se o par metro for omitido ser tamb m utilizado o modo de escrita configurado no driver Para maiores detalhes sobre estes par metros consulte a documenta o do driver Exemplo 56 Drivers Sub Botaol click Dim val Quando clica no bot o faz uma escrita no driver Set driver application Getobject Driver1 driver write 4 5 1 0 55 5 Faz a escrita do valor 55 5 End sub 3 1 2 2 WriteEx Write Ex N1 N2 N3 N4 Value Timestamp Quality WriteStatus WriteSyncMode Faza escrita de um dado no equipament
308. iedades do objeto Linha do Relat rio 22 6 7 1 1 LineColor Ma propriedade LineColor especifica a cor da linha do objeto O valor padr o desta propriedade preto RGB O 0 0 22 6 7 1 2 LineStyle sta propriedade determina o estilo da linha do objeto O valor padr o desta P E iedade d i ilo da linha do obj Oval dr od propriedade 1 ddLSSolid As outras op es dispon veis desta propriedade s o as seguintes Op es dispon veis para LineStyle OP O DESCRI O O ddLSTransparent Alinha fica transparente no objeto 1 ddLSSolid Alinha aparece s lida no objeto 2 ddLSDash Alinha fica tracejada no objeto 3 ddLSDot Alinha fica pontilhada no objeto 4 ddLSDashDot Alinha fica tracejada e pontilhada no objeto 5 ddLSDashDotDot Alinha fica pontilhada tracejada e pontilhada no objeto Relat rios 515 22 6 7 1 3 LineWeight 9 Apropriedade LineWeight especifica a largura da linha do objeto Configurando a lagura para 1 a linha do objeto expandida em at 15 pontos se a largura for 2 a linha do objeto expandida em at 30 pontos e assim por diante Quanto maior o n mero configurado na propriedade maior a largura do objeto O valor padr o desta propriedade 1 22 6 7 1 4 X1 9 Apropriedade X1 habilita ou desabilita a posi o do ponto inicial da linha no eixo X 22 6 7 1 5 X2 9 A propriedade X2 determina a posi o do ponto final da li
309. ield informam os campos da tabela a serem usados A propriedade QueryName indica o nome da tabela usada Quando DataSourceType for igual a 2 Pena Mista as op es 0 e 1 funcionar o simultaneamente para a pena NOTA Em tempo de execu o quando a propriedade for alterada e a pena deixar de mostrar os dados de tempo real ser preciso chamar o m todo Connect para que estes dados sejam mostrados novamente E3Chart 435 Exemplo Sub CommandButtonl clickQO Set E3Chartl Screen Item E3Chart1 MsgBox clique OK para criar a pena set Pen E3Chart1 Pens AddPen Pen1 Pen DataSourceType 0 Tempo real Pen yLink Dados TagDemo1 Pen UseTimeStamp True Em X usa o timestamp Pen Color RGB 255 0 0 Pen Docstring Teste MsgBox clique OK para conectar Pere COELO Come a a receber os dados MsgBox Clique OK para enquadrar E3Chart1 FitPen 0 MsgBox Clique OK para remover a pena E3Chart1 Pens Remove Pen Name End sub 18 5 2 7 DigitalData F Determina o estilo de plotagem digital Se a propriedade estiver configurada para True o estilo de plotagem digital assume que a varia o do dado seja de forma digital ou seja que seu valor em rela o ao ltimo variou instantaneamente Caso contr rio a varia o considerada linear e os pontos s o unidos por um segmento de reta O valor padr o desta propriedade True Exemplo Sub CommandButtonl Click set Pen1 Screen Item E3Chart1 Pens It
310. ifica a cor do preenchimento do fundo do objeto Nos scripts utilize a fun o do VBScript RGB para formar a cor a ser associada a esta propriedade O valor padr o desta propriedade preto RGB O 0 0 22 6 4 1 3 hyperLink A Especifica o link atribu do ao texto Para utilizar este recurso use o evento OnHyperLink O valor padr o desta propriedade vazio 22 6 4 1 4 LineColor a Especifica a cor da linha do objeto O valor padr o desta propriedade preto RGB 0 0 0 504 Relat rios 22 6 4 1 5 LineStyle P Determina o estilo da linha do objeto As op es dispon veis desta propriedade s o as seguintes Op es dispon veis para LineStyle OP O DESCRI O O ddLSTransparent Alinha fica transparente no objeto 1 ddLSSolid Alinha aparece s lida no objeto 2 ddLSDash Alinha fica tracejada no objeto 3 ddLSDot inha fica pontilhada no objeto 4 ddLSDashDot A inha fica tracejada e pontilhada no objeto 5 ddLSDashDotDot A inha fica pontilhada tracejada e pontilhada no objeto Ovalor padr o desta propriedade 1 ddLSSolid 22 6 4 1 6 LineWeight 9 Especifica a largura da linha do objeto Configurando a lagura para 1 a linha do objeto expandida em at 15 ponto e assim por diante Quanto maior o n mero configurado na propriedade maior a largura do objeto O valor padr o desta propriedade 1 22 6 4 1 7 Picture
311. ifica que o usu rio s pode digitar nomes de arquivos existentes Caso contr rio a caixa de di logo mostra um aviso na caixa de mensagens 4 NOCHANGEDIR Recupera o diret rio atual para o valor original caso o usu rio tenha mudado de diret rio enquanto buscava o arquivo N o tem efeito para Abrir Arquivo no Windows XP 8 NODEREFERENCELINKS Configura a caixa de di logo para retornar o arquivo de atalho Ink selecionado Se este flag n o for especificado a caixa de di logo retorna o caminho e nome de arquivo referenciados pelo shortcut 16 NOREADONLYRETURN Determina que o arquivo retornado n o seja somente para leitura e o diret rio n o protegido contra Viewer 311 VALOR DESCRI O grava o 32 PATHMUSTEXIST Especifica que o usu rio pode informar apenas arquivos e diret rios v lidos caso contr rio uma caixa de mensagem mostrada para avisar o usu rio 64 READONLY Faz o bot o de op o Somente Leitura ser selecionado inicialmente quando o di logo criado 128 OVERWRITEPROMPT Faza caixa de di logo de Salvar Como gerar uma mensagem informando da exist ncia do arquivo e pede confirma o para sobrescrever o arquivo Exemplo de filtro arquivos de Chart xlc xlc Planilhas Excel x1s xIs Arquivos de Dados xlc xls xlc xlslTodos os arquivos C De 10 2 28 ShowPickColor
312. ign OP O DESCRI O 0 taLeft Alinhamento esquerdo 458 E3Chart OP O DESCRI O 1 taRight Alinhamento direito 2 taCenter Alinhamento centralizado Exemplo Sub commandButton1l click Set col Screen Item E3chart1 Legend Item 1 col Textalign 2 End sub 18 10 1 7 Width 9 Retorna a largura da coluna Exemplo Sub commandButton1l click Set col Screen Item E3cChart1 Legend Item 1 col width 50 End sub E3Chart 459 CAP TULO E3Playback Esta se o cont m informa es sobre m todos e propriedades do objeto E3Playback Este objeto n o possui eventos associados 19 1 M todos Esta se o cont m informa es sobre os m todos do objeto E3Playback 19 1 1 Pause Pause Congela o rel gio de playback no tempo atual Exemplo sub CommandButton1 Click screen Item E3Playback1 Pause End sub 19 1 2 Play Play Inicia a reprodu o dos dados no hor rio atual de playback avan ando o rel gio de acordo com a velocidade de reprodu o atual Exemplo Sub CommandButtonl click screen Item E3Playback1 Play End sub 19 1 3 Stop Stop Interrompe o playback os dados de tags e alarmes s o removidos das telas e nenhuma nova consulta feita ao banco de dados Exemplo sub CommandButton1 click O screen Item E3Playback1 stop End sub
313. igura 6 fmPicturePositionAboveLeft Afigura aparece acima da legenda A legenda alinhada com a extremidade esquerda da figura 7 fmPicturePositionAboveCenter Afigura aparece acima da legenda A legenda centralizada abaixo da figura padr o 8 fmPicturePositionAboveRight Afigura aparece acima da legenda A legenda alinhada com a extremidade direita da figura 228 ActiveX OP O DESCRI O 9 fmPicturePositionBelowLeft Afigura aparece abaixo da legenda A legenda alinhada com a extremidade esquerda da figura 10 fmPicturePositionBelowCenter Afigura aparece abaixo da legenda A legenda centralizada acima da figura 11 fmPicturePositionBelowRight Afigura aparece abaixo da legenda A legenda alinhada com a extremidade direita da figura 7 3 8 2 11 SpecialEffect aP A propriedade SpecialEffect especifica a apar ncia de um objeto Esta propriedade acess vel apenas em tempo de execu o As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para SpecialEffect OP O DESCRI O O fmSpecialEffectFlat O obi eto aparece plano e possui um destaque na borda uma altera o de cor ou ambos 1 fmSpecialEffectRaised O objeto possui um destaque na parte superior esquerda e uma sombra na parte inferior direita Oobjeto parece estar em relevo
314. ilitar ou O para n o habilitar Os par metros lt zoom gt e lt barra de rolagem gt s o v lidos apenas se o link indicado se tratar de uma Tela Caso contr rio ser o ignorados Se o par metro lt Z0om gt n o for informado assumido 100 Se o par metro lt barra de rol agem gt n o for informado assumido 1 ou seja habilitado Exemplo Sub CommandButton1 clickQO Application GetFrame Divisor1 splitLink Telal 1071 End Sub 278 Quadros e Divisores 8 2 5 SplitResizable PI Determina se o divisor mandante pode ser redimensionado em tempo de execu o Esta propriedade n o tem efeito no divisor restante O valor padr o desta propriedade True 8 2 6 SplitValue 9 Apropriedade SplitValue determina o valor que ser atribu do ao divisor do quadro que tanto pode ser percentagem hm HIMETRIC ou px pixels Se a unidade for omitida o valor ser considerado em HIMETRIC Exemplo Sub Divisorl Click Splitvalue 10 End sub 8 3 Propriedades do Quadro Esta se o cont m informa es sobre as propriedades do objeto Quadro 8 3 1 Caption A A propriedade Caption define o t tulo da Quadro a ser mostrado na barra de t tulo no Viewer Quadros e Divisores 279 CAP TULO Associa es Links Conex es ou Associa es s o liga es feitas entre objetos dos aplicativos e de seus m dulos A propriedade Links uma cole es de links do objeto Para maiores informa es veja o Manua
315. impedir que o usu rio digite um string num SetPoint Verifique se o valor digitado num rico no evento Validate Por exemplo Sub Text1 Validate Cancel Newvalue If NOT IsNumeric newvalue Then MsgBox The value must be numeric Cancel True End If End sub Como abrir um calend rio para selecionar uma data e hora ao clicar num SetPoint Usando o m todo ShowDatePicker no evento Click do SetPoint Por exemplo D vidas Mais Frequentes 519 Sub Text1l Click Dim datevalue If application showDatePicker datevalue Then value datevalue End If End sub Como reconhecer todos os alarmes de uma rea Para reconhecer todos os alarmes de uma rea por script poss vel utilizar o m todo Application GetObject ServidorAlarmes1 AckArea area user onde e Area o nome da rea de alarmes da qual se quer reconhecer o alarme e User onome do operador logado que pode ser o item Application User Para reconhecer todos os alarmes ativos poss vel utilizar o m todo Application GetObject ServidorAlarmes1 AckAlIIAlarms user Como executar uma a o ao clicar numa tecla espec fica do mouse ou do teclado Usando os eventos KeyDown ou KeyUp da tela Estes eventos s o disparados quando uma tecla pressionada ou solta e retornam dois par metros Um o c digo em ASCII da tecla que foi pressionada o outro indica a condi o das teclas SHIFT e CTRL no momento em que a tecla foi pressionada Aideia c
316. indo do canto inferior direito 17 SpotSouthWest Degrad com cor de frente partindo do canto inferior esquerdo 18 SpotNorthWest Degrad com cor de frente partindo do canto superior esquerdo 19 SpotNorthEast Degrad com cor de frente partindo do canto superior direito 20 SpotFromCenter Degrad com cor de fundo do centro para as bordas 21 SpotToCenter Degrad com cor de fundo das bordas para o centro 6 1 3 7 HasFocus P Esta propriedade determina que o objeto selecionado est com o foco Esta propriedade acess vel apenas em tempo de execu o 6 1 3 8 Height 9 A propriedade Height define a altura da Tela em unidades Himetric 138 Telas e Objetos de Tela 6 1 3 9 Layer 9 Esta propriedade define em quais camadas o objeto deve aparecer Ovalor representa uma m scara de 32 bits um bit para cada camada Portanto podem ser definidas at 32 camadas individuais Assim objetos podem ser agrupados logicamente e mostrados ou escondidos apenas com a modifica o da m scara da propriedade Layer E3Chart1 E3Chart Propriedades Jp 2gac 2 9 HorMinorTicks 0 HorScaleBegin EF 3 6 2009 09 59 29 HorScaleEnd EF 3 6 2009 10 00 29 A HorScaleFormat 9 tons 0 ye 1 v Camada P MouseMode 3 MouseModeSearch c A Name E3Chart Todas as Camadas 9 Padding 10 Nenhuma Camada A PathContainer Telalnicial A PathName Telalnicial E3Chart 1 A Pat
317. io coloca o ponteiro do mouse sobre o objeto 18 3 44 Title Determina o t tulo principal do E3Chart Para que o t tulo apare a no E3Chart a propriedade ShowfTitle deve ser configurada para True E3Chart 425 18 3 45 TitleFont Determina a fonte do t tulo principal do E3Chart Exemplo Sub CommandButton1 click Set E3Chartl Screen Item E3Chart1 E3Chartl Title Teste E3Chartl SshowTitle True MsgBox Troca fonte E3Chartl Titleront Times New Roman MsgBox Troca tamanho E3Chartl Titleront size 20 End sub 18 3 46 VerAxisTitle Determina o t tulo do eixo vertical principal Exemplo Sub ComboBox1 Change EM Screen Item E3Chart1 veraxisTitle Titulol End sub 18 3 47 VerGrid a Determina otipo de linha que ser aplicada na grade vertical do E3Chart Op es dispon veis para VerGrid OP O DESCRI O 0 Solid Aplica uma linha s lida na grade vertical do E3Chart 1 Dash Aplica uma linha tracejada na grade vertical do E3Chart 2 Dot Aplica uma linha pontilhada na grade vertical do E3Chart padr o 3 Dashdot Aplica uma linha tra o e ponto na grade vertical do E3Chart 4 Dashdotdot Aplica uma linha tra o ponto ponto na grade vertical do E3Chart 5 Invisible Aplica uma linha invis vel na grade vertical do E3Chart Exemplo Sub E3Chart1 OnsStartRunning O vergrid 2 End sub
318. ion OP O DESCRI O 0 ddbcLeftToRight O c digo de barras direcionado da esquerda para a direita 1 ddbcRightToLeft O c digo de barras direcionado da direita para a esquerda 2 ddbcTopToBottom O c digo de barras direcionado de baixo para cima 3 ddbcBottomToTop O c digo de barras direcionado de cima para baixo Ovalor padr o desta propriedade 0 ddbcLeftToRight 22 6 2 1 7 EnableCheckSum P Habilita ou desabilita a leitura do valor de CheckSum Caractere de objeto do c digo de barras Se a propriedade estiver habilitada para False somente c digos com CheckSum ser o afetados 22 6 2 1 8 Font Determina a fonte do objeto no texto estabelecido pela propriedade Caption O valor padr o desta propriedade Arial NOTA Esta propriedade n o usada em scripts ou em associa es sendo editada somente via E3 Studio Relat rios 499 22 6 2 1 9 Forecolor E Especifica a cor de preenchimento de frente do objeto Nos scripts utilize a fun o do VBScript RGB para montar a cor a ser associada a esta propriedade O valor padr o desta propriedade preto RGB 0 0 0 22 6 2 1 10 Style P Determina o estilo do c digo de barras As op es dispon veis s o as seguintes Op es dispon veis para Style OP O DESCRI O 0 ddbcNone Estilo de c digo de barras padr o 1 ddbcAnsi39 Estilo de c digo de b
319. ion 1 End sub 176 Telas e Objetos de Tela CAP TULO ActiveX Esta se o cont m informa es sobre eventos m todos e propriedades de objetos ActiveX 7 1 M todos Comuns Esta se o cont m informa es sobre os m todos comuns aos objetos ActiveX 7 1 1 BringToFront BringToFront Faz com que o objeto se posicione frente de todos os outros objetos da tela Exemplo Sub Botaol click Ao clicar em Botaol o sistema traz o objeto Retangulol para a frente screen Item Retangulol BringToFront O End sub 7 1 2 SendToBack SendToBack Fazcom que o objeto se posicione atr s de todos os outros objetos da tela Exemplo Sub Botao Click Ao clicar em Botao2 o sistema Jeva o objeto Retangulol para tr s Screen Item Retangulo1 sendToBack End sub 7 1 3 SetFocus SetFocus Utilize o m todo SetFocus para mover o foco do mouse ou do teclado para um objeto determinado Exemplo Sub screeni onshow Ao abrir a tela move o foco para o Botaol ActiveX 177 Item Botao1 SetFocus End sub 7 2 Propriedades Comuns Esta se o cont m informa es sobre as propriedades comuns aos objetos ActiveX 7 2 1 Enabled P Habilita ou desabilita o acesso via teclado ou mouse Esta propriedade afeta apenas os objetos que permitem entrada via teclado ou mouse 7 2 2 Frame 58 Retorna o quadro pai do objeto Esta propriedade acess vel apenas em tempo de execu o 7
320. isualizar a convers o Caso contr rio n o ser poss vel visualizar a convers o O campo s aceita os valores 0 e 1 O valor padr o desta propriedade 0 6 2 6 1 4 EnableOverrideLineColor FP Esta propriedade habilita ou desabilita o objeto a sobrescrever a cor original da linha da imagem pela cor definida na propriedade OverrideLineColor Se a propriedade EnableOverrideLineColor estiver habilitada faz com que sejam modificadas a cor original da linha do objeto pela cor de OverrideLineColor Caso contr rio o objeto Figura exibir a cor original 6 2 6 1 5 Filename a Define o nome do arquivo de imagem associado a esse objeto O caminho do arquivo pode ser tanto o caminho completo do arquivo no disco quanto o caminho relativo aplica o quando inserido o arquivo de imagem como um recurso da aplica o O valor padr o desta propriedade vazio Os seguintes tipos de arquivos de imagem s o suportados PROPRIEDADE FILTRO DESCRI O FILTRO Bitmap file BMP N o Sim Graphics Interchange Format GIF N o Sim Joint Picture Expert Group JPG N o Sim Icon File ICO N o Sim 6 2 6 1 6 HorizontalFilStyle P Define como ser o preenchimento horizontal do objeto Esta propriedade trabalha em conjunto com a propriedade HorizontalPercentFill que informa qual porcentagem do objeto dever ser preenchida Estas duas propriedades permitem uma simula o de um preenchimento de n
321. ital Este c digo de barras utilizado no Reino Unido 23 ddbcUCCEAN128 Estilo de c digo de barras UCC EAN 128 Utilize caracteres completos ASCII Avers o especial do c digo 128 usado na aplica o HIBC 22 6 3 Elipse Ret ngulo e Ret ngulo Arredondado Esta se o cont m informa es sobre propriedades dos objetos Elipse Ret ngulo e Ret ngulo Arredondado do Relat rio Estes objetos n o possuem eventos nem m todos associados 22 6 3 1 Propriedades Esta se o cont m informa es sobre as propriedades dos objetos Elipse Ret ngulo e Ret ngulo Arredondado do Relat rio 22 6 3 1 1 LineColor a Especifica a cor da linha do objeto O valor padr o desta propriedade preto RGB 0 0 0 22 6 3 1 2 LineStyle P Determina o estilo da linha do objeto As op es dispon veis desta propriedade s o as seguintes Op es dispon veis para LineStyle OP O DESCRI O O ddLSTransparent Alinha do objeto fica transparente 1 ddLSSolid Alinha do objeto aparece s lida 2 ddLSDash Alinha do objeto fica tracejada 502 Relat rios OP O DESCRI O 3 ddLSDot Alinha do objeto fica pontilhada 4 ddLSDashDot Alinha do objeto fica tracejada 5 ddLSDashDotDot Alinha do objeto fica pontilhada tracejada e pontilhada Ovalor padr o desta propriedade 1 ddLSSolid
322. itar ou O para n o habilitar Os par metros lt zoom gt e lt barra de rolagem gt s o v lidos apenas se o linkindicado se tratar de uma Tela Caso contr rio ser o ignorados Se o par metro lt Zoom gt n o for informado assumido 100 Se o par metro lt barra de rol agem gt n o for informado assumido 1 ou seja habilitado Exemplo Sub CommandButtonl click Application Item top SplitLink Telal 1021 End Sub 10 4 2 6 SplitResizable PI Determina se o divisor mandante pode ser redimensionado em tempo de execu o Esta propriedade n o tem efeito no divisor restante O valor padr o desta propriedade True 10 4 2 7 SplitValue 9 Apropriedade SplitValue determina o valor que ser atribu do ao divisor do quadro que tanto pode ser percentagem hm HIMETRIC ou px pixels Se a unidade for omitida o valor ser considerado em HIMETRIC Exemplo Sub Divisorl click Application Item top splitvalue 10 End sub 328 Viewer CAP TULO Banco de Dados Esta se o cont m informa es sobre m todos e propriedades do objeto Banco de Dados Este objeto n o possui eventos associados 11 1 M todos Esta se o cont m informa es sobre os m todos do objeto Banco de Dados 11 1 1 SetDBParameters SetDBParameters ServerName UserName Password DBName String de conex o com o DB nas propriedades do objeto Banco de Dados O par metro ServerName determina o nome do
323. ite a intera o do usu rio com outras Telas enquanto esta estiver ativa NTelatnicial C Telatnicial a JaJa Click Fires when screen is dicked on 68H Abrir Tela modal Abre a Tela modal Abrir Tela modal Abrir aTela HW T tulo Zoom inicial 100 hd Par metro 90 Habilitar scroll da tela I Especificar a posi o da tela I Especificar o tamanho da tela Esquerda pixels O Largura pixels himetic O Topo pixels 0 3 altura pixels Himetric 0 OBS Use hm para especificar tamanho em HIMETRIC Para pixels use apenas n meros Ex 1000hm 3500 hm 100 400 Estilo da janela Mensagens IE Scripts Configu ra es do pick Abrir Tela Modal Op es dispon veis no pick Abrir Tela Modal CAMPO DESCRI O Abrir atela Seleciona a Tela a ser aberta T tulo Define o t tulo da janela Esse texto ser concatenado com o nome da Tela Zoom inicial Define o zoom da Tela quando mostrada Par metro Indica um par metro a ser passado na chamada da Tela Habilitar scroll datela Habilita o uso das barras de rolagem na Tela Especificar a posi o Determina a posi o em pixels do quadro na Tela a partir datela do canto superior esquerdo da Tela Introdu o 15 CAMPO DESCRI O Especificar o tamanho Determina a largura e a
324. ito grandes ou muito pequenos recomenda se utilizar o formato Cient fico e Data Apresenta valores num ricos de data e hora quando v lidos Para representar apenas a hora use o formato equivalente e Hora Apresenta valores num ricos de hora e data quando v lidos Para representar apenas a data use o formato equivalente e Porcentagem Multiplica o n mero por 100 e adiciona o s mbolo de porcentagem Admite at 15 casas decimais e Cient fico Apresenta o n mero em nota o de mantissa e expoente Ideal para ActiveX 255 n meros de magnitude variada Admite at 15 casas decimais e Especial Permite formatar n meros inteiros em bases n o decimais hexadecimal octal ou bin ria por exemplo e Outro Permite editar diretamente o c digo de formata o desejado ou selecionar um formato criado anteriormente 7 4 5 1 4 HorizontalAlignment a Define o alinhamento horizontal do texto do E2Display Os valores desta propriedade s o os seguintes e O HorizontalAlignmentLeft alinha horizontalmente esquerda e 1 HorizontalAlignmentCenter alinha horizontalmente ao centro e 2 HorizontalAlignmentRight alinha horizontalmente direita Ovalor padr o desta propriedade 1 HorizontalAlignmentCenter 7 4 5 1 5 MultiLline FI Define se o objeto possui m ltiplas linhas ou n o Esta propriedade s ter efeito se a propriedade Value for do tipo String 7 4 5 1 6 TextColor E Define a cor do texto
325. iveX 7 3 9 3 4 BackStyle P A propriedade BackStyle define o estilo do plano de fundo para os objetos As op es dispon veis para esta propriedade s o as seguintes e 0 fmBackStyleTransparent define o objeto como transparente isto nenhum fundo deste objeto ser desenhado e 1 fmBackStyleOpaque define o objeto como opaco isto o fundo ser desenhado valor padr o 7 3 9 3 5 BorderColor Esta propriedade determina a cor da borda que ser aplicada no objeto Com esta propriedade poss vel aplicar a cor padr o ou personaliz la atrav s da sua edi o Para que esta propriedade seja aplic vel necess rio que a propriedade BorderStyle esteja configurada para 1 fmBorderStyleSingle O valor padr o desta propriedade preto RGB O 0 0 7 3 9 3 6 BorderStyle aP A propriedade BorderStyle determina o estilo de borda que ser aplicada ao objeto As op es dispon veis s o e 0 fmBorderStyleNone sem borda e 1 fmBorderStyleSingle com borda simples 7 3 9 3 7 CanPaste F A propriedade CanPaste especifica se a rea de transfer ncia cont m os dados aos quais o objeto d suporte Se a op o estiver configurada para True o objeto pode receber informa es coladas da rea de transfer ncia Se os dados da rea de transfer ncia estiverem em um formato ao qual o objeto n o d suporte a propriedade CanPaste ser False Por exemplo ao se tentar colar um bitmap em um objeto que s d supor
326. jeto n o possui m todos associados 7 3 8 1 Eventos Esta se o cont m informa es sobre os eventos do objeto Bot o Liga Desliga 7 3 8 1 1 MouseMove MouseMove Ocorre quando o ponteiro do mouse movimentado sobre o bot o Liga Desliga 7 3 8 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Bot o Liga Desliga 7 3 8 2 1 Accelerator Define ou recupera a tecla aceleradora do objeto Esta tecla aceleradora uma tecla de atalho que usada em conjunto com a tecla ALT d o foco ao objeto O valor padr o desta propriedade vazio ActiveX 225 7 3 8 2 2 Alignment aP A propriedade Alignment especifica a posi o do objeto relativa a sua legenda As op es dispon veis para esta propriedade s o as seguintes e O fmaAlignmentLeft coloca a legenda esquerda do objeto e 1 fmAligmentRight coloca a legenda direita do objeto Esta propriedade acess vel apenas em tempo de execu o 7 3 8 2 3 AutoSize F A propriedade AutoSize ajusta a largura do texto caso a rea dispon vel para o mesmo ultrapasse o tamanho do objeto Para o objeto Bot o Liga Desliga Toggle Button quando a propriedade estiver configurada para True o texto redimensionado para coincidir com o tamanho atual o objeto permitindo assim a sua exibi o completa 7 3 8 2 4 BackStyle aP A propriedade BackStyle define o estilo do plano de fundo para os objetos As op es dispon veis para esta p
327. l do Timer Para o tipo Single a pr pria data hora de disparo Para os demais o momento a partir do qual o timer come a a disparar Ovalor padr o o dia ea hora locais 5 5 2 5 TriggerType aP Tipo de disparo do timer As op es dispon veis s o Op es dispon veis para TriggerType OP O DESCRI O O ttSingle Disparo nico 1 ttContinuous Disparo cont nuo 2 ttDaily Disparo di rio 3 ttMonthly Disparo mensal 128 Servidor de Dados CAP TULO Telas e Objetos de Tela Esta se o cont m informa es sobre eventos m todos e propriedades de Telas e Objetos de Tela 6 1 Tela Esta se o cont m informa es sobre eventos m todos e propriedades do objeto Tela 6 1 1 Eventos Esta se o cont m informa es sobre os eventos do objeto Tela 6 1 1 1 Click Click Ocorre quando o bot o esquerdo do mouse pressionado sobre a tela Este evento n o ocorrer se a tela n o estiver vis vel ou sua propriedade Enabled estiver configurada para False Avisibilidade da tela depende de tr s fatores propriedade Visible igual a True objeto pai vis vel e propriedade Layer do objeto presente na camada da Tela Exemplo sub Tela Click Mostra uma caixa de mensagem quando o usu rio clica na tela MsgBox voc clicou sobre a tela End Sub 6 1 1 2 DbClick DbClick Ocorre quando h um duplo clique ou seja o bot o esque
328. l do Usu rio t pico Associa es 9 1 M todos Comuns Esta se o cont m informa es sobre os m todos comuns ao objeto Associa o 9 1 1 CreateLink CreateLink Property Source Type Este m todo permite criar uma conex o com uma propriedade do objeto Em caso de sucesso o m todo retorna o objeto criado Caso contr rio ocorrer um erro de script e o m todo retornar Nothing O m todo possui os seguintes par metros e Property especifica o nome da propriedade para qual ser criada a conex o e Source especifica o nome do objeto origem da conex o e Type opcional especifica o tipo de conex o a ser criada Quando este par metro for omitido ser criada uma conex o simples 280 Associa es Op es dispon veis para o par metro Type OP O DESCRI O O Conex o Simples Na conex o simples o valor da origem copiado para a propriedade toda vez que ele for modificado 1 Conex o Bidirecional Na conex o bidirecional ocorre o mesmo que na simples por m caso haja uma varia o na propriedade seu valor ser copiado para a origem gerando assim uma conex o de duas dire es 2 Conex o Anal gica Aconex o anal gica estabelece uma escala de convers es entre a vari vel origem e a propriedade 3 Conex o Digital Na conex o digital s o especificados valores fixos ou alternantes para a propriedade que s o atribu dos de acordo com a fonte ser verd
329. l o valor m nimo que dever ser atribu do propriedade Value ajustando a escala ao valor do equipamento ou do dispositivo antes desta atribui o Da mesma forma no momento da escrita feita a opera o inversa antes de enviar o valor para o driver Esta convers o s ocorre quando a propriedade EnableScaling est configurada para True O valor padr o desta propriedade 0 Exemplo sub Elemento OnsStartRunning O Faz o ajuste de escala de um elemento temperatura que varia de O a 255 no OPC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub 108 Drivers 3 8 1 8 Index 9 Utilize esta propriedade para especificar a posi o que um elemento ocupa entre os elementos configurados pela propriedade Size do objeto Bloco OPC no qual ele est inserido Esta propriedade aceita valores de O at um n mero menor do que a valor definido em Size Por exemplo configurando um bloco OPC para ter Size iguala 20 0 n mero m ximo v lido para a propriedade Index ser 19 e o m nimo O Esta propriedade pode ser alterada ap s iniciada a comunica o O valor padr o da propriedade 0 por m ao mapear os elementos de um bloco o E3 Studio automaticamente configura o par metro Index para um valor de acordo com o especificado Exemplo Sub Elementol onRead MsgBox Index End sub 3 8 1 9 Quality 9 A propriedade Q
330. la 17 3 29 TextBkColor E Especifica a cor de fundo das c lulas de dados do E3Browser O valor padr o desta propriedade a cor branca RGB 255 255 255 17 3 30 TextColor ia Especifica a cor do texto do E3Browser O valor padr o desta propriedade a cor preta RGB 0 0 0 406 E3Browser 17 3 31 Tip Cont m um texto de ajuda apresentado como dica quando o usu rio coloca o ponteiro do mouse sobre o objeto 17 3 32 TitleTipBkColor E Especifica a cor do fundo do texto da dica do E3Browser O valor padr o desta propriedade a cor preta RGB 0 0 0 17 3 33 TitleTipTextColor E Especifica a cor do texto da dica do E3Browser O valor padr o desta propriedade a cor cinza RGB 204 204 204 17 3 34 ToolbarBkColor E Especifica a cor de fundo da barra de fun es do E3 Browser O valor padr o desta propriedade bege RGB 236 233 216 17 3 35 ToolbarFont Determina a fonte utilizada nos textos da barra de fun es do E3 Browser Esta propriedade n o pode ser utilizada em scripts ou em associa es sendo configurada somente via Studio 17 3 36 ToolbarForeColor a Especifica a cor de frente da barra de fun es do E3 Browser O valor padr o desta propriedade preto RGB O 0 0 17 3 37 Visible P Habilita ou desabilita a visibilidade do campo selecionado no E3Browser Se a propriedade estiver configurada para True o campo ser vis vel no E3Browser Caso contr
331. la o quando estes caracteres forem atingidos Por exemplo para que uma Lista de Sele o exiba dados de estoque que possuam sempre cinco caracteres pode se usar a propriedade MaxLength para especificar o n mero m ximo de caracteres a serem introduzidos no objeto e a propriedade AutoTab para tabular automaticamente para o pr ximo objeto depois que o usu rio digitar cinco caracteres 7 3 4 3 3 AutoWordSelect F Habilita ou desabilita a sele o autom tica de palavras no objeto Se esta propriedade estiver configurada para True a palavra indicada selecionada no texto mais o espa o seguinte caso se tenha selecionado parte dela Caso contr rio somente o caractere indicado na palavra selecionado 7 3 4 3 4 BackStyle aP A propriedade BackStyle define o estilo do plano de fundo para os objetos As op es dispon veis para esta propriedade s o as seguintes e O fmBackStyleTransparent define o objeto como transparente isto nenhum fundo deste objeto ser desenhado e 1 fmBackStyleOpaque define o objeto como opaco isto o fundo ser desenhado valor padr o NOTA Esta propriedade n o afeta a transpar ncia de bitmaps Deve se usar um 196 ActiveX 7 3 4 3 5 BorderColor Esta propriedade determina a cor da borda que ser aplicada no objeto Com esta propriedade poss vel aplicar a cor padr o ou personaliz la atrav s da sua edi o Para que esta propriedade seja aplic vel necess rio que
332. lado oposto do eixo original Caso contr rio o eixo permanece na mesma posi o Exemplo Sub CommandButton1 pBCclick Set Chart Screen Item E3Chart1 Chart axes Item NomeDoEixo Mirror Not _ Chart axes Item NomeDoEi xo Mirror End sub 18 7 2 8 Name Determina o nome do eixo Exemplo Sub CommandButton1 pBClick Set Chart Screen Item E3Chart1 Chart Axes Item NomeDoEixo Title Chart Axes Item NomeDoEixo Name End sub 18 7 2 9 Position a Determina a posi o do eixo em rela o grade do E3Chart As op es dispon veis s o as seguintes Op es dispon veis para Position OP O DESCRI O O axpLeft O eixo posicionado esquerda da escala 1 axpRight O eixo posicionado direita da escala 2 axpTop O eixo posicionado no topo da escala 3 axpBottom O eixo posicionado na base da escala E3Chart 449 Exemplo Sub CommandButton1 clickQO Set Chart Screen Item E3Chart1 Set newaxis Chart Axes Addaxis For i 0To3 MsgBox clique OK para mudar a posi o do eixo newaxis Position i Next MsgBox Remover o eixo Chart Axes Remove newaxi s Name End sub 18 7 2 10 ScaleType a Determina o tipo de escala mostrada pelo eixo As op es dispon veis deste item s o as seguintes Op es dispon veis para ScaleType OP O DESCRI O O atNumberScale Escala num ri
333. las de opera es arquivos e3ie e30 Isso faz com que as opera es feitas no Banco de Dados sejam vistas de forma mais r pida 466 F rmulas 20 2 3 TableName Indica o nome das tabelas onde ficar o as informa es das f rmulas O valor padr o desta propriedade vazio F rmulas 467 CAP TULO Bibliotecas de Usu rio Esta se o cont m informa es sobre os objetos XControls XObjects e as Propriedades de um ElipseX 21 1 XControls e XObjects Esta se o cont m informa es sobre eventos e propriedades dos objetos XControls e XObjects Estes objetos n o possuem m todos associados 21 1 1 Eventos Esta se o cont m informa es sobre os eventos dos objetos XControls e XObjects 21 1 1 1 Constructor Constructor Disparado quando o ElipseX iniciado Pode se utilizar este evento para rodar um script que inicie valores internos de um ElipseX por exemplo 21 1 1 2 CustomConfig CustomConfig Permite configura es automatizadas nas inst ncias de ElipseX Uma op o de configura o ir aparecer no menu de contexto das inst ncias de ElipseX sempre que existir um script associado ao evento CustomConfig da defini o do ElipseX Quando a op o selecionada no menu o evento disparado Otexto que aparece na op o do menu pode ser informado na propriedade CustomConfigText da defini o do ElipsexX Se esta propriedade estiver em branco aparecer o texto Configurar
334. lat rio conforme as especifica es da se o Detail 22 5 2 1 8 UnderlayNext PI Determina se a se o deve imprimir uma se o depois da outra consecutivamente Se a propriedade estiver configurada para True a se o seguinte come ar a impress o a partir da coordenada superior da se o na p gina do relat rio Caso contr rio este recurso n o utilizado O valor padr o desta propriedade False Relat rios 489 22 5 3 Detail Esta se o cont m informa es sobre propriedades do objeto Detail do Relat rio Este objeto n o possui eventos nem m todos associados 22 5 3 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Detail do Relat rio 22 5 3 1 1 ColumnCount 9 Determina o n mero de colunas na se o Detail do relat rio Alargura de cada coluna deve ser igual a rea imprim vel do relat rio dividida pelo n mero de colunas Ovalor padr o desta propriedade 1 22 5 3 1 2 ColummDirection aP A propriedade ColumnDirection determina a dire o da impress o das colunas da se o Detail As op es dispon veis s o as seguintes Op es dispon veis para ColumnDirection OP O DESCRI O 0 ddCDDownAcross Imprime cada coluna da se o Detail de cima para baixo e depois passa para a pr xima coluna direita 1 ddCDAcrossDown Imprime cada coluna da se o Detail da direita para a esquerda e assim por
335. le o o sistema define o valor da propriedade Listindex O valor da propriedade Listindex da primeira linha de uma lista 0 0 valor da segunda linha 1 e assim por diante Esta propriedade acess vel apenas em tempo de execu o 7 3 4 3 25 ListRows 9 Apropriedade ListRows determina o n mero m ximo de linhas na lista do objeto O valor padr o desta propriedade 8 7 3 4 3 26 ListStyle aP A propriedade ListStyle determina o estilo da lista do objeto As op es dispon veis para esta propriedade s o as seguintes e 0 fmListStylePlain listagem com os itens do plano de fundo em destaque e 1 fmListStyleOption exibe bot es de op o ou caixas de sele o para uma lista de v rias op es Quando o usu rio seleciona um item do grupo o bot o de op o associado ao item selecionado e os bot es de op o para outros itens no grupo s o desmarcados Ovalor padr o desta propriedade 0 fmListStylePlain ActiveX 203 7 3 4 3 27 ListWidth 9 A propriedade ListWidth determina a largura da lista do objeto O valor padr o desta propriedade O 7 3 4 3 28 Locked FI A propriedade Locked habilita ou desabilita a edi o do objeto Se esta propriedade estiver configurada para True a edi o n o permitida Caso contr rio poss vel editar o objeto Os valores configurados na propriedade Enabled influenciam o comportamento de Locked Para maiores detalhes consulte a propriedade Enabled O valor p
336. lida quando a propriedade SummaryType for igual a 3 SubTotal SummaryGroup indica qual o nome da se o GroupHeader que ser usada para controlar os subtotais ou seja a cada mudan a de valor no GroupHeader o somat rio reiniciado NOTA Quando esta propriedade utilizada as propriedades CanShrink e CanGrow 510 Relat rios ficam desabilitadas 22 6 5 1 15 SummaryRunning P Determina se ser feito o total de somat rios acumulados de acordo com as op es e 0O None n ofazototal e 1 Group calcula os totais acumulados para cada intervalo de totais especificado e 2 All calcula o total acumulado para todos os valores do relat rio independente do agrupamento Esta propriedade s v lida quando a propriedade SummaryType tem valor diferente de 0 22 6 5 1 16 SummaryType P Determina o tipo ou n vel de totaliza o a ser gerada As op es dispon veis s o as seguintes Op es dispon veis para SummaryType OP O DESCRI O 0 None Sem gera o de somat rio 1 GrandTotal Especifica que ser totalizado todo o conte do do relat rio 2 PageTotal Especifica que ser gerado um subtotal por p gina 3 SubTotal Especifica que ser gerado um subtotal para cada grupo definido na propriedade SummaryGroup 4 PageCount Especifica o contador de p gina Relat rios 511 22 6 5 1 17 Text Determina o texto que ser atribu do
337. lidade com a especifica o padr o dos objetos Microsoft Forms 7 3 7 2 4 Column Especifica a linha e coluna no objeto Se for especificado somente o valor de coluna a propriedade Column l ou escreve a coluna especificada na linha atual do objeto Porexemplo MinhaLi stadesele o Column 3 l ou escreve a terceira coluna do objeto Esta propriedade acess vel apenas em tempo de execu o 7 3 7 2 5 ColumnCount 9 A propriedade ColumnCount especifica o n mero de colunas do objeto A configura o de ColumnCount como 0 n o exibe nenhuma coluna e a configura o desta propriedade como 1 exibe todas as colunas dispon veis O valor padr o desta propriedade 1 218 ActiveX 7 3 7 2 6 ColumnHeads Fi A propriedade ColumnHeads habilita ou desabilita a exibi o do t tulo das colunas no objeto Se a propriedade estiver configurada para True o t tulo mostrado Caso contr rio o t tulo das colunas n o mostrado O valor padr o False 7 3 7 2 7 ColumWidths 9 A propriedade ColumnWidths utilizada para especificar a largura da coluna do objeto em pontos Um valor igual a 1 ou em branco faz com que a largura seja calculada na coluna a largura m nima de uma coluna calculada 72 pontos ou 1 polegada Um valor igual a O oculta a coluna Para produzir colunas mais estreitas deve se especificar a largura na propriedade ou utilizar alguma dos valores a seguir Op es dispon veis para ColumnWidths
338. lizada quando feita uma nova leitura v lida de um valor do equipamentoou do dispositivo utilizando sua parametriza o por m o tipo desta vari vel n mero inteiro ponto flutuante texto depende do driver OPC ao qual ele est associado e da sua parametriza o Esta propriedade somente ir ser atualizada desta forma se a propriedade AllowRead estiver configurada para True e quando n o houver erros de comunica o neste caso somente as propriedades Quality e TimeStamp s o atualizadas mas de acordo com o tempo de varredura definido no grupo ao qual ele pertence Outra forma de utilizar esta propriedade escrever valores no equipamento ou dispositivo Basta para isso atribuir um novo valor para a propriedade Value ou algum dos bits Bit00 at Bit31 desde que a propriedade AllowWrite esteja configurado para True Esta propriedade tamb m a propriedade padr o do objeto tag OPC Sendo assim uma refer ncia por valor a um objeto tag OPC n o necessita obrigatoriamente explicitar a propriedade Value para acessar o valor Ovalor padr o desta propriedade vazio Exemplo Drivers 99 Sub Botaol click tagl um objeto set obj Applicati Getobject MsgBox valor atual MsgBox valor atual End Sub Acessa um tag e mostra o valor atual tipo OPCTag oia Driverde Comunicacaol tag1 de tagl amp obj Value Sem mostrar a propriedade Value que padr o de tagl amp obj 3 7 Bloco de Comunica
339. lor ser mostrado na coluna Operator do E3Alarm Se for omitido ser utilizado o usu rio atual do Viewer ou ent o Sem usu rio caso n o haja nenhum usu rio logado Para o reconhecimento em si necess rio que o usu rio logado tenha permiss o para reconhecer alarmes 13 2 4 GetFocusedEvent GetFocusedEvent Este m todo retorna um objeto com as propriedades do evento selecionado aquele que temo foco atual no E3Alarm caso haja algum evento selecionado Se nenhum evento estiver selecionado o m todo retornar um objeto Nothing As propriedades do objeto retornado cont m os valores dos campos do evento selecionado O objeto cont m uma c pia dos valores no momento da chamada do m todo portanto se houver uma mudan a no evento selecionado as propriedades n o ser o atualizadas automaticamente sendo necess rio utilizar o m todo sempre que houver necessidade de obter informa es atualizadas do evento selecionado As propriedades do objeto retornado pelo m todo s o as seguintes Propriedades do objeto retornado por GetFocusedEvent NOME DESCRI O Acked Informa se o alarme foi reconhecido ou n o Este campo pode assumir os valores 0 n o reconhecido e 1 reconhecido AckRequired Determina o reconhecimento autom tico do alarme Este campo apresenta os valores 0 reconhecimento autom ticoe 1 reconhecimento manual AckTime Registra a data hora do E3 no momento em que o alarme reconhecido
340. lor unidimensional inteiro de 32 bits sinalizado 4 Single Valor unidimensional de ponto flutuante de 32 bits 5 Double Valor unidimensional de ponto flutuante de 64 bits 6 Currency Valor unidimensional monet rio com 4 casas decimais 7 Date Valor de data hora 8 String Valor literal Texto 9 Object Valor unidimensional de refer ncia a um objeto 10 Error Valor unidimensional de c digo de erro 92 Drivers OP O DESCRI O 11 Boolean Valor unidimensional booleano verdadeiro ou falso 12 Variant Dados de qualquertipo usados para objetos e outros valores para os quais o tipo de dados desconhecido 13 UnkObject Valor unidimensional de refer ncia a um objeto 14 Decimal Valor unidimensional de ponto flutuante de 96 bits 36 Record Valor unidimensional de grava o 16 Char Valor unidimensional inteiro de 8 bits 17 Byte utilizado para cria o de DLLs e para OLE Ocupa 1 byte de mem ria 18 Word Valor unidimensional inteiro de 16 bits 19 Dword Valor unidimensional inteiro de 32 bits 20 Longlong Valor unidimensional inteiro de 64 bits sinalizado 21 DDWord Valor unidimensional inteiro de 64 bits 22 Integer N meros sem decimais cujo intervalo de ocorr ncia dever ser de 32 768 a 32 767 Ocupa 2 bytes 23 Uinteger N mero inteiro sem sinal no caso equivale a um DWORD que vai de 0
341. lse a ordena o de eventos pelo campo prim rio ser no sentido descendente Caso contr rio o sentido ser ascendente O valor padr o desta propriedade False 13 3 29 PrimarySortField Determina oca mpo prim rio para a ordena o dos eventos no E3Alarm O nome do campo deve ser sempre especificado em ingl s ver tabela de campos dos alarmes no ap ndice deste manual O valor padr o dessa propriedade EventTime Quando esta op o est vazia a propriedade SecondarySortField n o tem efeito 13 3 30 SecondarySortAscending Fi Quando esta propriedade estiver configurada para True a ordena o de eventos pelo campo secund rio ser no sentido ascendente Caso contr rio o sentido ser descendente O valor padr o desta propriedade False E3Alarm 371 13 3 31 SecondarySortField Determina o ca mpo secund rio para a ordena o dos eventos no E3Alarm O nome do campo deve ser sempre especificado em ingl s ver tabela de campos dos alarmes no ap ndice deste manual O valor padr o dessa propriedade vazio Essa propriedade n o tem efeito quando a propriedade PrimarySortField estiver vazia 13 3 32 ShowHighPriority P Filtra quais alarmes ser o mostrados ou n o de acordo com a sua severidade Quando estiver em True ser o mostrados os alarmes de severidade alta do contr rio estes alarmes n o ser o mostrados O valor padr o desta propriedade True 13 3 33 ShowLowPriority P Filtra quais
342. ltiline Fi A propriedade Multiline indica se o texto ter m ltiplas linhas True ou se ser uma caixa de texto simples False Isto pode ser visualizado quando o objeto Viewer est em execu o O valor padr o desta propriedade False 22 6 6 1 9 Style A A propriedade Style permite especificar um estilo CSS para o texto em substitui o ao estilo global O valor da propriedade deve ser um String CSS v lido caso contr rio a propriedade ser ignorada O valor padr o desta propriedade vazio o E3 ir usar o padr o do sistema Exemplo Sub Report OnBeforePrint Labell style font family Times font weight bold text align center color RGB 255 255 0 End sub 22 6 6 1 10 VerticalAlignment PA propriedade VerticalAlignment determina o alinhamento vertical do texto a saber e 0O ddTxTop alinhamento pelo topo padr o e 1 ddTxMiddle alinhamento centralizado e 2 ddTxBottom alinhamento pela base 22 6 6 1 11 WordWrap F Habilita ou desabilita uma quebra de linha no texto caso a rea dispon vel para o texto ultrapasse os limites determinados no objeto Para que esta propriedade funcione a propriedade Multiline deve ser obrigatoriamente igual a True 514 Relat rios 22 6 7 Linha Esta se o cont m informa es sobre propriedades do objeto Linha do Relat rio Este objeto n o possui eventos nem m todos associados 22 6 7 1 Propriedades Esta se o cont m informa es sobre as propr
343. lue 9 Especifica o valor m ximo atingido na propriedade Exemplo Sub DstHivalue ValueChange On Error Resume Next Dim Bind Set Bind Screen Item scrollBar1 Links Item value screen Item scrollBar1 Mmax Value If Bind Is Nothing Then Cedo scroliBarl n o tem associa o Else MsgBox scrollBarl est associado a amp Bind Source amp MsgBox Mudando DstHivalue de amp Bind DstHivalue amp para amp Value Bind DstHivalue Value End If End sub 9 7 1 2 DstLoValue 9 Especifica o valor m nimo atingido na propriedade Exemplo Sub DstLovalue ValueChange On Error Resume Next Dim Bind Set Bind Screen Item scroliBar1 Links Item value Screen Item scrollBar1 min Value If Bind Is Nothing Then Ci Ge scroliBarl n o tem associa o Else MsgBox ScrollBarl est associado a amp Bind Source amp MsgBox Mudando DstLovalue de amp Bind DstLovalue amp para amp Value Bind DstLovalue Value End If End sub 9 7 1 3 SrcHiValue 9 Especifica o valor m ximo atingido na fonte Exemplo Sub SrcHivalue ValueChange On Error Resume Next Dim Bind Set Bind Screen Item scroliBar1 Links Item value screen Item scrollBar2 Max Value If Bind Is Nothing Then qe neae scroliBarl n o tem associado Else MsgBox scrollBarl est associado a amp Bind Source amp MsgBox Mudando SrcHivalue de amp Bind srcHivalue amp para amp Val
344. m informa es sobre os m todos do objeto E3Alarm 13 2 1 AckAll AckalI Operator Permite reconhecer globalmente todos os alarmes Operator um string opcional que indica o nome do operador que reconheceu o alarme Esse valor ser mostrado na coluna Operator do E3Alarm Se for omitido ser utilizado o usu rio atual do Viewer ou ent o Sem usu rio caso n o haja nenhum usu rio logado Para o reconhecimento em si necess rio que o usu rio logado tenha permiss o para reconhecer alarmes 13 2 2 AckCurrentFilter AckCurrentFilter Operator Permite reconhecer todos os alarmes do filtro corrente Operator um string opcional que indica o nome do operador que reconheceu o alarme Esse valor ser mostrado na coluna Operator do E3Alarm Se for omitido ser utilizado o usu rio atual do Viewer ou ent o Sem usu rio caso n o haja nenhum usu rio logado Para o reconhecimento em si necess rio que o usu rio logado tenha permiss o para reconhecer alarmes 360 E3Alarm 13 2 3 AckSelected AckSelected Operator Permite reconhecer os alarmes selecionados Se n o houver alarme selecionado no E3Alarm o m todo falha O usu rio poder reconhecer o alarme neste caso ser inserido um novo registro no Banco de Dados indicando o reconhecimento e no E3Alarm a linha correspondente indicar que ele foi reconhecido Operator um string opcional que indica o nome do operador que reconheceu o alarme Esse va
345. m sinal ou entre par nteses Para n meros muito grandes ou muito pequenos recomenda se utilizar o formato Cient fico e Data Apresenta valores num ricos de data e hora quando v lidos Para E3Chart 427 representar apenas a hora use o formato equivalente e Hora Apresenta valores num ricos de hora e data quando v lidos Para representar apenas a data use o formato equivalente e Porcentagem Multiplica o n mero por 100 e adiciona o s mbolo de porcentagem Admite at 15 casas decimais e Cient fico Apresenta o n mero em nota o de mantissa e expoente Ideal para n meros de magnitude variada Admite at 15 casas decimais e Especial Permite formatar n meros inteiros em bases n o decimais hexadecimal octale bin ria por exemplo e Outro Permite editar diretamente o c digo de formata o desejado ou selecionar um formato criado anteriormente Am scara destes formatos como exemplificadas no campo Tipo ser exibida na Janela de Propriedades por exemplo d M yy H mm 0E 00 etc 18 3 53 VerTickUnit 9 Determina o n mero de subdivis es entre as marcas da grade Quando esta propriedade estiver com valor 0 o espa amento ser autom tico Exemplo Sub CommandButtonl clickO set E3Chart1 Screen Item E3Chart1 old E3Chartl verTickUnit For i 0 To 30 step 10 E3chartl verTickunit i MsgBox E3Chartl vVerTickUnit amp Cstr i Next MsgBox voltar E3Chartl verTickUnit old End s
346. mente de leitura mas pode ser modificada em tempo de execu o 16 3 5 Frame 5 Retorna o quadro pai do objeto Esta propriedade acess vel apenas em tempo de execu o 16 3 6 FunctionSubType aP Especifica o subtipo da fun o indicada por FunctionType Apenas as op es 1 ftArchivedValue 2 ftTagAttribute e 6 ftCalculatedData possuem subtipos Para as outras fun es FunctionSubType assume o valor 1 ffNoSubType Atabela a seguir mostra os poss veis valores da propriedade de acordo com a fun o escolhida na propriedade FunctionType Subtipos para fun o ArchivedValue FunctionType 1 SUBTIPO DESCRI O O fsPreviousArchivedValue Valor armazenado imediatamente anterior ao timestamp fornecido 1 fsinterpolatedArchivedValue Valor calculado a partir do valor anterior e posterior Consultas 393 SUBTIPO DESCRI O 2 fsNextArchivedValue Valor armazenado imediatamente posterior ao timestamp 3 fsExactArchivedValue Se for encontrado um valor armazenado no exato instante que foi fornecido pelo timestamp Subtipos para fun o TagAttribute FunctionType 2 SUBTIPO DESCRI O 0 fsTagAttributeDescription Significado ou descri o do tag 1 fsTagAttributeSource Caminho do Tag que est sendo armazenado 2 fsTagAttributeType Tipo de dado Double Boolean String 3 fs
347. mento ou do dispositivo a que este tagestar associado Consulte a documenta o do driver para sua correta parametriza o Esta propriedade pode ser modificada a p s iniciada a comunica o O valor padr o desta propriedade 0 Exemplo Sub Tag OnStartRunningO NZ 10 N4 20 End sub 3 2 3 17 ParambDevice Define o endere o do equipamento acessado pelo tag Esta propriedade herdada do driver mas seu valor pode ser sobrescrito se necess rio 3 2 3 18 Paramitem Identifica o dado que o tagacessa dentro de um equipamento 3 2 3 19 PercentDeadBand 9 Apropriedade PercentDeadBand determina a varia o m nima do valor banda morta de um tag para que seu valor no E3 seja atualizado Este valor especificado como um percentual da diferen a entre as propriedades DeviceHigh e DeviceLow Esta propriedade s ser utilizada caso a propriedade EnableDeadBand do mesmo tag esteja configurada para True Se a propriedade PercentDeadband for iguala O o tag n o ter banda morta e qualquer varia o no seu valor ser repassada para o E3 Caso contr rio s ser enviado para o E3 um novo valor cuja diferen a em rela o ao valor atual no E3 seja maior que a banda morta O valor padr o desta propriedade 0 70 Drivers 3 2 3 20 Quality 9 A propriedade Quality informa qual a qualidade do valor contido na propriedade Value Cada vez que o Driver atribui um novo valor para o Tag ele tamb m configura a quali
348. minutos 14 2 9 EnableBackupTable P Cria uma tabela de backup onde os dados descartados permanecer o por seguran a Se configurada para True a tabela ser criada do contr rio n o haver tabela de backup O valor padr o desta propriedade False Hist ricos 377 14 2 10 EnableDiscard P Indica descarte dos dados do Hist rico ap s um certo tempo Se configurada para False os dados ser o armazenados indefinidamente na tabela do contr rio ser o descartados ap s determinado tempo O valor padr o dessa propriedade False 14 2 11 EnableQualityLogs F Quando em True ao iniciar o Hist rico o E3 gera um registro igual ao primeiro registro coletado mas com qualidade ruim 0 e timestamp de um segundo antes 14 2 12 ScanTime E Define a varia o de intervalo do tempo em milissegundos que o Hist rico ir esperar para fazer a aquisi o e grava o de um novo registro na tabela Utilize esta propriedade se houver necessidade de maior ou menor quantidade de dados gerados por segundo O valor padr o desta propriedade 1000 14 2 13 TableName Define o nome da tabela que ser utilizada no Hist rico 14 2 14 UserTable FI Quando esta propriedade est configurada para True identifica que o Hist rico do usu rio ou seja os dados da tabela foram importados do banco Caso contr rio um hist rico normal do E3 Esta propriedade apenas de leitura 14 2 15 UseTagQuality Fi se for True o Hist
349. mitindo uma troca mais r pida entre elas Se a propriedade for habilitada ent o o cache de Telas tamb m habilitado 10 3 3 Caption Determina o nome da aplica o que est utilizando o Viewer O valor padr o desta propriedade vazio 10 3 4 CenterWindow F Quando habilitada determina que a janela de visualiza o do Viewer dever iniciar centralizada Caso contr rio ser utilizada a configura o padr o O valor padr o desta propriedade True 10 3 5 CloseButton FI se a op o estiver habilitada o bot o Fechar habilitado no Viewer e poss vel utilizar este bot o Caso contr rio este bot o n o aparece na janela O valor padr o desta propriedade True Viewer 315 10 3 6 DisableTaskSwitching P se estiver configurada para True desabilita a troca de janelas no Viewer Caso contr rio a troca de janelas habilitada O valor padr o desta propriedade False Essa propriedade pode ser modificada em tempo de execu o utilizando o m todo SetDisableTaskSwitching 10 3 7 EnableHeartbeat F Habilita ou desabilita o envio de heartbeat mensagem enviada em intervalos fixos que indica que o E3 Server est ativo entre o Viewer e o servidor Caso o Viewer pare de receber as mensagens de heartbeat sinal de que algum problema ocorreu portanto a conex o deve ser abortada O valor padr o desta propriedade False 10 3 8 Enablelnactivity F Habilita ou desabilita a verifica o do pe
350. muito a performance da aplica o Poristo esta pr tica n o aconselh vel Programando no E3 31 2 3 7 Acessando Objetos de um ElipseX a partir do pr prio ElipseX Na cria o de um ElipsexX pode se declarar propriedades XProperties e inserir objetos que podem ser objetos de Tela XControl ou objetos do servidor XObject Para se acessar as XProperties atrav s de scripts basta acessar o nome da propriedade diretamente f XControlt 4 b x gi xcontrons aj bl x x Tipo s valor iniciat Texto de aj Variant i Variant Ja J w Variant 4 14 4 ni N Design A Propriedades Scripts Acessando objetos de um ElipseX a partir do pr prio ElipseX Por exemplo na figura anterior temos o XContro11 coma propriedade Propriedade1 e os objetos Textole Retangulol A propriedade Propriedade1 do tipo Booleano pode ser acessada com a linha a seguir Sub xControl1 onstartRunningO XControl1 Propriedadel True End sub ouainda Sub xControl1 onstartRunningO Propriedadel True End sub Se o ElipseX possui objetos internos ent o poss vel utilizar o m todo Item para obter uma refer ncia destes objetos Por exemplo Sub xControl1 onstartRunningO Item Textol value motor Item Retangulo1 Foregroundcolor RGB 212 208 20 End sub 32 Programando no E3 2 3 8 Acessando Objetos de um ElipseX Externamente Oacesso extern
351. n o possui eventos nem m todos associados 9 6 1 Propriedades Esta se o cont m informa es sobre as propriedades da Conex o Digital 9 6 1 1 BlinkOff FI quando esta propriedade estiver configurada para True a propriedade conectada ir alternar periodicamente entre os valores das propriedades OffValue e BlinkOffValue caso a fonte retorne False Exemplo Sub Blinkoff change O On Error Resume Next Dim Bind Set Bind Screen Item Retangulo1 Ade Links Item Foregroundcolor If Bind Is Nothing Then lg Retangulol n o tem associa o MsgBox Retangulol est associado a amp Bind Ssource amp MsgBox Mudando Blinkoff de amp Bind Blinkoff amp para amp value Bind Blinkoff value End If End sub 9 6 1 2 BlinkOffValue Especifica o valor alternativo a ser assumido periodicamente pela propriedade quando a express o da fonte resultar em False e a propriedade BlinkOff estiver configurada em True Exemplo Sub Blinkoffvalue Click On Error Resume Next Dim Value If application showpickcolor Value Foregroundcolor 400 300 Then Dim Bind Set Bind Screen Item Retangulo1l Links Item Foregroundcolor If Bind Is Nothing Then dada Retangulol n o tem associa o Else MsgBox Retangulol est associado a amp Bind Source amp MsgBox Mudando Blinkoffvalue de amp Bind Blinkoffvalue amp para amp Value Bind Blinkoffvalue value End If Foregroundcolor
352. n veis para FunctionType OP O DESCRI O 1 ftNoFunction N o h nenhuma fun o definida O ftLastValue Retorna o ltimo valor armazenado na Base de Dados 1 ftArchivedValue Retorna um valor armazenado em rela o a um determinado instante de tempo definido na vari vel TimeStamp Otipo de rela o definido em FunctionSubType 2 ftTagAttribute Devolve um atributo do Tag definido em FunctionSubType Consultas 395 OP O DESCRI O 3 ftCompressedDataNValues Retorna para um nico Tag N valores definidos na vari vel NumVals armazenados a partir de um instante inicial definido na vari vel StartTime 4 ftCompressedDataStartEndTime Retorna para um nico Tag os valores armazenados que est o entre o intervalo definido pelas vari veis StartTime e EndTime 5 ftSampledData Retorna para um ou mais Tags os valores interpolados ou seja estimados entre os instantes definidos pelas vari veis StartTime e EndTime a intervalos fixos definidos pela vari vel TimeInterval 6 ftCalculatedData Retorna para um ou mais Tags o resultado de opera es matem ticas aplicadas aos dados entre os instantes definidos pelas vari veis StartTime e EndTime a intervalos fixos definidos pela vari vel TimeInterval NOTA As vari veis tamb m podem ser definidas em tempo de execu o a partir da chamada do m todo
353. na no objeto Se for especificado somente o valor de coluna a propriedade Column l ou escreve a coluna especificada na linha atual do objeto Por exemplo MinhaListadeselecao Column 3 l ou escreve a terceira coluna do objeto Esta propriedade acess vel apenas em tempo de execu o 7 3 4 3 10 ColumnCount 9 A propriedade ColumnCount especifica o n mero de colunas do objeto A configura o de ColumnCount como 0 n o exibe nenhuma coluna e a configura o desta propriedade como 1 exibe todas as colunas dispon veis O valor padr o desta propriedade 1 7 3 4 3 11 ColumHeads Fi A propriedade ColumnHeads habilita ou desabilita a exibi o do t tulo das colunas no objeto Se a propriedade estiver configurada para True o t tulo mostrado Caso contr rio o t tulo das colunas n o mostrado O valor padr o False 7 3 4 3 12 ColumnWidths aP A propriedade ColumnWidths utilizada para especificar a largura da coluna do objeto em pontos Um valor igual a 1 ou em branco faz com que a largura seja calculada na coluna a largura m nima de uma coluna calculada 72 pontos ou 1 polegada Um valor igual a O oculta a coluna Para produzir colunas mais estreitas deve se especificar a largura na propriedade ou utilizar alguma dos valores a seguir Op es dispon veis para ColumnWidths OP O DESCRI O 90 72 90 A primeira coluna possui 90 pontos 1 25 polegada a segunda coluna possui 72 pontos 1
354. na tela acusando a falta de dados para imprimir e cancele o relat rio 22 1 9 OnPageEnd OnPageEnd Ocorre ao final da impress o de cada p gina do relat rio 22 1 10 OnPageStart OnPagesStart Ocorre no in cio da impress o de cada p gina do relat rio Relat rios 473 22 1 11 OnPrintProgress OnPrintProgress PageNumber Ocorre enquanto uma p gina do relat rio est sendo impressa Avari vel PageNumber indica o n mero da p gina atual 22 1 12 OnReportEnd OnReportEnd Disparado no final da gera o do relat rio ap s finalizar a sua impress o 22 1 13 OnReportStart OnReportStart Disparado no in cio da gera o do relat rio antes de come ar a sua impress o 22 2 M todos Esta se o cont m informa es sobre os m todos do objeto Relat rio 22 2 1 Export Export ExportFilter ExportFileName Imprime um relat rio de acordo com o formato especificado no arquivo Este m todo possui o par metro strExportFilter que determina o filtro para o relat rio indicando o formato para a exporta o Pode assumir as seguintes op es e PDF Exporta os dados para o formato Adobe PDF e Excel Exporta os dados para o formato de planilha Excel e HTML Exporta os dados para o formato HTML e TEXT Exporta os dados para um arquivo texto e RTF Exporta os dados para o formato Rich Text Format e TIFF Exporta os dados para o formato Tag Image File Format 474 Relat rios
355. nd O m todo SetForegroundWnd ativa e d o foco para a janela do Viewer Este m todo til quando se deseja chamar a aten o do operador para algum evento ocorrido quando a janela do Viewer encontra se escondida ou minimizada Exemplo Sub CommandButton1 clickQO Application GetFrame outro setForegroundwnd O End sub Quadros e Divisores 275 8 1 12 SetDisableTaskSwitching SetDisableTaskSwitching Disable Habilita ou desabilita a troca de janelas O par metro Disable um valor booleano que indica se a troca de janelas ser habilitada ou n o Este m todo atualiza a propriedade DisableTaskSwitching do objeto Viewer 8 1 13 SetFrameOptions SetFrameOptions Title Flags Utilizado para configurar o t tulo do frame na janela e o estilo da janela O par metro Title um String que cont m o t tulo da janela Este texto ser mostrado se a propriedade Caption da Tela estiver vazia O par metro Flags especifica o estilo da janela Se este par metro for omitido o valor padr o ser 1 Este valor usado para manter a configura o anterior da janela Quando o valor especificado n o for 1 pode se modificar o estilo da janela especificando a soma dos valores das seguintes combina es Combina es poss veis para o par metro Flags VALOR DESCRI O 1 Habilita a barra de t tulo na janela 2 Habilita o bot o Fechar na janela 4 Habilita o bot o Minimizar na janela 8 Habili
356. nde o E3Chart est posicionado 18 3 23 Legend 58 Retorna o objeto legenda do E3Chart A partir da as propriedades da legenda podem ser modificadas 18 3 24 MouseMode P seleciona uma das op es de runtime do menu do E3Chart Os valores poss veis para essa propriedade s o e 0 MouseModeZoom Coloca o mouse em modo zoom por rea selecionada Esta op o est dispon vel nos gr ficos de escala num rica em XY e escala fixa Equivale a selecionar a op o Caixa de Zoom do menu de runtime do E3Chart e 1 MouseModePan Coloca o mouse em modo de movimenta o das escalas Equivale a selecionar a op o Mover do menu de runtime do E3Chart e 2 MouseModePanH Coloca o mouse em modo de movimenta o das escalas somente na dire o horizontal Equivale a selecionar a op o Mover horizontalmente do menu de runtime do E3Chart e 3 MouseModesSearch Coloca o mouse em modo de pesquisa de valores nos dados das penas Equivale a selecionar a op o Pesquisar do menu de runtime do E3Chart e 4 MouseModecCursors Habilita a op o de pesquisa de intervalos de tempo Equivale a selecionar a op o Pesquisar Intervalos do menu de runtime do E3Chart 18 3 25 MouseOver Fi A propriedade MouseOver informa se o ponteiro do mouse encontra se em cima da Tela Caso afirmativo a propriedade MouseOver habilitada do contr rio ser False Esta propriedade somente de leitura e acess vel apenas em tempo de execu o O valor p
357. ndo se a op o Propriedades Na aba Scripts da view do objeto pode se ver a caixa combo onde se define qual evento ser o gerador do script Como visto no cap tulo anterior existem dois tipos de eventos em um objeto do E3 os pr definidos e os definidos pelo usu rio Os eventos pr definidos variam de objeto para objeto dependendo da sua utiliza o e funcionalidade Um objeto de tela por exemplo possui eventos relacionados interface gr fica como OnClick chamado ao clicar sobre o objeto ou OnDbcClick chamado com um duplo clique j um objeto como um Driver de Comunica o possui eventos relacionados comunica o como OnCommeError chamado quando h um erro de comunica o Pode se tamb m definir outros eventos para o objeto como visto anteriormente Quando um script associado a um evento em um objeto o campo de digita o apresenta uma declara o de procedimento procedure cuja defini o autom tica Programando no E3 23 e composta do seguinte texto Sub NomeDoobjeto NomeDoEvento End sub Onde NomeDoobj eto o nome do objeto associado e NomeDoEvento o nome do evento em quest o Os comandos do script dever o estar entre essas duas linhas Para ajudar na digita o do script pode se utilizar o AppBrowser Ao se escolher o m todo ou propriedade desejada pode se acessar o bot o Copiar Otag propriedade ou m todo escolhidos ser o inseridos na posi o do cursor no quadro de edi
358. nem propriedades associadas 7 4 2 2 1 M todos Esta se o cont m informa e sobre os m todos do objeto Cole o de Zonas 7 4 2 2 1 1 Add Add AxisName Adiciona uma nova zona na cole o de zonas O par metro AxisName opcional e n o tem efeito sendo mantido por quest es de compatibilidade com vers es anteriores 7 4 2 2 1 2 Remove Remove Index Remove uma zona O par metro Index indica o ndice da zona que deve ser removida 7 4 2 3 Zonas Define um conjunto de imagens de bitmap que ser o usadas para criar o efeito de anima o no objeto As zonas podem ser configuradas acessando a janela Propriedades do objeto na aba EZAnimation As op es dessa janela s o as seguintes Op es dispon veis na aba EZAnimation OP O DESCRI O Zonas Listagem com todas as zonas definidas no objeto Bot o Adicionar Adiciona uma nova zona 248 ActiveX Bot o Remover Apaga a zona selecionada Zona Padr o Define a zona selecionada como a zona padr o do objeto Pisca Define se o bitmap ir piscar quando o valor do objeto estiver dentro do intervalo da zona Dica Mostra um texto de ajuda sobre a zona M nimo Valor m nimo para a varia o da zona M ximo Valor m ximo para a varia o da zona Arquivo de imagem Nome do arquivo de bitmap que ser mostrado quando o valor do objeto estiver dentro do intervalo da z
359. nforma a express o utilizada para avaliar as condi es de alarme O limite deste campo quando armazenado no Banco de Dados de 100 caracteres Por exemplo Dados TagDemo1 Value e SubConditionNam Nome da subcondi o se for um evento de alarme Este campo pode assumir os valores e BM Alarme de Banda Morta e DIG Alarme Digital e TV Alarme Taxa de Varia o e LOLO Alarme Anal gico na faixa Muito Baixo e LO Alarme Anal gico na faixa Baixo e Hi Alarme Anal gico na faixa Alto e HIHI Alarme Anal gico na faixa Muito Alto Se o evento n o for um alarme por exemplo se ele estiver usando o m todo LogTrackingEvent do Servidor de Alarmes este campo ser igual a uma string vazia O limite deste campo quando armazenado no Banco de Dados de 100 caracteres UserField Propriedade de leitura indexada cujo ndice varia de 1 at 4 contendo os campos criados pelo usu rio Exemplo Dim evt Set evt GetFocusedEvent O If NoT evt Is Nothing Then Dim str str str amp EventTime amp evt EventTime amp chr 13 str str amp EventTimeuTC amp evt EventTimeuTC amp Chr 13 str str amp InTime amp evt InTime amp chr 13 str str amp outTime amp evt OutTime amp Chr 13 str str amp ackTime amp evt ackTime amp Chr 13 str str amp currentvalue amp evt Currentvalue amp Chr 13 str str amp actorID
360. nha no eixo X O valor padr o desta propriedade vazio 22 6 7 1 6 Y1 9 Apropriedade Y1 determina a posi o do ponto inicial da linha no eixo Y Ovalor padr o desta propriedade vazio 22 6 7 1 7 Y2 propriedade etermina a posi o do ponto final da linha no eixo Y O valor 9a iedade Y2 d i i od final da linh ixo Y O val padr o desta propriedade vazio 22 6 8 Quebra de P gina Esta se o cont m informa es sobre propriedades do objeto Quebra de P gina do Relat rio Este objeto n o possui eventos nem m todos associados 22 6 8 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Quebra de P gina do Relat rio 516 Relat rios 22 6 8 1 1 Enabled F A propriedade Enabled habilita ou desabilita o objeto no relat rio Se a op o estiver configurada para True o objeto habilitado no relat rio Caso contr rio o objeto fica desabilitado O valor padr o desta propriedade True 22 6 9 Tabela Esta se o cont m informa es sobre propriedades do objeto Tabela do Relat rio Este objeto n o possui eventos nem m todos associados 22 6 9 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Tabela do Relat rio 22 6 9 1 1 CanGrow FI Determina a aplica o do efeito de stretch ao texto do objeto Caso a largura ou altura do objeto sejam aumentadas o texto acompanha esta varia o Se a propriedade estiver configurada para True
361. nido Vazio 1 _Null Valor nulo 2 Integer Valor unidimensional Inteiro de 16 bits sinalizado 3 Long Valor unidimensional inteiro de 32 bits sinalizado Drivers 101 OP O DESCRI O 4 Single Valor unidimensional de ponto flutuante de 32 bits 5 Double Valor unidimensional de ponto flutuante de 64 bits 6 Currency Valor unidimensional monet rio com 4 casas decimais 7 Date Valor de data hora 8 String Valor literal Texto 9 Object Valor unidimensional de refer ncia a um objeto 10 Error Valor unidimensional de c digo de erro 11 Boolean Valor unidimensional booleano verdadeiro ou falso 12 Variant Dados de qualquertipo usados para objetos e outros valores para os quais otipo de dados desconhecido 13 UnkObject Valor unidimensional de refer ncia a um objeto 14 Decimal Valor unidimensional de ponto flutuante de 96 bits 36 Record Valor unidimensional de grava o 16 Char Valor unidimensional inteiro de 8 bits 17 Byte utilizado para cria o de DLLs e para OLE Ocupa 1 byte de mem ria 18 Word Valor unidimensional inteiro de 16 bits 19 Dword Valor unidimensional inteiro de 32 bits 20 Longlong Valor unidimensional inteiro de 64 bits sinalizado 21 DDWord Valor unidimensional inteiro de 64 bits 22 Integer N meros sem decimais cujo int
362. no par metro definido em TagName Otipo e o valor do par metro NewVal dever o ser suportados pelo objeto especificado em TagName Exemplo Sub Botaol Click Ao clicar em Botaol atribui o valor 20 para a propriedade Value do tag application setvalue Dataserveri InternalTag1 20 End Sub 10 2 26 ShowDatePicker ShowDatePicker DateValue Left Top DefaultDate Abre uma caixa de di logo para a altera o da data e da hora Este m todo retorna True se o usu rio confirmar a data ou False se o usu rio cancelar a edi o Anova data retornada no par metro DateValue A posi o da caixa de di logo pode ser configurada atrav s dos par metros Left e Top que indicam a dist ncia da margem esquerda e do topo da tela em pixels respectivamente Caso estes par metros n o sejam informados a caixa de di logo fica centralizada O valor do par metro DefaultDate a data e a hora iniciais quando a caixa de di logo for aberta Se n o for informada a data o sistema assume a data atual se n o for informada a hora iniciar como 00 00 00 Se nem a data nem a hora forem informadas iniciar com data e hora atuais Exemplos sub Texto Cl ickQO Dim novaHora Application showDatePicker novaHora 300 300 MsgBox A hora amp novaHora End Sub 310 Viewer 10 2 27 ShowrFilePicker ShowFilePicker Open FileName Extension Flags Filter Exibe as caixas de di logo Salvar e Abrir Arquivo do Windows O par m
363. nt PI Esta propriedade habilita ou desabilita a transpar ncia do objeto baseada na cor definida na propriedade TransparentColor 7 4 3 1 3 TransparentColor E Define qual cor ser considerada pela propriedade IsTransparent como sendo transparente O valor padr o desta propriedade branco RBG 255 255 255 250 ActiveX 7 4 4 E2Button Esta se o cont m informa es sobre eventos e propriedades do objeto E2Button Este objeto n o possui m todos associados 7 4 4 1 Eventos Esta se o cont m informa es sobre os eventos do objeto E2Button 7 4 4 1 1 OnRelease OnRelease Este evento gerado quando o bot o do mouse solto 7 4 4 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto E2Button 7 4 4 2 1 Action aP Esta propriedade define o comportamento do objeto E2Button quando clicado Os valores poss veis para esta propriedade s o e 0 Momentary Comportamento normal do bot o aparecendo rebaixado somente enquanto o mouse est pressionado e 1 Toggle Possui dois estados ligado e desligado e 2 Jog Alterna entre dois valores um quando o bot o pressionado e outro quando o bot o solto Ovalor padr o desta propriedade 0 Momentary ActiveX 251 7 4 4 2 2 Alignment Determina o alinhamento do texto do bot o Os valores poss veis desta propriedade s o e O HorizontalAlignmentLeft Alinha o texto esquerda e 1 HorizontalAli
364. nte comum na programa o de scripts no E3 Ela facilita a manipula o de objetos e deixa o c digo mais intelig vel Exemplo sub CommandButtonl Click atribui o valor 20 propriedade Value do objeto TagInternol que est em Dados Set a Application Getobject Dados TagInterno1 tag valu End Sub 2 7 2 8 Item Item ltemid Retorna a refer ncia para o objeto filho Itemld do objeto que chamou o m todo O m todo Item pode buscar um objeto tanto pelo nome quanto pelo ndice inteiro de 1 at o especificado na propriedade Count Se o ndice ou o nome especificado for v lido o m todo Item retorna a refer ncia do objeto Caso contr rio o m todo retorna um erro de Par metro Inv lido Exemplo Sub Telal clickO Atribui a obj a refer ncia para o objeto filho Botaol de Telal Set obj Ttem Botao1 Configura a propriedade BackColor de obj ou seja de Botaol obj Backcolor RGB 255 0 0 End Sub 2 7 2 9 Save Save Este m todo salva o objeto especificado que foi modificado em tempo de execu o runtime Os objetos filho tamb m ser o salvos conforme as especifica es do objeto pai Este m todo n o v lido para os objetos Tela e Viewer Exemplo Sub CommandButton1 clickQO Set area Application Getobject configalarms addobject Area True Application Getobject configalarms save End sub NOTA As modifica es feitas em runtime e salvas no objeto s ser o vi
365. ntes par metros e Col identifica a coluna a ser inserida ver Tabela de Identifica o das Colunas no in cio do t pico M todos da Legenda e Index determina a posi o em que a coluna ser inserida Exemplo Sub CommandButtonl Click screen Item E3Chart1 Legend Insertcolum 1 2 End sub Sub CommandButtonl clickQO Ela Item E3Chart1 Legend Insertcolum color 2 End Su 18 9 1 4 Item Item Col Retorna uma coluna da legenda pelo nome ou pelo ndice O par metro Col determina o ndice ou o nome da coluna ver Tabela de Identifica o das Colunas no in cio do t pico M todos da Legenda Exemplo Sub CommandButtonl clickQO MsgBox Screen Item E3Chart1 Legend Item 1 End Sub 18 9 1 5 RemoveColumn RemoveColumn Col Remove uma coluna Este m todo possui o par metro Col que determina a coluna que ser removida ver Tabela de Identifica o das Colunas no in cio do t pico M todos da Legenda Exemplo Sub CommandButtonl clickQO Screen Item E3Chart1 Legend RemovecoTumn 1 End sub E3Chart 455 18 9 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Legenda 18 9 2 1 Count 9 Retorna o n mero total de colunas da Legenda Exemplo sub CommandButtoniO click MsgBox Screen Item E3Chart1 Legend Count End Sub 18 9 2 2 LegendPos a Indica a posi o da legenda no E3Chart Op es dispon veis para LegendPos
366. nto de alarme Este campo pode apresentar os seguintes valores e Banda Morta Fonte de alarme do tipo banda morta e Digital Fonte de alarme dotipo digital e N vel Fonte de alarme dotipo anal gico e TaxaDeVaria o Fonte de alarme do tipo taxa de varia o Se o evento n o for um alarme por exemplo usando o m todo LogTrackingEvent do Servidor de Alarmes este valor ser sempre uma string vazia O limite deste campo quando armazenado no Banco de Dados de 100 caracteres 362 E3Alarm NOME DESCRI O CurrentValue Determina o valor da fonte de alarme convertido para Double no momento do evento Para outros eventos por exemplo usando o m todo LogTrackingEvent o valor ser sempre zero 0 O limite deste campo quando armazenado no Banco de Dados de 100 caracteres Enabled Determina se a verifica o do alarme est habilitada Este campo apresenta os estados 0 verifica o da fonte de alarmes desabilitada e 1 verifica o da fonte de alarme habilitada EventCategory Categoria do evento Para alarmes este campo pode assumir os seguintes valores e Banda Morta Fonte de alarme do tipo banda morta e Digital Fonte de alarme dotipo digital e N vel Fonte de alarme dotipo anal gico e TaxaDeVaria o Fonte de alarme do tipo taxa de varia o Para outros eventos por exemplo usando o m todo LogTrackingEvent do Servidor de Alarmes o campo po
367. ntro da se o especificada no caso o PageHeader e GridBkColor o nome da propriedade do objeto neste caso o E3Chart e RGB 255 0 255 o par metro ou a o da propriedade Neste caso mudara cor de fundo do gr fico para rosa Sendo assim para fazer se um script no relat rio usa se o seguinte conceito Report Sections NomeDaSe o Controls NomeDoobjeto NomeDaPropriedade par metros da propriedade NOTA O objeto Relat rio encapsula um objeto ActiveReports ou AR que o relat rio propriamente dito 478 Relat rios 22 3 1 Caption Cont m o t tulo do relat rio que aparece na barra de t tulo da janela de visualiza o preview O valor padr o desta propriedade vazio 22 4 Layout Esta se o cont m informa es sobre propriedades do objeto Layout do Relat rio Este objeto n o possui eventos nem m todos associados 22 4 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Layout do Relat rio 22 4 1 1 PageBottomMargin 9 Determina a margem inferior do relat rio em twips 1 twip 1 1440 polegada O valor padr o desta propriedade 1440 1 pol ou 2 54 cm 22 4 1 2 PageLeftMargin 9 Determina a margem esquerda do relat rio em twips 1 twip 1 1440 polegada O valor padr o desta propriedade 1440 1 pol ou 2 54 cm 22 4 1 3 PageRightMargin 9 Determina a margem direita do relat rio em twips 1 twip 1 1440 polegada
368. o Este m todo retorna um booleano que indica o sucesso ou n o da opera o Os par metros N1 a N4 correspondem aos par metros N do driver O par metro Value define o valor a ser escrito no driver Para maiores detalhes sobre estes par metros consulte a documenta o do driver Os par metros Timestamp Quality e WriteStatus s o opcionais Se omitidos o comportamento do m todo o mesmo do m todo Write Timestamp especifica a data hora a ser escrita no tag se suportada pelo equipamento Se omitido assumida a data hora do momento da opera o de escrita Quality indica a qualidade de 0 a 255 Se omitido assumida a qualidade Boa 192 WriteStatus recebe um valor retornado pelo driver que indica o status da escrita se suportado pelo driver de acordo com sua documenta o pr pria O par metro WriteSyncMode permite utilizar o modo de escrita diferente do utilizado no driver As op es dispon veis para este par metro s o 0 usa o modo de escrita configurado no driver 1 faz uma escrita s ncrona 2 faz uma escrita ass ncrona sem confirma o Se o par metro for omitido ser tamb m utilizado o modo de escrita configurado no driver Exemplo Dim status If Driverl writeex O O O O 100 status Then MsgBox Escrita feita com sucesso status amp status se MsgBox Escrita falhou status amp status End If 3 1 3 Propriedades Esta se o cont m informa es sobre as propriedades do o
369. o Alfanum rico de largura total 8 fmIMEMOdeAlpha IME ativado com modo Alfanum rico de meia largura 9 fmIMEMOode HangulFull IME ativado com modo Hangul de largura total 10 fmIMEMOde Hangul IME ativado com modo Hangul de meia largura 11 fmiIMEMOdeHanziFull IME ativado com modo Hanzi de largura total 12 fmIMEMOde Hanzi IME ativado com modo Hanzi de meia largura 7 3 4 3 21 LineCount 9 Apropriedade LineCount retorna o n mero de linhas do objeto Esta propriedade acess vel apenas em tempo de execu o 202 ActiveX 7 3 4 3 22 List Retorna ou define as entradas da linha e da coluna na lista do objeto Anumera o de linha e de coluna come a com zero Isto o n mero de linha da primeira linha na lista zero o n mero de coluna da primeira coluna zero O n mero da segunda linha ou coluna 1 e assim por diante Esta propriedade acess vel apenas em tempo de execu o 7 3 4 3 23 ListCount 9 Retorna o n mero de itens contidos na lista do objeto Esta propriedade acess vel apenas em tempo de execu o 7 3 4 3 24 Listindex 9 identifica o item atualmente selecionado na lista chamado de ndice Os valores de Listindex v o de 1 ao n mero total de linhas em uma lista menos um isto ListCount 1 Quando nenhuma linha selecionada Listindex retorna 1 Quando o usu rio seleciona uma linha em uma Lista de se
370. o MsgBox para mostrar a mensagem Como fazer uma consulta com filtro por data antes de montar um relat rio Para fazeristo necess rio configurar o objeto Consulta ver cap tulo Consulta que acompanha o relat rio e criar as vari veis necess rias na coluna Filtro No evento de chamada de relat rio use um script semelhante ao seguinte set relatorio application LoadReport Relat rio1 set consulta Relatorio Query Consulta SetVariablevalue variavel1 Valorl Consulta SetVariablevalue variavel2 Valor2 Relatorio PrintPreviewQO Onde e Relat rio1 o nome do relat rio a ser chamado e Variavel1 Variavel2 s o as vari veis criadas no filtro do campo E3TimeStamp e Valor1 Valor2 s o as datas a serem consultadas Para verificar outros tipos de filtros consulte o cap tulo Consultas ou a documenta o dispon vel no Elipse Knowledgebase Como depurar erros de scripts no servidor e no Viewer Caso o evento seja executado no Viewer utilize o m todo MsgBox J se o evento for executado no servidor utilize o m todo Trace D vidas Mais Frequentes 521 eli Matriz Rua 24 de Outubro 353 10 andar 90510 002 Porto Alegre RS Fone 51 3346 4699 Fax 51 3222 6226 E mail elipseGelipse com br software Filial SP Rua dos Pinheiros 870 Conj 141 142 05422 001 S o Paulo SP Fone 11 3061 2828 Fax 11 3061 2828 E mail elipse speelipse com br USA 40190 Jarvis Gray Lane
371. o a rea dispon vel para o texto ultrapasse os limites determinados no objeto Para que esta propriedade funcione a propriedade Multiline deve ser obrigatoriamente igual a True 7 3 7 Lista Esta se o cont m informa es sobre m todos e propriedades do objeto Lista Este objeto n o possui eventos associados 7 3 7 1 M todos Esta se o cont m informa es sobre os m todos do objeto Lista 7 3 7 1 1 Addltem Additem pvargitem pvargindex O m todo Additem utilizado para se adicionar itens a uma Lista pvargitem um string que cont m o texto que ser adicionado lista se for omitido ser acrescentado um string em branco pvargindex o ndice do texto na lista se for omitido pvargitem adicionado como ltimo item da lista Exemplo Sub CommandButtonl Click EntryCount EntryCount 1 ListBox1 AddItem EntryCount amp selection End sub 216 ActiveX 7 3 7 1 2 Clear Clear Limpa o texto do objeto Exemplo Sub clearTextButton Click ListBox1 Clear End sub 7 3 7 1 3 Removeltem Removeltem pvargindex Remove itens da Lista Este m todo possui o par metro pvargindex que especifica a linha que ser exclu da iniciando em zero Ou seja o primeiro elemento 0 0 segundo 1 e assim por diante Exemplo sub commandButton2 clickQO List1 SetFocus Verifica se a lista cont m dados selecionados If Listl ListCount gt 1 Then Se n o h nenhuma sele o escolhe
372. o a um objeto ElipseX s pode ser feito atrav s de suas propriedades utilizando suas inst ncias criadas N o poss vel acessar objetos internos diretamente Se o ElipseX em quest o for um XControl ele se comporta como um objeto de Tela Por exemplo na seguinte aplica o Organizer TA Dominio Projeto Configura o Bibliotecas de Objetos 5i sa XObjects E XObject 1 E XControls 1 4 XControl1 m Viewer e Quadros E Viewer 15 Telas S E Telalnicial XControl11 a Relat rios 58 Recursos Objetos de Servidor By Drivers e OPC i Objetos de Dados G E Dados Qiy XObject11 Banco de Dados E Aa Alames H sa Explorer E E E XControl exemplo Para alterar a propriedade Propriedade1 do XControl pode se fazer o seguinte script no bot o Programando no E3 33 Sub CommandButtonl clickQO screen Item xContro111 Propriedadel True End sub Ou ainda sub commandButton1 Click parent aca 11 Propriedadel True End su No caso de um XObject deve se inser lo em um Servidor de Dados EEEEXHESEIITTTTTTTTTOOOOOOOOOOOOOO ds p Visualizar Objetos Arranjar Ferramentas Janela Ajuda Je o3 reou aa Je E ler PT E A SAGE A i T Ca h h zoom camadas E Ec Configura o 3 8 Bibliotecas de Objetos Visualiza o E Objetos de Servidor E Drivers e OPC c i Objetos de Dados Dados e XObject11 Hj Banco de Dados M Names 5 Explorer
373. o com os par metros B1 at B4 Criando os elementos para o bloco possibilita acessar os valores lidos e tamb m permite a escrita de valores para o equipamento ou dispositivo Esta propriedade n o pode ser modificada ap s iniciada a comunica o Ovalor padr o desta propriedade 0 Exemplo sub BlocooPcl OnStartRunning O size 12 End sub 3 7 1 9 SyncWrite FI A propriedade SyncWrite determina o tipo de escrita usada por um Bloco OPC Se a propriedade estiver configurada para True a escrita ser s ncrona isto o Driver OPC espera o resultado da escrita do servidor Caso contr rio a escrita ass ncrona isto o valor do OPCTag ser enviado e o processamento do Driver OPC continuar imediatamente O valor padr o desta propriedade False 3 7 1 10 TimeStamp E A propriedade TimeStamp atualizada sempre que ocorrer alguma mudan a de valor ou de estado nas propriedades Value ou Quality Ele informa qual a data hora associada tanto ao valor quanto qualidade do Bloco OPC Esta uma propriedade somente para leitura O valor padr o desta propriedade 00 00 00 Drivers 105 3 8 Elemento de Bloco de Comunica o OPC Esta se o cont m informa es sobre propriedades do objeto Elemento de Bloco de Comunica o OPC Este objeto n o possui eventos nem m todos associados 3 8 1 Propriedades Esta se o cont m as propriedades do objeto Elemento de Bloco de Comunica o OPC 3 8 1 1 BitOO Bit
374. o de Comunica o Este objeto n o possui eventos associados 78 Drivers 3 4 1 M todos Esta se o cont m informa es sobre os m todos do objeto Elemento de Bloco de Comunica o 3 4 1 1 Write Write WriteSyncMode Faza escrita do valor corrente do elemento de bloco no equipamento Normalmente este comando de script s usado quando a propriedade AllowWrite deste objeto for False O par metro WriteSyncMode permite utilizar o modo de escrita diferente do utilizado no driver As op es dispon veis para este par metro s o 0 usa o modo de escrita configurado no driver 1 faz uma escrita s ncrona 2 faz uma escrita ass ncrona sem confirma o Se o par metro for omitido ser tamb m utilizado o modo de escrita configurado no driver Para maiores detalhes consulte a documenta o do driver Este m todo retorna um booleano que indica o sucesso ou n o da opera o 3 4 1 2 WriteEx WriteEx Value Timestamp Quality WriteStatus WriteSyncMode Faza escrita de um valor no equipamento Todos os seus par metros s o opcionais se omitidos o comportamento do m todo igual ao do m todo Write Este m todo retorna um booleano que indica o sucesso ou n o da opera o O par metro Value define o valor a ser escrito no driver Otipo de dado depende do driver se omitido assumido o valor corrente do tag Timestamp especifica a data hora a ser escrita no tag se suportada pelo equipamento
375. o e o valor contido na propriedade Valuel se o bot o est pressionado 7 4 4 2 15 Value0 Define o valor da propriedade Value quando o bot o n o est pressionado 7 4 4 2 16 Value Define o valor da propriedade Value quando o bot o est pressionado 7 4 5 E2Display Esta se o cont m informa es sobre propriedades do objeto E2Display Este objeto n o possui eventos nem m todos associados 254 ActiveX 7 4 5 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto E2Display 7 4 5 1 1 BackgroundColor E Esta propriedade define a cor de fundo do objeto O valor padr o desta propriedade cinza RGB 192 192 192 7 4 5 1 2 BackgroundStyle a Define o estilo de fundo do objeto Os valores desta propriedade s o os seguintes e O bsTransparent o fundo transparente e 1 bsOpaque a cor definida em BackgroundColor v sivel Ovalor padr o desta propriedade 1 bsOpaque 7 4 5 1 3 Format A Cont m um texto que representa uma m scara dentro da qual os valores do objeto ser o mostrados Esta m scara pode representar v rios tipos de valores e Geral N o possui formata o espec fica adaptando se automaticamente ao valor especificado e N mero Apresenta n meros com parte inteira e fracion ria O usu rio pode optar por at 15 casas decimais por usar ou n o um separador de milhares e por apresentar n meros negativos com sinal ou entre par nteses Para n meros mu
376. o esquerdo do objeto no relat rio 22 6 1 5 Name Determina o nome do objeto O valor padr o desta propriedade vazio 22 6 1 6 Tag Retorna o tipo do tag associado ao objeto isto Boolean String Integer etc 22 6 1 7 Top 9 Retorna o valor do topo do objeto 496 Relat rios 22 6 1 8 Visible FI Determina a visibilidade do objeto no relat rio Se a op o estiver configurada para True o objeto vis vel no relat rio Caso contr rio o objeto est oculto O valor padr o desta propriedade True 22 6 1 9 Width 9 Esta propriedade determina a largura do objeto no relat rio 22 6 2 C digo de Barras Esta se o cont m informa es sobre propriedades do objeto C digo de Barras do Relat rio Este objeto n o possui eventos nem m todos associados 22 6 2 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto C digo de Barras do Relat rio 22 6 2 1 1 Alignment a Determina o alinhamento do texto do objeto no relat rio As op es dispon veis s o as seguintes e O ddtxLeft alinha o texto esquerda do objeto e 1 ddtxRight alinha o texto direita do objeto e 2 ddtxCenter alinha o texto ao centro do objeto Relat rios 497 22 6 2 1 2 BarWidth 9 Determina a largura das barras do C digo de Barras Configurando a largura para 1 a barra do objeto expandida em at 15 pontos e assim por diante Quanto maior o n mero configurado na propr
377. o n mero de caracteres selecionados no objeto Esta propriedade acess vel apenas em tempo de execu o 7 3 9 3 26 SelStart 9 Indica o ponto inicial do texto selecionado ou o ponto de inser o se nenhum texto for selecionado Esta propriedade acess vel apenas em tempo de execu o 7 3 9 3 27 SelText 9 Retorna o texto selecionado no objeto Esta propriedade acess vel apenas em tempo de execu o 7 3 9 3 28 SpecialEffect aP A propriedade SpecialEffect especifica a apar ncia de um objeto As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para SpecialEffect OP O DESCRI O 0 fmSpecialEffectFlat O objeto aparece plano e possui um destaque na borda uma altera o de cor ou ambos 1 fmSpecialEffectRaised O objeto possui um destaque na parte superior esquerda e uma sombra na parte inferior direita O objeto parece estarem relevo 2 fmSpecialEffectSunken O objeto possui uma sombra na parte superior esquerda e um destaque na parte inferior direita O objeto e a sua borda parecem estar afundados na Tela 3 fmSpecialEffectEtched Aborda parece estar esculpida ao redor da extremidade do objeto 6 fmSpecialEffectBump O objeto possui um ressalto na parte inferior direita e parece plano na parte superior ActiveX 239 OP O DESCRI O esquerda
378. o tag mudar O valor padr o desta propriedade verdadeiro 7 4 7 1 13 Select AlOnFocus F Habilita ou desabilita a sele o de todos os caracteres do E2Setpoint quando o objeto recebe o foco O valor padr o dessa propriedade verdadeiro ActiveX 265 7 4 7 1 14 TextColor E Define a cor do texto do objeto O valor padr o desta propriedade preto RGB 0 0 0 7 4 7 1 15 TextFont AA propriedade TextFont utilizada para determinar a fonte do objeto Esta propriedade n o pode ser utilizada em scripts ou em associa es sendo configurada unicamente via Studio 7 4 7 1 16 Type aP Define o tipo de Setpoint Os valores poss veis desta propriedade s o os seguintes e O setpointString aceita quaisquer caracteres alfan mericos e 1 setpointNumeric aceita somente caracteres n mericos e o separador decimal ponto ou v rgula dependendo das configura es regionais e 2 setpointDateTime aceita somente valores de data hora que ser o convertidos para o formato definido nas configura es regionais Ovalor padr o desta propriedade 1 setpointNumeric 7 4 7 1 17 Value Esta propriedade define um valor para o E2Setpoint Aforma como esse valor ser visualizado definida na propriedade Format 7 4 7 1 18 VerticalAlignment a Define o alinhamento vertical do texto do E2Setpoint Os valores desta propriedade s o os seguintes e 0 VerticalAlignmentTop alinha verticalmente com a parte superior do
379. objeto e 1 VerticalAlignmentMiddle alinha verticalmente com o centro do objeto e 2 VerticalAlignmentBottom alinha verticalmente com a parte inferior do objeto 266 ActiveX Ovalor padr o desta propriedade 1 VerticalAlignmentMiddle 7 4 7 1 19 VScroll F Habilita ou desabilita a exibi o de uma barra de rolagem vertical no texto caso a propriedade Multiline esteja em True 7 4 8 EZText Esta se o cont m informa es sobre propriedades do objeto E2Text Este objeto n o possui eventos nem m todos associados 7 4 8 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto E2ZText 7 4 8 1 1 BlinkTime 9 Define o intervalo de tempo em milissegundos do efeito de pisca do objeto 7 4 8 1 2 DefaultZone 9 Define a zona padr o do objeto 7 4 8 1 3 Value Esta propriedade cont m um Variant que pode assumir valores de todo e qualquer tipo de dados Integer Boolean String etc 7 4 8 2 Cole o de Zonas Esta se o cont m informa es sobre os m todos do objeto Cole o de Zonas do E2Text Este objeto n o possui eventos nem propriedades associadas ActiveX 267 7 4 8 2 1 M todos Esta se o cont m informa es sobre os m todos do objeto Cole o de Zonas do E2Text 7 4 8 2 1 1 Add Add AxisName Adiciona uma nova zona na cole o de zonas O par metro AxisName opcional e n o tem efeito sendo mantido por quest es de compatibilidade com vers es anterio
380. objeto Exemplo Sub CommandButtonl clickO MsgBox Screen Item Dynami cMovel RangeMax End Sub 6 2 9 1 9 RangeMin 9 atrav s da propriedade RangeMin determinado o alcance m nimo do movimento linear ou rotacional no objeto Exemplo Sub CommandButton1 clickQO MsgBox Screen Item Dynami cMovel RangeMin End Sub 174 Telas e Objetos de Tela 6 2 9 1 10 Shadow F Indica a presen a do efeito de sombra no objeto Se True o objeto possui uma sombra cujas coordenadas s o estabelecidas pelas propriedades ShadowX e ShadowY Do contr rio o objeto n o possui o efeito de sombra O valor padr o desta propriedade False 6 2 9 1 11 ShadowColor E Especifica a cor do preenchimento da sombra do movimento Esta cor utilizada quando a propriedade Shadow est configurada para True Nos scripts utilize a fun o do VBScript RGB para montar a cor a ser associada a esta propriedade O valor padr o desta propriedade cinza escuro RGB 128 128 128 Exemplo Sub Botaol Click Troca a cor de fundo do botao para cinza claro quando clica no obj objeto Shadowcolor RGB 192 192 192 End sub 6 2 9 1 12 ShadowX 9 Define a coordenada vertical esquerda da sombra deste objeto em unidades Himetric Este sombra sempre relativa a propriedade X do objeto Valores positivos indicam que a sombra estar direita do objeto e negativos esquerda O valor padr o desta propriedade 200 6 2 9 1 13 Shadow
381. objeto SetPoint do Relat rio 22 6 5 1 1 Alignment P Determina o alinhamento do texto no objeto As op es dispon veis para esta propriedade s o e O Left alinhamento esquerda padr o e 1 Right alinhamento direita e 2 Center alinhamento centralizado 22 6 5 1 2 CanGrow PI Determina a aplica o do efeito de stretch ao texto do objeto Caso a largura ou altura do objeto sejam aumentadas o texto acompanha esta varia o Se a propriedade estiver configurada para True o texto acompanha as varia es de altura e largura do objeto Caso contr rio este permanece com as configura es iniciais O valor padr o desta propriedade True 22 6 5 1 3 CanShrink Fi Determina a aplica o do efeito de encolhimento ao texto do objeto Caso a largura ou altura do objeto sejam diminu das o texto acompanha esta varia o Se a propriedade estiver configurada para True o texto acompanha as varia es de altura e largura do objeto Caso contr rio este permanece com as configura es iniciais O valor padr o desta propriedade True Relat rios 507 22 6 5 1 4 ClassName Retorna a classe do objeto Esta propriedade somente de leitura 22 6 5 1 5 DataField A Configura ou retorna o dado associado ao objeto Este dado associado pode ser um campo da tabela no Banco de Dados fornecido pelo objeto Consulta uma express o matem tica com campos da Consulta e fun es do VBScript neste caso o campo deve ser
382. odo a exemplo do m todo AddField foi inclu do para manter a compatibilidade com as vers es antigas da consulta do E3Chart Exemplo Sub CommandButton1 clickQO Screen Item E3Browser Item Consulta RemoveField Campo1 End sub 16 2 9 RemovesStorageTag RemoveStorageTag Name Remove um tag previamente configurado na consulta O par metro Name indica o nome do tag Retorna um booleano indicando o sucesso ou n o da opera o 16 2 10 RemoveTable RemoveTable TableName Remove uma tabela da consulta O par metro TableName determina o nome da tabela a ser removida 16 2 11 SetVariableValue SetVariableValue VarName Value O m todo SetVariableValue ajusta o valor de uma vari vel configurada na consulta de forma que este valor possa ser informado como um filtro ou par metro antes de a mesma ser realizada Deve ser definido o nome da vari vel VarName e seu valor Value que pode ser um n mero texto ou data hora Exemplo sub commandButton Click Set cons Screen Item E3Browser1 Item Cconsultal DataInicial now 1 DataFinal now cons SetVariablevalue DataIni DataInicial cons SsetVariablevalue DataFim DataFinal End sub Consultas 391 16 3 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Consulta 16 3 1 CursorLocation P Define o local onde a consulta ser gerada e manipulada sob o ponto de vista do SGBD Sistema Gerenciador do Banco de
383. odos do objeto top 10 4 1 1 BringToFront BringToFront Traz para frente um divisor que esteja escondido ou abaixo de outro Exemplo sub top OnStartRunning O BringToFront O End su 10 4 1 2 Close Close Code Utilize o m todo Close para fechar a janela do objeto top O par metro Code ter o valor de retorno para o m todo DoModal se o objeto em quest o tiver sido chamado por este m todo Exemplo Sub BotaoFecha Click Quando BotaoFecha for clicado fecha o objeto top Item top Close 0 End sub 10 4 1 3 FlashWindow FlashWindow Number Time Este m todo faz com que o cone do Viewer comece a piscar na barra de tarefas do Windows O par metro Number determina o n mero de vezes que a tarefa deve piscar e Time determina o tempo em milissegundos entre um piscar e outro Exemplo Sub Textol Click set quadro application GetFrame top quadro Flashwindow 50 500 322 Viewer End sub 10 4 1 4 MaximizeFrame MaximizeFrame Maximiza um quadro ou Tela modal Exemplo sub commandButton4 Click Application Item top MaximizeFrame End Sub 10 4 1 5 MinimizeFrame MinimizeFrame Minimiza um quadro ou Tela modal Exemplo sub CommandButton4_ClickO Application Item top MinimizeFrame End Sub 10 4 1 6 MoveFrame MoveFrame PosxX PosY SizeX SizeY Move e redimensiona um Divisor Frame para uma coordenada e um tamanho espec ficos Os par metros PosX
384. ogramando no E3 45 2 7 2 5 DeleteObject DeleteObject ChildName Apaga do projeto o objeto especificado O par metro ChildName um String ignora mai sculas e min sculas que indica o objeto filho que se deseja apagar O m todo retorna True caso tenha conseguido apagar o objeto ou False caso o objeto filho n o exista Para se apagar um objeto a partir de uma refer ncia a um elemento utiliza se o m todo DeleteObject do objeto pai Exemplo sub CommandButtonl Click set obj Application Getobject Dados If obj Deleteobject Tag001 Then regras ted apagado com sucesso Else MsgBox Falha em apagar o tag n o existe End IF End sub 2 7 2 6 GetChildObject GetChildObject ObjectPath O m todo GetChildObject retorna uma refer ncia para o objeto filho apontado pelo par metro ObjectPath Com isso poss vel acessar todas as propriedades e m todos deste objeto semelhante ao funcionamento do m todo GetObject O m todo falhar se o caminho apontado por ObjectPath contiver uma propriedade ou m todo ao final O caminho apontado pelo objeto filho n o um caminho desde a raiz o arquivo prj e sim um caminho sempre a partir do objeto onde o m todo chamado 46 Programando no E3 2 7 2 7 GetObject GetObject ObjectPath O m todo GetObject retorna a refer ncia do objeto especificado em ObjectPath Isto permite acessar todas as propriedades ou m todos do objeto Esta uma pr tica basta
385. ol11 lib XControll xi Item Posi o Associa es s XValor Angle Count DocString Enabled HasFocus Height Layer MouseOver MouseOverChild Name PathContainer PathName PathVolume TabStop 9 9 A r 9 9 r r A A A A l XValor associa o 2 3 8 1 Exemplo de Cria o de um ElipseX Suponha que determinada aplica o necessite supervisionar e comandar 10 motores Cada motor precisa ser representado por um desenho na Tela que exibe a cor verde quando estiver operando e vermelho quando estiver desligado Tamb m deve ser permitido o comando do motor na Tela enviando instru es para ligar e desligar Sua velocidade tamb m deve ser exibida Uma possibilidade a cria o de um XControl chamado Motora com as propriedades Estado igual a Boolean e Velocidade igual a Double conforme a figura a seguir 36 Programando no E3 pl Motora ERES Nome Tpo 8 Estado Boolean ToggieSutton 1 ToggleButton Velocidade Double value Motora Estado Figurai DrawPicture loverrideFilColor Motora Estado a valor nica Texto de Ajuda F FE Texto1 DrawString Value Motora Velocidade ao Osso Propriedades SERIE Defini o do XControl 1 Para a indica o da cor a propriedade OverrideFillColor do motor deve estar associada propriedade Estado do XControl atrav s de uma associa o
386. olagem pelo conte do no objeto Quando o usu rio move o ponto de inser o para uma outra linha de texto rolando o conte do do objeto a propriedade CurTargetX especifica a posi o desejada para o ponto de inser o A propriedade CurX definida com este valor se a linha de texto for maior do que o valor de CurTargetX Caso contr rio CurX definido no fim da linha de texto Esta propriedade acess vel apenas em tempo de execu o 7 3 9 3 11 DragBehavior Pl Habilita ou desabilita o recurso de arrastar e soltar um texto no conte do do objeto As op es dispon veis para esta propriedade s o as seguintes e 0O fmDragBehaviorDisabled n o permite a a o de arrastar e soltar o texto no conte do do objeto 234 ActiveX e 1 fmDragBehaviorEnabled permite a a o de arrastar e soltar o texto no conte do do objeto Ovalor padr o desta propriedade 0 fmDragBehaviorDisabled NOTA A propriedade DragBehavior n o tem efeito se a propriedade Style estiver configurada para 2 7 3 9 3 12 EnterFieldBehavior aP Esta propriedade controla a forma como o conte do do texto selecionado na rea de edi o quando se pressiona a tecla TAB no objeto e n o quando o objeto recebe o foco como um resultado do m todo SetFocus As op es dispon veis para esta propriedade s o as seguintes e O fmEnterFieldBehaviorSelectAII valor padr o seleciona todo o conte do do texto quando a tecla TAB pressionada no objeto
387. olor para vermelho Dim obj For i 1 To Count Set obj Item i Pega objeto filho obj Foregroundcolor RGB 255 0 0 Next End sub 2 7 3 3 DocString Texto livre que tem por objetivo possibilitar a documenta o das funcionalidades ou caracter sticas do objeto pelos programadores do projeto Exemplo sub commandButtonl Click Docstring Este bot o ativa o condensador do sistema MsgBox Docstring End Sub Programando no E3 49 2 7 3 4 Links 58 Retorna um objeto que uma cole o das conex es ou associa es de um objeto qualquer do E3 Esta propriedade acess vel apenas em tempo de execu o 2 7 3 5 Name Identifica cada um dos objetos presentes no sistema Alterar esta propriedade implica em modificar todas as outras propriedades ou scripts que utilizam este objeto N o aconselh vel a altera o desta propriedade em tempo de execu o Exemplo Sub CommandButton9 clickQO MsgBox O nome da Tela End Sub amp Screen Name 2 7 3 6 Parent se Retorna o objeto pai deste objeto Sendo assim se um objeto est inserido na Tela a propriedade Parent retorna o objeto Tela Da mesma forma se um Tag Interno est inserido diretamente abaixo de um Servidor de Dados a propriedade Parent do Tag Interno apontar para o Servidor de Dados Exemplo sub Retangulol Click Ao clicar no Retangulol troca a cor do Retangulo2 Ambos objetos est o na mesma tela Parent Item Retangulo2
388. omin aumenta o zoom no E3Chart isto aproxima a visualiza o das penas Em tempo de execu o este recurso pode ser acessado atrav s do clique com o bot o direito do mouse sobre o objeto e selecionando a op o Mais Zoom do menu de contexto Exemplo E3Chart 413 Sub CommandButtonl clickQO screen Item E3Chart1 ZoomIn End sub 18 2 8 ZoomOut ZoomoOut O m todo ZoomOut diminui o zoom no E3Chart isto afasta a visualiza o das penas no E3Chart Em tempo de execu o este recurso pode ser acessado atrav s do clique como bot o direito do mouse sobre o E3Chart e selecionando a op o Menos Zoom Exemplo Sub CommandButton1l clickQO screen Item E3Chart1 Zzoomout O End sub 18 3 Propriedades Esta se o cont m informa es sobre as propriedades do objeto E3Chart 18 3 1 Axes 58 Retorna a cole o de eixos do E3Chart A partir da as propriedades da cole o de eixos podem ser modificadas 18 3 2 BackColor E Determina a cor de fundo do E3 Chart Para que esta cor apare a a propriedade ShowBackground deve estar configurada como True O valor padr o desta propriedade bege RGB 236 233 216 18 3 3 CursorBegin 9 Define a posi o do cursor inicial entre 0 e 1 necess rio executar o m todo ShowcCursor ou habilitar a op o Pesquisa de Intervalos para que os cursores apare am 18 3 4 CursorColor E Estabelece a cor do cursor de pesquisa de intervalo O valor pad
389. omparar o par metro de retorno do evento com o c digo em ASCII do caractere esperado Como criar um script WhileRunning Criando um evento associado a alguma propriedade que tenha sempre o mesmo valor Por exemplo a propriedade Visible de um objeto de tela Enquanto o objeto estiver vis vel Visible igual a True o script ser executado Por m recomendado evitar o uso de scripts WhileRunning pois estes podem prejudicar a performance da aplica o Na maioria dos casos eles podem ser substitu dos por associa es Como criar um script OnValueChanged Criando um evento associado propriedade Value do tag que seja executado quando a propriedade alterar o seu valor NOTA Aten o para n o usar m todos do Viewer no Server por exemplo um MsgBox Se for o caso o evento pode ser criado na tela ou at no pr prio objeto Viewer ao inv s de ser criado no tag 520 D vidas Mais Frequentes Como criar tags e objetos de tela durante a execu o Usando o m todo AddObject Por exemplo o script a seguir cria tags de comunica o no driverDriverl Set obj application Getobject Driver1 For i 1 To 100 Set tag obj addobject IoTag false tag Name IOTag amp Cstr i tag Activate Next Como mostrar uma mensagem natela ao alterar o valor de um tag Criando um evento na tela associado propriedade Value do tag que seja executado quando a propriedade alterar o seu valor Neste evento utilize o m tod
390. ona Exemplo Mostra uma pr via do arquivo de bitmap da zona selecionada 7 4 2 3 1 Propriedades Esta se o cont m informa es sobre as propriedades das Zonas do objeto E2 Animation 7 4 2 3 1 1 Blink FP Indica que esta zona participa do efeito de piscar O valor padr o dessa propriedade falso 7 4 2 3 1 2 Filename Indica qual o nome do arquivo de imagem utilizado na zona 7 4 2 3 1 3 Maximum 9 Define o valor m ximo para a zona O valor padr o dessa propriedade 20000 ActiveX 249 7 4 2 3 1 4 Minimum 9 Define o valor m nimo para a zona O valor padr o dessa propriedade O 7 4 2 3 1 5 TipEnable F Habilita ou desabilita a dica para a zona O valor padr o dessa propriedade falso 7 4 2 3 1 6 TipText Define a dica para a zona Ovalor padr o dessa propriedade em branco 7 4 3 EZBitmap Esta se o cont m informa es sobre propriedades do objeto E2Bitmap Este objeto n o possui eventos nem m todos associados 7 4 3 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto E2Bitmap 7 4 3 1 1 Filename 4d Define o nome do arquivo de imagem associado ao E2Bitmap O caminho do arquivo pode ser tanto o caminho completo do arquivo no disco quanto o caminho relativo aplica o quando o arquivo de imagem inserido como um recurso da aplica o O valor padr o desta propriedade vazio 7 4 3 1 2 IsTranspare
391. ona 2 faz uma escrita ass ncrona sem confirma o Se o par metro for omitido ser tamb m utilizado o modo de escrita configurado no driver Exemplo sub Tagl OnRead O m todo writeEx pode ser usado para transferir valores de vari veis de um driver para outro Application Getobject Driver2 Tag WriteEx Value TimeStamp Quality End sub 3 2 3 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Tag de Comunica o 3 2 3 1 AdviseType P Controla o modo Advise As op es dispon veis s o Op es dispon veis para a propriedade AdviseType OP O DESCRI O 0 AlwayslnAdvise Otag mantido atualizado se a propriedade AllowRead for True 1 AdviseWhenLinked Otags atualizado se AllowRead for True e o tag estiver associado a algum objeto ativo por exemplo um Display 64 Drivers OP O DESCRI O de uma Tela aberta um Alarme habilitado entre outros Aassocia o do tag para esse prop sito pode ser feita nas seguintes propriedades Value RawValue TimeStamp Quality e Bit00 at Bit31 do Tag de Comunica o Exemplo Sub CcommandButton3 clickQO MsgBox Application 7 Ap ication Getobject Driver1 Tag1 AdviseType End Su 3 2 3 2 AllowRead P Configure esta propriedade para definir se este tag dever ou n o ser lido pelo driver de comunica o
392. ondi o SubConditionName Alarmes 353 e Reconhecido Acked 1 True e Precisa Ack AckRequired O False e Habilitado Enabled 1 True e EventTimeUTC Sempre igual a EventTime como em eventos de alarme e M scara ChangeMask O e Cookie O Exemplo sub CommandButtonl Click No par metro UserFields para cada elemento do array ser mostrado o valor atribu do a ele Application Getobject servidoralarmes1 LogTrackingEvent clicou no bot o Application User Opera o 2 IBotaot i annayi GI sabio End sub 12 4 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Servidor de Alarme 12 4 2 1 ActiveAlarms 9 Determina o n mero total de alarmes ativos do sistema Esta propriedade somente de leitura 12 4 2 2 ActiveHighAlarms 9 Indica o n mero de alarmes ativos com severidade alta Esta propriedade somente de leitura 354 Alarmes 12 4 2 3 ActiveHighNACKAlarms 9 Indica o n mero de alarmes n o reconhecidos com severidade alta Esta propriedade somente de leitura 12 4 2 4 ActivelLowAlarms 9 Indica o n mero de alarmes ativos com severidade baixa Esta propriedade somente de leitura 12 4 2 5 ActiveLowNACKAlarms 9 Indica o n mero de alarmes n o reconhecidos com severidade baixa Esta propriedade somente de leitura 12 4 2 6 ActiveMedAlarms 9 Indica o n mero de alarmes ativos com severidade m dia Esta propriedade
393. ont m informa es sobre as propriedades da Conex o por Tabela 9 8 2 1 Count 9 Apropriedade Count informa o n mero de linhas da tabela Esta propriedade somente de leitura Exemplo sub Retangulol Click Dim Bind Set Bind Links Item Foregroundcolor If Bind Is Nothing Then MsgBox Associa o inexistente Else MsgBox Bind Count End If End sub 9 8 3 Linha da Conex o por Tabela Esta se o cont m informa es sobre propriedades da Linha da Conex o por Tabela Este objeto n o possui eventos nem m todos associados 9 8 3 1 Propriedades Esta se o cont m informa es sobre as propriedades da Linha da Conex o por Tabela 9 8 3 1 1 Blink FI Determina que quando a fonte estiver no intervalo desta linha a propriedade ir alternar periodicamente entre os valores especificados nas propriedades Value e BlinkValue Exemplo Sub checkBox1 Cclick Screen Item Retangulo1l Links Item Foregroundcolor Item 1 Blink Value Screen Item Retangulo1 Links Item Foregroundcolor Item 2 Blink Value End sub 292 Associa es 9 8 3 1 2 BlinkValue Especifica o valor alternativo para piscar da propriedade a ser assumido quando a fonte estiver no intervalo especificado na linha e a propriedade Blink estiver configurada para True Exemplo Sub CommandButtonl clickO Dim Cor Escolhe uma cor Application showpickColor Cor O 100 100 screen Item Retangulo1 Links Item Foregroundcol
394. opriedade EnableDriverEvent do tag deve obrigatoriamente estar habilitada 3 5 1 2 OnTagWrite OnTagWrite Tag Succeeded User Ocorre quando uma escrita for disparada em qualquer tag do Driver Para que o evento ocorra a propriedade EnableDriverEvent do tag deve obrigatoriamente estar habilitada Se a escrita for ass ncrona o evento OnTagWrite ser gerado apenas quando o servidor enviar a resposta indicando o efetivo sucesso ou n o da escrita Vari veis do evento OnTagWrite NOME DESCRI O Tag Uma refer ncia para o objeto Tag que est sofrendo a escrita Por exemplo pode se acessar a propriedade do tag usando a sintaxe Tag DocString Drivers 85 Succeeded Um valor Booleano que indica sucesso ou falha na escrita User Texto que retorna o usu rio que feza escrita Atualmente tem sempre o valor System 3 5 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Driver de Comunica o OPC 3 5 2 1 Compatibility P permite controlar o uso das interfaces padr o OPC pelo Cliente OPC do E3 As op es dispon veis s o as seguintes e 0 AnyVersion funcionamento normal recomendado o OPC driver ir comunicar com servidores DA2 0xe 1 0a dando prefer ncia ao uso de interfaces 2 0x e 1 Version10A permite for ar a comunica o no padr o DA 1 0a para servidores que suportam DA2 0xe 1 0a e 2 Ve
395. or Item 1 Blinkvalue Cor End sub 9 8 3 1 3 Max 9 Especifica o valor m ximo da fonte para uma linha da tabela 9 8 3 1 4 Min 9 Especifica o valor m nimo da fonte para uma linha da tabela Exemplo para Max e Min Sub CommandButton1 clickQO Set Bind _ screen Item Retangulo1 Links Item Foregroundcolor set Linhal Bind Item 1 Linhal min O Linhal Max 20 set Linha Bind Item 2 Linha2 Min 21 Linha2 Max 100 End sub 9 8 3 1 5 Value Especifica o valor da propriedade a ser assumido quando a fonte estiver no intervalo especificado na linha Exemplo Sub CommandButtoni Click Dim Cor Escolhe uma cor Application showPickColor Cor O 100 100 screen Item Retangulo1 Links Item Foregroundcolor Item 1 Value Cor End sub Associa es 293 9 9 Conex o M ltipla Esta se o cont m informa es sobre m todos e propriedades da Conex o M ltipla Este objeto n o possui eventos associados 9 9 1 M todos Esta se o cont m informa es sobre os m todos da Conex o M ltipla 9 9 1 1 InsertRow InsertRow InsertAtRow Insere uma nova linha na tabela de conex es m ltiplas 9 9 1 2 RemoveRow RemoveRow Row Remove a linha no ndice indicado pelo par metro Row 9 9 2 Propriedades Esta se o cont m informa es sobre as propriedades da Conex o M ltipla 9 9 2 1 Count 9 Esta propriedade retorna o n mero de linhas da tabela de conex es m ltiplas 9 9
396. or maior que o valor de CurTargetX Caso contr rio a propriedade CurX definida como o final da linha do texto Esta propriedade acess vel apenas em tempo de execu o NOTA Esta propriedade n o tem efeito no E3 e foi mantida por motivos de compatibilidade com a especifica o padr o dos objetos Microsoft Forms 7 3 4 3 14 CurX 9 Apropriedade CurX especifica a posi o atual horizontal do ponto de inser o no objeto Esta propriedades aplicada num objeto que possua v rias linhas isto a propriedade Multiline est habilitada O valor de retorno v lido quando o objeto possui o foco Pode se usar a propriedade Multiline e a propriedade CurX para posicionar o ponto de inser o do texto conforme o usu rio usa a barra de rolagem pelo conte do do objeto Quando o usu rio move o ponto de inser o para uma outra linha de texto rolando o conte do do objeto a propriedade CurTargetX especifica a posi o desejada para o ponto de inser o A propriedade CurX definida com este valor se a linha de texto for maior do que o valor de CurTargetX Caso contr rio CurX definido no fim da linha de texto Esta propriedade acess vel apenas em tempo de execu o ActiveX 199 7 3 4 3 15 DragBehavior P Habilita ou desabilita o recurso de arrastar e soltar um texto no conte do do objeto As op es dispon veis para esta propriedade s o as seguintes e O fmDragBehaviorDisabled n o permite a a o de arrasta
397. or um tempo maior ou igual ao especificado 12 3 2 7 DoubleAckRequired Fi Quando configurada como True indica que o alarme pode ser reconhecido tanto quando est ativo como quando passa a inativo ou seja pode ser reconhecido duplamente Quando configurada como False indica que o alarme s pode ser reconhecido uma vez e ao ser reconhecido sai da lista de alarmes Alarmes que n o necessitem reconhecimento propriedade AckRequired n o possibilitam esta personaliza o Aplica es anteriores vers o 2 5 v m com esta propriedade 342 Alarmes configurada como False 12 3 2 8 Event FI Quando configurada como True indica que o alarme do tipo evento Um alarme do tipo evento ao ser ativado reconhecido pelo usu rio System Portanto ao ser reconhecido nada acontece n o tem efeito algum assim como n o incrementa o n mero de alarmes ativos nem o n mero de alarmes n o reconhecidos N o pode ser modificada em tempo de execu o 12 3 2 9 Format AA propriedade Format especifica que tipo de formato ser atribu do ao objeto Permite mudar a forma como os dados s o apresentados sem mudar valor que existe por tr s deles Esta propriedade pode ser editada manualmente ou configurada atrav s da janela de formata o Seu uso semelhante aos formatadores usados nas planilhas de dados seguindo a mesma sintaxe b sica S o suportados os seguintes tipos de dados Tipos de dados suportados por Format
398. os 12 3 1 M todos Comuns Esta se o cont m informa es sobre os m todos comuns aos objetos Fonte de Alarme 12 3 1 1 Ack Ack ActorlD Executa o reconhecimento de um alarme configurado no objeto Fonte de Alarmes O m todo retorna um booleano que indica o sucesso ou n o da opera o O par metro ActorlD informa o nome do usu rio respons vel pelo reconhecimento dos alarmes Alarmes 335 12 3 1 2 GetAlarm GetAlarm Retorna um objeto que permite o acesso s configura es espec ficas de cada tipo de alarme Isto permite verificar ou modificar em tempo de execu o as propriedade de um determinado alarme Dependendo do tipo de alarme o m todo retornar as seguintes propriedades e Alarme Digital Respons vel pelas configura es de alarme digital Propriedades do Alarme Digital ITEM DESCRI O A DigitalReturnMessageText Mensagem de retorno do alarme digital FP Digital Habilita ou desabilita a verifica o de alarme digital 9 DigitalLimit Limite para o alarme digital A DigitalMessageText Texto da mensagem de alarme digital aP DigitalSeverity Severidade do alarme digital Conjunto de valores e O Alta e 1 M dia e 2 Baixa P DigitalackRequired Necessidade de reconhecimento para este tipo de alarme digital e Alarme Anal gico Respons vel pelas configura es do alarme anal gico Propriedades deste objeto
399. os atrav s da compara o entre os trechos iniciais dos nomes Por exemplo AckArea ANA reconheceria alarmes das reas ANALOGICOS ANA AREA2 etc Se o valor deste par metro for vazio o m todo ter o mesmo comportamento de AckAllAlarms O par metro ActorlD informa o nome do usu rio respons vel pelo reconhecimento dos alarmes Exemplo Sub Botaol click Quando clica no bot o reconhece os alarmes da Areal Application Getobject servidoralarmes1 ackarea Areal _ ap ication User End su 12 4 1 3 LogTrackingEvent LogTrackingEvent Message ActorlD Area Severity EventTime Source EventCategory EventType UserFields AlarmSourceName FullAlarmSourceName Simula um evento ou alarme e o envia direto para o banco de dados do servidor de alarmes sem passar pelo E3Alarm Por isso este evento n o pode ser visto no E3Alarm nem tampouco o alarme pode ser reconhecido Cada par metro do m todo permite especificar o valor do campo de mesmo nome no evento Os campos do evento s o preenchidos de acordo com os par metros do m todo Par metros do m todo LogTrackingEvent NOME DESCRI O Message Par metro texto que especifica o conte do do campo de Mensagem do evento Se omitido assume uma string vazia ActorlD Par metro texto que especifica o conte do do campo Operador do evento Se omitido assume o valor System Area Par metro texto que especifica o conte do do campo rea do even
400. os m todos e propriedades do objeto E3Alarm 13 1 Eventos Esta se o cont m informa es sobre os eventos do objeto E3Alarm 13 1 1 KeyPress KeyPress KeyAscii Ocorre quando o E3Alarm tem o foco de teclado e o usu rio pressiona uma tecla que corresponde a um caractere que pode ser mostrado em tela uma tecla ANSI de c digo indicado na vari vel KeyAscii Ou seja o evento ocorre quando alguma das teclas a seguir s o pressionadas e Qualquer caractere do teclado que possa ser impresso Tecla CTRL combinada com qualquer caractere do alfabeto padr o Tecla CTRL combinada com qualquer caractere especial Tecla BACKSPACE Tecla ESC Este evento n o ocorre nas seguintes condi es e Pressionando a tecla TAB e Pressionando a tecla ENTER e Pressionando a tecla DEL essa tecla n o ANSI E3Alarm 359 e Pressionando as setas do teclado e Quando uma tecla faz com que o foco v de um objeto a outro Enquanto um usu rio pressiona uma tecla que produz um c digo ANSI o E3Alarm recebe os eventos KeyDown e KeyPress repetidamente Quando o usu rio libera a tecla o evento KeyUp ocorre Para monitorar o estado f sico do teclado ou manipular teclas n o reconhecidas pelo evento KeyPress como teclas de fun o navega o etc utiliza se os eventos KeyDown e KeyUp 13 1 2 MouseMove MouseMove Ocorre quando o ponteiro do mouse se move sobre o objeto E3Alarm 13 2 M todos Esta se o cont
401. os filtros de rea separados por dois pontos Os coringas permitidos s o e aceita nenhum ou qualquer quantidade de caracteres e aceita um caractere qualquer e HW aceita um d gito qualquer e permite especificar um conjunto de caracteres e ab aceita um caractere se for a ou b e f h aceita um caractere entre f e h e lIcz aceita um caractere que n o seja nem c nem z e Im p aceita um caractere que n o seja de m at p O padr o dessa propriedade vazio ou seja sem filtragem por rea ver tamb m propriedades SimpleAreaFilter ShowHighPriority ShowMediumPriority e ShowLowPriority Exemplo Sub ComboBox1 Change o valor da ComboBox indica o filtro de area do E3Alarm screen Item E3Alarml Filter Value End sub E3Alarm 369 13 3 19 FilterType P Efetua os filtros de alarme As op es dispon veis s o e 1 OnlyAlarms mostra apenas alarmes e 2 Only Events mostra apenas eventos e 3 AlarmsAndEvents mostra tanto alarmes quanto eventos 13 3 20 Frame 5 Retorna o quadro pai do objeto Esta propriedade acess vel apenas em tempo de execu o 13 3 21 GridBkColor E Esta propriedade determina a cor de fundo do E3Alarm O valor padr o desta propriedade a cor configurada no Windows para o item Janela Painel de Controle V deo Apar ncia Avan ada 13 3 22 HasFocus PI Esta propriedade determina que o objeto selecionado
402. ou mover de alguma origem e 1 fmDropEffectCopy objeto alvo permite copiar de alguma origem para si e 2 fmDropEffectMove objeto alvo permite mover de alguma origem para si e 3 fmDropEffectCopyOrMove objeto alvo permite copiar ou mover de alguma origem para si Shift Inteiro cuja a soma dos fatores indica o status das teclas SHIFT CTRLe ALT e 1 tecla SHIFT pressionada e 2 tecla CTRL pressionada e 4 tecla ALT pressionada Por exemplo um valor igual a 5 indica que as teclas SHIFT e ALT estavam pressionadas 1 4 5 ActiveX 183 7 3 1 3 Change Change Ocorre quando o valor da propriedade Value do objeto modificada Aseguir est o alguns exemplos de a es que disparam o evento Change e Clicar em uma caixa de sele o em um bot o de op es ou bot o incremento decremento e Clicar ouselecionar palavras em uma lista de sele o ou editor de texto e Selecionar diferentes abas em um di logo e Movera barra de rolagem em um objeto barra de rolagem e Clicar nas setas de um bot o incremento decremento e Selecionar diferentes p ginas em um objeto multi p ginas 7 3 1 4 OnError OnError Number Description SCode Source HelpFile HelpContext CancelDisplay Gerado por um erro interno no objeto Se este evento n o for tratado o E3 ir mostrar uma mensagem de erro gen rica Vari veis do evento OnError NOME
403. oundColor ME Esta propriedade especifica a cor de preenchimento do fundo do objeto Esta cor utilizada quando a propriedade BackgroundStyle est configurada para 1 opaco e umas das propriedades VerticalPercentFill ou HorizontalPercentFill est com valores diferentes de 100 Outro uso desta cor quando a propriedade FillStyle est configurada entre os valores 2 e 8 Isto faz com que a rea restante utilize a cor de fundo para preenchimento Nos scripts utilize a fun o do VBScript RGB para montar a cora ser associada a esta propriedade O valor padr o desta propriedade cinza RGB 192 192 192 6 2 6 1 2 BackgroundStyle aP Esta propriedade especifica o modo do preenchimento do fundo do objeto Esta propriedade habilita a utiliza o das propriedades VerticalPercentFill e HorizontalPercentFill com valores diferentes de 100 e tamb m da propriedade FillStyle configurada entre os valores 2 e 8 Isto faz com que a rea restante utilize a cor de fundo BackgroundColor para preenchimento Aseguinte tabela cont m os valores v lidos para a propriedade BackgroundStyle Op es dispon veis para BackgroundStyle OP O DESCRI O 0 Transparente Nenhum fundo deste objeto ser desenhado 1 Opaco Caso vis vel o fundo ser desenhado Telas e Objetos de Tela 151 6 2 6 1 3 Convert 9 Esta propriedade permite a convers o da figura Se a op o do campo estiverem 0 poss vel v
404. oundColor e indo para BackgroundColor Op es dispon veis para GradientStyle OP O DESCRI O 0 LeftToRight Degrad vertical da esquerda para a direita 1 RightToLeft Degrad vertical da direita para a esquerda 2 VerFromCenter Degrad vertical do centro para as bordas 3 VerToCenter Degrad vertical das bordas para o centro 4 BottonUp Degrad horizontal de baixo para cima 5 TopDown Degrad horizontal de cima para baixo 6 HorzFromCenter Degrad do centro para as bordas 7 HorzToCenter Degrad das bordas para o centro 8 DiagUpRight Degrad diagonal para cima com a cor de frente na direita padr o 9 DiagUpLeft Degrad diagonal para cima com a cor de frente na esquerda 10 DiagUpFromCenter Degrad diagonal para cima do centro para as bordas 11 DiagUpToCenter Degrad diagonal para cima das bordas para o centro Telas e Objetos de Tela 137 OP O DESCRI O 12 DiagDownLeft Degrad diagonal para baixo com cor de frente na esquerda 13 DiagDownRight Degrad diagonal para baixo com cor de frente na direita 14 DiagDownFromCenter Degrad diagonal para baixo do centro para as bordas 15 DiagDownToCenter Degrad diagonal para baixo das bordas para o centro 16 SpotSouthEast Degrad com cor de frente part
405. padr o desta propriedade a cor branca RGB 255 255 255 17 3 15 GridFont Determina a fonte utilizada nos textos da rea de dados do E3Browser O valor padr o desta propriedade a fonte Arial Esta propriedade n o pode ser utilizada em scripts ou em associa es sendo configurada somente via Studio 17 3 16 GridLineColor E Determina a cor das linhas da grade de dados do E3Browser O valor padr o desta propriedade cinza RGB 192 192 192 17 3 17 GridLinesType P Determina otipo de linhas a serem desenhadas na grade de dados do E3Browser Op es dispon veis para GridLinesType OP O DESCRI O 0 GLNone Sem linhas separadoras 1 GLHorz Somente as linhas horizontais padr o 2 GLVert Somente as linhas verticais 3 GLBoth Linhas verticais e horizontais 17 3 18 HasFocus F Em True indica que o E3 Browser est com o foco do teclado 404 E3Browser 17 3 19 Height 9 Essa propriedade determina a altura do objeto em unidades Himetric 17 3 20 Layer 9 Indica o n mero da camada onde o E3Browser est posicionado 17 3 21 MouseOver Fi A propriedade MouseOver informa se o ponteiro do mouse encontra se em cima da Tela Caso afirmativo a propriedade MouseOver habilitada do contr rio ser False Esta propriedade somente de leitura e acess vel apenas em tempo de execu o O valor padr o desta propriedade False 17 3
406. padr o desta propriedade branco RGB 255 255 255 Exemplo Sub CommandButton1 clickQO Set E3Chartl Screen Item E3Chart1 old E3chartl GridsBkColor MsgBox Pr xima E3Chartl GridBkcolor RGB O 255 0 MsgBox voltar E3Chartl GridBkcolor old End sub 18 3 12 HasFocus FP Esta propriedade determina que o objeto selecionado est com o foco Esta propriedade acess vel apenas em tempo de execu o 18 3 13 Height 9 Apropriedade Height define a altura do E3 Chart em unidades Himetric 18 3 14 HorAxisTitle Determina o t tulo do eixo horizontal principal Exemplo Sub CommandButton1 clickQO Set E3Chartl Screen Item E3Chart1 old E3Chartl HoraxisTitle MsgBox Pr xima E3Chartl HoraxisTitle Teste MsgBox voltar E3Chartl HoraxisTitle old End sub 416 E3Chart 18 3 15 HorGrid a Determina otipo de linha que ser aplicada na grade horizontal do E3Chart Op es dispon veis para HorGrid OP O DESCRI O 0 Solid Aplica uma linha s lida na grade horizontal do E3Chart 1 Dash Aplica uma linha tracejada na grade horizontal do E3Chart 2 Dot Aplica uma linha pontilhada na grade horizontal do E3Chart padr o 3 Dashdot Aplica uma linha tra o e ponto na grade horizontal do E3Chart 4 Dashdotdot Aplica uma linha tra o ponto ponto na grade horizontal do E3Chart 5 Invisible Aplica uma linha invis vel na grad
407. port ncia do n vel de alarme Alto Conjunto de valores e O Alta e 1 M dia e 2 Baixa PI HiAckRequired Necessidade de reconhecimento para este n vel de alarme Alto ALARME HIHI MUITO ALTO ITEM DESCRI O Pl HiHi Habilita ou desabilita a verifica o de alarme Muito Alto 9 HiHiLimit Limite para o n vel de alarme Muito Alto HiHiMessageText Texto da mensagem de alarme Muito Alto P HiHiSeverity Import ncia do n vel de alarme Muito Alto Conjunto de valores e O Alta e 1 M dia e 2 Baixa Fi HiHiackRequired Necessidade de reconhecimento para este n vel de alarme Muito Alto 338 Alarmes e Alarme Taxa de Varia o Respons vel por configura es de alarme de taxa de varia o Propriedades do Alarme Taxa de Varia o ITEM DESCRI O A ROCReturnMessageText Mensagem de retorno da taxa de mudan a Fi ROC Habilita ou desabilita a verifica o de alarme de taxa de varia o 9 ROCLimit Limite para o alarme de taxa de mudan a Para o alarme ocorrer basta que o valor dotag associado ultrapasse esse valor em um segundo A ROCMessageText Texto da mensagem de alarme de taxa de mudan a 9 ROCSeverity Import ncia do alarme de taxa de mudan a Conjunto de valores e O Alta e 1 M dia e 2 Baixa Fi ROCAckRequired Necessidade de reconhecimento para este tipo de alarme taxa de mudan a
408. pplication Getobject IO Inputs 1001 If Application Esign Tag PathName altera o do Valor _ Tag Value 1 User Comment Then If Tag writeEx 1 Then App ication TrackEvent _ Tag IO Inputs 1001 alterado para 1 amp pelo usu rio amp User Comment End If End If End sub 10 2 32 UserAdministration UserAdministration Este m todo abre uma caixa de di logo que permite editar a lista de usu rios do E3 Server As fun es dispon veis s o e Mostrara lista de todos os usu rios e Apagar usu rios n o poss vel apagar o usu rio atual e Adicionar e editar usu rios e Editar as configura es de um usu rio e Alterara senha do usu rio e Alterar os demais dados do usu rio login nome etc Exemplo Sub Textol clickO 314 Viewer Application useradministrationQO End sub 10 3 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Viewer 10 3 1 BlinkTime 9 Define o tempo em milissegundos entre cada mudan a de estado quando um objeto tem que piscar ou seja toda vez que algum objeto de tela tem uma associa o e marcada a op o Piscar O valor padr o desta propriedade 200ms NOTA O tempo m nimo de atualiza o da tela 55ms portanto se esta propriedade for configurada com tempo inferior a 55ms a configura o n o ter efeito algum 10 3 2 CacheEnable PI Mant m em mem ria as Telas j abertas instanciadas no Viewer per
409. pre que a propriedade alterar o seu valor J Tratar a desconex o como mudan a de valor n Janela para a adi o de eventos definidos pelo usu rio Op es dispon veis na janela Eventos OP O DESCRI O Nome do Evento Nome que identifica o evento A propriedade express o Express o geradora do evento Pode ser copiada atrav s do AppBrowser pressionando se o bot o a For uma condi o verdadeira Indica que o evento ser do tipo etOnEvent o evento ocorre no momento que a express o for verdadeira ou etWhileEvent o evento ocorre ciclicamente em intervalos pr definidos ms Repetir o evento a cada Quando preenchido indica que o evento ser etWhileEvent Indica o ciclo de repeti o do evento em milissegundos isto de quanto em quanto tempo ele ir ocorrer enquanto a express o geradora for verdadeira Alterar o seu valor Indica que o evento ser etOnValueChanged isto o evento ir ocorrer sempre que a express o geradora Introdu o 21 OP O DESCRI O mudaro valor Tratar a desconex o como Indica se a conex o ou desconex o da express o mudan a geradora do evento dever ser tratada como mudan a 2 Clique em OK para completar o processo e inserir o evento Ele ir aparecer na lista de eventos 4 3 Para alterar este evento selecione o
410. precedido do s mbolo de igual ou um tag ou propriedade do E3 Neste caso o valor atual da vari vel ser mostrado ao realizar a impress o O valor padr o desta propriedade vazio NOTA O servidor deve estar sendo executado para que o valor da vari vel possa ser capturado 22 6 5 1 6 Font A Esta propriedade determina a fonte do texto no objeto O valor padr o desta propriedade vazio Esta propriedade n o pode ser utilizada em scripts ouem associa es e configurada somente via Studio 22 6 5 1 7 ForeColor E A propriedade ForeColor especifica a cor de fundo do objeto Nos scripts utilize a fun o do VBScript RGB para montar a cor a ser associada a esta propriedade O valor padr o desta propriedade preto RGB 0 0 0 22 6 5 1 8 hyperLink A A propriedade hyperLink determina o link que ser atribu do ao texto Para utilizar este recurso use o evento OnHyperLink 22 6 5 1 9 Multiline Fi A propriedade Multiline indica se o texto ter m ltiplas linhas True ou se ser uma caixa de texto simples False Isto pode ser visualizado quando o objeto Viewer est em execu o O valor padr o desta propriedade False 508 Relat rios 22 6 5 1 10 OutputFormat A Configura ou retorna a formata o do texto da propriedade Text utilizado nas configura es da fun o Format do Visual Basic 22 6 5 1 11 Style Retorna o estilo do texto configurado no objeto Esta propriedade somente de lei
411. priedade Enabled igual a False ou este objeto n o possuir o foco do teclado Vari veis do evento KeyDown NOME DESCRI O KeyCode N mero inteiro que identifica o caractere ASCII da tecla que foi pressionada Shift Mostra a tecla pressionada juntamente com o mouse 142 Telas e Objetos de Tela NOME DESCRI O e 4 Tecla SHIFT e 8 Tecla CTRL e 12 Teclas CTRL SHIFT Exemplo Sub Botao KeyDown KeyCode Shift Mostra uma caixa de mensagem quando o usu rio pressiona uma tecla MsgBox c digo da tecla amp KeyCode End Sub 6 2 1 4 KeyUp KeyUp KeyCode Shift Ocorre no momento em que uma tecla solta e o objeto est com o foco do teclado Note que este evento n o ser gerado se o objeto n o estiver habilitado propriedade Enabled igual a False ou este objeto n o possuir o foco do teclado Vari veis do evento KeyUp NOME DESCRI O KeyCode N mero inteiro que identifica o caractere ASCII da tecla que foi pressionada Shift Mostra a tecla pressionada juntamente com o mouse e 4 Tecla SHIFT e 8 Tecla CTRL e 12 Teclas CTRL SHIFT Exemplo Sub Botao Keyup KeyCode Shift Mostra uma caixa de mensagem quando o usu rio soltar uma tecla MsgBox c digo da tecla amp KeyCode End Sub Telas e Objetos de Tela 143 6 2 1 5 MouseDown MouseDown Button ShiftSt
412. propriedade Delay afeta a dura o de tempo entre os eventos SpinUp SpinDown e Change consecutivos gerados quando o usu rio clica e mant m pressionada a barra de rolagem O primeiro evento ocorre imediatamente O tempo de espera at a segunda ocorr ncia do evento de cinco vezes o valor especificado na propriedade Delay Ap s o tempo inicial o intervalo entre os eventos o valor especificado para Delay Ovalor padr o de Delay 50 ms Isto significa que o objeto inicia o primeiro evento depois de 250 ms cinco vezes o valor especificado e inicia cada evento subsequente depois de 50 ms ActiveX 243 7 3 11 2 2 LargeChange 9 Especifica a quantidade de passos do cursor da Barra de Rolagem O valor da propriedade LargeChange a quantidade pela qual a propriedade Value alterada quando o usu rio clica na rea entre a caixa de rolagem e o cursor da barra de rolagem Qualquer valor inteiro permitido para a propriedade LargeChange mas o intervalo recomendado de 32 767 a 32 767 sendo que este valor deve estar entre os valores determinados nas propriedade Maxe Min da barra de rolagem 7 3 11 2 3 Max 9 Apropriedade Max utilizada para determinar o limite m ximo do objeto 7 3 11 2 4 Min 9 Apropriedade Min utilizada para determinar o limite m ximo do objeto 7 3 11 2 5 Orientation P A propriedade Orientation utilizada para determinar a orienta o do objeto na Tela As op es dispon veis para esta prop
413. propriedade VerificationInternal A propriedade VerificationUnit indica a unidade de tempo em que ser feita a verifica o para descarte dos dados As op es dispon veis s o 0 dtHour horas 1 dtDay dias e 2 dtMonth meses padr o 3 dtMinute minutos 384 Storage 15 3 Campo do Storage Esta se o cont m informa es sobre propriedades do objeto Campo do Storage Este objeto n o possui eventos nem m todos associados 15 3 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Campo do Storage 15 3 1 1 DeadBand 9 Banda morta para c lculo do algoritmo 15 3 1 2 DeadBandUnit 9 valor absoluto ou a porcentagem de modifica o 15 3 1 3 Link Determina a fonte de dados que ser associada ao campo Propriedade apenas de leitura 15 3 1 4 MaxRecTime 9 Tempo m ximo de espera por um dado Se este tempo for ultrapassado o dado torna se antigo e armazenado 15 3 1 5 MinRecTime 9 Tempo m nimo para inser o de um dado na tabela Este tempo calculado em milissegundos 15 3 1 6 Name Propriedade que retorna o nome configurado para este campo no objeto Storage Atrav s dele poss vel buscar itens na cole o Storage 385 15 3 1 7 Type P Retorna o tipo do objeto no formato do Storage 0 Double 1 Bit 2 String Esta propriedade de leitura e escrita mas s aceita mudan as enquanto a coleta de dados para este campo ainda n o
414. r metro Arg permite repassar o valor especificado Tela atrav s do evento OnPreShow Exemplo sub Botaol Click Quando clica no botao abre a Tela2 no frame Teste e passa o valor 1 que ser usado no evento OnPreshow Application ItemC top OpenScreen TelaZ 100207 Isso um teste End sub sub Tela2 onPreshow varg VA caixa de mensagem vai mostrar a frase Isso um Teste MsgBox VArg End Sub 10 4 1 8 Refresh Refresh Force O m todo Refresh permite for ar o redesenho do conte do de uma Tela ou divisor Ele deve ser usado em scripts de Viewer com processamento massivo por exemplo la os ou em chamadas de m todos que demandem muito tempo e exijam indica es visuais ao usu rio do progresso do processo Devido ao redesenho em geral ser uma opera o pesada a vers o padr o do m todo 324 Viewer Refresh sem par metros otimizada de forma a ignorar pedidos de redesenho muito pr ximos incluindo redesenho do pr prio E3 Este comportamento padr o ideal para indica es de progresso em la os onde muitos redesenhos s o feitos em sequ ncia O par metro Force desabilita esta otimiza o garantindo que para cada chamada do m todo Refresh seja feito um redesenho Por m ao utilizar se esta op o o m todo Refresh n o pode ser chamado repetidamente como dentro de um la o por exemplo Exemplo Sub CommandButtonl clickQO Desenha uma barra de progresso de uma opera o while
415. r metro FilterName que determina o filtro para o relat rio indicando otipo de formato para a exporta o Pode assumir as seguintes op es e PDF Exporta os dados para o formato Adobe PDF e Excel Exporta os dados para o formato de planilha Excel e HTML Exporta os dados para o formato HTML e TEXT Exporta os dados para um arquivo texto e RTF Exporta os dados para o formato Rich Text Format e TIFF Exporta os dados para o formato Tag Image File Format Relat rios 475 Depois de obtido o filtro as seguintes propriedades podem ser modificadas Propriedades pass veis de modifica o PROPRIEDADE FILTRO DESCRI O AutoRowHeight Excel Em True padr o configura a altura da linha automaticamente Em False configura a altura para o maior elemento na linha BorderSpace Excel Espa amento m nimo entre as c lulas O valor padr o de 59 twips CreateCSSFile HTML Se verdadeiro gera um arquivo CSS no diret rio TMLOutputPath DoubleBoundaries Excel Em True indica que os elementos alinhados direita devem repor os alinhados esquerda na mesma coluna Caso contr rio deixe em falso para liberar mais espa o ExportRange HTML Indica uma faixa de p ginas para serem exportadas Por exemplo 1 2 3 9 14 FaxExport TIFF Objeto que permite exportar os dados no formato RFC 1314 TIFF FileName Todos Informa o nome do arquivo para o qual os dados ser o exportados
416. r o vermelho RGB 255 0 0 414 E3Chart 18 3 5 CursorEnd 9 Define a posi o do cursor final entre O e 1 necess rio executar o m todo ShowcCursor ou habilitar a op o Pesquisa de Intervalos para que os cursores apare am 18 3 6 CursorLineStyle P Estilo de linha do cursor de pesquisa de intervalo As op es dispon veis s o Op es dispon veis para CursorLineStyle OP O DESCRI O O0 LS Solid Aplica uma linha s lida no cursor de intervalo do E3Chart 1 LS Dash Aplica uma linha tracejada no cursor de intervalo do E3Chart 2 LS Dot Aplica uma linha pontilhada no cursor de intervalo do E3Chart 3 LS Dashdot Aplica uma linha tra o e ponto no cursor de intervalo do E3Chart 4 LS Dashdotdot Aplica uma linha tra o ponto ponto no cursor de intervalo do E3Chart 5 LS Null Aplica uma linha invis vel no cursor de intervalo do E3Chart 18 3 7 CursorLineWidth 9 Estabelece a largura do cursor de intervalo 18 3 8 Enabled FI Habilita o objeto ActiveX no projeto O valor padr o desta propriedade True E3Chart 415 18 3 9 ForeColor E Determina a cor de frente do E3 Chart O valor padr o desta propriedade preto RGB 0 0 0 18 3 10 Frame 58 Retorna o quadro pai do objeto Esta propriedade acess vel apenas em tempo de execu o 18 3 11 GridBkColor E Determina a cor de fundo da grade do E3Chart O valor
417. r odo de inatividade do usu rio Para maiores informa es veja o evento Onlnactive do objeto Viewer Ovalor padr o desta propriedade False 10 3 9 EnableZoomMenu FI se estiver configurada como True habilita a exibi o do menu de configura o do zoom da tela atrav s do bot o direito do mouse em tempo de execu o exceto quando algum script estiver configurado com informa o divergente nos eventos MouseDown ou MouseUp Caso contr rio o menu n o ser mostrado O valor padr o desta propriedade True 10 3 10 HeartbeatPeriodMs 9 Indica o intervalo em milissegundos entre as mensagens de heartbeat enviadas pelo E3 Server A mensagem de heartbeat sempre enviada quando o servidor fica o per odo indicado por esta propriedade sem enviar nenhuma mensagem para o Viewer Ovalor padr o desta propriedade 2000 dois segundos 316 Viewer 10 3 11 HeartbeatTimeoutMs 9 Indica o tempo em milissegundos que o Viewer tolera sem receber nenhuma mensagem do E3 Server Se este tempo passar e nenhuma mensagem for recebida o Viewer assume que a conex o foi perdida e inicia o processo de reconex o Este tempo deve ser maior que o tempo determinado na propriedade HeartbeatPeriodMs de prefer ncia maior que o dobro O valor padr o desta propriedade 5000 cinco segundos 10 3 12 InactivityTime 9 Define o tempo m ximo de espera por um evento de mouse ou de teclado antes do per odo de inatividade em minutos Para
418. r e soltar o texto no conte do do objeto e 1 fmDragBehaviorEnabled permite a a o de arrastar e soltar o texto no conte do do objeto Ovalor padr o desta propriedade 0 fmDragBehaviorDisabled NOTA A propriedade DragBehavior n o tem efeito se a propriedade Style estiver configurada para 2 fmStyleDropDownList 7 3 4 3 16 DropButtonStyle aP Esta propriedade especifica o s mbolo exibido no bot o da Lista de Sele o As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para DropButtonStyle OP O DESCRI O 0 fmDropButtonStylePlain Exibe um bot o plano sem s mbolo 1 fmDropButtonStyleArrow Exibe um seta para baixo padr o 2 fmDropButtonsStyleEllipsis Exibe retic ncias 3 fmDropButtonStyleReduce Exibe uma reta horizontal como um caractere sublinhado Ovalor padr o desta propriedade 1 fmDropButtonStyleArrow 200 ActiveX 7 3 4 3 17 EnterFieldBehavior a Esta propriedade controla a forma como o conte do do texto selecionado na rea de edi o quando se pressiona a tecla TAB no objeto e n o quando o objeto recebe o foco como um resultado do m todo SetFocus As op es dispon veis para esta propriedade s o as seguintes e O fmEnterFieldBehaviorSelectAlIl seleciona todo o conte do do texto quando a tecla TAB pressionada no objeto e 1 fmEnterFieldBehaviorRecallSelection deixa a sele o inalterad
419. r este valor se necess rio Drivers 59 3 1 3 9 ReadRetries 9 Indica o n mero de re tentativas de leitura do driver em caso de erro Se for configurada para 2 por exemplo indica que o driver vai tentar duas vezes mais uma comunica o falhada sem contar a tentativa original 3 1 3 10 ShareMaximum 9 Apropriedade ShareMaximum define o n mero m ximo de drivers de comunica o que ser o agrupados em um I O Server compartilhado Esta propriedade s utilizada se a propriedade ShareServer estiver habilitada Exemplo Este driver n o ser compartilhado Shareserver False ShareMaximum lt qualquer valor gt Todos os drivers ser o agrupados no mesmo IOServer n o define um limite ShareServer True ShareMaximum 0 agrupa cada 5 drivers em um IOServer Shareserver True ShareMaximum 5 3 1 3 11 ShareServer FP se a propriedade ShareServer estiver configurada para True isto significa que este driver ir compartilhar sua execu o entre os demais objetos Driver de Comunica o que possuam o mesmo string em DriverLocation Isto implica que somente o primeiro driver de comunica o configurado executar a inicializa o da comunica o Todos os demais objetos Driver de Comunica o compartilhados ignorar o todos os par metros de configura o P1 at P4 e tamb m outras configura es Do contr rio sea propriedade estiver configurada para False o driver n o compartilhar qualquer tipo de comunica
420. r o ltimo dado da lista If Listl ListIndex 1 Then Listl ListIndex Listl ListCount 1 End If List1 RemoveItem List1 ListIndex End If End sub 7 3 7 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Lista 7 3 7 2 1 BorderColor MH Esta propriedade determina a cor da borda que ser aplicada no objeto Com esta propriedade poss vel aplicar a cor padr o ou personaliz la atrav s da sua edi o Para que esta propriedade seja aplic vel necess rio que a propriedade BorderStyle esteja configurada para 1 fmBorderStyleSingle O valor padr o desta propriedade preto RGB O 0 0 ActiveX 217 7 3 7 2 2 BorderStyle a Apropriedade BorderStyle determina o estilo de borda que ser aplicada ao objeto As op es dispon veis s o e 0O fmBorderStyleNone sem borda e 1 fmBorderStyleSingle com borda simples 7 3 7 2 3 BoundColumm Determina a coluna da lista onde os dados ser o armazenados Por exemplo se cada linha cont m 8 itens e a propriedade BoundColumn 3 o sistema armazena as informa es na terceira coluna da linha atualmente selecionada Se o valor for igual a O este valor passado para a propriedade Listindex do objeto Se o valor for 1 ou superior o dado indicado atribu do coluna referente ao valor especificado na propriedade As colunas s o numeradas a partir de 1 NOTA Esta propriedade n o tem efeito no E3 e foi mantida por motivos de compatibi
421. rAxis Color RGB O 255 0 End sub 18 7 2 2 Format Determina a formata o dos valores do eixo Exemplo Sub CommandButton1_ClickO Muda a formata o Set Chart Screen Item E3Chart1 stroldFormat Chart Axes Item NomeDoEixo Format MsgBox Clique para setar a formata o autom tica Chart axes Item NomeDoEixo Format Automatico MsgBox Clique para usar outra formata o Chart Axes Item NomeDoEixo Format 0 0 MsgBox Clique para usar outra formata o Chart axes Item NomeDoEixo Format dd Mm yy hh mm ss MsgBox Clique novamente para voltar formata o original chart axes Usem O NOmeDOE i ima strOldFormat End Su 18 7 2 3 GridColor E Determina a cor das linhas da grade Exemplo sub CommandButton1_ClickO Set Chart Screen Item E3Chart1 Chart axes Item NomeDoEixo sShowGrid False MsgBox Clique para trocar a cor das linhas na grade Chart axes Item NomeDoEixo Gridcolor RGB O 0 255 part Axes Tren CNOMEDHEiXO O ShowGrid True End Su E3Chart 447 18 7 2 4 GridStyle P Determina o estilo da linha da grade As op es dispon veis s o as seguintes Op es dispon veis para GridStyle OP O DESCRI O O solid O estilo da linha da grade s lida 1 dash O estilo da linha da grade pontilhada 2 dot O estilo da linha da grade tracejada 3 dashdot O estilo da linha da grade pontilhada e tr
422. ra determinar a fonte do t tulo da moldura Esta propriedade n o pode ser utilizada em scripts ou em associa es sendo configurada unicamente via Studio 7 4 2 E2Z2 Animation Esta se o cont m informa es sobre propriedades do objeto E2 Animation Este objeto n o possui eventos nem m todos associados 7 4 2 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto EZAnimation 7 4 2 1 1 BackgroundColor E Esta propriedade define a cor de fundo do objeto E2Animation O valor padr o desta propriedade branco RGB 255 255 255 7 4 2 1 2 BlinkTime 9 Define o intervalo de tempo em milissegundos do efeito de pisca do objeto 7 4 2 1 3 Border Pl Habilita ou desabilita a exibi o de uma borda ao redor do objeto 7 4 2 1 4 DefaultZone 9 Define a zona padr o que ser mostrada quando o tagassociado estiver fora dos limites das outras zonas definidas para o objeto 7 4 2 1 5 IsTransparent FI se o valor desta propriedade for verdadeiro define que o fundo do objeto ser transparente permitindo que o fundo da tela apare a Caso contr rio a cor de fundo ser s lida definida em BackgroundColor ActiveX 247 7 4 2 1 6 Value 9 Essa propriedade define o valor que ir determinar qual a zona ativa O valor padr o dessa propriedade 0 7 4 2 2 Cole o de Zonas Esta se o cont m informa es sobre os m todos do objeto Cole o de Zonas Este objeto n o cont m eventos
423. ra o alarme de taxa de varia o Para o alarme ocorrer basta que o valor do tag associado ultrapasse esse valor em um segundo 12 3 6 1 4 ROCMessageText A Texto da mensagem do alarme de taxa de varia o 350 Alarmes 12 3 6 1 5 ROCReturnMessageText A Mensagem de retorno do alarme de taxa de varia o 12 3 6 1 6 ROCSeverity aP Import ncia do alarme de taxa de varia o Conjunto de valores e O Alta e 1 M dia e 2 Baixa 12 4 Servidor de Alarmes Esta se o cont m informa es sobre m todos e propriedades do objeto Servidor de Alarme Este objeto n o possui eventos associados 12 4 1 M todos Esta se o cont m informa es sobre os m todos do objeto Servidor de Alarme 12 4 1 1 AckAllAlarms AckAllAlarms ActorlD Executa o reconhecimento de todos os alarmes do servidor independente da rea O m todo retorna um booleano que indica o sucesso ou n o da opera o O par metro ActorlD informa o nome do usu rio respons vel pelo reconhecimento dos alarmes Exemplo Sub Botaol Click Quando clica no botao reconhece todos os alarmes Application Getobject servidoralarmes1 AckaTTAlarms Application User End sub Alarmes 351 12 4 1 2 AckArea AckArea Area ActorlD Executa o reconhecimento dos alarmes em uma determinada rea O m todo retorna um booleano que indica o sucesso ou n o da opera o O par metro Area especifica o nome da s rea s cujos alarmes ser o reconhecid
424. randes ou muito pequenos recomenda se utilizar o formato Cient fico Data Apresenta valores num ricos de data e hora quando v lidos Para representar apenas a hora use o formato equivalente Hora Apresenta valores num ricos de hora e data quando v lidos Para representar apenas a data use o formato equivalente Porcentagem Multiplica o n mero por 100 e adiciona o s mbolo de porcentagem Admite at 15 casas decimais Cient fico Apresenta o n mero em nota o de mantissa e expoente Ideal para n meros de magnitude variada Admite at 15 casas decimais Especial Permite formatar n meros inteiros em bases n o decimais hexadecimal octal ou bin ria por exemplo Outro Permite editar diretamente o c digo de formata o desejado ou selecionar um formato criado anteriormente Am scara destes formatos como exemplificadas no campo Tipo ser exibida na Janela de Propriedades por exemplo d M yy H mm 0E 00 etc 18 3 21 HorTickUnit 9 Determina o n mero de subdivis es entre as marcas da grade Quando esta propriedade estiver com valor 0 o espa amento ser autom tico Exemplo Sub subCommandButton1 click Set E3Chartl Screen Item E3Chart1 old E3chartl HorTickUnit For i 0 To 30 step 10 E3chartl HorTickunit MsgBox E3Chart1 HorTickUnit amp cstr i Next MsgBox voltar E3Chartl HorTickunit old E3Chart 419 End sub 18 3 22 Layer 9 Indica o n mero da camada o
425. rd 8208 ArrChar Array unidimensional de va orchar 8209 ArrByte Array unidimensional de bytes que s o valores utilizados para cria o de DLLs e para OLE Ocupa 1 byte de mem ria Drivers 103 OP O DESCRI O 8210 ArrWord Array unidimensional de valor inteiro de 32 bits 8211 ArrDWord Array unidimensional de valor inteiro de 32 bits 8212 ArrLonglong Array unidimensional de valor inteiro de 16 bits 8213 ArrDDWord Array unidimensional de valor inteiro de 32 bits sinalizado 8214 Arrinteger Array unidimensional de Inteiro de 16 bits sinalizado 8215 ArrUlnteger Array unidimensional de n mero inteiro sem sinal neste caso equivale a um DWORD que vai de 0 a 4294967295 2 1 3 7 1 5 EnableDriverEvent P Esta propriedade utilizada para controlar a gera o do evento OnTagRead que ocorre no Driver de Comunica o OPC que cont m o bloco Se a propriedade EnableDriverEvent do bloco estiver configurada para True a cada leitura vinda do servidor OPC seja com erro ou n o ser gerado o evento OnTagRead no objeto Driver OPC que contem este bloco Caso contr rio o evento n o ocorre Tamb m quando a propriedade EnableDriverEvent tiver o valor True a cada escrita que seja enviada para o servidor OPC ser gerado o evento OnTagWrite no objeto OPC Driver que contem o bloco Se a escrita for ass
426. rdo do mouse pressionado rapidamente duas vezes sobre a tela Este evento n o ocorrer se o objeto n o estiver vis vel ou sua propriedade Enabled estiver configurada para False Avisibilidade do objeto depende de tr s fatores propriedade Visible igual a True Telas e Objetos de Tela 129 objeto pai vis vel e propriedade Layer do objeto presente na camada da Tela Exemplo sub Tela DbClickO Mostra uma caixa de mensagem quando o usu rio faz um duplo clique na tela MsgBox voc clicou duas vezes na tela End Sub 6 1 1 3 KeyDown KeyDown KeyCode Shift Ocorre no momento em que uma tecla pressionada independentemente do foco na Tela Vari veis do evento KeyDown NOME DESCRI O KeyCode N mero inteiro que identifica o caractere ASCII da tecla que foi pressionada Shift Mostra a tecla pressionada juntamente com o mouse e 4 Tecla SHIFT e 8 Tecla CTRL e 12 Teclas CTRL SHIFT Exemplo Sub Telal KeyDown KeyCode shift Mostra uma caixa de mensagem quando o usu rio pressiona uma tecla MsgBox c digo da tecla amp KeyCode End Sub 130 Telas e Objetos de Tela 6 1 1 4 KeyUp KeyUp KeyCode Shift Ocorre no momento em que uma tecla solta independentemente do foco na Tela Vari veis do evento KeyUp NOME DESCRI O KeyCode N mero inteiro que identifica o caractere ASCII da tecla que foi pressionada Shift Mostra
427. reconhecimento no objeto ativos ou n o Esta propriedade somente de leitura 13 3 9 AllowAckAll F Habilita a op o presente no menu pop up do E3Alarm que permite o reconhecimento de todos os alarmes O valor padr o desta propriedade True 13 3 10 AllowAckCurrentFilter Pl Habilita a op o presente no menu pop up do E3Alarm que permite o reconhecimento de todos os alarmes do filtro atual Se n o houverem alarmes vis veis a propriedade n o tem efeito O valor padr o desta propriedade True E3Alarm 367 13 3 11 AllowAckSelected P Habilita a op o presente no menu pop up do E3Alarm que permite o reconhecimento de alarmes selecionados Se n o houverem alarmes selecionados a propriedade n o tem efeito O valor padr o desta propriedade True 13 3 12 AllowColumnClick F Habilita ou desabilita a sele o dos campos e a dire o de ordena o destes atrav s do clique no cabe alho das colunas do E3Alarm em tempo de execu o Se esta op o estiver configurada para True e o cabe alho for vis vel ver propriedade ColumnHeader ao clicar no t tulo da coluna os dados ser o ordenados tendo esta coluna como chave Clicando novamente nesta mesma coluna a ordena o ser feita na dire o contr ria muda se a ordem ascendente para descendente e vice versa Ao clicar na coluna com a tecla SHIFT pressionada o campo usado como segunda chave Como na chave prim ria um segundo clique com SHIFTinverte
428. referentes s propriedades BitOO at Bit31 Da mesma forma atualizar o valor de Value toda vez que alguma das propriedades Bit00 at Bit31 mudar de valor e posteriormente enviar para o equipamento ou para o dispositivo se a propriedade AllowWrite do bloco de comunica o estiver configurada para True Caso contr rio os bits n o sofrer o nem acarretar o qualquer mudan a Esta propriedade pode ser atualizada ap s tersido iniciada a comunica o O valor padr o desta propriedade False 3 4 2 14 Value Atualizada sempre que uma nova leitura v lida de um valor do equipamento ou do dispositivo for feita utilizando se a parametriza o B1 at B4 do Bloco de Comunica o onde este elemento estiver inserido e considerando se sua posi o na tabela lida atrav s da propriedade Index Otipo desta vari vel n mero inteiro ponto flutuante texto depende do driver ao qual o elemento est associado e da sua parametriza o Esta propriedade somente ser atualizada desta forma se a propriedade AllowRead do objeto Bloco de Comunica o ao qual o elemento pertence estiver configurada para True e quando n o houver erros de comunica o neste caso somente as propriedades Quality e TimeStamp ser o atualizadas de acordo com o tempo de varredura definido em Scan Outra forma de utilizar esta propriedade para escrever valores no equipamento ou no dispositivo bastando para isto atribuir um novo valor propriedade Value ou a alg
429. res 7 4 8 2 1 2 Remove Remove Index Remove uma zona O par metro Index indica o ndice da zona que deve ser removida 7 4 8 3 Zonas Define um conjunto de zonas para o objeto E2 Text Estas zonas podem ser configuradas acessando a janela de propriedades do objeto na aba Zonas As op es dispon veis nesta aba s o as seguintes Op es dispon veis na aba Zonas OP O DESCRI O Zonas Listagem com todas as zonas definidas no objeto Bot o Adicionar Adiciona uma nova zona Bot o Remover Remove a zona selecionada Pisca a cada ms Define se o texto e o fundo da zona ir o piscar quando o valor do objeto estiver dentro do intervalo da zona Mensagem Texto da mensagem exibida quando o valor do objeto estiver dentro do intervalo da zona Alinhamento Define o alinhamento do texto Fonte Define a fonte do texto 268 ActiveX Cor de fundo Define a cor de fundo da zona Transparente Define se o fundo do objeto ser transparente quando a zona estiver ativa Zona padr o Define a zona selecionada como a zona padr o do objeto Pisca Define se a zona ir piscar quando o valor do objeto estiver dentro do intervalo da zona M nimo Valor m nimo para a zona M ximo Valor m ximo para a zona Dica Mostra um texto de ajuda para a zona Exemplo Mostra um exemplo do comportamento da zona em tempo de execu o
430. ria a realiza o de um c lculo ou tarefa mais complexa em um objeto quando o evento gerador vem de um outro tag ou propriedade Apesar de se poder criar e executar este mesmo tipo de trabalho a partir do pr prio tagou da propriedade geradora do evento existem vantagens em manter se o script junto ao objeto que sofrer a a o deste Dentre elas podemos citar o trabalho adicional necess rio para fazer um objeto apontar para outro al m de facilidades de manuten o pois se por algum motivo for necess rio modificar ouapagarotagoua propriedade que seja o evento gerador n o necess rio modificar um segundo objeto Outra vantagem o fato de que se o tag gerador do evento for apagado o objeto n o perder o script basta que se indique uma outra fonte geradora de evento Agera o de eventos internos facilita ainda a cria o de bibliotecas pois cada vez que um componente de biblioteca inserido em uma aplica o ele traz consigo os scripts e c lculos que podem ser necess rios diminuindo o trabalho de configura o Para gerar um novo evento interno em um objeto siga estes procedimentos 4 1 Clique no bot o Criar evento do usu rio Ea ou ent o em Criar novo evento na Lista de Eventos O E3 abrir uma janela para a defini o das propriedades do evento 20 Introdu o Sempre que a propriedade for uma condi o verdadeira E Repetir o evento Intervalo de repeti o ms 1000 Sem
431. riedade acess vel apenas em tempo de execu o 7 3 7 2 21 TextAlign aP Especifica como o texto alinhado no objeto As op es dispon veis s o as seguintes e 1 fmTextAlignLeft alinha o texto com a extremidade esquerda do objeto e 2 fmTextAlignCenter centraliza o texto com o centro do objeto e 3 fmTextAlignRight alinha o texto com a extremidade direita do objeto 7 3 7 2 22 TextColum A propriedade TextColumn identifica a coluna no objeto Os valores para a propriedade TextColumn v o de 1 ao n mero de colunas na lista O valor TextColumn para a primeira coluna 1 o valor da segunda coluna 2 e assim por diante A configura o de TextColumn como O exibe os valores para a propriedade Listindex A configura o de TextColumn como 1 exibe a primeira coluna que possui o valor da propriedade ColumnWidths maior do que zero 224 ActiveX 7 3 7 2 23 Toplndex 9 A propriedade TopIndex define ou retorna o item da lista que aparece na posi o mais pr xima do topo na lista Esta propriedade retorna o valor 1 se a lista est vazia ou n o exibida 7 3 7 2 24 Value o valor da propriedade BoundColumn das linhas atualmente selecionadas Esta propriedade n o tem efeito no E3 e foi mantida por motivos de compatibilidade com a especifica o padr o dos objetos Microsoft Forms 7 3 8 Bot o Liga Desliga Esta se o cont m informa es sobre eventos e propriedades do objeto Bot o Liga Desliga Este ob
432. riedade deve ser de 30 meses Esta propriedade trabalha em conjunto com a propriedade BackupDiscardTimeUnit O valor padr o desta propriedade 12 doze unidades de tempo indicadas em BackupDiscardTimeUnit NOTA O tempo total indicado pela combina o das propriedades BackupDiscardinterval e BackupDiscardTimeUnit deve ser maior que o tempo indicado pelas propriedades Discardinterval e DiscardTimeUnit Hist ricos 375 14 2 2 BackupDiscardTimeUnit P A propriedade BackupDiscardTimeUnit indica a unidade de tempo em que os dados de backup ficar o armazenados at serem descartados As op es dispon veis s o e O dtHour horas e 1 dtDay dias e 2 dtMonth meses padr o e 3 dtMinute minutos Esta propriedade trabalha em conjunto com a propriedade BackupDiscardInterval 14 2 3 CacheSize 9 Define o tamanho do bloco de registros que deve ser lido pelo Hist rico antes de ser enviado para o banco de dados Por exemplo se CacheSize igual a 4 ser o enviados blocos contendo quatro registros cada um para o DBServer associado Os valores v lidos para esta propriedade devem estar no intervalo entre 1 e 4 O valor padr o desta propriedade 1 NOTA O bloco de registros enviado a cada 1 segundo mesmo que n o tenha atingido o tamanho configurado na propriedade CacheSize 14 2 4 CompressedTable P Habilita o uso de banda morta para a grava o de dados O valor padr o desta propriedade False 14 2 5 DBSe
433. riedade s o as seguintes e 1 fmOrientationAuto determina automaticamente a orienta o com base nas dimens es do objeto isto conforme ele foi criado e 0 fmoOrientationVertical o objeto disposto verticalmente e 1 fmoOrientationHorizontal o objeto disposto horizontalmente Ovalor padr o desta propriedade 1 fmOrientationAuto 7 3 11 2 6 ProportionalThumb Fi A propriedade ProportionalThumb especifica se o tamanho da caixa de rolagem igual a dimens o do objeto Se a propriedade estiver configurada para True a caixa da Barra de Rolagem tem a mesma dimens o do objeto Caso contr rio se for dimensionado o objeto a caixa de rolagem permanece com o tamanho original O valor padr o desta propriedade True 244 ActiveX 7 3 11 2 7 SmallChange 9 A propriedade SmallChange especifica a quantidade de movimento que ocorre quando o usu rio clica em uma seta de rolagem no objeto O valor padr o desta propriedade 1 7 3 11 2 8 Value N mero inteiro entre os valores definidos pelas propriedades Min e Max Indica a posi o inicial da barra de rolagem N o aceita valores menores que o valor de Min nem maiores que o valor de Max 7 4 E2Controls Esta se o cont m informa es sobre eventos m todos e propriedades de objetos E2Controls 7 4 1 Propriedades Comuns Esta se o cont m informa es sobre propriedades comuns aos objetos EZControls 7 4 1 1 Frame BorderColor E Define uma cor par
434. rio o campo n o mostrado no E3Browser em tempo de execu o O valor padr o True E3Browser 407 17 3 38 Width 9 Determina a largura do objeto em unidades Himetric 17 3 39 X 9 A propriedade X define a coordenada horizontal esquerda em unidades Himetric do objeto 17 3 40 Y 9 Esta propriedade define a coordenada vertical superior em unidades Himetric do objeto 17 4 Campos do E3Browser Esta se o cont m informa es sobre propriedades dos campos do objeto E3Browser Estes campos n o possuem eventos nem m todos associados 17 4 1 Propriedades Esta se o cont m informa es sobre as propriedades dos campos do objeto E3Browser 17 4 1 1 BkColor E Determina a cor de fundo do campo do E3Browser O valor padr o a cor configurada no Windows para o item Janela do Painel de Controle Painel de Controle V deo Apar ncia Avan ada 17 4 1 2 Color E Retorna a cor do texto do campo O valor padr o dessa propriedade preto RGB 0 0 0 408 E3Browser 17 4 1 3 Format Configura o formatador usado na coluna 17 4 1 4 Name Retorna o nome do campo 17 4 1 5 Visible FI Habilita ou desabilita a visibilidade do campo selecionado na consulta do E3Browser Se a propriedade estiver configurada para True o campo ser vis vel no E3Browser Caso contr rio o campo n o mostrado no E3Browser em tempo de execu o O valor padr o True 17 4 1 6 Width 9
435. ripts utilizando se a fun o LoadPicture para especificar o caminho e o nome do arquivo que cont m a figura Para remover a figura clique no valor da propriedade Picture e pressione a tecla DEL Atecla BACKSPACE tecla de espa o do teclado n o remove a figura Exemplo Sub CommandButton1 clickQO Re reen Item CheckBox1 Picture LoadPicture C Naba gif End Su ActiveX 227 7 3 8 2 10 PicturePosition P A propriedade PicturePosition especifica a posi o da figura atribu da ao objeto em rela o a sua legenda As op es dispon veis para esta propriedades s o as seguintes Op es dispon veis para PicturePosition OP O DESCRI O 0 fmPicturePositionLeftTop A figura aparece esquerda de sua legenda Alegenda alinhada com a parte superior da figura 1 fmPicturePositionLeftCenter Afigura aparece esquerda da legenda Alegenda centralizada relativamente imagem 2 fmPicturePositionLeftBottom Afigura aparece esquerda da legenda Alegenda alinhada coma parte inferior da figura 3 fmPicturePositionRightTop Afigura aparece direita da legenda A legenda alinhada coma parte superior da figura 4 fmPicturePositionRightCenter Afigura aparece direita da legenda A legenda centralizada relativamente figura 5 fmPicturePositionRightBottom Afigura aparece direita da legenda A legenda alinhada com a parte inferior da f
436. rmente 7 4 7 1 6 HorizontalAlignment a Define o alinhamento horizontal do texto do E2Setpoint Os valores desta propriedade s o os seguintes e O HorizontalAlignmentLeft alinha horizontalmente esquerda e 1 HorizontalAlignmentCenter alinha horizontalmente ao centro e 2 HorizontalAlignmentRight alinha horizontalmente direita Ovalor padr o desta propriedade 1 HorizontalAlignmentCenter 264 ActiveX 7 4 7 1 7 HScroll F Habilita ou desabilita a exibi o de uma barra de rolagem horizontal no texto caso a propriedade Multiline esteja em True 7 4 7 1 8 MaxLimit imite m ximo que pode ser atingido pela propriedade Value do objeto O valor 9 Limi xi d ingido pel iedade Value do objeto Oval padr o dessa propriedade 200 O limite s verificado se a propriedade EnableMaxLimit estiver habilitada 7 4 7 1 9 MinLimit 9 Limite m nimo que pode ser atingido pela propriedade Value do objeto O valor padr o dessa propriedade 0 O limite s verificado se a propriedade EnableMinLimit estiver habilitada 7 4 7 1 10 Multiline FP Define se o objeto possui m ltiplas linhas ou n o Esta propriedade s estar dispon vel se a propriedade Value for do tipo String 7 4 7 1 11 ReadOnly P Indica se o objeto pode ser editado ou n o em tempo de execu o O valor padr o dessa propriedade falso 7 4 7 1 12 Refresh FP Indica se o valor do E2Setpoint ser atualizado ou n o sempre que o valor d
437. rona isto o valor do tag OPC ser enviado e o processamento do OPC Driver continuar imediatamente O valor padr o desta propriedade False 98 Drivers 3 6 1 17 TimeStamp Ea A propriedade TimeStamp atualizada sempre que ocorrer alguma mudan a de valor ou de estado nas propriedades Value ou Quality Ele informa qual a data hora associada tanto ao valor quanto qualidade do tag OPC Esta uma propriedade somente para leitura O valor padr o desta propriedade 00 00 00 3 6 1 18 UseBitFields P Caso a propriedade UseBitFields tenha o valor True toda vez que o valor da propriedade Value for modificada ele atualizar os bits referentes s propriedades BitOO at Bit31 Da mesma forma atualizar o valor de Value toda vez que alguma das propriedades Bit00 at Bit31 mudar de valor e posteriormente enviar para o equipamento ou dispositivo se a propriedade AllowWrite estiver configurada para True Caso contr rio se a propriedade UseBitFields estiver configurada para False os bits n o sofrer o qualquer mudan a Esta propriedade pode sofrer atualiza o ap s ter sido iniciada a comunica o O valor padr o desta propriedade False Exemplo sub TagoPc1_clickO UseBitFields True End sub NOTA Os valores dos bits Propriedades Bit00 at Bit31 n o s o afetados pelo ajuste de escala Isto representam os bits do valor lido do equipamento antes da convers o 3 6 1 19 Value A propriedade Value atua
438. ropriedade s o as seguintes e 0 fmBackStyleTransparent define o objeto como transparente isto nenhum fundo deste objeto ser desenhado e 1 fmBackStyleOpaque define o objeto como opaco isto o fundo ser desenhado valor padr o 7 3 8 2 5 Caption Define o texto que ser mostrado no objeto 226 ActiveX 7 3 8 2 6 Font A A propriedade Font utilizada para determinar a fonte do objeto Esta propriedade n o pode ser utilizada em scripts ou em associa es sendo configurada unicamente via Studio 7 3 8 2 7 GroupName A A propriedade GroupName utilizado para criar um grupo de objetos mutuamente exclusivos Esta propriedade acess vel apenas em tempo de execu o NOTA Esta propriedade n o utilizada no E3 e foi mantida por motivos de compatibilidade com a especifica o padr o dos objetos Microsoft Forms 7 3 8 2 8 Locked FI A propriedade Locked habilita ou desabilita a edi o do objeto Se esta propriedade estiver configurada para True a edi o n o permitida Caso contr rio poss vel editar o objeto Os valores configurados na propriedade Enabled influenciam o comportamento de Locked Para maiores detalhes consulte a propriedade Enabled O valor padr o desta propriedade False 7 3 8 2 9 Picture 4 Apropriedade Picture especifica a figura bitmap atribu da ao objeto Um arquivo com imagem pode ser selecionado de duas maneiras atrav s da Lista de Propriedades ouvia sc
439. rsion20 permite for ar a comunica o apenas no padr o OPC DA2 0 Essa propriedade n o pode ser modificada quando a comunica o do cliente OPC estiver habilitada tanto no E3 Studio quanto em tempo de execu o 3 5 2 2 ReconnectPeriod 9 Controla o per odo da conex o com o Servidor OPC Se a conex o for perdida o driver p ra e reinicia at que esta a o retorne sucesso O per odo configurado em milissegundos e quando o valor configurado para 0 a reconex o desabilitada Pelo fato do Driver OPC ser parado e iniciado os eventos BeforeStart e AfterStop ser o gerados Quando a conex o for perdida todos os tags relacionados ser o desconectados do seu estado atual bad quality null value Exemplo 86 Drivers Sub Driveropcl Afterstart Application Getobject DriveropC1 Grupoorc1 ReconnectPeriod 0 End sub 3 5 2 3 ServeriD Determina o servidor ao qual o Driver OPC deve se conectar Apesar do valor padr o da propriedade ser vazio se o campo estiver vazio o objeto OPC n o ir conectar Esta propriedade s pode ser modificada quando o Driver OPC n o est conectado Exemplo Sub CommandButtonl clickQO Set opc application Getobject Driveropc1 opc Deactivate opc ServerId ElipsesCADA OPCsvr 1 opc ServerMachine server2 opc activate End sub 3 5 2 4 ServerMachine A A propriedade ServerMachine determina o endere o da esta o onde est rodando o servidor OPC Para apl
440. rver Indica o objeto Banco de Dados utilizado no hist rico para cria o de tabelas e registros de dados O valor padr o desta propriedade vazio 376 Hist ricos 14 2 6 DeadBand 9 Esta propriedade trabalha em conjunto com a propriedade CompressedTable Indica o valor calculado sobre o ltimo valor gravado em percentagem que define se este novo valor ser gravado Se o valor gravado n o for num rico sua modifica o faz com que todos os valores sejam gravados 14 2 7 DiscardInterval 9 Esta propriedade trabalha em conjunto com a propriedade DiscardTimeUnit A propriedade Discardinterval indica o intervalo de tempo durante o qual os dados do Hist rico ficar o armazenados na tabela do banco de dados at serem descartados Ovalor padr o desta propriedade 1 uma unidade de tempo indicada em DiscardTimeUnit Se esta propriedade for configurada com um valor menor ou igual ao valor da propriedade BackupDiscardInterval o E3 automaticamente ajusta o valor de BackupDiscardInterval como o dobro do valor de DiscardiInterval Esta propriedade pode ser modificada em tempo de execu o 14 2 8 DiscardTimeUnit aP Esta propriedade trabalha em conjunto com a propriedade DiscardInterval A propriedade DiscardTimeUnit indica a unidade de tempo em que os dados da tabela ficar o armazenados at serem descartados As op es dispon veis s o e O dtHour horas e 1 dtDay dias e 2 dtMonth meses padr o e 3 dtMinute
441. s veis no E3 Studio ap s a atualiza o do projeto que pode ser feita clicando com o bot o direito do mouse sobre o nome do projeto e selecionando a op o Atualizar Programando no E3 47 2 7 3 Propriedades Todo objeto possui Propriedades que servem para guardar informa es a respeito de suas caracter sticas Por exemplo um objeto do tipo Ret ngulo possuia propriedade Name que cont m seu nome e as propriedades Width e Height que guardam a sua largura e a sua altura respectivamente entre outras propriedades Neste cap tulo listamos todas as propriedades dos objetos do E3 Cada entrada trazo nome da propriedade descri o e quando aplic vel um exemplo de seu uso O primeiro t pico Propriedades Padr o introduzas propriedades presentes em todos os objetos do E3 Os t picos seguintes trazem as propriedades espec ficas de cada objeto ou grupo de objetos mencionados em seu t tulo Em alguns destes t picos o primeiro item tamb m de propriedades comuns neste caso propriedades comuns a todos os objetos do grupo sendo descrito por exemplo no t pico Propriedades dos Objetos de Tela o primeiro item Propriedades Comuns dos Objetos de Tela onde est o agrupadas todas as propriedades comuns a este grupo de objetos As propriedades s o identificadas por um cone que indica o tipo de dado suportado em seu conte do Estes s o Tipos de Dados dispon veis CONE DADO DESCRI
442. s algumas diretivas b sicas Por exemplo para se manipular o valor de um Tag de Comunica o o caminho Servidor Driver Pasta se houver Tag J se o objetivo manipular um bot o na Tela o caminho Viewer Quadro se houver Tela Bot o Existem basicamente tr s localiza es de origem de scripts do ponto de vista da metodologia para acesso dos objetos e Servidor E3 Server e Telas e Quadros E3 Viewer e ElipseX bibliotecas podem ser XObjects rodam no servidor e XControls rodam no E3 Viewer Programando no E3 25 2 3 1 Acessando Propriedades do Servidor Para se acessar um objeto que est sendo executado no servidor a partir de um Objeto de Tela ou um ElipseX deve se usar a diretiva Application GetObject A palavra Application representa a aplica o como um todo e o m todo GetObject procura no servidor por um objeto dentro de Application com o nome fornecido Exemplo Sub Buttonl Click Application Getobject Driverl Item tag001 AlTowread False End sub ouainda Sub Buttonl Click application Getobject Driverl tag001 AlTowread False End Sub O m todo Item foi utilizado para a partir da refer ncia de Driver localizar o tag001 pois o Driver uma cole o de Tags Depois de localizado o objeto suas propriedades e fun es podem ser acessadas livremente Caso alguma outra opera o tivesse que ser realizada como Driverl ou tag001 outra alternativa para o s
443. s associados 12 3 5 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Fonte de Alarme Anal gico 12 3 5 1 1 DeadBand F Habilita ou desabilita a verifica o de alarme de banda morta 12 3 5 1 2 DeadBandAckRequired FI Necessidade de reconhecimento para o alarme de banda morta 12 3 5 1 3 DeadBandLimit 9 Limite para o alarme de banda morta 12 3 5 1 4 DeadBandMessageText Texto da mensagem de alarme de banda morta 12 3 5 1 5 DeadBandReturnMessageText A Mensagem de retorno de alarme de banda morta 12 3 5 1 6 DeadBandSetpoint Limite de banda morta do alarme Cada vez que o valor do tagassociado ultrapassar o valor desta propriedade para mais ou para menos do valor de DeadBandLimit o alarme ocorrer Alarmes 349 12 3 5 1 7 DeadBandSeverity 9 Import ncia do alarme de banda morta Conjunto de valores e O Alta e 1 M dia e 2 Baixa 12 3 6 Fonte de Alarme Taxa de Varia o Esta se o cont m informa es sobre propriedades do objeto Fonte de Alarme Taxa de Varia o Este objeto n o possui eventos nem m todos associados 12 3 6 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Fonte de Alarme Taxa de Varia o 12 3 6 1 1 ROC F Habilita ou desabilita a verifica o de alarme de taxa de varia o 12 3 6 1 2 ROCAckRequired F Necessidade de reconhecimento para o alarme de taxa de varia o 12 3 6 1 3 ROCLimit 9 Limite pa
444. s sobre os eventos do objeto Tag Contador 5 2 1 1 OnPreset OnPreset Ocorre toda vez que o valor da propriedade Preset alcan ado 5 2 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Tag Contador 120 Servidor de Dados 5 2 2 1 AutoRestart P Indica que a contagem deve ser recome ada do zero ap s ter sido atingido o valor estabelecido na propriedade Preset Esta propriedade somente v lida quando a propriedade CounterType est configurada com o valor 0 Preset 5 2 2 2 CounterType P Define o comportamento do contador Os valores dispon veis para esta propriedade s o e O Preset a contagem interrompida quando o valor estabelecido na propriedade Preset atingido e 1 Infinite a contagem prossegue infinitamente 5 2 2 3 Enabled FP Inicia ou p ra o contador Em True a contagem iniciada em False ela interrompida 5 2 2 4 Increment 9 Define o intervalo de atualiza o da propriedade Value Caso esta propriedade tenha seu valor modificado enquanto a contagem estiver em curso esta modifica o s ter efeito quando o contador for parado e reiniciado 5 2 2 5 Preset 9 Limite a ser atingido pelo contador em segundos Caso o valor de Preset n o seja um m ltiplo de Increment o tagir atingir este valor antes do pr ximo incremento 5 2 2 6 ResetCounterWhenEnabled P Habilita o rein cio da contagem do zero cada vez que o valor da propriedade Ena
445. sabilitada Esta propriedade somente de leitura E3Chart 437 18 5 2 19 MinY 9 Informa o valor m nimo da pena no intervalo caso a propriedade EnableCalc esteja habilitada Caso o E3Chart esteja no modo de Pesquisa de Intervalos mostra a m dia nesse intervalo do contr rio mostra a m dia no intervalo entre o in cio e o fim no eixo horizontal Valores com qualidade ruim n o s o considerados caso a propriedade ShowBadPoints esteja desabilitada Esta propriedade somente de leitura 18 5 2 20 Name Determina o nome da pena Exemplo Sub Ccommandsuttoni click screen Item E3Chart1 Pens Name Penal End sub 18 5 2 21 PenStyle P Determina o tipo de linha da pena As op es dispon veis s o as seguintes Op es dispon veis para PenLineStyle OP O DESCRI O 0 LsSolid Linha s lida 1 LsDash Linha tracejada 2 LsDot Linha pontilhada 3 LsDashDot Linha tra o ponto 4 LsDashDotDot Linha tra o ponto ponto 5 LsNull Sem linha Exemplo Sub CommandButton1 clickQO set Pen1 Screen Item E3Chart1 Pens Item Pen1 Penl PenLinestyle 4 End sub 438 E3Chart 18 5 2 22 PenType a Determina otipo de desenho da pena no E3Chart e O Linha e 1 Ponto e 2 Ponto linha e 3 rea Exemplo Sub CommandButtoni Click set Pen1 Screen Item E3Chart1 Pens Item Pen1 Penl PenType 1 End sub 18 5 2 23 QueryName
446. sado o cone do E3 na rea de Notifica o come a a piscar em vermelho indicando a ocorr ncia da falha As falhas reportadas s o normalmente condi es que impedem que o aplicativo funcione parcialmente problema de comunica o em uma porta serial link de rede inativo banco de dados sem conex o e que normalmente n o podem ser detectadas pelo E3 Server Este m todo tem duas finalidades e Avisar o operador do sistema a respeito de problemas em um servidor e Auxiliar o gerenciador autom tico de hot standby a decidir qual servidor est mais apto para executar o aplicativo O m todo ReportFailure possui os seguintes par metros Par metros do m todo ReportFailure NOME DESCRI O FailureName Cont m o nome da falha definido pelo usu rio Este mesmo par metro deve ser passado para o m todo ClearFailure quando o aplicativo detectar que a falha n o est mais ativa Por exemplo Falha COM1 FailureDescription Descri o textual da falha definida pelo usu rio Por exemplo Falha de comunica o na COMI FailureWeight Define a severidade ou peso da falha O valor O indica um aviso sem gravidade Valores maiores que zero indicam falhas Quanto maior o valor mais grave a falha Exemplo Objetos em Tempo de Execu o do Servidor 117 Sub TagEstadoserial onVvalueChanged O If value then O valor do tag TRUE indica que est em falha Application
447. scii Ou seja o evento ocorre quando alguma das teclas a seguir s o pressionadas e Qualquer caractere do teclado que possa ser impresso Tecla CTRL combinada com qualquer caractere do alfabeto padr o Tecla CTRL combinada com qualquer caractere especial Tecla BACKSPACE Tecla ESC Este evento n o ocorre nas seguintes condi es e Pressionando a tecla TAB e Pressionando a tecla ENTER e Pressionando a tecla DEL essa tecla n o ANSI E3Browser 399 e Pressionando as setas do teclado e Quando uma tecla faz com que o foco v de um objeto a outro Enquanto um usu rio pressiona uma tecla que produz um c digo ANSI o E3Browser recebe os eventos KeyDown e KeyPress repetidamente Quando o usu rio libera a tecla o evento KeyUp ocorre Para monitorar o estado f sico do teclado ou manipular teclas n o reconhecidas pelo evento KeyPress como teclas de fun o navega o etc utiliza se os eventos KeyDown e KeyUp 17 1 2 OnDrawRow OnDrawRow bSelected nLine cTextColor cBackColor Este evento passa quatro par metros bSelected indica se a linha est selecionada nLineindica o n mero da linha sendo desenhada cTextColor indica a cor do texto da linha e cBackColor indica a cor de fundo do texto Se a cor for modificada dentro deste evento esta modifica o ser usada pelo E3Browser no desenho da linha Outra modifica o importante que se o m todo GetColumnValue for chamado de dentro do evento os
448. seguintes e 0 fmStyleDropDownCombo a lista de sele o se comporta como uma caixa de combina o suspensa O usu rio pode digitar um valor na regi o de edi o ou selecionar um valor da lista suspensa padr o e 2 fmStyleDropDownList a Lista de sele o se comporta como uma caixa de listagem O usu rio deve escolher um valor da lista 7 3 4 3 40 Text Retorna o texto da op o selecionada Esta propriedade acess vel apenas em tempo de execu o 7 3 4 3 41 TextAlign aP Especifica como o texto alinhado no objeto As op es dispon veis s o as seguintes e 1 fmTextAlignLeft alinha o texto com a extremidade esquerda do objeto e 2 fmTextAlignCenter centraliza o texto com o centro do objeto e 3 fmTextAlignRight alinha o texto com a extremidade direita do objeto 7 3 4 3 42 TextColumn A propriedade TextColumn identifica a coluna no objeto Os valores para a propriedade TextColumn v o de 1 ao n mero de colunas na lista O valor TextColumn para a primeira coluna 1 o valor da segunda coluna 2 e assim por diante A configura o de TextColumn como O exibe os valores para a propriedade Listindex A configura o de TextColumn como 1 exibe a primeira coluna que possui o valor da propriedade ColumnWidths maior do que 0 ActiveX 207 7 3 4 3 43 TextLensth 9 Retorna o n mero de caracteres digitados no objeto Esta propriedade acess vel apenas em tempo de execu o 7 3 4 3 44 ToplIndex
449. seguintes itens sejam tamb m obedecidos obrigatoriamente o objeto pai deste objeto tamb m deve estar vis vel e a propriedade Layer do objeto deve estar presente na camada de Tela Do contr rio o objeto fica invis vel 13 3 39 Width 9 Apropriedade Width define a largura em unidades Himetric do objeto 13 3 40 X 9 Apropriedade X define a coordenada horizontal esquerda em unidades Himetric do objeto 13 3 41Y 9 Esta propriedade define a coordenada vertical superior em unidades Himetric do objeto E3Alarm 373 CAP TULO Hist ricos Esta se o cont m informa es sobre m todos e propriedades do objeto Hist rico Este objeto n o possui eventos associados 14 1 M todos Esta se o cont m informa es sobre os m todos do objeto Hist rico 14 1 1 StartAcquisition StartAcquisition Habilita o Hist rico a gravar os valores do seus campos periodicamente a partir da taxa especificada na propriedade ScanTime Este m todo pode ser chamado a qualquer momento ap s a chamada do m todo StopAcquisition O comportamento padr o deste m todo iniciar a aplica o habilitado ou seja este m todo sempre executado internamente ao se iniciar o Hist rico Exemplo sub Botaol click Quando clica no bot o habilita o hist rico Application Getobject Hist1 startacquisitionQ End sub 14 1 2 StopAcquisition StopAcquisition Desabilita a grava o dos registros por per odo no Hist
450. ser o adotadas as configura es do Viewer para a janela modal Quando este valor for diferente de 1 pode se fazer as combina es descritas na tabela a seguir 298 Viewer Combina es poss veis para o par metro Flags VALOR DESCRI O 1 Habilita a barra de t tulo na janela 2 Habilita o bot o Fechar na janela 4 Habilita o bot o Minimizar na janela 8 Habilita o bot o Maximizar na janela 16 Habilita a borda na janela 32 Especifica que a janela pode ser dimensionada 64 Especifica que a janela pode ser movida 256 Especifica que a janela ficar no topo da Tela 512 Especifica que a janela ser configurada no estilo Barra de Ferramentas 1024 Desabilita os bot es de objeto 2048 Centraliza a Tela modal no Quadro tanto horizontal quanto verticalmente Exemplo sub Botaol Click Ao clicar no Bot o abre uma outra Tela modal pg aa Telas mitulo 0 0724007 200780533 End Su Viewer 299 10 2 4 ESign ESign ObjName Description Action From To User Comment O m todo ESign utilizado para fazer uma valida o da altera o de um campo atrav s de assinatura eletr nica Quando este m todo utilizado a seguinte caixa de di logo mostrada Assinatura Eletr nica xl Tag Dados TagInterno A o Altera o do valor De 0 Para 1 r Executado por Descri o do TagInterno Usu rio
451. ser passado e a propriedade retorna se o item est selecionado ou n o Dessa forma poss vel ver quais itens est o selecionados quando o usu rio selecionar mais de um Esta propriedade acess vel apenas em tempo de execu o Quando o usu rio n o estiver utilizando m ltiplas sele es recomenda se que sejam usadas as propriedades Value ou Listindex 7 3 7 2 19 SpecialEffect aP A propriedade SpecialEffect especifica a apar ncia de um objeto As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para SpecialEffect OP O DESCRI O 0 fmSpecialEffectFlat O objeto aparece plano e possui um destaque na borda uma altera o de cor ou ambos 1 fmSpecialEffectRaised O objeto possui um destaque na parte ActiveX 223 OP O DESCRI O superior esquerda e uma sombra na parte inferior direita O objeto parece estarem relevo 2 fmSpecialEffectSunken O objeto possui uma sombra na parte superior esquerda e um destaque na parte inferior direita Oobjeto e a sua borda parecem estar afundados na Tela 3 fmSpecialEffectEtched Aborda parece estar esculpida ao redor da extremidade do objeto 6 fmSpecialEffectBump O objeto possui um ressalto na parte inferior direita e parece plano na parte superior esquerda 7 3 7 2 20 Text Retorna o texto da op o selecionada Esta prop
452. servidor O par metro UserName determina o nome do usu rio O par metro Password determina a senha do login para se conectar ao banco O par metro DBName o nome do banco de dados utilizado no SQL Server Para os demais bancos de dados esse par metro n o utilizado 11 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto Banco de Dados 11 2 1 ConnectionActive FI Mostra o status da conex o principal do Banco de Dados Se a conex o estiver ativa a propriedade tem o valor True Caso contr rio temo valor False 11 2 2 EnableLocalCreation FI Define se o Viewer criar a conex o do banco de dados localmente ou n o A conex o local ser utilizada somente para a cria o de consultas Se a propriedade estiver habilitada True o Viewer tenta criara conex o localmente e se isso n o for poss vel busca a consulta pedida no servidor Ovalor padr o desta propriedade False Banco de Dados 329 11 2 3 EnableSynchronization P Indica ao E3 se habilitada True que ele tamb m deve fazer a grava o dos dados em uma segunda base de dados simultaneamente para permitir uma maior seguran a Se a propriedade estiver habilitada e houver um servidor StandBy o E3 faz a sincroniza o entre os bancos de dados dos dois servidores Ovalor padr o desta propriedade False ou seja a sincronia est desabilitada 11 2 4 NetLibrary aP Configura o tipo de biblioteca de rede do Banco de Dados
453. sta propriedade s o os seguintes 0 Left a parte inferior do objeto est alinhada com o lado esquerdo da moldura e 1 Up a parte inferior do objeto est alinhada com a parte de cima da moldura e 2 Down a parte inferior do objeto est alinhada coma parte de baixo da moldura 3 Right a parte inferior do objeto est alinhada com o lado direito da moldura Ovalor padr o desta propriedade 2 Down 7 4 6 1 27 Reverted F Habilita ou desabilita a revers o da escala do objeto 7 4 6 1 28 ShowFrame P Habilita ou desabilita a exibi o do fundo ao longo do percurso do ponteiro 7 4 6 1 29 StartAngle 9 Define o ngulo inicial de exibi o do ponteiro do objeto E2ZGauge 7 4 6 1 30 SubTickColor E Define a cor das subdivis es da escala O valor padr o desta propriedade preto RGB 0 0 0 7 4 6 1 31 SubTicksVisible P Habilita ou desabilita a exibi o das subdivis es da escala ActiveX 261 7 4 6 1 32 TextColor E Define a cor do texto da escala O valor padr o desta propriedade preto RGB 0 0 0 7 4 6 1 33 TextFont AA propriedade TextFont utilizada para determinar a fonte do texto da escala Esta propriedade n o pode ser utilizada em scripts ou em associa es sendo configurada unicamente via Studio 7 4 6 1 34 ThickTicks P Habilita ou desabilita a exibi o de divisores da escala mais espessos O valor padr o dessa propriedade falso 7 4 6 1 35 TickColor E Define
454. sta se o cont m informa es sobre os eventos do objeto Relat rio 22 1 1 OnAfterPrint OnAfterPrint Iniciado ap s uma se o ter sido montada no relat rio Pode se utilizar este evento para atualizar qualquer contador cuja utiliza o seja necess ria depois do relat rio ser completado 22 1 2 OnBeforePrint OnBeforePrint Iniciado antes da se o ter sido montada no relat rio Pode se utilizar este evento para modificar o valor de um objeto no relat rio antes que este seja impresso Recomenda se que os campos da consulta do relat rio n o sejam acessados quando este evento estiver sendo utilizado 22 1 3 OnDatalnitialize OnDatalnitialize Ocorre antes do evento OnReportStart Este evento permite acrescentar e configurar campos cole o Fields de um relat rio antes de sua gera o Exemplo Sub OnDataInitialize Fields add Nome Fields add setor Fields add c digo End sub Relat rios 471 22 1 4 OnError OnError Number Description SCode Source HelpFile HelpContext CancelDisplay Gerado por um erro interno no relat rio Se este evento n o for tratado o E3 ir mostrar uma mensagem de erro gen rica Vari veis do evento OnError NOME DESCRI O Number N mero inteiro identificador do erro Description String com a descri o do erro SCode Inteiro com o c digo de erro do subsistema OLE n o utilizado Source String com o objeto origem do
455. strar o texto da mensagem 7 4 8 3 1 9 TipEnable F Habilita ou desabilita a dica para a zona O valor padr o dessa propriedade falso 7 4 8 3 1 10 TipText Define a dica para a zona O valor padr o dessa propriedade em branco 270 ActiveX 7 4 8 3 1 11 Transparent FI Define que o fundo do objeto ser transparente quando esta zona estiver ativa ActiveX 271 CAP TULO Quadros e Divisores Esta se o cont m informa es sobre m todos e propriedades de Quadros e Divisores O objeto Divisor n o possui eventos associados e o objeto Quadro n o possui eventos nem m todos associados 8 1 M todos do Divisor Esta se o cont m informa es sobre os m todos do objeto Divisor 8 1 1 BringToFront BringToFront Traz para frente um divisor que esteja escondido ou abaixo de outro Exemplo Sub Botaol click Application GetFrame Teste BringToFront O End sub 8 1 2 CaptureScreen CaptureScreen Filename Captura o conte do de um divisor gravando o no arquivo de nome e caminho Filename no formato BMP Exemplo sub CommandButtonl Click 3 p Quando o bot o clicado copia o conte do do divisor para o arquivo Frame bm Screen Frame Capturescreen c dC omalEare bmp End sub 8 1 3 Close Close Code Utilize o m todo Close para fechar a janela do quadro O par metro Codeter o valor de retorno para o m todo DoModal se a janela em quest o tiver sido chamada por este m
456. t rio As op es dispon veis s o as seguintes Op es dispon veis para GrpKeepTogether OP O DESCRI O 0 GrpNone A p gina pode ser quebrada imediatamente depois de um GroupHeader 1 GrpFirstDetails O GroupHeader ser impresso com a primeira se o Detail da mesma p gina ou coluna do relat rio 2 GrpAll O GroupHeader Detail e Footer de grupo ser o impressos juntos na mesma p gina do relat rio Ovalor padr o desta propriedade 0 GrpNone Relat rios 487 22 5 2 1 4 KeepTogether P Determina se as se es do relat rio ser o impressas como um nico bloco na mesma p gina As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para KeepTogether OP O DESCRI O 0 ddGrpNone H uma quebra de p gina depois do relat rio 1 ddGrpFirstDetail Orelat rio imprimir a se o Detail na mesma p gina ou coluna 22 5 2 1 5 NewColumm a Insere uma nova quebra de coluna antes ou depois da impress o da se o no relat rio As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para NewColumn OP O DESCRI O 0 ddNPNone N o h quebra de p gina na se o 1 ddNBefore Inicia a impress o da se o em uma nova p gina 2 ddNPA ter Inicia uma nova p gina depois de imprimir a se o 3 ddNPBeforeAfter Inicia a impress o
457. t rio3 strrep PrintPreview visualizando a impress o End sub 10 2 19 Login Login Mode Abre uma caixa de di logo para o login autentica o de usu rio na aplica o O usu rio logado permanece na mem ria at que seja feito outro login ou logout sa da do usu rio da aplica o Este m todo possui o par metro Mode que um booleano que determina se uma mensagem de confirma o ou falha da opera o dever ser mostrada o padr o False Quando uma Tela estiver para ser aberta atrav s do m todo OpensScreen verificado se existe alguma configura o de seguran a Caso exista a Tela s ser aberta se o usu rio logado tiver permiss o Caso n o tenha permiss o aberto um di logo para o login Exemplos Sub TelaInicial onPreshow varg Application Login Usa False como padr o Application Login True aApplication Login False End Sub Viewer 307 10 2 20 LoginUser LoginUser Username UserPassword Executa o login de um usu rio espec fico sem mostrar nenhuma mensagem O par metro Username o nome do usu rio e o par metro UserPassword a senha desse usu rio O m todo retorna True se o login do usu rio foi bem sucedido False caso contr rio Se o usu rio passado no par metro Username estiver configurado para trocar de senha no pr ximo login o m todo retorna False Exemplo sub CommandButton2 Click Dima b a Screen Item Usuario value b screen Item senha
458. tSouthEast Degrad com cor de frente partindo do canto inferior direito 17 SpotSouthWest Degrad com cor de frente partindo do canto inferior esquerdo 18 SpotNorthWest Degrad com cor de frente partindo do canto superior esquerdo 19 SpotNorthEast Degrad com cor de frente partindo do canto superior direito 20 SpotFromCenter Degrad com cor de fundo do centro para as bordas 21 SpotToCenter Degrad com cor de fundo das bordas para o centro IMPORTANTE Um grande n mero de objetos sendo mostrados com degrad simultaneamente acarreta uma perda de performance na atualiza o da Tela O uso de figuras no lugar pode resolver o problema Exemplo Sub Botaol click Objeto fica com degrade Filistyle 8 GradientFill Gradientstyle 0 TeftToRight End sub 6 2 8 1 10 LineColor E Determina a cor da linha com as marcas divis rias e subdivis rias da escala Para determinar a cor da legenda com n meros do objeto use a propriedade TextColor O valor padr o desta propriedade preto RGB 0 0 0 Telas e Objetos de Tela 169 6 2 8 1 11 MaximumValue 9 Esta propriedade determina o valor m ximo atingido pela escala Ovalor padr o desta propriedade 100 Exemplo Sub CommandButton Click Ao clicar no bot o abre um MessageBox indicando o valor m ximo da propriedade da escala MsgBox CSTr Screen Item Escala1l Maximumvalue End Su 6 2 8 1 12 MinimumValue 9 Est
459. ta propriedade s o as seguintes Op es dispon veis para NewPage OP O DESCRI O 0 ddNPNone N o h quebra de p gina na se o 492 Relat rios OP O DESCRI O 1 ddNBefore Inicia a impress o em uma nova p gina 2 ddNPA ter Inicia uma nova p gina depois da impress o da se o 3 ddNPBeforeAfter Inicia a impress o em uma nova p gina e inicia uma nova p gina depois de imprimir a se o 22 5 4 GroupFooter Esta se o cont m informa es sobre propriedades do objeto GroupFooter do Relat rio Este objeto n o possui eventos nem m todos associados 22 5 4 1 Propriedades Esta se o cont m informa es sobre as propriedades do objeto GroupFooter do Relat rio 22 5 4 1 1 ColumnLayout FI Determina se o GroupFooter ir utilizar o mesmo layout das colunas configuradas na se o Detail Se a propriedade estiver configurada para True o n mero de colunas na se o Detail ir refletir no GroupHeader ou no GroupFooter associados Caso contr rio permanece com as configura es padr o O valor padr o desta propriedade True 22 5 4 1 2 KeepTogether P Determina se as se es do relat rio ser o impressas como um nico bloco na mesma p gina As op es dispon veis para esta propriedade s o as seguintes Op es dispon veis para KeepTogether OP O DESCRI O 0 ddGrpNon
460. ta o bot o Maximizar na janela 16 Habilita a borda na janela 276 Quadros e Divisores VALOR DESCRI O 32 Especifica que a janela pode ser dimensionada Para isso necess rio que a janela em quest o tenha borda 64 Especifica que a janela pode ser movida 256 Especifica que a janela ficar no topo da Tela 512 Especifica que a janela ser configurada no estilo Barra de Ferramentas 1024 Desabilita os bot es de objeto Exemplo sub Tela OnPreshow Frame SetFrameoptions Tela de Alarmes 114 End sub No exemplo anterior o valor 114 2 16 32 64 indica que a janela ter o bot o Fechar habilitado 2 ter uma borda 16 poder ser dimensionada 32 e poder ser movida 64 O t tulo da janela ser Tela de Alarmes Nos picks Abrir Tela e Abrir Tela Modal tamb m poss vel configurar o estilo da janela durante a edi o atrav s da caixa de di logo Estilo da Janela Para mais informa es veja o t pico Picks NOTA o m todo SetFrameOptions deve ser usado ap s a chamada ao m todo SetDisableTaskSwitching caso seja necess rio modificar o t tulo ou o estilo da janela 8 2 Propriedades do Divisor Esta se o cont m informa es sobre as propriedades do objeto Divisor 8 2 1 ISHTML Fi A propriedade ISHTML retorna True se o divisor cont m c digos HTML inseridos no quadro Caso contr rio retorna Fals
461. ta propriedade define o n mero de casas decimais para o valor nominal do E2Gauge 7 4 6 1 4 HiColorLegend E Define a cor da legenda para o limite Alto O valor padr o desta propriedade amarelo RGB 255 255 0 7 4 6 1 5 HiDiv 9 Marca o in cio da escala para o limite Alto O valor padr o dessa propriedade 13300 7 4 6 1 6 HiHiColorLegend E Define a cor da legenda para o limite Muito Alto O valor padr o desta propriedade vermelho RGB 255 0 0 7 4 6 1 7 HiHiDiv 9 Marca o in cio da escala para o limite Muito Alto O valor padr o dessa propriedade 16600 7 4 6 1 8 HiHilimitVisible P Habilita ou desabilita a exibi o do limite Muito Alto 7 4 6 1 9 HiLimit 9 Ovalor m ximo dessa propriedade 1e o m nimo limitado pela propriedade LowLimit O valor padr o dessa propriedade 0 7 258 ActiveX 7 4 6 1 10 HiLimitVisible F Habilita ou desabilita a exibi o do limite Alto 7 4 6 1 11 LegendVisible P Exibe uma barra ao longo do objeto E2Gauge onde podem ser configuradas diferentes cores dependendo da faixa de valores O valor padr o desta propriedade True 7 4 6 1 12 LimitVisible FI Define se os valores m nimos e m ximos da escala aparecem ou n o no gr fico 7 4 6 1 13 LowColorLegend E Define a cor da legenda para o limite Baixo O valor padr o desta propriedade verde escuro RGB 0 128 0 7 4 6 1 14 LowDiv 9 Marca o in cio da escala para o limite Baixo
462. tag sendo executado em um DataServer X application Getvalue Dataserverl InternalTag1 End sub 10 2 10 GetFormulaUnitDataObj GetFormulaUnitDataObj FormulaName Este m todo obt m a configura o das unidades existentes numa determinada f rmula As unidades s o o destino dos dados salvos na f rmula valores Este m todo possui o par metro FormulaName que informa o nome da f rmula Utilize o m todo GetFormulaUnitDataObj para obter uma cole o das unidades de uma f rmula Este m todo retorna True se conseguir realizar a opera o ou False caso n o consiga Exemplo sub Botaol Click Dim val Quando clica no bot o mostra uma caixa de mensagem MessageBox com o n mero de Units e o nome da Primeira Unit set obj application GetFormulaunitDataob j Formulal MsgBox CStr obj Count MsgBox Cstr obJ Name 1 End Sub 10 2 11 GetFormulaValueDataObj GetFormulaValue DataObj FormulaName Este m todo obt m a configura o dos valores existentes numa determinada f rmula Os valores s o o conjunto de dados salvos na f rmula Este m todo possui o par metro FormulaName que informa o nome da f rmula Utilize o m todo GetFormulaValueDataObj para obter uma cole o de valores na f rmula Este m todo retorna True se conseguir realizar a opera o ou False caso n o consiga Exemplo Sub Botaol Click Dim val Quando clica no bot o mostra uma caixa de mensagem MessageBox com o n mero
463. tando se o bot o o E3 abre o AppBrowser para a escolha do tag desejado Valor 1 Determina o primeiro valor a ser comparado Se o valor do tag for igual a Valor1 ent o o tag recebe Valor2 Valor 2 Determina o segundo valor a ser comparado Se o valor do tag for igual a Valor2 ent o o tag recebe Valor1 18 Introdu o 1 3 6 Imprimir Relat rio Permite imprimir um relat rio na tela ou na impressora 3 Tetatnicial 7 BI click aaa Ag x Click Fires when screen is dicked on NTelatnicial A bd x i Imprimir relat rio Imprime o relat rio r Imprimir relat rio Imprimir relat rio Mensagens Scripts HEEE Configura es do pick Imprimir Relat rio Op es dispon veis no pick Imprimir Relat rio CAMPO DESCRI O Imprimir Permite escolher o relat rio a ser impresso relat rio Sa da Determina o tipo de sa da do relat rio e Impressora Envia o relat rio para a impressora Corresponde ao m todo Print e Tela Fazuma pr via de impress o de relat rio na tela Corresponde ao m todo PrintPreview Introdu o 19 1 4 Eventos Definidos pelo Usu rio Apesar do E3 vir com uma extensa gama de eventos muitas vezes o usu rio pode desejar criar um evento espec fico para sua aplica o Um exemplo para a utiliza o de eventos definidos pelo usu rio se
464. te a texto CanPaste ser False ActiveX 233 Esta propriedade acess vel apenas em tempo de execu o 7 3 9 3 8 CurLine 9 Especifica a linha corrente do objeto ou seja a linha que cont m o ponto de inser o de texto O n mero da primeira linha 0 O valor padr o desta propriedade 0 7 3 9 3 9 CurTargetX 9 Retorna a posi o horizontal de inser o de um texto no objeto Esta posi o medida em unidades him tricas um himetro 0 0001 de um metro Pode se usar CurTargetX e CurX para mover o ponto de inser o de um texto conforme o usu rio percorre o conte do do objeto Quando o usu rio move o ponto de inser o para outra linha do texto a propriedade CurTargetX especifica a posi o mais indicada para o ponto de inser o do texto desejado A propriedade CurX definida neste valor se a linha do texto for maior que o valor de CurTargetX Caso contr rio a propriedade CurX definida como o final da linha do texto Esta propriedade acess vel apenas em tempo de execu o 7 3 9 3 10 CurX 9 Apropriedade CurX especifica a posi o atual horizontal do ponto de inser o no objeto Esta propriedades aplicada num objeto que possua v rias linhas isto a propriedade Multiline est habilitada O valor de retorno v lido quando o objeto possui o foco Pode se usar a propriedade Multiline e a propriedade CurX para posicionar o ponto de inser o do texto conforme o usu rio usa a barra de r
465. tempo de atualiza o do E3Chart Exemplo Sub E3Chart1 OnStartRunning O MsgBox RefreshTime End sub 18 3 31 ScaleFont Determina a fonte do texto utilizada na grade Exemplo Sub CommandButtonl clickQO Screen Item E3Chart1 scaleFont Times New Roman Screen Item E3Chart1 scaleFont size 12 Screen Item E3Chart1 scaleFont Italic true End sub 18 3 32 Screen Cont m uma refer ncia para o objeto Tela onde o E3Chart est inclu do 18 3 33 ShowBackground P Habilita ou desabilita a visualiza o do fundo do gr fico Se a propriedade for igual a True o fundo do gr fico mostrado Caso contr rio o gr fico fica com o fundo transparente Acor escolhida na propriedade BackColor n o aparece se esta propriedade estiver em False op o padr o Exemplo Sub CommandButtonl1 click set E3chartl Screen Item E3Chart1 F acharti sopa carona Not E3Chart1 showBackground End Su 18 3 34 ShowBottomScale Fi Se a propriedade estiver configurada para True o eixo horizontal principal mostrado na base da grade Caso contr rio n o mostrado O valor padr o True Exemplo Sub CommandButtonl clickQO set E3chartl Screen Item E3Chart1 oldBottomscale E3cChart1 sShowBottomscale MsgBox Mostrar eixo E3Chartl ShonBottomscale True MsgBox Esconder eixo E3Chartl ShowBottomscale False MsgBox voltar E3Chart1 showBottomscale oldBottomscale End sub E3Chart 423 1
466. to gerado a chamada do m todo FitAll ou FitPen pode causar problemas caso se esteja utilizando a consulta autom tica j que o m todo ativa outras consultas at que todos os dados sejam lidos Neste caso recomendado que o valor passado pelos par metros destes m todos seja 1 o que enquadra verticalmente as penas 18 2 M todos Esta se o cont m informa es sobre os m todos do objeto E3Chart 18 2 1 CopyConfig CopyConfig SourceChart Flags O m todo CopyConfig copia as configura es de um E3Chart para outro O par metro SourceChart indica o E3Chart de origem cujas propriedades ser o copiadas para o E3Chart que chamou o m todo Por exemplo para copiar a configura o de um E3Chart que est numa Tela ScreenChart para outro que est dentro de um relat rio ReportChart o seguinte script pode ser adicionado no objeto E3Report associado ao relat rio Sub OnBeforePrint set Chart Report Sections PageHeader Controls ReportChart Chart Copyconfig application GetFrameO screen Item Sscreenchart Chart Loadbata Chart FitalTO End sub E3Chart 411 18 2 2 FitAlI FitAlI FitStyle Enquadra todas as penas no E3Chart O par metro opcional FitStyle indica o modo de enquadramento das penas em tempo de execu o e 0 enquadra ambos os eixos ao mesmo tempo e 1 enquadra apenas o eixo vertical e 2 enquadra apenas o eixo horizontal Exemplo Sub CommandButtonl clickO screen It
467. to As op es dispon veis s o e 0 fmBorderStyleNone sem borda e 1 fmBorderStyleSingle com borda simples 7 3 6 1 6 Caption Define o texto que ser mostrado no objeto 7 3 6 1 7 Font Apropriedade Font utilizada para determinar a fonte do objeto Esta propriedade n o pode ser utilizada em scripts ou em associa es sendo configurada unicamente via Studio 7 3 6 1 8 Picture 4 Apropriedade Picture especifica a figura bitmap atribu da ao objeto Um arquivo com imagem pode ser selecionado de duas maneiras atrav s da Lista de Propriedades ouvia scripts utilizando se a fun o LoadPicture para especificar o caminho e o nome do arquivo que cont m a figura Para remover a figura clique o valor da propriedade Picture e pressione a tecla DEL Atecla BACKSPACE tecla de espa o do teclado n o remove a figura Exemplo sub CommandButtonl Click screen Item checkBox1 Picture LoadPicture C Naba gif End sub ActiveX 213 7 3 6 1 9 PicturePosition P A propriedade PicturePosition especifica a posi o da figura atribu da ao objeto em rela o a sua legenda As op es dispon veis para esta propriedades s o as seguintes Op es dispon veis para PicturePosition OP O DESCRI O 0 fmPicturePositionLeftTop A figura aparece esquerda de sua legenda Alegenda alinhada com a parte superior da figura 1 fmPicturePositionLeftCenter Afigura aparece esquerda
468. to Se omitido assume uma string vazia 352 Alarmes NOME DESCRI O Severity Par metro num rico que determina a severidade do evento Se omitido assume o valor 0 ou seja severidade alta EventTime Especifica o timestamp do evento Se omitido assume o valor do timestamp do momento da chamada do m todo Source Par metro texto que especifica o conte do do campo Fonte do evento Se omitido assume uma string vazia EventCategory Par metro texto que especifica a categoria do evento Se omitido assume uma string vazia EventType Par metro texto que especifica o tipo do evento Se omitido assume o valor Tracking UserFields Par metro array de quatro posi es ou mais onde cada posi o assume o valor do campo especificado pelo usu rio AlarmSource Name Par metro texto que especifica o nome da fonte de alarme Se omitido assume uma string vazia FullAlarmSource Name Par metro texto que especifica o caminho completo da fonte de alarme incluindo a rea a configura o do alarme e as poss veis pastas onde o alarme est inserido Se omitido assume uma string vazia Os demais campos do evento n o podem ser especificados e sempre assumem os valores a seguir Valor CurrentValue 0 0 Qualidade Quality e Condi o Ativa ConditionActive O False Nome da Condi o ConditionName Nome da Subc
469. to modelo template numa determinada unidade Retorna True se conseguir realizar a opera o ou False caso contr rio Este m todo possui os par metros UnitName que informa o nome da unidade TemplateName que informa o nome do template do Tag e Data que informa o nome da vari vel que cont m o nome do Tag Exemplo Sub Botaol Click Appl ication cetobijectiromulalD sarna Unidade2 Template5 50 End Su 20 1 14 SetValueData SetValueData ValueName TemplateName Data Altera o valor referente a um template definido para um determinado conjunto de valores Este m todo faza verifica o dos limites retornando True se conseguir realizar a opera o ou False caso contr rio Este m todo possui os par metros ValueName que determina o nome do conjunto de valores TemplateName que determina o nome do template e Data que determina o nome da vari vel que possui o valor Exemplo Sub Botaol Click App an on GetObject Formula1 SetValueData Unidade2 Templatel 100 End Su 20 2 Propriedades Esta se o cont m informa es sobre as propriedades do objeto F rmula 20 2 1 DBServer Indica o nome do banco de dados onde ser o gravadas as informa es da f rmula ou seja as unidades e os conjuntos de valores O valor padr o desta propriedade vazio 20 2 2 ImmediateExecute FI Quando habilitada faz com que a F rmula escreva seus registros diretamente no Banco de Dados sem precisar passar por suas fi
470. toSize P A propriedade AutoSize ajusta a largura do texto caso a rea dispon vel para o mesmo ultrapasse o tamanho do objeto Para o objeto Editor de Texto Text Box quando a propriedade estiver configurada para True a largura do texto reajustada para a mesma do objeto Ovalor padr o desta propriedade False 7 3 9 3 2 AutoTab FI A propriedade AutoTab habilita ou desabilita a tabula o autom tica no objeto Se a propriedade estiver configurada para True a tabula o autom tica ocorre Caso contr rio n o utilizada Ap s o usu rio digitar o n mero m ximo de caracteres em um objeto utilizando a propriedade MaxLength o foco se move automaticamente para o pr ximo objeto da ordem de tabula o quando estes caracteres forem atingidos Por exemplo quando se quer que um Editor de Texto exiba dados de estoque que possuam sempre cinco caracteres pode se usar a propriedade MaxLength para especificar o n mero m ximo de caracteres a serem introduzidos no objeto e a propriedade AutoTab para tabular automaticamente para o pr ximo objeto depois que o usu rio digitar cinco caracteres 7 3 9 3 3 AutoWordSelect F Habilita ou desabilita a sele o autom tica de palavras no objeto Se esta propriedade estiver configurada para True a palavra indicada selecionada no texto mais o espa o seguinte caso se tenha selecionado parte dela Caso contr rio somente o caractere indicado na palavra selecionado 232 Act
471. tos similares Os objetos contidos em uma cole o s o referenciados por ndices semelhante refer ncia de arrays Pode se adicionar ou remover objetos individuais de uma cole o conforme o exemplo a seguir 40 Programando no E3 Sub CommandButtonl clickQO adiciona uma pena no objeto E3Chartl Screen Item E3Chart1 Pens add Pena End sub Sub CommandButton2 clickQO Remove a primeira pena screen Item E3Chart1 Pens Remove O End sub NOTA o primeiro objeto em uma cole o possui o ndice 1 Todas as cole es possuem uma propriedade em comum chamada Count que o n mero de objetos ou filhos existentes Exemplo Sub CommandButton1 clickQO Mostra uma caixa de di logo com o n mero de penas MsgBox Screen Item E3Chart1 Pens Count End Sub 2 5 1 Acessando Objetos com o M todo Item Toda cole o possui um m todo Item que pode ser usado para acessar qualquer objeto dentro da cole o O m todo Item aceita um par metro Item que pode ser um n mero inteiro positivo ou o nome do objeto dentro da cole o que se deseja acessar Os exemplos a seguir s o de ajustes da cor da segunda pena do objeto E3Chart Sub CommandButton1 clickQO Modifica a cor da terceira pena creen TrenGiEschart LD penso trono color RGB 212 208 20 End Su Ou ainda Sub CommandButton1 clickQO Modifica a cor da pena com nome Pena2 screen Item E3Chart1 Pens Item Pena2 Color RGB 212 208 20
472. tribu da ao objeto em rela o a sua legenda As op es dispon veis para esta propriedades s o as seguintes Op es dispon veis para PicturePosition OP O DESCRI O 0 fmPicturePositionLeftTop Afigura aparece esquerda de sua legenda Alegenda alinhada com a parte superior da figura 1 fmPicturePositionLeftCenter Afigura aparece esquerda da legenda Alegenda centralizada relativamente imagem 2 fmPicturePositionLeftBotton Afigura aparece esquerda da legenda Alegenda alinhada com a parte inferior da figura 3 fmPicturePositionRightTop Afigura aparece direita da legenda A legenda alinhada coma parte superior da figura 4 fmPicturePositionRightCenter Afigura aparece direita da legenda A legenda centralizada relativamente figura 5 fmPicturePositionRightBotton Afigura aparece direita da legenda A legenda alinhada coma parte inferior da figura 6 fmPicturePositionAboveLeft Afigura aparece acima da legenda A legenda alinhada com a extremidade esquerda da figura 7 fmPicturePositionAboveCenter Afigura aparece acima da legenda A legenda centralizada abaixo da figura padr o 8 fmPicturePositionAboveRight Afigura aparece acima da legenda A legenda alinhada com a extremidade ActiveX 191 OP O DESCRI O direita da figura 9
473. tura 22 6 5 1 12 SummaryDistinctField Determina o nome do campo que ser usado pela fun o selecionada na propriedade SummaryFunc Esta propriedade s v lida se a fun o definida em SummaryFunc for do grupo de fun es Distinct Summary o qual abrange as fun es de n meros 9 at 15 e quando a propriedade SummaryType tem valor diferente de 0 22 6 5 1 13 SummaryFunc P Determina o tipo de fun o que ser usada para processar os valores do campo especificado na propriedade DataField como listado na tabela a seguir Esta propriedade s v lida quando a propriedade SummaryType tem valor diferente de 0 Op es dispon veis para SummaryFunc OP O DESCRI O 0 Sum Calcula a soma de todos os valores dentro do intervalo de totais especificado grupo p gina ou relat rio 1 Avg Calcula a m dia de todos os valores dentro do intervalo de totais especificado grupo p gina ou relat rio 2 Count Conta o n mero de valores dentro do intervalo de totais especificado grupo p gina ou relat rio 3 Min Mostra o menor valor valor m nimo dentro do intervalo de totais especificado grupo p gina ou relat rio 4 Max Mostra o maior valor valor m ximo dentro do intervalo de totais especificado grupo p gina ou relat rio Relat rios 509 OP O DESCRI O 5 Var Calcula a vari nci
474. tureFile na Tela Esta propriedade s ser v lida se a propriedade FillStyle estiver selecionada como 12 bkPicture As op es v lidas s o Op es dispon veis para PicturePosition OP O DESCRI O 0 Center Figura no tamanho original centralizada na Tela 1 Tile Figura no tamanho original repetida tantas vezes quantas forem necess rias para preencher a Tela 2 Stretch Figura redimensionada para preencher a Tela 3 TopLeft Figura no tamanho original no canto esquerdo superior da Tela 140 Telas e Objetos de Tela OP O DESCRI O 4 BottomLeft Figura no tamanho original no canto esquerdo inferior da Tela 5 BottomRight Figura no tamanho original no canto direito inferior da Tela 6 TopRight Figura no tamanho original no canto direito superior da Tela 6 1 3 14 Screen 58 Retorna a Tela pai do objeto Esta propriedade acess vel apenas em tempo de execu o 6 1 3 15 TabStop P Esta propriedade determina a utiliza o da tecla TAB no sistema Se o valor do campo estiver em True poss vel utilizar a tecla caso contr rio a tecla n o pode ser utilizada 6 1 3 16 Width 9 Apropriedade Width define a largura em unidades Himetric da Tela 6 2 Objetos de Tela Esta se o cont m informa es sobre eventos m todos e propriedades dos Objetos de Tela 6 2 1 Eventos Comuns Esta se
475. uality representa o estado de qualidade do valor O E3 utiliza o padr o OPC para informar essa propriedade O campo formado por uma palavra de 16 bits sendo que os primeiros 8 bits s o definidos na forma de 3 campos de bits Qualidade Substatus e Limite nessa disposi o QQSSSSLL Qualidade pode ser ruim incerta ou boa ver tabela a seguir Substatus tem informa es complementares de Qualidade Limite pode indicar informa es de diagn stico Servidores que n o suportam estas ltimas informa es retornam zero nos bits correspondentes Os outros 8 bits de maior ordem est o dispon veis para uso de cada fabricante Se esses bits forem utilizados os bits de qualidade padr o ainda s o utilizados para indicar quais dedu es pode se fazer sobre os dados retornados Assim de responsabilidade do cliente interpretar o campo de informa es espec ficas de qualidade para garantir que o servidor que est provendo essa informa o usa as mesmas regras que o cliente Um driver ou servidor OPC que n o suporta informa o de qualidade sempre retorna o valor 192 qualidade boa Tamb m aceit vel que um servidor retorne simplesmente qualidade ruim 0 ou boa 192 e n o passe nenhuma informa o nos bits de substatus e limite retornar O nesses bits Uma lista dos valores poss veis de Quality e seu significado pode ser vista nas tabelas a seguir Faixas de valor para Quality FAIXA QUALIDADE DESCRI O
476. ub 18 3 54 Visible 9 Habilita ou desabilita a visibilidade do E3Chart Se a propriedade estiver configurada para True o E3Chart ser vis vel Caso contr rio o E3Chart n o mostrado O valor padr o True 428 E3Chart 18 3 55 Width 9 Determina a largura do objeto em unidades Himetric 18 3 56 X 9 Apropriedade X define a coordenada horizontal esquerda em unidades Himetric do objeto 18 3 57 Y Esta propriedade define a coordenada vertical superior em unidades Himetric do objeto 18 4 Cole o de Penas Esta se o cont m informa es sobre m todos e propriedades do objeto Cole o de Penas Este objeto n o possui eventos associados 18 4 1 M todos Esta se o cont m informa es sobre os m todos do objeto Cole o de Penas 18 4 1 1 AddPen AddPen Pen O m todo AddPen adiciona uma nova pena ao E3Chart retornando a pena criada Exemplo E3Chart 429 Sub CommandButtonl clickQO Cria uma pena sem nome Set Pen Screen Item E3Chart1 Pens AddPen MsgBox Pen Name End Sub subcommandButtonl DbClick O Cria uma pena com o nome Penl se o nome existir a pena incrementada Set Pen Screen Item E3Chart1 Pens AddPen Pen1 MsgBox Pen Name End Sub Sub commandButton2 clickQO Cria uma pena e associa a TagDemol set Chart Screen Item E3cChart1 Set Pen Chart Pens addPen MsgBox Pen Name Pen UsetimeStamp True Pen YLink Dados TagDemo1 P
477. ue Bind srcHivalue Value End If End sub Associa es 289 9 7 1 4 SrcLoValue 9 Especifica o valor m nimo atingido na fonte Exemplo Sub SrcLovalue ValueChange On Error Resume Next Dim Bind Set Bind Screen Item scrollBar1 Links Item value Screen Item scrollBar2 Min Value If Bind Is Nothing Then cds scrollBarl n o tem associado Else MsgBox scrollBarl est associado a amp Bind Source amp MsgBox Mudando SrcLovalue de Bind srcLovalue amp para amp Value Bind srcLovalue Value End If End sub 9 8 Conex o Por Tabela Esta se o cont m informa es sobre m todos e propriedades da Conex o por Tabela Este objeto n o possui eventos associados 9 8 1 M todos Esta se o cont m informa es sobre os m todos da Conex o por Tabela 9 8 1 1 InsertRow InsertRow Row Insere uma nova linha na tabela O par metro Row opcional e especifica em que posi o da tabela deve ser inserida a linha Quando omitido assume o comportamento padr o de inserir a linha no fim da tabela o que equivale a usar Row igual a 1 Quando informado e n o for 1 deve ser um valor entre 1 e Count e a nova linha criada desloca as linhas de ndice maior ou igual para a dire o ascendente dos ndices Uma linha nova sempre assume os seguintes valores padr o para as propriedades e Min 0 0 e Max 1 0 290 Associa es e Blink False e BlinkValue 0 0 e Value 0 0 E
478. ueles definidos na F rmula Este m todo possui os seguintes par metros FormulaName determina o nome da f rmula e UnitName determina o nome da unidade O nome do conjunto de valores configurado no par metro ValueName Uma caixa de mensagem aparecer permitindo ao usu rio informar valores diferentes daqueles definidos para cada um dos valores da F rmula NOTA O m todo retorna um valor l gico ou seja retorna True quando executada com sucesso e False quando falha o que n o significa que houve um erro no script Exemplo Sub Botaol Click Application LoadFormulavalues Formulal Unit1 valuel End sub 306 Viewer 10 2 17 LoadFormulaValuesQuiet LoadFormulaValuesQuiet FormulaName UnitName ValueName Carrega um conjunto de valores para uma unidade de destino sem apresentar nenhuma mensagem Este m todo possui os seguintes par metros FormulaName determina o nome da F rmula e UnitName determina o nome da unidade Onome do conjunto de valores configurado no par metro ValueName Exemplo Sub Botaol Click Application LoadFormulavaluesQuiet Formulal Unidade3 valor1 End sub NOTA Este m todo tamb m acessado atrav s do objeto Formula 10 2 18 LoadReport LoadReport ReportName Carrega um modelo de relat rio O par metro ReportName o nome do relat rio a ser carregado Exemplo sub Rect Click Carregando o relat rio pr definido Set strRep Application LoadReport Rela
479. um dos bits Bit00 a Bit31 Neste caso a propriedade AllowWrite do objeto Bloco de Comunica o deve estar configurada para True Esta tamb m a propriedade padr o do objeto Elemento de Bloco Sendo assim uma refer ncia por valor a um Elemento de Bloco n o necessita obrigatoriamente explicitar a propriedade Value para acessar o valor Caso esta propriedade n o esteja sendo atualizada verifique se a propriedade Index est corretamente configurada O valor padr o desta propriedade vazio sem valor Exemplo 84 Drivers Sub Botaol click Acessa um elemento e mostra o valor atual elm1 um objeto tipo Bloco de comunica o Set obj application Getobject Driverde Comuni cacaol Block1 elm1 MsgBox Valor atual de elml amp obj value Isto tamb m pode ser feito de outra forma sem mostrar a propriedade Value que padr o MsgBox valor atual de elml amp obj End Sub 3 5 Driver de Comunica o OPC Esta se o cont m informa es sobre os eventos e propriedades do objeto Driver de Comunica o OPC Este objeto n o possui m todos associados 3 5 1 Eventos Esta se o cont m informa es sobre os eventos do objeto Driver de Comunica o OPC 3 5 1 1 OnTagRead OnTagRead Tag Ocorre na leitura de um tag sempre que um novo valor ou um erro for retornado pelo Servidor OPC Ou seja se o valor ou a qualidade do tag n o mudarem o evento n o ser disparado Para que este evento ocorra a pr
480. usu rio poder escolher entre tr s op es de estados Falso verdadeiro ou Nulo O valor Nulo exibido como um bot o sombreado Caso contr rio o usu rio pode escolher entre os valores False ou True O valor padr o desta propriedade False 7 3 3 1 14 Value Indica o valor inicial do objeto Tem comportamento booleano se True o objeto inicia marcado do contr rio seu estado inicial n o marcado O valor padr o desta propriedade False 7 3 3 1 15 WordWrap F Habilita ou desabilita uma quebra de linha no texto caso a rea dispon vel para o texto ultrapasse os limites determinados no objeto Para que esta propriedade funcione a propriedade Multiline deve ser obrigatoriamente igual a True 7 3 4 Lista de Sele o Esta se o cont m informa es sobre eventos m todos e propriedades do objeto Lista de Sele o 7 3 4 1 Eventos Esta se o cont m informa es sobre os eventos do objeto Lista de Sele o 7 3 4 1 1 DropButtonClick DropButtoncClick Ocorre quando a lista de op es aparece ou desaparece ao se clicar no objeto ActiveX 193 7 3 4 2 M todos Esta se o cont m informa es sobre os m todos do objeto Lista de Sele o 7 3 4 2 1 Addltem Additem pvargitem pvargindex O m todo Additem utilizado para se adicionar itens a uma Lista de Sele o pvarglitem um string que cont m o texto que ser adicionado na lista se for omitido ser acrescentado um string
481. utilizada para controlar a gera o do evento OnTagRead que ocorre no driver de comunica o que cont m o bloco Se a propriedade EnableDriverEvent do tag estiver configurada para True ser habilitada a gera o do evento OnTagRead por este tag Caso contr rio n o ocorre Os tr s tipos de elementos de comunica o Tag de Comunica o Bloco de Comunica o e Elemento de Bloco podem gerar este evento O evento ocorre no driver e n o no bloco 3 2 3 9 EnableScaling Fi A propriedade EnableScaling habilita ou desabilita a escala de valor para o valor enviado e recebido do equipamento ou do dispositivo Se esta propriedade estiver configurada para True todo valor proveniente do equipamento ou do dispositivo sofrer ajuste de escala nas propriedades DeviceHigh DeviceLow EUHigh e EULow antes de ser atribu do propriedade Value Caso contr rio nenhum ajuste de escala ser efetuado em nenhum dos dois sentidos escrita e leitura Exemplo Drivers 67 Sub Tag OnStartRunningO Faz o ajuste de escala de um tag de temperatura que varia de O a 255 no PLC mas significam na pr tica de O a 100 graus Celsius EU Graus Celsius Enablescaling True DeviceHigh 255 DeviceLow O EuHigh 100 EULow O End sub 3 2 3 10 EU A Esta propriedade utilizada para identificar a unidade de engenharia que o valor representa como por exemplo graus metros KW h etc Exemplo Sub Tag OnStartRunning O Faz o ajuste de
482. vbnNewLine End If Next MsgBox strResult End sub 18 5 1 6 GetPoint GetPoint ValueX ValueY Retorna as coordenadas X e Y do ponto mais pr ximo ao valor de entrada em ValueX O par metro ValueX informa o valor de refer ncia para a busca do ponto e depois recebe o valor efetivo da coordenada X do ponto mais pr ximo encontrado O par metro ValueY retorna o valor efetivo da coordenada Y do ponto mais pr ximo encontrado O m todo retorna True se encontrou um ponto e False caso contr rio 18 5 1 7 SetCursorPos SetCursorPos X Range Posiciona o cursor da pena do E3Chart O par metro X indica em qual posi o o cursor deve ser posicionado similar ao comportamento de mover o cursor na pesquisa com o mouse O cursor movido para a posi o mais pr xima indicada por X O par metro Range opcional e usado como valida o O cursor s ser movido se o ponto v lido estiver dentro do intervalo Qualquer valor negativo indica que o intervalo passado n o deve ser usado Exemplo Existindo um ponto v lido em x 1 y 10 e outro em x 4 y 20 SetcursorPos 2 move o cursor para o ponto 1 10 SetcursorPos 4 move o cursor para o ponto 4 20 Quando range usado o cursor s movido se ponto estiver dentro do range N o vai mover o cursor porque 2 est mais de 0 5 unidade distante do ponto mais pr ximo que 1 SetcursorPos 2 0 5 Envia o cursor para o ponto 1 10 SetcursorPos 2 4
483. vel em um objeto como ocorre em um n vel de um tanque por exemplo 152 Telas e Objetos de Tela Op es dispon veis para HorizontalFillStyle OP O DESCRI O O FillLeftToRight A porcentagem de preenchimento ser da esquerda para a direita padr o 1 FillRightToLeft A porcentagem de preenchimento ser da direita para a esquerda 2 FillCenterToEdgesH A porcentagem de preenchimento ser do centro para as bordas Exemplo Sub circulol OonStartRunningO Horizontalrilistyle 2 End sub 6 2 6 1 7 HorizontalPercentFil 9 Utilize a propriedade HorizontalPercentFill para especificar qual a porcentagem da rea horizontal do objeto dever ser preenchida Os valores aceitos por esta propriedade variam de 0 a 100 Esta propriedade trabalha em conjunto com a propriedade HorizontalFillStyle que informa como este preenchimento ocorrer O valor padr o desta propriedade 100 Exemplo sub circulol OnStartRunningO HorizontalPercentrill 200 End sub 6 2 6 1 8 OverrideFillColor E Quando a propriedade OverrideFillMode estiver especificada para os valores 2 ou 3 a propriedade OverrideFillColor ser usada para definira cora ser usada no preenchimento da imagem ao inv s da cor original Nos scripts utilize a fun o do VBScript RGB para montar a cora ser associada a esta propriedade Ovalor padr o desta propriedade vermelho RGB 255 0 0 Exemplo Sub Drawpictur
484. vos esquerda O valor padr o desta propriedade 200 Telas e Objetos de Tela 155 6 2 6 1 14 ShadowY 9 Define a coordenada horizontal superior da sombra deste objeto em unidades Himetric Esta sombra sempre relativa a propriedade Y do objeto Valores positivos indicam que a sombra estar abaixo do objeto e negativos acima O valor padr o desta propriedade 200 Exemplo Sub Botaol Click Shadowy 250 End sub 6 2 6 1 15 TransparentColor E Quando a propriedade TransparentMode estiver configurada para 1 esta propriedade definir qual cor da imagem n o ser desenhada e a imagem ficar transparente nestes pontos Nos scripts utilize a fun o do VBScript RGB para montar a cora ser associada a esta propriedade O valor padr o desta propriedade branco RGB 255 255 255 Exemplo Sub Drawpicturel click Deixa a cor da imagem azul transparente quando se clica no objeto Figura TransparentMode 1 ByColor Transparentcolor RGB O 0 255 End sub 6 2 6 1 16 TransparentMode aP A propriedade TransparentMode especifica o modo como a imagem ter o efeito de transpar ncia Op es dispon veis para TransparentMode OP O DESCRI O 0 Disabled Nenhuma transpar ncia ser efetuada 1 ByColor Atranspar ncia ser de acordo com a cor definida na propriedade TransparentColor 156 Telas e Objetos de Tela
485. x Este ndice deve ser de 1 at Count Caso n o exista conex o com a propriedade ou o ndice seja inv lido ocorrer um erro de script Como as demais cole es Links permite o uso do comando For Each do VBScript Exemplo Sub Textol Click For Each Link In Links MsgBox Origem do link amp Link source Next End sub 9 1 3 RemoveLink RemoveLink Property Este m todo remove uma conex o com a propriedade especificada por Property caso ela exista Caso n o exista conex o com a propriedade especificada o m todo n o tem efeito Exemplo Sub CommandButton2 clickQO On Error Resume Next Dim Bind Set Bind Screen Item scroliBar1 Links Item value If Bind Is Nothing Then Se a conex o n o existe TRE ScrollBarl n o est conectado Else MsgBox ScrollBarl est ligado amp Bind Source amp MsgBox Removendo o link Screen Item scrollBar1 Links RemoveLink value End If End sub 282 Associa es 9 2 Propriedades Comuns Os Links trazem grande facilidade para criar diversos tipos de associa es visto que n o necess ria a execu o l gica ou via scripts para associar duas vari veis quaisquer O objeto Links retorna uma cole o das associa es de um objeto qualquer do E3 A propriedade comum toda a cole o Links Count Para acessar ou modificar uma conex o s o usadas as propriedades e m todos dos objetos de conex o Links Cada tipo de conex o tem proprieda
486. x o Reversa 9 6 Conex o Digital 9 7 Conex o Anal gica 9 8 Conex o Por Tabela 9 9 Conex o M ltipla 10 Viewer 10 1 Eventos 10 2 M todos 10 3 Propriedades 10 4 Objeto top 11 Banco de Dados 11 1 M todos 11 2 Propriedades 12 Alarmes 12 1 Configura o de Alarmes 12 2 reas de Alarme 12 3 Fontes de Alarme 12 4 Servidor de Alarmes 13 E3Alarm 13 1 Eventos 13 2 M todos 13 3 Propriedades 14 Hist ricos 14 1 M todos 14 2 Propriedades 15 Storage 15 1 M todos 15 2 Propriedades 15 3 Campo do Storage 16 Consultas 16 1 Eventos 16 2 M todos 16 3 Propriedades 17 E3Browser 17 1 Eventos 17 2 M todos 17 3 Propriedades 17 4 Campos do E3Browser 18 E3Chart 279 280 280 283 284 285 285 286 288 290 294 296 296 297 315 322 329 329 329 333 333 333 335 351 359 359 360 366 374 374 375 380 380 381 385 387 387 387 392 399 399 400 401 408 410 18 1 Eventos 18 2 M todos 18 3 Propriedades 18 4 Cole o de Penas 18 5 Penas 18 6 Cole o de Eixos 18 7 Eixos 18 8 Cole o de Consultas 18 9 Legenda 18 10 Colunas da Legenda 19 E3Playback 19 1 M todos 19 2 Propriedades 20 F rmulas 20 1 M todos 20 2 Propriedades 21 Bibliotecas de Usu rio 21 1 XControls e XObjects 21 2 Propriedades de um ElipseX 22 Relat rios 22 1 Eventos 22 2 M todos 22 3 Propriedades 22 4 Layout 22 5 Se o 22 6 Objetos 23 D vidas Mais Frequentes 410 411 414 429 431 442 444 451 453 457 460 460 4
487. xemplo sub Retangulol Click On Error Resume Next Dim Bind set Bind _ screen Item Retangulo1 Links Item Foregroundcolor If Bind Is Nothing Then MsgBox Retangulol n o tem nenhuma associa o Else Dim row row Screen Item setPointRow value MsgBox Bind RowCcount If row lt 1 OR row gt Bind RowCount Then 185 9Box N mero de linha inv lido amp row Else MsgBox acrescentando uma linha em amp row Bind InsertRow row If row 1 Then row Bind RowCount Bind value line _ Screen Item Rectanglevalue Foregroundcolor Bind Blinkvalue line _ screen Item RectangleBlinkvalue Foregroundcolor Bind Max line screen Item setPointMax value Bind Min line screen Item setPointMin value Bind Blink line _ screen Item checkBoxBl ink value End If End If End If End sub 9 8 1 2 RemoveRow RemoveRow Row Remove a linha no ndice especificado O par metro Row determina a linha da tabela a ser removida deve ser de 1 at Count Exemplo Sub RemoveRow Click On Error Resume Next Dim Bind set Bind screen Item Retangulo1 Links Item Foregroundcolor If Bind Is Nothing Then la Retangulol n o tem associa o Else MsgBox Retangulol est ligado amp Bind Source amp Dim row row Screen Item Row Value MsgBox Removendo a linha amp row Bind RemoveRow row End If End sub Associa es 291 9 8 2 Propriedades Esta se o c
488. zado N o utilizado 196 215 Sobrescritalocal Ovalorfoisobrescrito 216 217 218 219 Tipicamente indica que a entrada foi desconectada e um valor entrado manualmente foi for ado N o especificado Ovalor bom mas 220 255 nenhuma raz o espec fica conhecida 3 8 1 10 RawValue Acessa o valor original do elemento anterior escala ou seja independentemente da configura o da propriedade EnableScaling Ent o se esta propriedade for False as propriedades Value e RawValue apresentam o mesmo comportamento 3 8 1 11 UseBitFields FI Caso a propriedade UseBitFields tenha o valor True toda vez que o valor da propriedade Value for modificada ele atualizar os bits referentes s propriedades BitOO at Bit31 Da mesma forma atualizar o valor de Value toda vez que alguma das propriedades Bit00 at Bit31 mudar de valor e posteriormente enviar para o equipamento ou dispositivo se a propriedade AllowWrite do bloco de comunica o 114 Drivers estiver configurada para True Caso contr rio se a propriedade UseBitFields estiver configurada para False os bits n o sofrer o nem acarretar o qualquer mudan a Esta propriedade pode ser atualizada ap s ter sido iniciada a comunica o Ovalor padr o desta propriedade False 3 8 1 12 Value Atualizada sempre que um novo valor lido no servidor OPC de acordo com a especifica o da propriedade ItemlD do Bloco

Tutorial Script E3

Contents

Download Pdf Manuals

Related Search

Related Contents