WOL
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

form

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

shellapplication

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.