TWOLTabControl - WOLGUI

Descendente de TWOLVisualControl. É a representação, em objeto WOL, de um notebook básico da GUI em uso. Arquivo fonte: WOLGUI29.PP.

Propriedades do TWOLTabControl

Propriedade	Descrição
MultiLine	Propriedade que indica se a aba é multilinhas ou numa única linha.
TabWidth	Propriedade que indica a largura de cada aba.
TabHeight	Propriedade que indica a altura de cada aba.
HotTrack	Propriedade que indica que o título da aba ficará iluminada quando o mouse passar por cima.
Scroll	Propriedade que indica que as abas rolarão se ultrapassarem a largura do tabcontrol.
TabIndex	Propriedade que indica o índice da aba correntemente ativa.
TabPos	Propriedade que indica a posição das abas em relação ao tabcontrol. É do tipo TWOLPositionSet.
Pages	Propriedade do tipo TWOLTabPages que carrega as páginas do notebook. Toda a manipulação de páginas é feita nessa propriedade.

Métodos e Eventos Públicos

— OnChange:TWOLEvent

Evento disparado quando o usuário muda de aba.

— OnChanging:TWOLBoolEvent

Evento disparado quando a aba está para mudar.

TWOLTabPages

Trata-se de uma classe à parte usada para carregar o conjunto de abas do TabControl. No WOL Designer, a entrada de abas pode ser realizada através de uma janela apropriada para isso. Para realizar as tarefas, conta com os seguintes métodos, eventos e propriedades.

Propriedades da TWOLTabPages

Propriedade	Descrição
Page[index:Integer]	Propriedade do tipo TWOLTabPage que representa cada uma das abas, juntamente com a área, do TabControl.
Count	Propriedade que retorna o número de abas existentes no TabControl.
TabIndex	Propriedade que indica e/ou altera a aba corrente do TabControl.
TabWidth	Propriedade que indica a largura de cada aba no TabControl.
TabHeight	Propriedade que indica a altura de cada aba no TabControl.

Métodos e Eventos Públicos

— constructor Create(aOwner:TWOLTabControl);

Método usado para criar o conjunto de abas, inicialmente vazio.

— destructor Destroy; override;

Método usado para destruir o conjunto de páginas e liberar memória.

— procedure Add(S:String);

Método usado para adicionar uma aba com o título indicado em S.

— procedure Delete(index:Integer);

Método usado para apagar uma aba de índice indicado pelo index.

— procedure Insert(index:Integer; S:String);

Método usado para inserir uma aba de título indicado em S na posição indicada em index.

— function IndexOf(S:String):Integer;

Método usado para recuperar o índice da aba de nome indicado em S. Caso não exista, o valor retornado é -1.

— procedure CreatePages;

Método usado para recriar as abas.

— function FindControlInPages(aHandle:TWOLHandle):TWOLVisualControl;

Procura e retorna um objeto de janela incluso em uma das abas do TabControl. Caso não encontre, retornará nil.

— function FindPageByHandle(aHandle:TWOLHandle):Boolean;

Método que retorna True se encontrar uma página no conjunto com o handle indicado.

— function ControlsCount:Integer;

Método usado para retornar a quantidade de objetos de janela contidos no conjunto de abas. Isto é, a quantidade total do TabControl.

— procedure ControlsUnparent;

Os objetos colocados nas abas dos TabControl tem dois pais: um é a janela que representa a área onde está localizado. Esse é o pai perante a GUI em uso. Outro, é o próprio TabControl, apenas no sentido de ser o objeto pai. Em determinadas ações, há a necessidade de se anular o pai objeto do control. Isso é realizado por esse método.

— procedure Clear;

Método usado para limpar totalmente o conjunto de abas do TabControl.

— procedure Show;

Método usado para mostrar o conjunto de abas do TabControl.

— procedure Hide;

Método usado para esconder o conjunto de abas do TabControl.

TWOLTabPages

Essa classe à parte é usada para representar cada uma das abas do conjunto existente no TWOLTabControl. Deve-se utilizar essa classe para se incluir os objetos de janela nas abas do TabControl.

Propriedades da TWOLTabPage

Propriedade	Descrição
Controls[index:Integer]	Propriedade do tipo TWOLVisualControl que retorna o objeto de janela de índice indicado em index ou nil.
ControlsCount	Propriedade que retorna a quantidade de objetos de janela encontrados na aba.
PObject	Propriedade do tipo TObject que retorna o objeto associado à aba do TabControl.
Handle	Propriedade do tipo TWOLHandle que retorna o handle da aba (janela que representa a área onde se coloca os objetos de janela).
Caption	Propriedade que indica o título da aba.
Visible	Propriedade que indica e/ou altera a visibilidade da área que recebe os objetos de janela.
Params	Propriedade do tipo TWOLTabCtrlPgParams que retorna um registro de propriedades da aba.

Métodos e Eventos Públicos

— constructor Create(aOwner:TWOLTabPages);

Método usado para criar uma aba, inicialmente apenas com o título.

— destructor Destroy; override;

Método usado para destruir uma aba e liberar memória.

— procedure Add(aObject:TWOLVisualControl);

Método usado para adicionar um objeto de janela à aba.

— procedure Delete(index:Integer);

Método usado para apagar um objeto de janela de índice indicado em index.

— procedure Clear;

Método usado para limpar todos os objeto de janela da aba.

— procedure CreateWnd;

Método usado para criar a janela que representa a área da aba onde se coloca os objetos de janela.

— procedure RecreateWnd;

Método usado para recriar a janela que representa a área da aba e seus objetos.

— procedure DestroyWnd;

Método usado para destruir a janela que representa a área da aba juntamente com os objetos.

— function FindControlByHandle(aHandle:TWOLHandle):TWOLBase;

Método usado para procurar os objetos de janela baseado no handle indicado.

— function FindControlByName(aName:String):TWOLBase;

Método usado para procurar os objetos de janela baseano no nome indicado.

— function FindControl(Index:Integer):TWOLBase;

Método usado para procurar os objetos de janela baseado no índice indicado por index.

No WOL Designer, encontra-se a janela de entrada de abas do TabControl. Essa janela está no arquivo fonte WOLGUI29e.PP e pode ser ativada de outro ponto, mas foi criada para interagir com o Object Inspector do desinger.