A Linguagem AdvPl. Programação Com Interface Própria com o Usuário. Revisão: 09/06/2003

Transcrição

1 A Linguagem AdvPl Revisão: 09/06/2003 A Linguagem AdvPl teve seu início em 1994, sendo na verdade uma evolução na utilização de linguagens no padrão xbase pela Microsiga Software S.A. (Clipper, Visual Objects e depois FiveWin). Com a criação da tecnologia Protheus, era necessário criar uma linguagem que suportasse o padrão xbase para a manutenção de todo o código existente do sistema de ERP Siga Advanced. Foi então criada a linguagem chamada Advanced Protheus Language. O AdvPl é uma extensão do padrão xbase de comandos e funções, operadores, estruturas de controle de fluxo e palavras reservadas, contando também com funções e comandos disponibilizados pela Microsiga que a torna uma linguagem completa para a criação de aplicações ERP prontas para a Internet. Também é uma linguagem orientada a objetos e eventos, permitindo ao programador desenvolver aplicações visuais e criar suas próprias classes de objetos. Quando compilados, todos os arquivos de código tornam-se unidades de inteligência básicas, chamados APO s (de Advanced Protheus Objects). Tais APO s são mantidos em um repositório e carregados dinamicamente pelo Protheus Server para a execução. Como não existe a linkedição, ou união física do código compilado a um determinado módulo ou aplicação, funções criadas em AdvPl podem ser executadas em qualquer ponto do ambiente Advanced Protheus. O compilador e o interpretador da linguagem AdvPl é o próprio servidor Protheus (Protheus Server), e existe um ambiente visual para desenvolvimento integrado (Protheus IDE) onde o código pode ser criado, compilado e depurado. Os programas em AdvPl podem conter comandos ou funções de interface com o usuário. De acordo com tal característica, tais programas são subdivididos nas seguintes categorias: Programação Com Interface Própria com o Usuário Nesta categoria entram os programas desenvolvidos para serem executados através do terminal remoto do Protheus, o Protheus Remote. O Protheus Remote é a aplicação encarregada da interface e da interação com o usuário, sendo que todo o processamento do código em AdvPl, o acesso ao banco de dados e o gerenciamento de conexões é efetuado no Protheus Server. O Protheus Remote é o principal meio de acesso a execução de rotinas escritas em AdvPl no Protheus Server, e por isso permite executar qualquer tipo de código, tenha ele interface com o usuário ou não. Porém nesta categoria são considerados apenas os programas que realizem algum tipo de interface remota utilizando o protocolo de comunicação do Protheus. Pode-se criar rotinas para a customização do sistema ERP Advanced Protheus, desde

2 processos adicionais até mesmo relatórios. A grande vantagem é aproveitar todo o ambiente montado pelos módulos do ERP Advanced Protheus. Porém, com o AdvPl é possível até mesmo criar toda uma aplicação, ou módulo, do começo. Todo o código do sistema ERP Advanced Protheus é escrito em AdvPl. Programação Sem Interface Própria com o Usuário As rotinas criadas sem interface são consideradas nesta categoria porque geralmente têm uma utilização mais específica do que um processo adicional ou um relatório novo. Tais rotinas não têm interface com o usuãrio através do Protheus Remote, e qualquer tentativa nesse sentido (como a criação de uma janela padrão) ocasionará uma exceção em tempo de execução. Estas rotinas são apenas processos, ou Jobs, executados no Protheus Server. Algumas vezes, a interface destas rotinas fica a cargo de aplicações externas, desenvolvidas em outras linguagens, que são responsáveis por iniciar os processos no servidor Protheus através dos meios disponíveis de integração e conectividade no Protheus. De acordo com a utilização e com o meio de conectividade utilizado, estas rotinas são subcategorizadas assim: Programação por Processos Programação de RPC Programação Web Programação TelNet Programação por Processos Rotinas escritas em AdvPl podem ser iniciadas como processos individuais (sem interface) no Protheus Server através de duas maneiras: Iniciadas por outra rotina AdvPl através da chamada de funções como StartJob ou CallProc ou iniciadas automaticamente na inicialização do Protheus Server (quando propriamente configurado). Programação de RPC Através de uma biblioteca de funções disponível no Protheus (uma API de comunicação), pode-se executar rotinas escritas em AdvPl diretamente no Protheus Server, através de aplicações externas escritas em outras linguagens. Isto é o que se chama de RPC (de Remote Procedure Call, ou Chamada de Procedimentos Remota). O servidor Protheus também pode executar rotinas em AdvPl em outros servidores Protheus através de conexão TCP/IP direta utilizando o conceito de RPC. Do mesmo

3 modo, aplicações externas podem requisitar a execução de rotinas escritas em AdvPl através de conexão TCP/IP direta. Programação Web O Protheus Server pode também ser executado como um servidor Web, respondendo a requisições HTTP. No momento destas requisições, pode executar rotinas escritas em AdvPl como processos individuais, enviando o resultado das funções como retorno das requisições para o cliente HTTP (como por exemplo um Browser de Internet). Qualquer rotina escrita em AdvPl que não contenha comandos de interface pode ser executada através de requisições HTTP. O Protheus permite a compilação de arquivos HTML contendo código AdvPl embutido. São os chamados arquivos AdvPl ASP, para a criação de páginas dinâmicas. Programação TelNet TelNet é parte da gama de protocolos TCP/IP que permite a conexão a um computador remoto através de uma aplicação cliente deste protocolo. O Protheus Server pode emular um terminal TelNet, através da execução de rotinas escritas em AdvPl. Ou seja, pode-se escrever rotinas AdvPl cuja interface final será um terminal TelNet ou um coletor de dados móvel.

4 Classes da Interface Visual tsrvobject Revisão: 22/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe mãe de todas as classes de interface. Características Classe abstrata inicial de todas as classes de interface do Advpl. Não deve ser instanciada diretamente. Propriedades Propriedade Tipo nleft Numérico. Coordenada horizontal em pixels. ntop Numérico. Coordenada vertical em pixels. nwidth Numérico. Largura em pixels. nheight Numérico. Altura em pixels. ccaption Caractere. Título ou conteúdo do objeto. ctooltip Caractere. Mensagem exibida quando objeto exibe seu tooltip. lshowhint Lógico. Flag que ativa.t. ou desativa.f. a exibição do tooltip do objeto. cmsg Caractere. Mensagem exibida na barra de status da janela principal quando o objeto ganha foco. nclrtext Numérico. Cor do texto do objeto. nclrpane Numérico. Cor do fundo do objeto. bwhen bvalid Bloco de código. Bloco de código. Executado quando há movimentação de foco na janela.se retornar.t. o objeto continua habilitado, se retornar.f. o objeto será desabilitado. Executado quando o conteúdo do objeto é modificado e deverá ser validado. Deve retornar.t. se o conteúdo é válido e.f. se conteúdo inválido. blclicked Bloco de Executado quando acionado click do botão esquerdo do

5 código. mouse sobre o objeto. brclicked Bloco de Executado quando acionado click do botão direito do mouse código. sobre o objeto. Bloco de Executado quando acionado duplo click do botão esquerdo bldblclick código. do mouse sobre o objeto. ownd Objeto. Janela onde o objeto foi criado. lvisible Booleano. Se.T. o objeto é visível, se.f. o objeto é invisível. Cargo Objeto ou variável. Conteúdo associado ao objeto. Bloco de blostfocus código. Executado quando objeto perde foco. Bloco de bgotfocus código. Executado quando objeto ganha foco. Métodos SetFocus Sintaxe SetFocus( ) Força o foco de entrada de dados mudar para o objeto. Retorno NIL Hide Sintaxe Hide( ) Torna objeto invisível. Retorno NIL Show Sintaxe Show( ) Torna objeto visível. Retorno NIL Enable Sintaxe Enable( ) Habilita o objeto. Retorno NIL

6 Disable Sintaxe Disable( ) Desabilita o objeto. Retorno NIL Refresh Sintaxe Refresh( ) Força atualização (sincronia) de propriedades entre o programa e o Protheus Remote.

7 tfont Revisão: 23/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe que encapsula fonte de edição. Hierarquia tfontabs -> tfont Utilize objeto tfont para modificar a fonte padrão de controles visuais. Propriedades Vide classes ancestrais. Métodos New Sintaxe Parâmetros Método construtor da classe. New([acName], [npar2], [anheight], [lpar4], [albold], [npar6], [lpar7], [npar8], [alitalic], [alunderline]) Parâmetro Tipo / acname Caractere, opcional. Nome da fonte, o padrão é Arial. npar2 Reservado. anheight Numérico, opcional. Tamanho da fonte. O padrão é lpar4 Reservado. albold Lógico, opcional. Se.T. o estilo da fonte será negrito. npar6 Reservado. lpar7 Reservado.

8 npar8 Reservado. alitalic Lógico, opcional. Se.T. o estilo da fonte será itálico. Lógico, opcional. Se.T. o estilo da fonte será alunderline sublinhado. Retorno O objeto criado. Exemplo #INCLUDE "PROTHEUS.CH" User Function Teste() Local odlg, osay Local ofont:= TFont():New("Courier New",,-14,.T.) DEFINE MSDIALOG odlg FROM 0,0 TO 200,200 TITLE "My dialog" PIXEL // Apresenta o tsay com a fonte Courier New osay := TSay():New( 10, 10, { "Mensagem"},oDlg,, ofont,,,,.t., CLR_WHITE,CLR_RED ) /* o comando abaixo proporciona o mesmo 10,10 SAY osay PROMPT "Mensagem" FONT ofont COLOR CLR_WHITE,CLR_RED OF odlg PIXEL */ osay:ltransparent:=.f. ACTIVATE MSDIALOG odlg CENTERED Return

9 tcontrol Revisão: 23/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe abstrata mãe de todos os controles editáveis. Hierarquia tsrvobject -> tcontrol Características tcontrol é a classe comum entre todos os componentes visuais editáveis. Propriedades Nome Tipo / Numérico. Alinhamento do controle no espaço disponibilizado pelo seu Align objeto parente. 0 = Nenhum (padrão), 1= no topo, 2 = no rodapé, 3= a esquerda, 4 = a direita e 5 = em todo o parente. Lógico. Se.T. indica que o conteúdo da variável associada ao controle foi lmodified modificado. Lógico. Se.T. o conteúdo da variável associada ao controle permanecerá lreadonly apenas para leitura. Numérico. Handle (identificador) do objeto sobre o qual o controle foi hparent criado. Bloco de código. Executado quando o estado ou conteúdo do controle é bchange modificado pela ação sobre o controle. Métodos SetFocus Força mudança do foco de entrada de dados para o controle. Sintaxe SetFocus( ) REtorno NIL

10 tbutton Revisão: 23/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe de botão. Hierarquia tsrvobject -> tcontrol -> tbutton Utilize a classe tbutton para criar um controle visual do tipo botão. Propriedades Nome Tipo / lprocessing Lógico. Se.T. indica o botão está efetuando uma ação. baction Bloco de código. Executado quando o botão é pressionado. Métodos New Sintaxe Método construtor da classe. New([anRow], [ancol], [accaption], [aownd], [abaction], [anwidth], [anheight], [npar8], [aofont], [lpar10], [alpixel],[lpar12],[cpar13], [lpar14], [abwhen], [bpar16], [lpar17]) Parâmetro Tipo / Numérico, opcional. Coordenada vertical em pixels ou anrow carateres. Parâmetros Numérico, opcional. Coordenada horizontal em pixels ancol ou caracteres. accaption Caractere, opcional. Titulo do botão. aownd Objeto, opcional. Janela ou controle onde o botão

11 deverá ser criado. Bloco de código, opcional. Bloco que deverá ser abaction acionado quando o botão for pressionado. anwidth Numérico, opcional. Largura do botão em pixels. anheight Numérico, opcional. Altura do botão em pixels. npar8 Reservado. Objeto, opcional. Objeto tipo tfont com propriedades aofont da fonte utilizada para o título do botão. lpar10 Reservado. Lógico, opcional. Se.T. considera as coordenadas alpixel passadas em pixels, se.f. (padrão) considera em caracteres. lpar12 Reservado. cpar13 Reservado. lpar14 Reservado. Bloco de código, opcional. Executado quando mudança de foco de entrada de dados está sendo efetuada na abwhen janela onde o controle foi criado. O bloco deve retornar.t. se o controle deve permanecer habilitado ou.f. se não. bpar16 Reservado. lpar17 Reservado. Exemplo #include protheus.ch User Function TesteGet() Local odlg, obutton, ocombo, ccombo, aitems:= { item1, item2, item3 } ccombo:= aitems[2] DEFINE MSDIALOG odlg FROM 0,0 TO 300,300 PIXEL TITLE Meu Combo ocombo:= tcombobox():new(10,10,{ u if(pcount()>0,ccombo:=u,ccombo)},; aitems,100,20,odlg,,{ MsgStop( Mudou item )},,,,.T.,,,,,,,,, ccombo ) // Botão para fechar a janela obutton:=tbutton():new(30,10, fechar,odlg,{ odlg:end()},100,20,,,,.t.) ACTIVATE MSDIALOG odlg CENTERED MsgStop( O valor é +ccombo ) Return NIL

12 tcheckbox Revisão: 23/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe de caixa checkbox. Hierarquia tsrvobject -> tcontrol -> tcheckbox Utilize a classe tcheckbox quando desejar criar um controle que possua dois estados.t. ou.f.. Métodos New Sintaxe Parâmetros Método construtor da classe. New([anRow], [ancol], [accaption], [absetget], [aownd], [anwidth], [anheight], [npar8], [abclick], [aofont], [abvalid], [anclrfore], [anclrback], [lpar14], [alpixel], [cpar16], [lpar17], [abwhen]) Parâmetro Tipo / Numérico, opcional. Coordenada vertical em pixels ou anrow carateres. Numérico, opcional. Coordenada horizontal em pixels ancol ou caracteres. accaption Caractere, opcional. Texto exibido pelo controle. Bloco de código, opcional. Bloco de código no formato { u if( Pcount( )>0, <var>:= u, <var> ) } que o controle absetget utiliza para atualizar a variável <var>. <var> deve ser tipo lógico, se <var> =.T. então o controle aparecerá checado. Objeto, opcional. Janela ou controle onde o controle aownd deverá ser criado.

13 Retorno anwidth Numérico, opcional. Largura do controle em pixels. anheight Numérico, opcional. Altura do controle em pixels. npar8 Reservado. Bloco de código, opcional. Executado quando o abclick controle click do botão esquerdo do mouse é acionado sobre o controle. Objeto, opcional. Objeto tipo tfont com propriedades aofont da fonte utilizada para o texto do controle. Bloco de código, opcional. Executado quando o conteúdo do controle deve ser validado, deve retornar abvalid.t. se o conteúdo for válido e.f. quando o conteúdo for inválido. anclrfore Numérico, opcional. Cor de fundo do controle. anclrback Numérico, opcional. Cor do texto do controle. lpar14 Reservado. Lógico, opcional. Se.T. as coordenadas informadas alpixel são em pixels, se.f. são em caracteres. cpar16 Reservado. lpar17 Reservado. Bloco de código, opcional. Executado quando mudança de foco de entrada de dados está sendo efetuada na abwhen janela onde o controle foi criado. O bloco deve retornar.t. se o controle deve permanecer habilitado ou.f. se não. O objeto construído. Exemplo #include protheus.ch User Function Teste() Local odlg, obutton, ocheck, lcheck:=.f. DEFINE MSDIALOG odlg FROM 0,0 TO 300,300 PIXEL TITLE Meu programa ocheck:= tcheckbox():new(10,10, funcionou?,; { u if( pcount()>0,lcheck:=u,lcheck)};,odlg,100,20,,,,,,,,.t.) obutton:=tbutton():new(30,10, fechar,odlg,{ odlg:end()},; 100,20,,,,.T.) ACTIVATE MSDIALOG odlg CENTERED If lcheck MsgStop( Funcionou! ) Endif Return NIL

14 tcombobox Revisão: 23/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe de combobox. Hierarquia tsrvobject -> tcontrol -> tcombobox Utilize a classe tcombobox para cria uma entrada de dados com múltipla escolha com item definido em uma lista vertical, acionada por F4 ou pelo botão esquerdo localizado na parte direita do controle. A variável associada ao controle terá o valor de um dos itens selecionados ou no caso de uma lista indexada, o valor de seu índice. Propriedades Nome Tipo / Array. Lista de itens, caracteres, a serem exibidos. Pode ter os seguintes aitems formatos: a) Seqüencial, exemplo: { item1, item2,..., itemn } ou b) Indexada, exemplo: { a=item1, b=item2,..., n=itemn }. nat Numérico. Posição do item selecionado. Métodos New Sintaxe Método construtor da classe. New([anRow], [ancol], [absetget], [anitems], [anwidth], [anheight], [aownd], [npar8], [abchange], [abvalid], [anclrtext], [anclrback], [alpixel], [aofont], [cpar15], [lpar16], [abwhen], [lpar18], [apar19], [bpar20], [cpar21], [acreadvar]) Parâmetros Parâmetro Tipo /

15 Numérico, opcional. Coordenada vertical em pixels ou anrow caracteres. Numérico, opcional. Coordenada horizontal em pixels ancol ou caracteres. Bloco de código, opcional. Bloco de código no formato { u if( Pcount( )>0, <var>:= u, <var> ) } que o controle utiliza para atualizar a variável <var>. absetget <var> deve ser tipo caracter. Se a lista for seqüencial, o controle atualizará <var> com o conteúdo do item selecionado, se a lista for indexada, <var> será atualizada com o valor do índice do item selecionado. Array, opcional. Lista de items, caracteres, a serem exibidos. Pode ter os seguintes formatos: a) anitems Seqüencial, exemplo: { item1, item2,..., itemn } ou b) Indexada, exemplo: { a=item1, b=item2,..., n=itemn }. anwidth Numérico, opcional. Largura do controle em pixels. anheight Numérico, opcional. Altura do controle em pixels. Objeto, opcional. Janela ou controle onde o controle aownd será criado. npar8 Reservado. Bloco de código, opcional. Executado quando o abchange controle modifica o item selecionado. Bloco de código, opcional. Executado quando o conteúdo do controle deve ser validado, deve retornar abvalid.t. se o conteúdo for válido e.f. quando o conteúdo for inválido. anclrback Numérico, opcional. Cor de fundo do controle. anclrtext Numérico, opcional. Cor do texto do controle. Lógico, opcional. Se.T. as coordenadas informadas alpixel são em pixels, se.f. são em caracteres. Objeto, opcional. Objeto tipo tfont utilizado para aofont definir as características da fonte utilizada para exibir o conteúdo do controle. cpar15 Reservado. lpar16 Reservado. Bloco de código, opcional. Executado quando mudança de foco de entrada de dados está sendo abwhen efetuada na janela onde o controle foi criado. O bloco deve retornar.t. se o controle deve permanecer habilitado ou.f. se não. lpar18 Reservado. apar19 Reservado. bpar20 Reservado. cpar21 Reservado.

16 Retorno Caractere, opcional. Nome da variável que o controle deverá manipular, deverá ser a mesma variável acreadvar informada no parâmetro absetget, e será o retorno da função ReadVar( ). O objeto criado. Select Muda o item selecionado no combobox. Sintaxe Select( [anitem] ) Parâmetros Retorno Exemplo Parâmetro Tipo / anitem Numérico, opcional. Posição do item a ser selecionado. NIL #include protheus.ch User Function TesteGet() Local odlg, obutton, ocombo, ccombo, aitems:= { item1, item2, item3 } ccombo:= aitems[2] DEFINE MSDIALOG odlg FROM 0,0 TO 300,300 PIXEL TITLE Meu Combo ocombo:= tcombobox():new(10,10,{ u if(pcount()>0,ccombo:=u,ccombo)},; aitems,100,20,odlg,,{ MsgStop( Mudou item )},;,,,.T.,,,,,,,,, ccombo ) // Botão para fechar a 40,10 BUTTON obutton PROMPT Fechar OF odlg PIXEL ACTION odlg:end() ACTIVATE MSDIALOG odlg CENTERED MsgStop( O valor é +ccombo ) Return NIL

17 tget Revisão: 23/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe de controle para entrada de dados editáveis. Hierarquia tsrvobject -> tcontrol -> tget Use tget para criar um controle que armazene ou altere o conteúdo de uma variável através de digitação. O conteúdo da variável só é modicado quando o controle perde o foco de edição para outro controle. Propriedades Nome Tipo / Lógico. Se.T. o controle se comporta como entrada de dados de senha, lpassword exibindo asteriscos * para esconder o conteúdo digitado. Picture Caractere. Máscara de formatação do conteúdo a ser exibido. Métodos New Sintaxe Parâmetros Método construtor do controle. New([anRow], [ancol], [absetget], [aownd], [anwidth], [anheight], [acpict], [abvalid], [anclrfore], [anclrback], [aofont], [lpar12], [opar13], [alpixel], [cpar15], [lpar16], [abwhen], [lpar18], [lpar19], [abchange], [alreadonly], [alpassword], [cpar23], [acreadvar], [cpar25], [lpar26], [npar27], [lpar28]) Parâmetro Tipo / anrow Numérico, opcional. Coordenada vertical em pixels

18 ou caracteres. Numérico, opcional. Coordenada horizontal em pixels ancol ou caracteres. Bloco de código, opcional. Bloco de código no formato { u if( Pcount( )>0, <var>:= u, <var> ) } que absetget o controle utiliza para atualizar a variável <var>. <var> deve ser tipo caracter, numérico ou data. Objeto, opcional. Janela ou controle onde o controle aownd será criado. anwidth Numérico, opcional. Largura do controle em pixels. anheight Numérico, opcional. Altura do controle em pixels. Caractere, opcional. Máscara de formatação do acpict conteúdo a ser exibido. Bloco de código, opcional. Executado quando o conteúdo do controle deve ser validado, deve retornar abvalid.t. se o conteúdo for válido e.f. quando o conteúdo for inválido. anclrfore Numérico, opcional. Cor de fundo do controle. anclrback Numérico, opcional. Cor do texto do controle. Objeto, opcional. Objeto tipo tfont utilizado para aofont definir as características da fonte utilizada para exibir o conteúdo do controle. lpar12 Reservado. opar13 Reservado. Lógico, opcional. Se.T. as coordenadas informadas alpixel são em pixels, se.f. são em caracteres. cpar15 Reservado. lpar16 Reservado. Bloco de código, opcional. Executado quando mudança de foco de entrada de dados está sendo abwhen efetuada na janela onde o controle foi criado. O bloco deve retornar.t. se o controle deve permanecer habilitado ou.f. se não. lpar18 Reservado. lpar19 Reservado. Bloco de código, opcional. Executado quando o abchange controle modifica o valor da variável associada. Lógico, opcional. Se.T. o controle não poderá ser alreadonly editado. Lógico, opcional. Se.T. o controle exibirá asteriscos alpassword * no lugar dos caracteres exibidos pelo controle para simular entrada de senha. cpar23 Reservado. Caractere, opcional. Nome da variável que o controle acreadvar deverá manipular, deverá ser a mesma variável

19 Retorno informada no parâmetro absetget, e será o retorno da função ReadVar( ). cpar25 Reservado. lpar26 Reservado. npar27 Reservado. lpar28 Reservado. O controle construído. Exemplo #include protheus.ch User Function TesteGet() Local odlg, oget1, obutton, nget1:=0 DEFINE MSDIALOG odlg FROM 0,0 TO 300,300 PIXEL TITLE Meu Get oget1:= TGet():New(10,10,{ u if(pcount()>0,nget1:=u,nget1}}, odlg,; 999,999.99,; { o nget1> },,,,,,.t.,,,,,,,,,, nget1 ) /* Tem o mesmo 10,10 MSGET oget1 VAR nget1 SIZE 100,20 OF odlg PIXEL 999, VALID nget1> */ // Botão para fechar a 40,10 BUTTON obutton PROMPT Fechar OF odlg PIXEL ACTION odlg:end() ACTIVATE MSDIALOG odlg CENTERED MsgStop( O valor é 999, ) ) Return NIL

20 tgroup Revisão: 23/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe de painel de grupo de controles. Hierarquia tsrvobject -> tcontrol -> tgroup Utilize a classe tgroup para criar um painel onde controles visuais podem ser agrupados ou classificados. É criada uma borda com título em volta dos controles agrupados. Métodos New Sintaxe Método construtor da classe. New([anTop], [anleft], [anbottom], [anright], [accaption], [aownd], [anclrtext], [anclrpane], [alpixel], [lpar10]) Parâmetro Tipo / Numérico, opcional. Coordenada vertical superior em antop pixels ou caracteres. Numérico, opcional. Coordenada horizontal esquerda anleft em pixels ou caracteres. Numérico, opcional. Coordenada vertical inferior em anbottom Parâmetros pixels ou caracteres. Numérico, opcional. Coordenada horizontal direita em anright pixels ou caracteres. accaption Caractere, opcional. Título do grupo. Objeto, opcional. Janela ou controle onde o controle aownd será criado. anclrtext Numérico, opcional. Cor do texto.

21 anclrpane Numérico, opcional. Cor do fundo. alpixel Lógico, opcional. Se.T. as coordenadas informadas são em pixels, se.f. são em caracteres. lpar10 Reservado. Retorno O objeto criado. Exemplo #include protheus.ch User function teste() Local odlg, ogroup, oget1, oget2, cget1:=space(10),; cget2:= Space(10) DEFINE MSDIALOG odlg FROM 0,0 TO 400,400 TITLE My test PIXEL ogroup:= tgroup():new(10,10,200,200, grupo de 10,10 MSGET oget1 VAR cget1 SIZE 100,10 OF ogroup 30,10 MSGET oget2 VAR cget2 SIZE 100,10 OF ogroup PIXEL ACTIVATE MSDIALOG odlg CENTERED Return NIL

22 tlistbox Revisão: 23/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe de lista de items. Hierarquia tsrvobject -> tcontrol -> tlistbox Utilize a classe tlistbox para criar uma janela com itens selecionáveis e barra de rolagem. Ao selecionar um item, uma variável é atualizada com o conteúdo do item selecionado. Propriedades Nome Tipo / nat Numérico. Posição do item selecionado. aitems Array de items caracteres. Lista do itens selecionáveis. Métodos New Sintaxe Parâmetros Método construtor da classe. New([anRow], [ancol], [absetget], [aaitems], [anwidth], [anheigth], [abchange], [aownd], [abvalid], [anclrfore], [anclrback], [alpixel], [lpar13], [abldblclick], [aofont], [cpar16], [lpar17], [abwhen], [apar19], [bpar20], [lpar21], [lpar22], [abrightclick] ) Parâmetro anrow Tipo / Numérico, opcional. Coordenada vertical em pixels ou caracteres.

23 Retorno Numérico, opcional. Coordenada horizontal em ancol pixels ou caracteres. Bloco de código, opcional. Bloco de código no formato { u if( Pcount( )>0, <var>:= u, <var> )} absetget que o controle utiliza para atualizar a variável <var>. <var> deve ser tipo caracter ou numérica. Array de items caracteres, opcional. Lista de items aaitems selecionáveis. anwidth Numérico, opcional. Largura do controle em pixels. anheight Numérico, opcional. Altura do controle em pixels. Bloco de código, opcional. Executado quando o abchange item selecionado é alterado. Objeto, opcional. Janela ou controle onde o aownd controle será criado. Bloco de código, opcional. Executado quando o conteúdo do controle deve ser validado, deve abvalid retornar.t. se o conteúdo for válido e.f. quando o conteúdo for inválido. anclrfore Numérico, opcional. Cor de fundo do controle. anclrback Numérico, opcional. Cor do texto do controle. Lógico, opcional. Se.T. as coordenadas informadas alpixel são em pixels, se.f. são em caracteres. lpar13 Reservado. Bloco de código, opcional. Executado quando abldblclick acionado duplo click do botão esquerdo do mouse sobre o controle. Objeto, opcional. Objeto tipo tfont utilizado para aofont definir as características da fonte utilizada para exibir o conteúdo do controle. cpar16 Reservado. lpar17 Reservado. Bloco de código, opcional. Executado quando mudança de foco de entrada de dados está sendo abwhen efetuada na janela onde o controle foi criado. O bloco deve retornar.t. se o controle deve permanecer habilitado ou.f. se não. apar19 Reservado. bpar20 Reservado. lpar21 Reservado. lpar22 Reservado. Bloco de código, opcional. Executado quando abrightclick acionado click do botão direito do mouse sobre o controle. O objeto criado.

24 Select Força a seleção de um item. Sintaxe Select( [anitem] ) Parâmetros Retorno Parâmetro Tipo / nitem Numérico, opcional. Posição do item a ser selecionado. NIL Add Insere ou adiciona novo item. Sintaxe Add( ctext, npos ) Parâmetros Retorno Parâmetro Tipo / ctext Caractere, obrigatório. Texto do item. Numérico, obrigatório. Se 0 ou maior que o número de itens, insere o item no final da lista. Se valor entre 1 e npos número de itens, insere o item na posição informada, empurrando o item anterior para baixo. NIL Modify Modifica o texto de um item. Sintaxe Modify( ctext, npos ) Parâmetros Retorno Parâmetro Tipo / ctext Caractere, obrigatório. Novo texto do item. Numérico, obrigatório. Posição a ser modificada deve npos ser maior que 0 e menor ou igual que o número de itens. NIL Del Apaga um item. Sintaxe Del( npos )

25 Parâmetro Tipo / Parâmetros Numérico, obrigatório. Posição a ser excluida, deve ser npos maior que 0 e menor ou igual que o número de itens. Retorno NIL Len Retorna o número de itens. Sintaxe Len( ) Retorno Numérico. Número de itens. Reset Apaga todos os itens. Sintaxe Reset( ) Retorno NIL Exemplo #include protheus.ch User Funcion Teste() Local odlg, olist, nlist:= 1, aitems:={} Aadd(aItems, Item 1 ) Aadd(aItems, Item 2 ) Aadd(aItems, Item 3 ) Aadd(aItems, Item 4 ) DEFINE MSDIALOG odlg FROM 0,0 TO 400,400 PIXEL TITLE Teste olist:= tlistbox():new(10,10,{ u if(pcount()>0,nlist:=u,nlist)};,aitems,100,100,,odlg,,,,.t.) ACTIVATE MSDIALOG odlg CENTERED Return NIL

26 tmeter Revisão: 23/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe de régua de processamento. Hierarquia tsrvobject -> tcontrol -> tmeter Utilize a classe tmeter para criar um controle que exibe uma régua (gauge) de processamento, descrevendo o andamento de um processo atraves da exibição de uma barra horizontal. Propriedades Nome Tipo / ntotal Numérico. Número total de passos até o preenchimento da régua de processo. lpercentage Lógico. Se.T. considera o passo de movimentação em porcentagem. nclrbar Numérico. Cor da barra de andamento. Métodos New Sintaxe Parâmetros Método construtor da classe. New([anRow], [ancol], [absetget], [antotal], [aownd], [anwidth], [anheight], [lpar8], [alpixel], [opar10], [cpar11], [alnoperc], [anclrpane], [npar14], [anclrbar], [npar16], [lpar17]) Parâmetro Tipo / Numérico, opcional. Coordenada vertical em pixels ou anrow caracteres.

27 Retorno ancol Numérico, opcional. Coordenada horizontal em pixels ou caracteres. Bloco de código, opcional. Bloco de código no formato absetget { u if( Pcount( )>0, <var>:= u, <var> ) } que o controle utiliza para atualizar a variável <var>. <var> deve ser tipo numérico. antotal Numérico, opcional. Numero total de passos até o preenchimento da régua de processo. aownd Objeto, opcional. Janela ou controle onde o controle sera criado. anwidth Numérico, opcional. Largura do controle em pixels. anheight Numérico, opcional. Altura do controle em pixels. lpar8 Reservado. alpixel Lógico, opcional. Se.T. as coordenadas informadas são em pixels, se.f. são em caracteres. opar10 Reservado. cpar11 Reservado. Lógico, opcional. Se.T. (padrão) não considera os alnoperc passos de atualização em porcentagem. anclrpane Numérico, opcional. Cor de fundo do controle. npar14 Reservado. anclrbar Numérico, opcional. Cor da barra de andamento. npar16 Reservado. lpar17 Reservado. O objeto criado. Set Atualiza a posição da régua de processamento. Sintaxe Set( [nval] ) Parâmetros Retorno Exemplo Parâmetro Tipo / Numérico, opcional. Novo valor da posição da régua de nval processamento. NIL #include protheus.ch STATIC lrunning:=.f., lstop:=.f. User Function Teste()

28 Local odlg, ometer, nmeter:=0, obtn1, obtn2 DEFINE MSDIALOG odlg FROM 0,0 TO 400,400 TITLE Teste ometer:= tmeter():new(10,10,{ u if(pcount()>0,nmeter:=u,nmeter)};,100,odlg,100,20,,.t.) // cria a régua // botão para ativar andamento da 30,10 BUTTON obtn1 PROMPT Run OF odlg PIXEL ACTION 50,10 BUTTON obtn2 PROMPT Stop OF odlg PIXEL ACTION lstop:=.t. ACTIVATE MSDIALOG odlg CENTERED Return NIL STATIC Function RunMeter(oMeter) If lrunning Return Endif lrunning:=.t. ometer:set(0) // inicia a régua While.T..and.!lStop Sleep(1000) // pára 1 segundo ProcessMessages() // atualiza a pintura da janela, processa mensagens do windows Enddo ncurrent:= Eval(oMeter:bSetGet) // pega valor corrente da régua ncurrent+=10 // atualiza régua ometer:set(ncurrent) if ncurrent==ometer:ntotal Return endif lrunning:=.f. lstop:=.f. Return

29 tmultiget Revisão: 23/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe de campo Memo de edição. Hierarquia tsrvobject -> tcontrol -> tmultiget Utilize a classe tmultiget para criar controle de edição de texto de múltiplas linhas. Propriedades Nome Tipo / lwordwrap Lógico. Se.T., faz quebra automática de linhas. Métodos New Sintaxe Parâmetros Método construtor da classe. New([anRow], [ancol], [absetget], [aownd], [anwidth], [anheight], [aofont], [alhscroll], [anclrfore], [anclrback], [opar11], [alpixel], [cpar13], [lpar14], [abwhen], [lpar16], [lpar17], [alreadonly], [abvalid], [bpar20], [lpar21], [alnoborder], [alnovscroll]) Parâmetro anrow ancol absetget Tipo / Numérico, opcional. Coordenada vertical em pixels ou caracteres. Numérico, opcional. Coordenada horizontal em pixels ou caracteres. Bloco de código, opcional. Bloco de código no

30 Retorno formato { u if( Pcount( )>0, <var>:= u, <var> ) } que o controle utiliza para atualizar a variável <var>. <var> deve ser tipo caracter. Objeto, opcional. Janela ou controle onde o controle aownd será criado. anwidth Numérico, opcional. Largura do controle em pixels. anheight Numérico, opcional. Altura do controle em pixels. Objeto, opcional. Objeto tipo tfont utilizado para aofont definir as características da fonte utilizada para exibir o conteúdo do controle. Lógico, opcional. Se.T., habilita barra de rolagem alhscroll horizontal. anclrfore Numérico, opcional. Cor de fundo do controle. anclrback Numérico, opcional. Cor do texto do controle. opar11 Reservado. Lógico, opcional. Se.T. as coordenadas informadas alpixel são em pixels, se.f. são em caracteres. cpar13 Reservado. lpar14 Reservado. Bloco de código, opcional. Executado quando mudança de foco de entrada de dados está sendo abwhen efetuada na janela onde o controle foi criado. O bloco deve retornar.t. se o controle deve permanecer habilitado ou.f. se não. lpar16 Reservado. lpar17 Reservado. Lógico, opcional. Se.T. o controle so permitira alreadonly leitura. Bloco de código, opcional. Executado quando o conteúdo do controle deve ser validado, deve retornar abvalid.t. se o conteúdo for válido e.f. quando o conteúdo for inválido. bpar20 Reservado. lpar21 Reservado. alnoborder Lógico, opcional. Se.T. cria controle sem borda. Lógico, opcional. Se.T., habilita barra de rolagem alnovscroll vertical. O objeto criado. EnableVScroll Habilita a barra de rolagem vertical.

31 Sintaxe EnableVScroll( lenable ) Parâmetros Retorno Parâmetro Tipo / Lógico, obrigatório. Se.T. habilita se.f. desabilita a lenable barra de rolagem. NIL EnableHScroll Habilita a barra de rolagem horizontal. Sintaxe EnableHScroll( lenable ) Parâmetros Retorno Exemplo Parâmetro Tipo / Lógico, obrigatório. Se.T. habilita se.f. desabilita a lenable barra de rolagem. NIL #include protheus.ch User Function Teste() Local odlg, omemo, cmemo:= space(50) DEFINE MSDIALOG odlg FROM 0,0 TO 400,400 PIXEL TITLE My test omemo:= tmultiget():new(10,10,{ u 200,10 BUTTON obtn PROMPT Fecha OF odlg PIXEL ACTION odlg:end() ACTIVATE MSDIALOG odlg CENTERED MsgStop(cMemo) Return NIL

32 tpanel Revisão: 23/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe de painel estático. Hierarquia tsrvobject -> tcontrol -> tpanel Utilize a classe tpanel quando desejar criar um painel estático, onde podem ser criados outros controles com o objetivo de organizar ou agrupar componentes visuais. Métodos New Sintaxe Parâmetros Método construtor da classe. New([anRow], [ancol], [actext], [aownd], [aofont], [alcentered], [lpar6], [anclrtext], [anclrback], [anwidth], [anheight], [allowered], [alraised]) Parâmetro Tipo / anrow Numérico, opcional. Coordenada vertical em pixels. ancol Numérico, opcional. Coordenada horizontal em pixels. actext Caractere, opcional. Texto a ser exibido ao fundo. Objeto, opcional. Janela ou controle onde será criado o aownd objeto. Lógico, opcional. Se.T. exibe o texto de título ao alcentered centro do controle. lpar6 Reservado. anclrtext Numérico, opcional. Cor do texto do controle. anclrback Numérico, opcional. Cor do fundo do controle. anwidth Numérico, opcional. Largura do controle em pixels.

33 anheight Numérico, opcional. Altura do controle em pixels. Lógico, opcional. Se.T. exibe o painel rebaixado em allowered relação ao controle de fundo. Lógico, opcional. Se.T. exibe a borda do controle alraised rebaixada em relação ao controle de fundo. Retorno O objeto criado. Exemplo #include protheus.ch User Function Teste() Local odlg, opanel, obtn1, obtn2 DEFINE MSDIALOG odlg FROM 0,0 TO 400,400 PIXEL TITLE My test opanel:= tpanel():new(10,10,,odlg,,,,,clr_blue,100,100) // cria o 10,10 BUTTON obtn1 PROMPT hide OF opanel ACTION opanel:hide() // cria botão sobre o 200,10 BUTTON obtn2 PROMPT show OF odlg ACTION opanel:show() // cria botão fora o painel ACTIVATE MSDIALOG odlg CENTERED Return

34 tradmenu Revisão: 23/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe de radio group. Hierarquia tsrvobject -> tcontrol -> tradmenu Utilize a classe tradmenu para criar um controle que possibilita escolha de item através de uma lista. Propriedades Nome Tipo / noption Numérico. Item selecionado. aitems Array de caracteres. Lista de items selecionáveis. Métodos New Sintaxe Parâmetros Método construtor da classe. New([anRow], [ancol], [aacitems], [absetget], [aownd], [apar6], [abchange], [anclrtext], [anclrpan], [cpar10], [lpar11], [abwhen], [anwidth], [anheight], [abvalid], [lpar16], [lpar17], [alpixel]) Parâmetro Tipo / anrow Numérico, opcional. Coordenada vertical em pixels ou caracteres. ancol Numérico, opcional. Coordenada horizontal em pixels ou caracteres.

35 Retorno aacitems Array de caracteres, opcional. Lista de opções. Bloco de código, opcional. Bloco de código no formato { u if( Pcount( )>0, <var>:= u, <var> ) } que o controle absetget utiliza para atualizar a variável <var>. <var> deve ser tipo numérico. Objeto, opcional. Janela ou controle onde o controle aownd será criado. apar6 Reservado. Bloco de código, opcional. Executado quando o item abchange selecionado é alterado. anclrtext Numérico, opcional. Cor do texto do controle anclrpan Numérico, opcional. Cor de fundo do controle. cpar10 Reservado. lpar11 Reservado. Bloco de código, opcional. Executado quando mudança de foco de entrada de dados está sendo efetuada na abwhen janela onde o controle foi criado. O bloco deve retornar.t. para que o controle permaneça habilitado, ou.f. se não. anwidth Numérico, opcional. Largura do controle em pixels. anheight Numérico, opcional. Altura do controle em pixels. Bloco de código, opcional. Executado quando o abvalid conteúdo do controle deva ser validado, retornando.t. se o conteúdo for válido, e.f. quando inválido. lpar16 Reservado. Lpar17 Reservado. Lógico, opcional. Se.T. as coordenadas informadas são alpixel em pixels, se.f. são em caracteres. O objeto criado. EnableItem Sintaxe Parâmetros Retorno Exemplo Habilita ou desabilita item. EnableItem( [nitem], [lenable]) Parâmetro Tipo / nitem Numérico, opcional. Item selecionado. lenable Lógico, opcional. Se.T. habilita o item se.f. desabilita o item. NIL

36 #include protheus.ch User Function Teste() Local odlg, obutton, oradio, nradio:=1 Local aoptions:={ escolha1, escolha2 } DEFINE MSDIALOG odlg FROM 0,0 TO 300,300 PIXEL TITLE Meu Get oradio:= tradmenu():new(10,10,aoptions,; { u if(pcount()>0,nradio:=u,nradio)},; 40,10 BUTTON obutton PROMPT Fechar OF odlg PIXEL ACTION odlg:end() ACTIVATE MSDIALOG odlg CENTERED MsgStop( Escolheu +aoptions[nradio] ) Return NIL

37 tsay Revisão: 23/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe de label. Hierarquia tsrvobject -> tcontrol -> tsay O objeto tipo tsay exibe o conteúdo de texto estático sobre uma janela ou controle. Propriedades Nome Tipo / Lógico. Se.T. quebra o texto em várias linhas de maneira a enquadrar o lwordwrap conteúdo na área determinada para o controle, sendo o padrão.f. Lógico. Se.T. a cor de fundo do controle é ignorada assumindo o conteúdo ltransparent ou cor do controle ou janela ao fundo, sendo o padrão.t. Métodos New Sintaxe Parâmetros Método construtor da classe. New([anRow], [ancol], [abtext], [aownd], [acpicture], [aofont], [lpar7], [lpar8], [lpar9], [alpixels], [anclrtext], [anclrback], [anwidth], [anheight], [lpar15], [lpar16], [lpar17], [lpar18], [lpar19]) Parâmetro Tipo / anrow Numérico, opcional. Coordenada vertical em pixels ou caracteres. ancol Numérico, opcional. Coordenada horizontal em pixels

38 Retorno ou caracteres. abtext Codeblock, opcional. Quando executado deve retornar uma cadeia de caracteres a ser exibida. aownd Objeto, opcional. Janela ou diálogo onde o controle será criado. acpicture Caractere, opcional. Picture de formatação do conteúdo a ser exibido. Objeto, opcional. Objeto tipo tfont para configuração aofont do tipo de fonte que será utilizado para exibir o conteúdo. lpar7 Reservado. lpar8 Reservado. lpar9 Reservado. Lógico, opcional. Se.T. considera coordenadas alpixels passadas em pixels se.f., padrão, considera as coordenadas passadas em caracteres. anclrtext Numérico, opcional. Cor do conteúdo do controle. anclrback Numérico, opcional. Cor do fundo do controle. anwidth Numérico, opcional. Largura do controle em pixels. anheight Numérico, opcional. Altura do controle em pixels. lpar15 Reservado. lpar16 Reservado. lpar17 Reservado. lpar18 Reservado. lpar19 Reservado. O objeto criado. SetText Modifica o conteúdo a ser exibido pelo controle. Sintaxe SetText( [xval] ) Parâmetros Retorno Parâmetro Tipo / Caracter / Numérico / Data, Opcional. Valor a ser xval exibido. NIL

39 Exemplo #include protheus.ch User Function Teste() Local odlg, osay DEFINE MSDIALOG odlg FROM 0,0 TO 200,200 TITLE My dialog PIXEL osay:= tsay():new(10,10,{ para exibir },odlg,,,,;,,.t.,clr_white,clr_red,100,20) ACTIVATE MSDIALOG odlg CENTERED Return NIL

40 tscrollbox Revisão: 23/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe de área de scroll. Hierarquia tsrvobject -> tcontrol -> tscrollbox Utilize a classe tscrollbox para criar um painel com scroll deslizantes nas laterais do controle. Métodos New Sintaxe Parâmetros Retorno Método construtor da classe. New([aoWnd], [antop], [anleft], [anheight], [anwidth], [alvertical], [alhorizontal], [alborder]) Parâmetro Tipo / aownd Objeto, opcional. Janela ou controle onde o controle será criado. antop Numérico, opcional. Coordenada vertical em pixels. anleft Numérico, opcional. Coordenada horizontal em pixels. anheight Numérico, opcional. Altura do controle em pixels. anwidth Numérico, opcional. Largura do controle em pixels. alvertical Lógico, opcional. Se.T. exibe a barra de scroll vertical. Lógico, opcional. Se.T. exibe a barra de scroll alhorizontal horizontal. alborder Lógico, opcional. Se.T. exibe a borda do controle. O objeto criado.

41 Exemplo #include protheus.ch User Function Teste() Local odlg, oscr, oget1, oget2, oget3 Local cget1, cget2, cget3 cget1:= Space(10) cget2:= Space(10) cget3:= Space(10) DEFINE MSDIALOG odlg FROM 0,0 TO 400,400 PIXEL My test oscr:= TScrollBox():New(oDlg,10,10,200,200,.T.,.T.,.T.) // cria controles dentro do 10,10 MSGET oget1 VAR cget1 SIZE 100,10 OF oscr 50,10 MSGET oget2 VAR cget2 SIZE 100,10 OF oscr 150,100 MSGET oget3 VAR cget3 SIZE 100,10 OF oscr PIXEL ACTIVATE MSDIALOG odlg CENTERED Return NIL

42 Classe TIBrowser Exemplo de uso da classe TIBrowser Revisão: 09/06/2003 Versão 6.09 Versão 7.10 #include "protheus.ch" function teste() local odlg, otibrowser, obtnnav, obtnprint, obtnhome DEFINE MSDIALOG odlg FROM 0,0 TO 320,460 PIXEL TITLE "Teste TIBrowser" otibrowser:= TIBrowser():New( 10,10, 150, 150, " odlg 10, 160 BUTTON obtnnav PROMPT "Ir para Microsiga" SIZE 50,10 ACTION otibrowser:navigate(" OF odlg 20, 160 BUTTON obtnprint PROMPT "Imprimir" SIZE 50,10 ACTION otibrowser:print() OF odlg 30, 160 BUTTON obtnhome PROMPT "Home" SIZE 50,10 ACTION otibrowser:gohome() OF odlg PIXEL ACTIVATE MSDIALOG odlg CENTERED return

43 TIBROWSER:GOHOME Revisão: 09/06/2003 Versão 6.09 Versão 7.10 Sintaxe TIBROWSER:GOHOME ( ) --> nil Retorno Tipo (NULO) Este método retorna nil Direciona navegação para página <HOME> cadastrada no Internet Explorer

44 TIBROWSER:NAVIGATE Revisão: 09/06/2003 Versão 6.09 Versão 7.10 Sintaxe TIBROWSER:NAVIGATE ( < ahref > ) --> nil Parâmetros Argumento Tipo ahref Caracter Endereço da página a ser navegada Retorno Tipo (NULO) Este método sempre retorna nil Troca a página a ser visualizada

45 TIBROWSER:NEW Revisão: 09/06/2003 Versão 6.09 Versão 7.10 Sintaxe TIBROWSER:NEW ( < anrow >, < ancol >, < anwidth >, < anheight >, [ ainitlink ], [ anwindow ] ) --> Retorno Parâmetros Argumento Tipo anrow Numérico coordenada vertical ancol Numérico Coordenada horizontal anwidth Numérico Largura do objeto anheight Numérico Altura do objeto ainitlink Caracter Endereço da página inicial a ser carregada, se não informada, carregará a página <HOME> cadastrada no Internet Explorer. anwindow Objeto Janela ou componente visual onde o objeto será criado Retorno Tipo Objeto Retorna o objeto criado Cria uma instância do Microsoft Internet Explorer(tm) dentro de um componente visual. Para que o objeto esteja disponível para o usuário, é necesário configurar no arquivo de configuração do AP Remote (Ex: ap6rmt.ini ) como abaixo: [config] BrowserEnabled=1 ATENÇAO: A classe somente funcionará se o MS Internet Explorer estiver instalado na máquina que está executando o AP Remote.

46 TIBROWSER:PRINT Revisão: 09/06/2003 Versão 6.09 Versão 7.10 Sintaxe TIBROWSER:PRINT ( ) --> nil Retorno Tipo (NULO) Este método retorna nil Imprime a página que esta sendo visualizada

47 Exemplo de uso da Classe TWBrowse Revisão: 16/09/2004 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Versão 8.11 A função abaixo cria uma janela de dialogo, com uma twbrowse ocupando toda a extensão do diálogo, realizando uma consulta na Tabela SX5, filtrada através do índice 1, para mostrar apenas os elementos pertencentes à tabela 01 do SX5. Vale lembrar que, para testar o fonte abaixo, deve-se compilá-lo no projeto, e inserir uma chamada à esta função no Menu do ERP. #INCLUDE 'PROTHEUS.CH' User Function TstTWBrw() dbselectarea('sx5') DbSetORder(1) DEFINE MSDIALOG odlg TITLE 'Exemplo TWBrowse' FROM 000, 000 TO 500, 600 PIXEL obrw := TWBrowse():New( NIL,NIL,NIL,NIL,; { { SX5->X5_TABELA, SX5->X5_CHAVE, SX5->X5_DESCRI, str(sx5->(recno()),8,0) } },; { 'Tabela','Chave','', 'RECNO'},; NIL, odlg, "X5_FILIAL+X5_TABELA"," 01", " 01",,,,,,,,,, "SX5",.T. ) // Ajusta alinhamento do TWBrowse para pegar o dialogo inteiro obrw:align := CONTROL_ALIGN_ALLCLIENT ACTIVATE MSDIALOG odlg CENTERED Return

48 New Revisão: 16/09/2004 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Versão 8.11 Sintaxe TWBrowse():New ( [ nrow ], [ bscroll ], [ Param25 ], [ Param27 ], [ ncol ], [ nwidth ], [ nheigth ], < bline >, < aheaders >, [ acolsizes ], [ ownd ], [ cfield ], [ ctoplimit ], [ cbottomliit ], [ bchange ], [ bldblclick ], [ Param14 ], [ ofont ], [ Param16 ], [ nclrfore ], [ nclrback ], [ Param19 ], [ Param20 ], [ calias ], [ lpixel ], [ Param23 ], [ Param24 ] ) --> oobjtwbrowse Parâmetros Argumento Tipo nrow Numérico Coordenada vertical inicial do Objeto. bscroll Lógico Caso.T., habilita barra de scroll horizontal e botões de navegação vertical. Param25 (NULO) ( parâmetro reservado ) Param27 (NULO) ( parâmetro reservado ) ncol Numérico Coordenada horizontal inicial do Objeto nwidth Numérico Tamanho horizontal do objeto nheigth Numérico Tamanho vertical do objeto Code-Block, que deve retornar um array, com uma bline dimensão, onde devem ser retornados as strings Code-Block referentes aos elementos referentes às colunas do Browse. aheaders Array Array, que deve retornar um array, com uma dimensão, contendo as strings referentes aos Títulos das colunas do Browse. acolsizes Array Array, com uma dimensão, onde devem ser retornados os números referentes ào tamanho horizontal das colunas do Browse. Caso especificado NIL, os tamanhos das colunas são calculados automaticamente. ownd Objeto Objeto visual sobre o qual a twbrowse será criada. cfield Caracter Utilizado para especificar a expressão de índice para definição de limite superior e inferior do Browse. Este parâmetro é utilizado quando realizado um browse de uma tabela, aberta sob um alias, com uma expressão de índice.

49 ctoplimit Caracter Utilizado para especificar uma string, de acordo com a chave de índice passada em cfield, a ser utilizada para identificar o limite superior do Browse. Apenas devemos informar conteúdo neste, caso o parâmetro cfield seja especificado. cbottomliit Caracter Utilizado para especificar uma string, de acordo com a chave de índice passada em cfield, a ser utilizada para identificar o limite inferior do Browse. Apenas devemos informar conteúdo neste, caso o parâmetro cfield seja especificado. Ação a ser executada quando alterado o foco entre as bchange Code-Block linhas do Browse. Recebe o objeto do Browse como parâmetro. bldblclick Ação a ser executada quando executado um dupli-clique Code-Block sobre uma célula do Browse. Param14 (NULO) ( parâmetro reservado ) ofont Objeto Objeto referente à uma fonte alternativa para exibição dos dados neste Browse. Param16 (NULO) ( parâmetro reservado ) nclrfore Numérico Cor de escrita dos dados no TWBrowse. Verifique cores disponíveis no include "colors.ch" nclrback Numérico Cor de fundo da área da TWBrowse não preenchida com dados. Verifique cores disponíveis no include "colors.ch" Param19 (NULO) ( parâmetro reservado ) Param20 (NULO) ( parâmetro reservado ) calias Caracter Caso o Browse seja realizado sobre uma tabela aberta, estecifique o alias da tabela a ser utilizada neste parâmetro. lpixel Lógico Caso.T., indica que as coordenadas de tela são especificadas em PIXELS. Caso contrário, são coordenadas especificadas em CARACTERES. Param23 (NULO) ( parâmetro reservado ) Param24 (NULO) ( parâmetro reservado ) Retorno Tipo Objeto Retorna uma nova instância do Objeto da Classe TWBrowse. Contrutor da Classe TWBrowse. Retorna uma nova instância do Objeto da Classe TWBrowse.

50 Classes de Janelas MSDialog Revisão: 23/02/2003 Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Classe de diálogo de entrada de dados. Hierarquia tsrvobject -> twindow -> tdialog -> MSDialog Características MSDialog deve ser utilizada como padrão de janela para entrada de dados. MSDialog é um tipo de janela diálogo modal, isto é, não permite que outra janela ativa receba dados enquanto esta estiver ativa. Propriedades Vide classes ancestrais. Métodos New Sintaxe Parâmetros Método construtor da classe. New([anTop], [anleft], [anbottom], [anright], [accaption], [cpar6], [npar7], [lpar8], [npar9], [anclrtext], [anclrback], [opar12], [aownd], [alpixel], [opar15], [opar16], [lpar17]) Parâmetro Tipo / antop Numérico, opcional. Coordenada vertical superior em pixels ou caracteres. anleft Numérico, opcional. Coordenada horizontal esquerda em pixels ou caracteres.