Adicionando Propriedades e Funcionalidades aos Componentes Parte II

Transcrição

1 Adicionando Propriedades e Funcionalidades aos Componentes Parte II Quantas vezes eu não lamentei por este componente não ter uma propriedade que guardasse uma lista paralela a lista que é mostrada em tempo de execução e que esta lista pudesse ser indexada da mesma forma que a primeira também é. Um exemplo fala mais: Imaginemos que iremos colocar uma lista de estados brasileiros num ComboBox, mas é óbvio que iremos gravar (ou utilizar) apenas as siglas destes estados. Não seria interessante que houvesse uma lista paralela que pudéssemos armazenar apenas as siglas e na que é mostrada ao usuário tivesse os nomes dos estados? Como diria o pessoal do Casseta & Planeta: Seus problemas acabaram... Brincadeiras a parte, esta implementação é bem simples. O Problema Só para formalizar, iremos implementar uma propriedade chamada ValueList que é um TString. Esta lista é como se fosse uma lista paralela a lista da propriedade Items. Se a propriedade ItemIndex do ComboBox estiver no valor 0 (zero) significa que o primeiro item da propriedade Items está selecionada, mas vai significar também que o primeiro item da propriedade ValueList também estará selecionada. Então, todas as vezes que alterarmos a posição da lista Items o posicionamento da lista ValueList também será alterado. Como no ComboBox original existe uma propriedade Text que contém o ítem da propriedade Items que está selecionado, colocaremos também uma propriedade Value que conterá o item da propriedade ValueList selecionado. Faremos mais: Se alterarmos o valor da propriedade Value a nossa lista será novamente posicionada mediante a lista ValueList.

2 A Solução Como sempre, a solução é bem simples. Faremos um passo-a-passo de como isto é possível. Aprendi que em matéria de programação, os maiores problemas tem as soluções mais simples. Então vamos lá: Primeiro vamos iniciar a criação de um novo componente que chamará: TMyComboBox" (sugestivo, não?). Mas se quiser colocar outro nome (até peço para que façam isto) fiquem a vontade. No Delphi clique no menu Component e na opção New Component.... Vai abrir a janela parecida com a figura abaixo: No primeiro campo Ancestor type informamos de qual objeto iremos herdar as características. No nosso caso iremos herdar todas as características (propriedades, métodos e eventos) do TComboBox. No segundo campo Class Name informamos o nome do nosso objeto. No nosso caso coloquei TMyComboBox (como disse acima, poderia ser qualquer outro nome conforme a conveniência). No terceiro campo Palette Page informamos em qual paleta o novo componente será instalado. Pode ser uma previamente existente ou uma nova. No quarto campo Unit file name informamos o nome da unit que irá conter o nosso novo componente. Informe o nome do arquivo e o caminho onde o mesmo será gravado. E, finalmente, no quinto campo Search path é especificado o caminho de onde o componente será encontrado pelos aplicativos que o contiverem. Normalmente nem é preciso alterar este campo que já vem previamente preenchido. Clique no botão OK e a nova unit será aberta. A única coisa automática que veio é a classe de onde derivamos o nosso objeto (TComboBox no nosso caso) e a procedure Register que será a responsável por registrar o componente na paleta do Delphi.

3 Agora é mãos à obra. Vamos começar o nosso trabalho de construção de mais um componente. Na seção private iremos colocar o seguinte: private { Private declarations } FValue: String; FValueList: TStrings; São duas variáveis. A variável FValueList" irá a lista paralela a lista da propriedade Items e a variável FValue irá conter o item da lista FValueList" que está selecionado. Ainda na seção private, logo após as definições das variáveis, colocaremos o seguinte: procedure SetValue(Value: String); procedure SetValueList(Value: TStrings); São duas procedures. A procedure SetValue será para gravar o valor do novo item a ser selecionado da lista ValueList. A procedure SetValueList será para gravar os itens da lista ValueList. Na seção Protected, colocaremos o seguinte: protected { Protected declarations } procedure SetItemIndex(const Value: Integer); override; A procedure SetItemIndex é uma procedure já existente no componente ComboBox que iremos utilizar aqui para posicionar a lista ValueList a medida que a lista Items for posicionada. Ta complicado? Não se preocupe. Daqui a pouco verá que a coisa não é tão complicada assim! Agora o nosso trabalho é na seção Public. Coloque o seguinte: public { Public declarations } constructor Create(AOwner: TComponent); override; destructor Destroy; override; Aqui estamos aproveitando duas procedures já existentes no componente ComboBox, mas fazendo alterações. Por isto há a palavra override após a declaração das procedures. Agora é a declaração das novas propriedades. Isto é feito na seção Published : published { Published declarations } property Value: String read FValue write SetValue; property ValueList: TStrings read FValueList write SetValueList;

4 Até o momento apenas declaramos as variáveis, procedures e propriedades. Vamos agora a parte pesada de todo o processo. É chegada a hora de colocarmos a mão na massa. constructor TMyComboBox.Create(AOwner: TComponent); FValue := ''; FValueList := TStringList.Create; FValueList.Clear; Esta é a procedure responsável por criar o componente. Na criação devemos dar o valor inicial para a variável FValue e criarmos a nossa lista FValueList. Como a criação da lista FValueList implica em alocação de memória, portanto, na hora que o componente for destruído (liberado da memória) devemos também liberar a memória alocada para nossa lista. Esta é a função da procedure Destroy que listamos a seguir: destructor TMyComboBox.Destroy; FValueList.Free; Veja que antes de passar o controle para a versão original desta função, destruímos a nossa lista criada no momento da criação do componente. Agora façamos a procedure que irá gravar o conteúdo de nossa lista: procedure TMyComboBox.SetValueList(Value: TStrings); FValueList.Assign(Value);

5 Lembremos que na declaração das procedures, fizemos menção a uma procedure já existente no componente TComboBox que é a SetItemIndex. Agora vamos fazer a sua redefinição: procedure TMyComboBox.SetItemIndex(const Value: Integer); if (ItemIndex < 0) or (ItemIndex >= FValueList.Count) then FValue := '' else FValue := FValueList[ItemIndex] Desta forma, se o valor da propriedade ItemIndex do nosso componente for um valor maior ou igual a zero e menor que a quantidade de itens da nossa lista ValueList significa que devemos colocar o item (da lista ValueList ) respectivo na nova propriedade Value. Agora é o processo inverso. Ou seja, quando alterarmos o conteúdo da propriedade Value, se este conteúdo fizer parte da lista ValueList devemos alterar o posicionamento da lista Items na mesma proporção. procedure TMyComboBox.SetValue(Value: String); var Ind: Integer; Ind := FValueList.IndexOf(Value); if Ind >= 0 then FValue := Value; ItemIndex := Ind; Quando um novo valor para propriedade Value for setado, este valor é procurado dentro da lista ValueList. Caso seja encontrado, o valor informado na propriedade é gravado e a propriedade ItemIndex assume a posição do valor da propriedade Value dentro da lista ValueList.

6 Segue uma listagem completa do componente: unit MyComboBox; interface uses Windows, Messages, SysUtils, Classes, Controls, StdCtrls; type TMyComboBox = class(tcombobox) private { Private declarations } FValue: String; FValueList: TStrings; procedure SetValue(Value: String); procedure SetValueList(Value: TStrings); protected { Protected declarations } procedure SetItemIndex(const Value: Integer); override; public { Public declarations } constructor Create(AOwner: TComponent); override; destructor Destroy; override; published { Published declarations } property Value: String read FValue write SetValue; property ValueList: TStrings read FValueList write SetValueList; procedure Register; implementation procedure Register; RegisterComponents('Standard', [TMyComboBox]); constructor TMyComboBox.Create(AOwner: TComponent); FValue := ''; FValueList := TStringList.Create; FValueList.Clear; destructor TMyComboBox.Destroy; FValueList.Free;

7 procedure TMyComboBox.SetValueList(Value: TStrings); FValueList.Assign(Value); procedure TMyComboBox.SetItemIndex(const Value: Integer); if (ItemIndex < 0) or (ItemIndex >= FValueList.Count) then FValue := '' else FValue := FValueList[ItemIndex] procedure TMyComboBox.SetValue(Value: String); var Ind: Integer; Ind := FValueList.IndexOf(Value); if Ind >= 0 then FValue := Value; ItemIndex := Ind; end. E assim termina a programação do nosso componente. Agora é só instalar e usar. A instalação é, igualmente simples. No Delphi basta clicar no menu Component, na opção Install Component e na guia Into new package. A tela que vai aparecer é esta:

8 No primeiro campo é necessário informar o nome da unit que contém o componente. Incluindo o seu caminho. No segundo campo (que já vem preenchido) são as pastas onde ele vai buscar outras units caso sejam necessárias. Não precisa mexer neste campo. No terceiro campo é o nome do Package que será criado. Recomenda-se colocar um nome diferente da unit para evitar conflitos. No quarto campo é só uma descrição do componente. Após informar os campos desta tela e clicar no botão OK, vai abrir uma tela com toda a unit do componente e logo em seguida abre uma janela perguntando se deseja realmente instalar o componente. Clique no botão Yes. Vai abrir outra tela com o package já criado. Clique no botão Compile e logo depois no botão Install. Se tudo foi feito corretamente, o componente será compilado e devidamente instalado. Observe que o ícone deste componente é o mesmo do TComboBox. Isto é porque herdamos tudo do ComboBox (inclusive o ícone). Numa outra oportunidade descrevo como colocar um ícone diferente para nossos componentes. Um abraço, Marcelo Torres