Propriedades comuns de TControl

Todos os controles visuais (descendentes de TControl) compartilham certas propriedades, incluindo:

Position, Size e Alignment

Display

Parent

Navigation

Drag-and-drop

Drag-and-dock

Action

Apesar de essas propriedades serem herança de TControl, elas são públicas — e, conseqüentemente, aparecem no Object Inspector — somente para os componentes aos quais elas são aplicáveis. Por exemplo, TImage não publica a propriedade Color, sendo sua cor determinada pelo gráfico exibido.

TControl Action

Actions permitem que você compartilhe o código para ações comuns (por exemplo, quando um botão e um menu fazem a mesma coisa), e também fornecem um único caminho centralizado para ativar ou desativar ações, dependendo do estado de sua aplicação.

Action designa a ação associada ao controle.

ActionLink contém o action link object associado com o controle.

TControl Position, Size e Alignment

Este grupo de propriedades define a posição e o tamanho do controle no controle parent:

Height (altura) ajusta o comprimento vertical.

Width (largura) ajusta o comprimento horizontal.

Top posição da margem superior.

Left posição da margem esquerda.

AutoSize especifica se o controle ajusta seu tamanho automaticamente de acordo com o seu conteúdo.

Align determina como o controle ajusta-se (tamanho e forma) dentro do container (controle parent).

Anchor especifica como o controle fica ancorado no parent.

Este grupo de propriedades determina a altura, a largura e o tamanho global do controle cliente área:

ClientHeight especifica a altura do controle cliente área em pixels.

ClientWidth especifica a largura do controle cliente área em pixels.

Essas propriedades não são acessíveis aos componentes não visuais, mas o C++Builder mantém-nos informados acerca das coordenadas do local em que o ícone de tais componentes encontram-se inseridos no form. Na maior parte das vezes, ajustamos e alteramos essas propriedades pela simples manipulação do controle no form, o que reflete diretamente no Object Inspector, mas, de qualquer forma, podemos alterá-las em tempo de execução.

TControl Display

As propriedades a seguir administram a aparência geral dos controles:

Color altera a cor do background (fundo) de um controle.

Font altera a cor, o tipo, o estilo ou o tamanho de um ou mais caracteres.

Cursor especifica a imagem usada para representar o ponteiro do mouse quando este passar pela região abrangida pelo controle.

DesktopFont especifica se o controle usa as fonts símbolos do Windows quando escrever um texto.

TControl Parent

Para manter uma aparência consistente através de nossa aplicação, podemos fazer qualquer controle parecer como um container dela - chamar parent dela - colocando a propriedade parent como true.

ParentColor determina onde o controle deve procurar informações a respeito de sua cor.

ParentFont determina onde o controle procurará informação sobre sua font.

ParentShowHint determina a forma que o controle exporá seu Help Hint.

TControl Navigation

A propriedade seguinte determina como o usuário pode navegar entre os controles no form.

Caption contém o texto que rotula um componente. Para sublinhar um caracter numa string, devemos incluir um sinal “&” (E comercial) antes do caracter. A esse tipo de caracter, chamamos tecla aceleradora. Então, o usuário poderá selecionar o controle pressionando as teclas Alt juntamente com o caracter sublinhado.

TControl Drag-and-drop

Duas propriedades afetam o comportamento drag-and-drop (arrastar e soltar):

DragMode determina a forma do início do arrastar. Por padrão, DragMode é marcado dmManual, e a aplicação deve chamar o método BeginDrag para iniciar um arrastar. Quando DragMode está marcado para dmAutomatic, inicia-se um arrastar tão logo seja pressionado o botão do mouse.

DragCursor determina a figura do ponteiro do mouse quando um componente é arrastado.

TControl Drag-and-dock

As seguintes propriedades controlam o comportamento drag-and-dock:

Floating indica se o controle é flutuante.

DragKind especifica se o controle é arrastado normalmente ou por ancoragem.

DragMode determina como o controle inicia operação drag-and-drop ou drag-and-dock.

FloatingDockSiteClass especifica a classe do controle que hospeda temporariamente o controle quando ele é flutuante.

DragCursor é o cursor exibido enquanto é arrastado.

DockOrientation especifica como o controle é trazido em relação a outros controles no mesmo parent.

HostDockSite especifica o controle no qual o controle é trazido.

Para maiores informações, veja Implementing drag-and-dock in controls.