| Home | Download | Documentação | A Fazer... | Links Pascal | Começar |
Visão Geral da WOLGUI
A biblioteca tem como objeto essecial o TWOLRoot, que não possui métodos significativos nem apresenta eventos definidos. Pode ser substituído por um TComponent da FCL através de alteração no arquivo de configuração WOLGUI.INC. O objeto que vem logo acima desse na hierarquia é o TWOLBase, que retem diversos métodos e eventos os quais não são próprios de janelas. São métodos e eventos offscreen. Também apresenta diversas propriedades para leitura/alteração que modificam o seu funcionamento. O objeto seguinte é o TWOLVisualControl, com métodos, eventos e campos voltados para a interface visual, mas que por si só não pode ser visto em uma janela. Desse objeto devem derivar todos os objetos de janela, como botões, caixa de edição, etc.
|
Alem disso, dois outros objetos são essenciais numa aplicação: o formulário (ou janela propriamente dita), onde se localização os diversos objetos de janela, que é descrito na biblioteca como TWOLForm, e a própria aplicação, objeto que tem o controle interno sobre o conjunto da funcionalidade à aplicação. Esse objeto é o TWOLShellApplication.
Juntamente com essas classes de objetos, merecem destaque o TWOLSysDialog, responsável pelas caixas de diálogo geradas pelo sistema; TDataSet, responsável por derivação de conjuntos de dados; TDBDataSet, responsável pela derivação de tabelas de dados, os quais não tem a extensão WOL porque foram baseados nos respectivos componentes da FCL do Free Pascal; TWOLSysPrinter também faz parte do conjunto de objetos WOL mas é uma classe à parte que se presta à comunicação com a impressora ou arquivos pré-impressos; dessa classe de objeto deriva TWOLPrinter, que é a representação da impressora. Não menos importantes são as classes TWOLMenu e TWOLMenuItem, usadas para criação de toda espécie de menus.
Alem dos objetos básicos mostrados aqui, nas guias do WOL Designer você encontrará um conjunto completo de objetos de janelas da biblioteca para ser usado diretamente na sua aplicação.
TWOLForm
Objeto essencial que representa uma janela onde se coloca objetos diversos para constituir a interface com o usuário final. Descende de TWOLVisualControl, sendo o componente mínimo de uma aplicação. É descendente de TWOLVisualControl.
Código fonte: WOLGUI01.PP.| Propriedade | Descrição |
| —Icon:TWOLHIcon | Indica o handle do ícone que o formulário deve ter. |
| —MenuBar:TWOLMenuBar | Indica a barra de menus do formulário. |
| —MDIChildCount:TWOLSmallInt | Retorna o número de formulários filhos do tipo MDI. |
| —MDIChild[Index:TWOLSmallInt]:TWOLForm | Indica o de formulários filhos do formulário corrente. |
| —WindowRect:TWOLRect | Indica a área do formulário. Essa é área externa total e não a área cliente. |
| —ModalResult :TWOLModalResult | Indica o resultado modal do formulário. Quando usado com ShowModal, esse valor é modificado para o correspondente à ação do usuário. |
| —WindowState :TWOLFormState | Indica o estado inicial do formulário. |
| —WindowBorder :TWOLFormBorder | Indica o tipo do bordo do formulário. |
| —WindowIcons :TWOLFormIcons | Indica quais botões do sistema o formulario irá conter. |
| —WindowPlace :TWOLFormPos | Indica o posicionamento do formulário em relação à tela. |
| —VertScrollBar:TWOLFormSBar | Indica a barra de rolagem vertical do formulário. |
| —HorzScrollBar:TWOLFormSBar | Indica a barra de rolagem horizontal do formulário. |
| Métodos Públicos | |
| —function IsMainForm:Boolean; | |
| Usada para verificar se o formulário é a janela principal do aplicativo. | |
| —procedure Close; | |
| Usado para fechar um formulário. Se o formulário for a janela principal do aplicativo, esse será encerrado. | |
| —procedure SetHandle(anyHandle:TWOLHandle); virtual; | |
| Usado para atribuir um handle a um formulário. Deve ser usado com cuidado porque o handle anterior não é liberado. | |
| —procedure InitWindow; override; | |
| Usado internamente para iniciar um objeto de janela. Inicia, por conseguinte, um formulário, criando seus filhos e disparando eventos. | |
| —procedure InitWindowModal; virtual; | |
| Usada internamente para iniciar um formulário (janela) modal. | |
| —function ShowModal:TWOLModalResult; | |
| Usada para mostrar um formulário de maneira modal. Um formulário modal recebe todas as mensagens da aplicação enquanto estiver ativo. | |
| Eventos Públicos | |
| —OnActivate :TWOLEvent | |
| Evento disparado quando o formulário é ativado pelo mouse ou teclado. | |
| —OnClose :TWOLBoolEvent | |
| Evento disparado antes do formulário ser fechado. | |
| —OnCloseQuery :TWOLBoolEvent | |
| Evento disparado quando o formulário está para ser fechado. | |
| —OnDeactivate :TWOLEvent | |
| Evento disparado quando o formulário é desativado (perde o foco). | |
| —OnHelp :TWOLEvent | |
| Evento disparado quando o formulário recebe uma mensagem de pedido de ajuda do usuário. | |
| —OnInitForm :TWOLEvent | |
| Evento disparado quando o formulário termina a iniciação. | |
TWOLShellApplication
Não se trata de um objeto de janela, mas de uma representação da aplicação geral. É uma classe à parte. O propriedade do manipulador (Handle) retorna o valor atribuído à janela principal da aplicação.
Código fonte: WOLGUI01.PP.| Propriedade | Descrição |
| —Active:Boolean | Indica se a aplicação está ativa (com foco) ou não. |
| —ExeName:String | Indica o nome completo da aplicação. |
| —Handle:TWOLHandle | Indica o handle da aplicação. Em geral, o formulário principal. |
| —HelpFile:String | Indica o caminho completo do arquivo de ajuda. |
| —Hint:String | Indica um texto que aparece como hint (dica) no ícone da aplicação. |
| —Icon:TWOLHIcon | Indica o handle do ícone da aplicação. |
| —MainForm:TWOLForm | Indica o formulário principal da aplicação. |
| —Terminated:Boolean | Indica se a aplicação terminou ou não. |
| —Title:String | Indica o Título da Aplicação. |
| Métodos Públicos | |
| —procedure DisableTasks; | |
| Método usado para parar todas as tarefas que estão sendo executadas pela aplicação. | |
| —procedure EnableTasks; | |
| Método usado para recomeçar todas as tarefas da aplicação que foram paradas. | |
| —procedure CreateMainForm(WOLForm:TWOLFormClass; var AForm); | |
| Usado para criar o formulário principal de uma aplicação. Não deve ser usado para criar os formulários subsequentes (secundários). | |
| —procedure Minimize; | |
| Usado para minimizar a janela principal da aplicação e, consequentemente, os demais formulários. | |
| —procedure Restore; | |
| Usado para restaurar as janelas minimizadas da aplicação. | |
| —procedure Run; | |
| Usado para iniciar o loop de uma aplicação. Depois da criação do formulário principal, esse método deve ser chamado para iniciar a aplicação que só terminará quando o usuário fechar o formulário principal. | |
| —procedure Terminate; | |
| Usado para forçar o término de uma aplicação. | |
| —function GetChildByHandle(aHandle:TWOLHandle):TWOLVisualControl; | |
| Usada para recuperar um objeto dentro da aplicação pelo handle. Somente útil em tempo de projeto. | |
| —procedure ProcessMessages; | |
| Usada para processar mensagens pendentes que a GUI enviou à aplicação. | |
| —function Execute(cmd:String; Visible:Boolean):Boolean; | |
| Usada para fazer o Shell da GUI executar uma aplicação qualquer. | |
| —function MessageBox(aTitle, aText:String; aFlags:TWOLMsgBoxFlags):TWOLModalResult; | |
| Usada para mostrar uma caixa de mensagens modal, tais como as de perguntas e alertas. | |