Tópico: Programando com C++Builder

....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:



Informações acerca do controle

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

Propriedades de Navegação

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.

....eventos Standard de TWinControl....





Os seguintes eventos existem para todos os controles derivados de TWinControl (que também incluem todos os controles que definem o Windows). Estes eventos são adicionais àqueles que existem em todos os controles.



OnEnter ocorre quando o controle está recebendo o foco.



OnKeyDown ocorre na descida (down) da tecla que recebe a pressão.



OnKeyPress ocorre quando o usuário pressiona uma única tecla de caracter.



OnKeyUp ocorre na subida (up) da tecla que estava pressionada e foi liberada pelo usuário.



OnExit ocorre quando o foco é transferido para outro controle.



OnDockDrop ocorre quando outro controle é trazido para o controle.



OnDockOver ocorre quando outro controle é arrastado sobre o controle.



OnGetSiteInfo retorna informação do controle trazido.



OnMouseWheel ocorre quando o mouse roda em círculos.



OnMouseWheelDown ocorre quando o mouse gira abaixando.



OnMouseWheelUp ocorre quando o mouse gira subindo.



OnUnDock ocorre quando a aplicação testa para retirar um controle que é docked para um controle windowed.

Usando componentes







Muitos componentes visuais são fornecidos prontos no Componente palette do ambiente de desenvolvimento integrado (IDE). Selecionamos o componente na pallete e o arrastamos para o form, a fim de desenharmos a interface da aplicação. Somente os componente visuais podem ter posição, tamanho e outras propriedades ajustadas no form.

Os Componentes do C++Builder são agrupados em diferentes páginas do Componente pallete de acordo com suas funcionalidades. Por exemplo, componentes usualmente usados para criar menus, edit boxes ou buttons estão localizados na página Standard do Component palette. Controles úteis como timer, paint box, media player, e OLE container estão na página System.



Num primeiro momento, os componentes C++Builder parecem exatamente como qualquer outra classe C++. Mas há diferenças entre componentes C++Builder e as hierarquias de classe standard C++ que a maioria dos programadores C++ trabalha. Algumas dessas diferenças são:



Todos os componentes C++Builder descendem de Tcomponent.



Componentes são freqüentemente usados tal como são, e muitas vezes servem de “classes base” para subclasses quando têm suas funcionalidades alteradas através de sua propriedades. Quando um componente é herdado, ele freqüentemente adiciona um código específico em um evento existente ou função-membro.



Componentes VCL somente podem ser alocados no heap, mas não na stack (isto é, eles precisam ser criados com o operador new).



Propriedades intrínsecas dos componentes possuem informações típicas em tempo de execução.



Componentes podem ser adicionados ao Componente palette do C++Builder e manipulados no form.



Componentes freqüentemente alcançam (executam) um melhor grau de encapsulamento que são usualmente encontrados nas classes standard C++. Por exemplo, considere o uso de um diálogo contendo um botão de pressão. Num programa C++ Windows, quando o usuário clicar o botão, o sistema gera uma mensagem WM_LBUTTONDOWN. O programa deve capturar esta mensagem (tipicamente uma instrução, uma mensagem, ou uma resposta) e enviá-la para a rotina que deve executar a resposta à mensagem.



A maioria das mensagens Windows são cuidadas pelos componentes C++Builder. Quando desejamos uma resposta para uma mensagem Windows, só precisamos providenciar um evento handler.

VCL standard componentes





O componente pallete contém uma seleção de componentes que permitem realizar grande variedade de programações. Podemos adicionar, remover, e reordenar os componentes na pallete, e criar componentes, modelos e frames que agruparão muitos componentes.



Os componentes são arrumados na pallete de acordo com suas finalidades e funcionalidades. Essas páginas, de acordo com a versão do C++ Builder que estiver rodando, contém uma arrumação padrão. A lista a seguir enumera as páginas padrão e os tipos de componentes nelas contidos.





Standard - Controles padão Windows.



Additional - Controles adicionais



Win32 - Controles comuns Windows 9x/NT 4.0



System - Componentes e controles para acesso aos sistema, incluindo timers, multimedia, e DDE



Data Access - Componentes não visuais para accessar database tables, queries, and reports



Data Controls - Componentes visuais, controles data-aware



ADO - Componentes que provêem acesso a dados através de sistema ADO



InterBase - Componentes que fornecem acesso direto a InterBase



Midas - Componentes usados para criar aplicações base de dados multi-tiered



Internet Express - Componentes que são simultaneamente uma aplicação Web Server e o cliente de uma aplicação base de dados multi-tiered



Internet - Componentes para comunicação de protocolos de Internet e aplicações Web



FastNet - Controles Internet NetMasters



Decision Cube - Controles que permitem você resumir informações de base de dados e visualizá-las de uma variedade de perspectivas



Qreport - Componentes QuickReport para criação de relatórios



Dialogs - Caixas comuns de diálogo Windows



Win 3.1 - Componentes no velho estilo Win 3.1



Samples - Componentes Sample custom



ActiveX - Controles Sample ActiveX



Servers - COM Servers para Microsoft Excel, Word, e assim por diante



O help online fornece informações acerca dos componentes na guia padrão. Alguns dos componentes como ActiveX e Samples são apenas providos de exemplos, não havendo qualquer documentação sobre os mesmos.

Controles de Texto







Muitas aplicações apresentam texto para o usuário ou para permitir que o usuário entre com seu próprio texto. O tipo de controle usado para este propósito depende do tamanho e do formato da informação.




Use este componente
Quando desejar este resultado

Edit
Editar uma única linha de texto

Memo
Editar múltipla linhas de texto

MaskEdit
Editar a um formato particular, como caixa postal ou número de telefone

RichEdit
Editar múltiplas linhas de texto usando formato rich text, ou seja, linhas passíveis de formatação






Propriedades de texto





Eis um grupo de propriedades:


Text
determina o texto que aparece no edit box ou controle memo.

CharCase
força o o texto entrar como lowercase (minúsculas) ou uppercase (maiúsculas).

ReadOnly
(somente leitura) especifica se o usuário está autorizado a entrar com o texto, ou alterá-lo.

MaxLength
limite do número de caracteres no controle.

PasswordChar
oculta o texto, exibindo somente um único caractere (normalmente um asterisco).

HideSelection
especifica se o texto selecionado fica destacado quando o controle não possui o foco.

Mais Propriedades de texto





Controles Memo e RichEdit, que trabalham com múltiplas linhas de texto, possuem várias propriedades em comum; outras pertencem ao Edit (controle de uma linha):


Alignment
especifica como o texto é alinhado no componente (left (esquerda), right (direita), ou center (centro)).

Text
A propriedade Text pertence ao controle. Sua aplicação pode saber se o texto foi alterado pela checagem da propriedade Modified.

Lines
contém o texto como uma lista de strings.

OEMConvert
determina se o texto está temporariamente convertido de ANSI para OEM como é colocado. Isto é proveitoso para validade file names.

WordWrap
determina se o texto passará para a próxima linha quando alcançar a margem direita.

WantReturns
determina se o usuário pode inserir returns (tecla Enter) no texto.

WantTabs
determina se o usuário pode inserir tabs no texto.

AutoSelect
determina se o texto será automaticamente selecionado quando o controle se tornar ativo.

SelText
contém a parte selecionada do texto.

SelStart e SelLength
indica a posição e comprimento (length) da parte selecionada do texto.



Em tempo de execução, você pode selecionar todo o texto

em um memo com o método SelectAll








Controles Rich text







O Componente Richedit é um controle memo que suporta formatação rich text, impressão, localização e arrastar e soltar partes do texto. Ele permite que nós especifiquemos propriedades das fontes, alinhamento, tabs, margem e numeração.

Controles Splitter







Um splitter colocado entre controles alinhados permite ao usuário mudar o tamanho dos controles. Usado com componentes como panels e group boxes, splitters permite-nos dividir um form em várias partes com múltiplos controles em cada parte.

Depois de instalar um panel ou outro controle no form, adicione um splitter com o mesmo alinhamento daquele. O último controle deverá ser client-alinhado, de forma que preencha o resto do espaço quando o outro tiver seu tamanho alterado. Por exemplo, você pode colocar um panel na margem esquerda do form, assinalando o seu Alignment para alLeft, então ponha um splitter (também alinhado para alLeft) para a direita do panel, e finalmente coloque outro panel (alinhado para alLeft ou alClient) à direita do splitter.



Trabalhe MinSize para especificar um tamanho mínimo para o splitter deixar quando alterado o tamanho do controle vizinho. Marque Beveled para true para dar ao splitter’s uma margem com visual 3D.