Propriedades comuns de TWinControl

TWinControl é a classe base e que provê funcionalidades comuns a todos os controles que atuam como invólucro para objetos screen (“janelas”) Microsoft Windows. Controles base de invólucros de janelas possuem as seguintes características:

O controle pode incorporar a funcionalidade de uma janela base. Por exemplo, se o objeto base é um editor de textos, o controle pode incorporar a habilidade de controlar e exibir um texto buffer.

O controle pode receber o foco através de ações do usuário. Um controle que pode receber o foco pode tratar dados de entrada advindos de eventos do teclado. Alguns controles mudam sua aparência quando estão com o foco. Por exemplo, controles Button indicam que estão com o foco através do desenho de uma área retangular em volta de seu Caption.

O controle pode servir como um container para outros controles referidos como controles child (filhos). Este relacionamento encontra sua significância na propriedade child's Parent. Controles container provêem importantes serviços para seus filhos (children), incluindo exibição de tarefas de controles que não implementam sua própria tela. Exemplo de controles container incluem forms, panels, e toolbars.

Controles baseados em TWinControl podem exibir telas standard fornecidos por Microsoft Windows, ou personalizar telas desenvolvidos com a VCL.

Descendentes de TWinControl incluem classes base abstratas que sustentam a maioria dos tipos de interface com usuários. O mais significante descendente é TCustomControl, que provê código para implementar um canvas e tratar mensagens paint. Outro importante descendente abstrato inclui TScrollingWinControl, TButtonControl, TCustomComboBox, TCustomEdit, e TCustomListBox. Quando definimos novas classes de controles, devemos considerar esses descendentes antes de derivar diretamente de TwinControl.

Cada objeto TWinControl possui uma propriedade Handle a qual fornece tratamento para suporte a objetos screen Microsoft Windows. Use a propriedade Handle para contornar a VCL API e acessar diretamente a janela.

Todos os controles providos de janelas (descendentes de TWinControl) compartilham certas propriedades, incluindo:

1. Informações acerca do controle

2. Exibição de propriedades Border Style (estilo da borda)

3. Propriedades de Navegação

4. Propriedade Drag-and-dock

Essas propriedades são herdadas de TwinControl são published — e, portanto, aparecem no Object Inspector — só para os controles para os quais elas existem.

Nota: Membros published tem a mesma visibilidade dos membros públicos. A diferença é que as informações em tempo de execução (RTTI) são geradas por membros published.

TWinControl propriedades de informações gerais

As propriedades de informações gerais contêm informações acerca da aparência do TWinControl, client area, size e origin, windows assigned information, e informações a respeito do movimento do mouse.

ClientOrigin especifica as coordenadas na tela (em pixels) do canto superior esquerdo da área cliente de um controle. As coordenadas na tela do controle descendente de TControl e não de TWinControl são as coordenadas na tela dos controles parent adicionado às suas propriedades Left e Top.

ClientRect retorna um retângulo com suas propriedades Top e Left marcadas para zero, e as propriedades Bottom e Right marcadas de acordo com as propriedades Height e Width, respectivamente. ClientRect é equivalente a:

Rect(0, 0, ClientWidth, ClientHeight)

Brush determina a cor e o padrão usado para pintar o background do controle.

Handle provê acesso ao window handle do controle.

WindowHandle também provê acesso ao window handle do controle.

HelpContext provê um número contexto para uso na chamada de Help online.

Controls lista todos childrens do controle provido de janelas.

TWinControl propriedades de exibição do estilo da borda

A propriedade bevel (estilo de inclinação da borda do componente) controla a aparência dos cortes das linhas das bordas, boxes, ou frames no form e de controles providos de janela em sua aplicação.

InnerBevel especifica se o interior bevel possui aparência em relevo, rebaixada ou plana.

BevelKind especifica o tipo de bevel - se o controle possui bordas.

BevelOuter especifica se o bevel externo tem aparência plana, rebaixada ou em relevo.

BevelWidth especifica o width, em pixels, do interior e exterior do bevel.

BorderWidth é usado para receber ou agrupar o width da borda do controle.

BevelEdges é usado para receber ou colocar chanfra na margem do controle.

TWinControl propriedades de navegação

Duas propriedades adicionais determinam como o usuário navega entre os controles num form:

TabOrder indica a seqüência que o controle é selecionado pela tecla Tab do controle em relação a seu parent; ou seja, a ordem na qual o controle recebe o foco quando o usuário pressiona a tecla Tab. Inicialmente, TabOrder é a ordem na qual os controles são colocados no form, mas você pode mudar essa ordem alterando a propriedade TabOrder no Object Inspector. TabOrder funciona somente se TabStop estiver true.

TabStop determina se o usuário pode usar a tecla Tab para modificar o foco de um controle. Se TabStop estiver true, o controle aceita a TabOrder.

TWinControl propriedade Drag-and-dock

As propriedades a seguir administram o comportamento drag-and-dock:

UseDockManager especifica se o dock manager é usado em operações drag-and-dock.

VisibleDockClientCount especifica o número de controles visíveis que são colocados na janela.

DockManager especifica a interface do controle dock manager.

DockClients lista os controles que são colocados no controle windowed (provido de janela).

DockSite especifica se o controle pode ser alvo de operações drag-and-dock.

Para maiores informações, ver implementação drag-and-dock em controles.