Documenta��o do WOLDesigner

O WOL Designer n�o � uma IDE, mas assemelha-se bastante a uma. Nunca utilize o WOL Designer para editar arquivos comuns ou unidades que n�o tenham sido criados com ele.

A principal fun��o do WOL Designer � projetar interface gr�fica, permitindo que se ligue diversos eventos aos objetos criados. Rotinas inerentes ao sistema para o qual a aplica��o se destina ou rotinas especializadas em determinadas tarefas devem ser criadas em units a parte.

H� duas interfaces gr�ficas do WOL Designer: uma, chamada tradicional ou cl�ssica, que foi a primeira, constando de uma janela min�scula guiada por menus; outra, com uma janela extendida, constando de bot�es de atalho, guia de objetos, etc., chamada moderna. Ambas as interfaces foram feitas usando-se a pr�pria biblioteca WOL.

Em ambas interfaces, o formul�rio de trabalho � o mesmo, bem como o inspetor de onjetos. As opera��es no formul�rio consistem em se escolher com o ponteiro do mouse um objeto de janela e manipul�-lo. Para ajudar a modificar suas propriedades ou editar os eventos, usa-se a ajuda do inspetor de objetos e janelas adicionais. Sobre o pr�prio formul�rio h� um menu popup que altera e edita caracter�sticas do objeto selecionado. Um duplo clique em cima do nome da propriedade no inspetor de objeto faz abrir uma janela de edi��o do respectivo valor.

Observe as fun��es r�pidas do menu de contexto. Com elas se pode centralizar horizontal e verticalmente o objeto de janela; repetir o �ltimo tamanho de objeto no selecionado; bem como repetir a �ltima posi��o, comprimento e altura; alinhar a esquerda ou alinhar o topo do objeto ao �ltimo objeto selecionado; modificar a ordem com que os objetos s�o criados (isso altera a tabula��o dos objetos de entrada); enviar para baixo ou para cima de outro objeto aquele que est� selecionado; modificar o comportamento da barra de rolagem em tempo de projeto (faz ela ser funcional ou n�o); apagar um objeto; ou editar um objeto de banco de dados.

Estrutura de Menus/Fun��es

File — New Form

Cria um formul�rio novo, que � uma janela onde se pode posicionar os objetos que compor�o a interface da aplica��o. Se j� houver um formul�rio trabalhado na mem�ria, esse ser� apagado sem nenhuma pergunta.

File — Open

Abre um formul�rio que j� foi salvo antes pelo WOL Designer. N�o vai abrir arquivo que tenha sido criado por outro editor nem que n�o seja reconhecido pelo analisador interno. Os arquivos .XML e .WOL s�o lidos (se existirem com o mesmo nome do arquivo da unit) e permitem mais flexibilidade na hora de recuperar informa��es. Os arquivos .XML guardam informa��es sobre a janela e seus objetos. Os arquivos .WOL guardam parte da rotina de cria��o da janela.

File — Save

Salva o formul�rio corrente em disco. O armazenamento vai depender da configura��o que foi indicada em Project — Project Settings e de como se definiu o tipo de arquivo em Edit — Change Program/Unit. Geralmente, o sistema tenta escrever somente c�digo pascal (somente o c�digo fonte puro, o que � a inten��o da WOL).

File — Quit

Encerra o WOL Designer, fechando. Se houver formul�rio trabalhado na mem�ria, esse se perder� sem ser feita pergunta nenhuma ao usu�rio.

Edit — Change Program/Unit

Modifica como o arquivo corrente ser� salvo. Pode ser uma Unit ou um Program. Se nada for informado, o padr�o � usar Unit.

Edit — Show Form

Por enquanto, o WOL Designer suporta o trabalho em apenas um formul�rio por vez. Para fazer o formul�rio aparecer ou reaparecer, deve-se usar essa op��o do menu ou um bot�o de atalho.

Edit — Show Code

Para mostrar o c�digo relativo ao formul�rio corrente, deve-se usar essa op��o do menu ou um bot�o de atalho. O c�digo n�o � colorido e n�o � edit�vel. Trata-se de um visualizador do c�digo.

Edit — Alternative Code Editor

Pode-usar um editor alternativo usando-se essa op��o do menu ou de um bot�o de atalho, com muito cuidado. O WOL Designer n�o atualiza automaticamente o c�digo ap�s ele ser alterado em um editor externo. Para configurar o Editor alternativo desejado, use as op��es contidas no WOLDES.INI.

Edit — Object Inspector

Mostra ou esconde o inspetor de objetos. O inspetor � uma janela na qual se altera propriedades e eventos de um objeto de janela selecionado. Pode-se usar um bot�o de atalho para fazer o mesmo.

Edit — Replace String in Files

Ativa uma janela para que se fa�a substitui��o de uma ou mais palavras em um ou mais arquivos fontes.

Edit — XPM File to Pascal Code

Um dos objetivos da WOL � eliminar recursos propriet�rios que emperram o c�digo fonte na hora de se portar para outra plataforma. Pascal, assim como C, permite que se embuta no pr�prio c�digo fonte figuras que podem ser mapeadas para texto. � o caso do formato XPM. Essa janela permite a convers�o de arquivos XPM para c�digo pascal que, quando carregado, gerar� a figura correspondente.

Edit — Find String in Files

Janela usada para realizar busca de palavras em arquivos da pasta (diret�rio) corrente. A busca ainda � bastante rudimentar, n�o foram implementadas nenhumas chaves de op��es al�m das mostradas na janela.

Edit — No Standard Events List

Todos os eventos dos objetos de janelas podem ser escritos dentro de uma janela de c�digos a partir do inspetor de objetos. Quando se entra num editor alternativo e se acrescenta um evento que n�o seja padr�o (sendo um evento novo), pode-se acess�-lo a partir dessa janela.

Edit — (Un)Lock Objects

Trava ou destrava os objetos de janela dispostos no formul�rio de trabalho de forma a n�o se alterar o tamanho e a posi��o dos mesmos com o ponteiro do mouse. Todo o resto permanece funcional.

Project — Project Settings

A configura��o de um projeto pode ser feita a partir dessa janela. As configura��es do projeto em si e tamb�m da WOLGUI podem ser acessadas por essa janela. Nessa janela, pode-se indicar um nome de um programa ou de um projeto (com extens�o wpj). Os arquivos WPJ re�nem apenas algumas informa��es gerais sobre o programa pascal (pe�a principal de uma aplica��o). Nessa janela, o programador dever� indicar os caminhos onde est�o instalados o Free Pascal e a WOLGUI, bem como a utiliza��o de arquivos XML (para salvar formul�rios) e includes (para diminuir a quantidade de c�digo no arquivo fonte). H� um campo especial para se indicar as units que se deseja incluir automaticamente no c�digo do formul�rio que est� sendo editado. Por exemplo, eu sempre necessito da SysUtils, ent�o eu coloco nesse campo (o �ltimo da janela) a palavra sysutils. Pode-se colocar mais de uma separadas por v�rgula.

Project — Compile Program/Unit

Efetiva uma compila��o do programa ou unidade da seguinte forma. Se o WOL Designer n�o tiver nenhuma unidade ou programa carregado na mem�ria, a compila��o ser� do programa indicado em Project Settings. Se, ao contr�rio, houver uma unidade ou programa na mem�ria, a compila��o se dar� sobre este. Caso seja um programa, ao se encerrar a compila��o com sucesso, o mesmo ser� rodado. A compila��o de recursos do sistema somente � poss�vel no bot�o de compila��o do Project Settings.

Project — Run Compiled Program

Roda um programa que j� foi compilado seguindo as mesmas regras da compila��o. Se o programa execut�vel n�o existir, o WOL Designer n�o retornar� nenhuma mensagem.

Project — View Snippet Code

Mostra uma janela onde se pode ver uma lista de peda�os de c�digo fonte (desde que o programador tenha criado esses c�digo). Para salvar um c�digo, digita-se no campo do nome do c�digo o nome que vai lembrar ao usu�rio o c�digo que est� salvo ali. Digita-se o c�digo nas linhas destinadas para isso e salva-se o c�digo. Sempre que precisarmos de um fragmento de c�digo j� cadastrado, � s� peg�-lo nessa janela.

Project — Package Install*

O WOL Designer para Windows vem com a op��o de instala��o de pacotes. Essas retinas ainda est�o em fase de teste. A cria��o de um objeto visual com o intuito de instal�-lo numa aba do designer pode ser acompanhada lendo-se o c�digo da unit wolTeste.pp. No Windows, para criar um spinButton semelhante ao da GTK, temos de criar dois objetos de janela: um da classe updown e um da classe edit de uma s� linha. Esse unit mostra como criar um objeto para esse fim, mas de forma bem grosseira. A instala��o � simples, bastando, nessa op��o do designer indicar o Nome da Unit, o caminho do �cone que vai representar o objeto na aba (no momento somente bitmaps do Windows), a classe do objeto que se esta instalando, um texto de dica para o objeto (opcional) e um nome de aba onde o bot�o relativo ao objeto ser� colocado. Ap�s colocar os objetos numa lista, deve-se clicar no bot�o de escrita da dll wolpackage. Feito isso, fecha-se o designer e recompila-se a dll com a linha de comando fpc wolpackage. Por enquanto, somente objetos visuais s�o aceitos.

CGI — Convert WOLFORM to XHTML Form

Converte um formul�rio, com os objetos de janela dispostos nele, para o seu equivalente em XHTML, usando CSS. O resultado final � um formul�rio equivalente ao desenhado no WOL Designer pronto para ser usado por um browser que aceite CSS. As rotinas n�o s�o traduzidas e o formul�rio deve ser salvo com op��o XML ativa no Project Settings. Nem todos os objetos de janela est�o dispon�veis para convers�o.

CGI - View/Edit Units em XML File

Exibe as units indicadas no arquivo de formul�rio XML correntemente carregado. Pode-se alterar essas unidades, incluindo e excluindo, de forma a atualizar o c�digo do arquivo XML. Quando se coloca manualmente o nome de uma unit no arquivo fonte pascal, n�o ocorre atualiza��o no arquivo XML correspondente; por isso, � necess�rio um mecanismo que o fa�a automaticamente sem se editar c�digo nenhum. S� ir� funcionar se o arquivo fonte for salvo com a op��o XML do Project Settings

Tools — Report Editor

O Editor de Relat�rios ainda est� em ponto de desenvolvimento, mas j� � funcional. Trata-se de um adendo que re�ne rotinas pr�prias para permitir salvar relat�rios em diversos formatos (alguns ainda n�o implementados). O Editor de Relat�rios exige uma documenta��o pr�pria da qual n�o trataremos neste t�pico.

Tools — Create no Visual Object

Abre uma janela que ir� ajudar a criar um objeto n�o visual. Trata-se de uma ajuda, eliminando a digita��o de v�rias rotinas (eventos e m�todos) corriqueiras na execu��o do objeto. A forma de cria��o � simples: basta indicar as propriedades com os respectivos tipos.

Tools — User Tools

Janela destinada a tarefas repetidas do usu�rio, como apagar arquivos de backup, arquivos objetos, mudar de uma pasta para outra, etc. Para criar um item de ferramenta, deve-se indicar um t�tulo, o programa ou macro interna a ser usada e os par�metros. A lista de par�metros � auto explicativa.

Tools — Code Control

Janela que permite ao programador criar uma lista de c�digos fontes, recursos pr�prios, figuras, etc. e compactar os arquivos em um outro de extens�o .tar.gz. A lista de arquivos pode ter uma descri��o para cada c�digo fonte.

Tools — Configure WOL Library

Ferramenta que permite a configura��o da biblioteca. Algumas op��es de configura��o ainda n�o est�o dispon�veis. Essa configura��o ser� salva no arquivo wolgui.inc, na pasta da biblioteca indicada por Project Settings.

Tools — Application Analist

Procura contar linhas, palavras e letras de c�digo fonte de um ou mais arquivos fontes. Em geral, a cobran�a do valor de um sistema � feita com base nesses valores, da� uma primeira implementa��o do analista de aplicativos trazer exatamente o c�lculo desses valores.

Forge — About

Janela com o logotipo corrente da WOL e cr�ditos de autoria.

Forge — Thanks

Janela de agradecimentos a outras partes pelo uso de suas rotinas ou recursos.

Estrutura de Bot�es

Essa estrutura somente est� dispon�vel na vers�o moderna do WOL Designer. Na vers�o tradicional os comandos s�o todos movidos a menus, bastando clicar na �rea vermelha para que estes apare�am.

1 — Open: para abrir um arquivo fonte (geralmente com extens�o PP).

2 — Save: para salvar um arquivo fonte.

3 — New Form: para criar um formul�rio novo (sem nenhum conte�do).

4 — Change Program/Unit: para mudar o tipo de arquivo fonte corrente.

5 — Show Form: para mostrar o formul�rio de trabalho se esse estiver escondido.

6 — Show Code: para mostrar o c�digo fonte do formul�rio corrente.

7 — Alternative Editor: para carregar o programa designado como editor alternativo.

8 — Report Editor: para edi��o de relat�rios.

9 — Object Inspector: mostra ou esconde o inspetor de objetos.

A — Project Settings: para configurar o projeto e caminhos essenciais.

B — Compile Unit/Program: para compilar o programa ou unidade.

C — Run: para executar um programa compilado.

D — User Tools: para alterar, criar, excluir ferramentas �teis.

E — About: sobre o sistema...

A parte direita da janela do WOL Designer cont�m atalhos para a cria��o de objetos de janela na forma de fich�rio, sendo eles distribuidos em grupos diversos.

1 — Sele��o do fich�rio com o tipo de objeto desejado.

2 — Atalhos para os objetos de janela do tipo selecionado.

Para ver uma lista completa das fichas de objetos, consulte as guias do WOL Designer. L� est�o contidos todos os objetos possiveis de serem criados atrav�s do WOL Designer.