00 - Editorial.indd 2 24.03.

08 06:17:22
 Sumrio
Ol, eu sou o DevMan! Desta pgina em diante, eu estarei lhe
ajudando a compreender com ainda mais facilidade o conte-
do desta edio. Ser um prazer contar com sua companhia!
Confira abaixo o que teremos nesta revista:

08 Streams
Expert Implemente compactao, download em mltiplos pacotes e resources em
suas aplicaes com tcnicas avanadas de Streams Parte 2
[ Gustavo Chaurais ]

Expert 16 Anlise de Pontos de Funo

Engenharia de Saiba mensurar o tamanho de seu software e estimar o tempo que levar para ficar pronto
Software [ Carmo Crdiney de Melo e Marco Antnio Pereira Arajo ]

24 Usando todo o poder do TDataSetProvider

Mo na Massa Usufrua de todos os recursos do DataSetProvider em suas aplicaes
[ Adriano Santos ]

Mo na Massa 32 ClientDataSet
Automatizando o tratamento de Erros
[ Rodrigo Lazoti ]

Web
Mini-Curso 36 Controle on-line de vdeo-locadora - Parte 2
Mo na Massa Veja como criar um sistema on-line de controle para uma vdeo-locadora
[ Maikel Marcelo Scheid ]

Tutorial 42 Desenvolvendo uma Aplicao Completa com PocketStudio

Mini-Curso
Aprenda a criar aplicaes para o sistema operacional PalmOS Parte 3
[ Ricardo C. Boaro ]

50 Envio de E-mails com componentes da paleta Indy

Easy Veja como enviar e-mails utilizando os componentes da paleta Indy
[ Maikel Marcelo Scheid ]
Voc percebeu os cones ao lado de cada matria? Eles in-
dicam o que voc vai encontrar no artigo dessa forma,
54 Editor de Textos com RichEdit voc tambm pode ter uma idia geral do que vai encon-
Easy Veja como criar seu prprio editor de textos com o componente RichEdit trar nesta edio como um todo! Os editores trabalham
[ Maikel Marcelo Scheid ] sempre no sentido de fechar a revista seguindo esta defi-
nio, para oferecer a voc o melhor contedo didtico!

Confira abaixo a lista com a definio dos tipos de artigo

Delphi PHP 60 Orientao a Objetos no Delphi for PHP
encontrados nesta edio:
Mini-Curso
Como aplicar conceitos de POO em aplicaes PHP Parte 2
[ Rodrigo Carreiro Mouro ]

[ Mo na Massa ] Artigos que focam na resoluo de problemas
- e no na tecnologia. A tecnologia empregada apenas conseq-
ncia. O artigo parte do pressuposto que o leitor j conhece a tec-
nologia, mas tem dificuldade de implement-la em uma aplicao
cotidiana. Por exemplo, um artigo que ao invs de debulhar todos
os mtodos e propriedades de um Recordset, mostre como usar o
Recordset de forma inteligente. para criar um carrinho de compras.
[ Delphi PHP ] Artigo com foco na verso PHP do Delphi
[ Engenharia de Software ] Artigo dentro do contexto de
Engenharia de Software
[ Web ] Artigos sobre ou que envolvam tcnicas de
desenvolvimento para WEB.
[ Expert ] Artigo com foco no leitor avanado
[ Easy ] Com foco no desenvolvedor iniciante
[ Mini-Curso ] Artigo que faz parte de um mini-curso
[ Tutorial ] Artigo no estilo tutorial passo a passo

Edio 94 - ClubeDelphi 3

00 - Editorial.indd 3 25.03.08 16:57:19

 ClubeDelphi EDITORIAL
Ano 8 - 94 Edio - 2008 - ISSN 1517990-7 Impresso no Brasil O DataSetProvider tem uma importante funo no ciclo de vida da manipulao
de dados em uma aplicao Delphi. Ele responsvel por se comunicar
Corpo Editorial com o engine (dbExpress por exemplo), obter os dados, empacot-los nos
chamados DataPackets e envi-los atravs da memria para o ClientDataSet
Editor Geral (em uma aplicao 2-tier) ou atravs da interface IAppServer em uma aplicao
Guinther Pauli multicamadas (SOAP, COM+ etc.). O DataSetProvider faz muito mais do que isso,
guinther@devmedia.com.br
e expe muitas de suas funcionalidades na forma de propriedades e eventos,
Editor Tcnico como mostra o Adriano Santos em seu completo artigo sobre o assunto.
Adriano Santos Falando em DataSetProvider, seu irmo ClientDataSet tambm exerce
adrianosantos@devmedia.com.br importante funo em aplicaes de banco de dados. Um dos problemas
Equipe Editorial relacionados a esse componente, e que confunde muitos, a correta manipulao
Fabricio Desbessel, Maikel Scheid, Paulo Quicoli, Luciano Pimenta de erros gerados no SGBD (Firebird por exemplo). No artigo do Rodrigo, veja
Editor de Arte como construir um descendente de ClientDataSet que automaticamente trata
Vinicius O. Andrade os principais erros do servidor, como violao de foreign-key.
viniciusoandrade@gmail.com Na seo Expert, o Gustavo Chaurais continua o artigo sobre Streams. Na
Diagramao parte final do seu artigo, veja como implementar compactao, download em
Adolfo Sabino mltiplos pacotes e resources em suas aplicaes. Ainda nesta seo, o
simininu@yahoo.com.br Marco e o Carma aprofundam um assunto muito importante, que na verdade
um desafio nos projetos de software: como mensurar o esforo e o prazo
Capa
Antonio Xavier
necessrio para desenvolver determinada aplicao, ajudando a reduzir
webdesigner@devmedia.com.br custos e no estropolar o cronograma.
O Maikel continua a srie que demonstra a construo de uma locadora
Reviso
Web. E nada melhor que o ASP.NET para construir um sistema completo desse
Gregory Monteiro
tipo. O Ricardo usa e abusa de seus conhecimentos sobre desenvolvimento
gregory@clubedelphi.net
com PocketStudio e continua seu excelente curso que mostra como criar uma
Distribuio aplicao para o sistema operacional PalmOS.
Fernando Chinaglia Dist. S/A Na sesso Easy Delphi, para quem est iniciando, temos o Maikel com dois
Rua Teodoro da Silva, 907 artigos: veja como utilizar os principais controles da VCL na construo de um
Graja - RJ - 206563-900
pequeno editor de textos, bem prtico. No outro artigo, mostra como utilizar os
componentes da paleta Indy para criar um sistema de envio de e-mails. ideal por
exemplo se voc precisar enviar e-mails automaticamente da sua aplicao.
Atendimento ao Leitor Para finalizar, o Rodrigo apresenta aquele que considero o melhor recurso da
A DevMedia conta com um departamento exclusivo para o atendi- POO, o polimorfismo, tudo em PHP! Se voc j domina ou conhece o assunto,
mento ao leitor. Se voc tiver algum problema no recebimento do seu sabe que ele realmente poderoso. Que tal utiliz-lo agora em suas aplicaes
exemplar ou precisar de algum esclarecimento sobre assinaturas, Web com o Delphi for PHP?
exemplares anteriores, endereo de bancas de jornal, entre outros,
entre em contato com: Grande abrao e sucesso com o Delphi!
Carmelita Mulin
www.devmedia.com.br/central/default.asp
(21) 3382-5025
Kaline Dolabella
Gerente de Marketing e Atendimento
kalined@terra.com.br Guinther Pauli
(21) 3382-5025
guinther@devmedia.com.br
Publicidade Microsoft Certified: MCP, MCAD, MCSD.NET
Para informaes sobre veiculao de anncio na revista ou no site Borland Certified: Delphi 6, 7, 2005, 2006, Web, Kylix
entre em contato com:
Kaline Dolabella
publicidade@devmedia.com.br

NO A
Portal do Assinante

Fale com o Editor
muito importante para a equipe saber
o que voc est achando da revista: que
tipo de artigo voc gostaria de ler, que
artigo voc mais gostou e qual artigo
voc menos gostou. Fique a vontade
para entrar em contato com os editores
e dar a sua sugesto!
Se voc estiver interessado em publicar um
artigo na revista ou no site ClubeDelphi, entre
em contato com os editores, informando
o ttulo e mini-resumo do tema que voc
gostaria de publicar:
Guinther Pauli - Editor da Revista
guinther@devmedia.com.br
C
PER
A ClubeDelphi tem uma novidade para voc que comprou este
exemplar na banca de jornal: voc pode acessar GRATUITAMENTE,
o Portal do Assinante ClubeDelphi!
Confira o que voc encontra no Portal do Assinante:
- Mais de 560 Vdeo Aulas!
- 7 cursos online!
- 1 Livro Eletrnico sobre ADO.NET e BDP!
- Mais de 150 Artigos Exclusivos!

Para Utilizar o Portal do Assinante, acesse www.devmedia.com.br/clubedelphi/potal.asp

Apoio e utilize as informaes abaixo: Login: DVM.PL e Senha: STX200

O acesso vlido por 30 dias a partida da data de lanamento da revista. Todos os

meses a ClubeDelphi lhe dar uma senha vlida para acessar o portal. Comprando a
A revista ClubeDelphi parte integrante da assinatura ClubeDelphi
PLUS. Para mais informaes sobre o pacote PLUS, acesse: revista regularmente em bancas, voc ter acesso ininterrupto a ele!
http://www.devmedia.com.br/clubedelphi/portal.asp
 Informativo ClubeDelphi

Portal ClubeDelphi
+560 vdeo aulas e 7 cursos online
www.clubedelphi.net/portal

Caro Leitor
O portal ClubeDelphi PLUS a continuao, na Web,
da revista ClubeDelphi. O portal recebe um conte-
do novo todo dia e hoje conta com: i) mais de 560
vdeo aulas; ii) 7 cursos online; iii) 1 livro eletrnico
gratuito, de Guinther Pauli, sobre ADO.NET e BDP; iv)
mais de 150 artigos exclusivos (que no foram pu-
blicados na revista)!;
Acesse o portal ClubeDelphi PLUS e receba muito
mais contedo sobre Delphi! E o que melhor: de
graa! Todo leitor da revista ClubeDelphi, seja ele
assinante ou comprador da revista em bancas, tem
acesso ao portal (para quem compra em bancas, o
acesso vlido por 30 dias).
Se voc assinante, utilize o seu login e senha pes-
soais para acessar o portal. Se voc comprou em
bancas, utilize o login e senha publicados na pgina
do editorial desta edio.
Confira a seguir as ltimas novidades do portal!
Boa leitura e sucesso!
Equipe DevMedia

Brinde na web desta edio

1
Vdeo
Confira no portal ClubeDelphi PLUS um mini-curso sobre criao de um site com
ASP.NET e SQL Server 2005 Express
http://www.devmedia.com.br/articles/listcomp.asp?txtsearch=Delphi+e+SQL+Server+2005+Express

Gostou das vdeo aulas? O portal www.devmedia.com.br possui mais de 2 mil vdeo aulas e dezenas de
cursos online sobre desenvolvimento de software! Agora voc pode comprar as vdeo aulas que preferir e fazer
sua prpria combinao de vdeos! Saiba mais em www.devmedia.com.br/creditos

ltimas Vdeo-Aulas
Aprenda a desenvolver sistemas para o
sistema operacional PalmOS
Acompanhe as aulas de Ricardo Boaro que falam
unicamente do desenvolvimento de aplicaes
para PalmOS utilizando o IDE PocketStudio que
bastante semelhate ao Delphi inclusive utilizan-
do-se de linguagem Pascal.
Curso Aplicao ASP.NET com Delphi e SQL Server
2005 Express-Parte IV a X Testando a classe de
locao de fitas
Veja nessa vdeo aula de Luciano Pimenta as prin-
cipais diferenas de sintaxe para Stored Procedu-
res e Triggers entre FireBird e SQL Server 2005.
Desenvolvendo uma aplicao para PalmOS Construindo uma ferramenta de busca
com PocketStucio - Parte XIII a XV de arquivos Parte I e II
Veja nessas vdeo-aulas de Ricardo Boaro, como traba- Veja nessas vdeos de Paulo Quicoli como desen-
lhar com aplicaes PalmOS com o PocketStudio. volver uma podeorsa ferramenta para busca de
arquivos no disco rgido.
Mini-Curso Controle de Verso com JEDI VCS
Veja nesse mini-curso de Adriano Santos como
trabalhar com esta fabulosa ferramenta para con-
trole de verso e gerenciamento de equipes.
Como construir um WebServices com Delphi 7
Veja nessa vdeo aula de Guinther Pauli como de-
senvolver e trabalhar com WebServices usando o
Delphi 7.
 Ask The Expert
Perguntas e Respostas
Implementando Drag and
Drop na aplicao
Ol Adriano, quando digitamos um
texto no Word, selecionamos e depois
arrastamos para outro programa como o
Bloco de Notas por exemplo, o texto co-
lado. Gostaria de saber se possvel fazer
essa implementao em meu sistema.
Andr Matheus
Ol Andr, respondendo a sua questo:
sim, possvel implementar isso em sua
aplicao, mas o processo um tanto tra-
balhoso. Vejamos como fazer isso.
Primeiramente devemos criar uma srie
de funes capazes de interagir com o
mundo externo, j que possibilitaremos
que o aplicativo receba o valor de um
texto vindo de outro aplicativo. Para isso
abra seu Delphi, salve o projeto e declare
algumas funes na rea Interface da Unit
como segue na Listagem 1.
Pressione Ctrl + Shift + C para que o
Delphi crie o cabealho das funes. Em
seguida digite o cdigo de cada funo
conforme a Listagem 2.
Por fim deemos alterar os eventos On-
Create e OnDestroy do formulrio princi-
pal para se adaptarem s funes criadas.
Veja o cdigo na Listagem 3.
Adicione a Unit ShellApi ao Uses do proje-
to e por fim, insira um componente Memo
na tela e execute o programa. Pra testar,
abra o Word ou WordPad, digite alguma
coisa, selecione e em seguida arraste-o
para o Memo do programa criado. Note
que o texto totalmente copiado.
6 ClubeDelphi - Ask The Expert
+460 vdeo aulas | 6 cursos online
Dvidas respondidas por Adriano Santos
(envie as suas para falecom@adrianosantos.pro.br)
Listagem 1. Declarao de mtodos na seo Private
...
private
{ Private declarations }
function DragEnter(const dataObj: IDataObject;
grfKeyState: Longint; pt: TPoint;
var dwEffect: Longint): HResult; stdcall;
function DragOver(grfKeyState: Longint;
pt: TPoint; var dwEffect: Longint): HResult; stdcall;
function DragLeave: HResult; stdcall;
function Drop(const dataObj: IDataObject;
grfKeyState: Longint; pt: TPoint; var dwEffect: Longint): HResult; stdcall;
function _AddRef: Integer; stdcall;
function _Release: Integer; stdcall;
public
...
Listagem 2. Cdigos dos mtodos para interagir com o mundo externo
function TMemoDragDropFrm.DragEnter(const dataObj:
IDataObject; grfKeyState: Longint; pt: TPoint;
var dwEffect: Longint): HResult;
begin
dwEffect := DROPEFFECT_COPY;
Result := S_OK;
end;
function TMemoDragDropFrm.DragOver(grfKeyState: Longint;
pt: TPoint; var dwEffect: Longint): HResult;
begin
dwEffect := DROPEFFECT_COPY;
Result := S_OK;
end;
function TMemoDragDropFrm.DragLeave: HResult;
begin
Result := S_OK;
end;
function TMemoDragDropFrm._AddRef: Integer;
begin
Result := 1;
end;
function TMemoDragDropFrm._Release: Integer;
begin
Result := 1;
end;
function TMemoDragDropFrm.Drop(const dataObj:
IDataObject; grfKeyState: Longint; pt: TPoint;
var dwEffect: Longint): HResult;
var
aFmtEtc: TFORMATETC;
aStgMed: TSTGMEDIUM;
pData: PChar;
begin
if (dataObj = nil) then
raise Exception.Create(Ponteiro no vlido!);
with aFmtEtc do
begin
cfFormat := CF_TEXT;
ptd := nil;
dwAspect := DVASPECT_CONTENT;
lindex := -1;
tymed := TYMED_HGLOBAL;
end;
OleCheck(dataObj.GetData(aFmtEtc, aStgMed));
try
pData := GlobalLock(aStgMed.hGlobal);
Memo1.Text := pData;
finally
GlobalUnlock(aStgMed.hGlobal);
ReleaseStgMedium(aStgMed);
end;
Result := S_OK;
end;
Mudando fontes do programa de Listagem 3. Cdigo dos eventos OnCreate e OnDestroy
uma s vez procedure TMemoDragDropFrm.FormCreate(Sender: TObject);
Oi, gostaria de mudar todas as fontes begin
OleInitialize(nil);
do meu projeto automaticamente. Como OleCheck(RegisterDragDrop(Handle, Self));
end;
posso fazer isso?
Marcelo Jibas procedure TMemoDragDropFrm.FormDestroy(Sender: TObject);
begin
RevokeDragDrop(Handle);
OleUninitialize;
Ol Marcelo, uma alternativa para isso end;
seria criar uma funo que fizesse o
Listagem 4. Cdigo para modificao de fontes
servio pra ti. Essa funo teria que ser
implementada em todos os formulrios. procedure TForm1.ModificarFontes(AControle:
TWinControl);
Vejamos isso. procedure Modificar(AControle: TControl);
var
Crie um novo projeto no Delphi e na rea f: TFont;
private declare uma nova procedure como begin
if IsPublishedProp(AControle, Parentfont)
segue. and (GetOrdProp(AControle, Parentfont) =
.. Ord(False))
private and IsPublishedProp(AControle, font) then
procedure ModificarFontes( begin
AControle: TWinControl); f := TFont(GetObjectProp(AControle,
public font, TFont));
.. f.Name := Courier New;
end;
end;
Pressione Ctrl + Shift + C para que o var
i: Integer;
Delphi crie o cabealho da funo e em begin
seguida digite o cdigo da Listagem 4. Modificar(AControle);
for i := 0 to AControle.ControlCount - 1 do
No caso estamos fazendo um lao for if AControle.Controls[I] is TWinControl then
ModificarFontes(TWincontrol(AControle.
nos componentes do formulrio atual e Controls[I]))
utilizando os mtodos da Unit TypeInfo, else
Modificar(AControle.Controls[I]);
portanto declare a sua Unit no Uses do end;
Para utilizar a procedure basta incluir alguns controles em tela e em um boto fazer a
projeto. O nome da Unit TypInfo. chamada a ela, com mostrado a seguir:

procedure TForm1.Button1Click(Sender: TObject);

begin
D seu feedback sobre esta edio! Feedback ModificarFontes(Self);
eu
end;
s
D

A Java Magazine tem que ser feita ao seu

sobre e

gosto. Para isso, precisamos saber o que

s

ta
e
voc, leitor, acha da revista!
d i o

D seu voto sobre este artigo, atravs do link:

www.devmedia.com.br/javamagazine/feedback

Edio 94 - ClubeDelphi 7
Seo DELPHI Seo EASY DELPHI
Nesta seo voc encontra artigos intermedirios
sobre Delphi Win32 e Delphi .NET
Streams
Implemente compactao, download em mltiplos pacotes e resources em
suas aplicaes com tcnicas avanadas de Streams Parte 2
Gustavo Chaurais
(gustavoc@macrovision.com)
Borland Delphi 7 Advanced Certified, Borland
Delphi 2005 for Win32 Certified, Borland Del-
phi 2006 for Win32 Certified e Borland Delphi
Instructor Certified. Foi palestrante das trs
ltimas edies da Borland Conference Brasil
e de outros grandes eventos nacionais. Alm
disso, membro da coordenadoria do GIES-
SC. Hoje, ministra cursos, presta consultoria
e atua como Software Engineer do projeto
InstallAnywhere para a empresa norte-ame-
ricana Macrovision Corporation.
8 ClubeDelphi - Streams
Seo PHP
N
a edio anterior, iniciamos a
criao de uma aplicao que
faz uso intensivo de streams
(Edio 93), que implementa compac-
tao, download em mltiplos pacotes
e resources. Desta vez, utilizaremos
um stream temporrio para escrever o
arquivo que estamos lendo. Note que
estamos utilizando GetDestStream e
CleanDestStream para isso (veja ltima
listagem da edio anterior). Portanto,
poderemos estender essa classe futura-
mente para gerar a sada em um stream
qualquer, no s em arquivos. Seguem
suas implementaes (no se esquea da
diretiva virtual neles. Veja na Listagem 1
a implementao das funes GetDestS-
tream e CleanDestStream.
Seu funcionamento tambm bsico:
descartamos do arquivo Index 1 entra-
das para posicionar o cursor do stream
de leitura; depois lemos o tamanho do
nome, o nome e o tamanho do arquivo,
tambm para posicionar o cursor; e,
finalmente, lemos o contedo do arqui-
vo atravs de um CopyFrom do stream
temporrio.
Na Listagem 2 podemos ver a imple-
mentao de outro mtodo importante,
ReadEntry. Estamos apenas lendo uma
entrada e descartando-a caso WriteResult
seja false. Para finalizar, vejamos o mto-
do Delete descrito na Listagem 3.
Este provavelmente o mtodo mais
complicado da classe. Vamos precisar
de um stream temporrio que ser, na
verdade, o mesmo arquivo final, s que
sem o arquivo deletado. Tivemos de fazer
isso porque, ao deletarmos o arquivo no
mesmo stream, depois no conseguimos
reduzir o seu size para o tamanho novo
(menor). Esse o comportamento padro
de um TCompressionStream.
O primeiro passo ser ento copiar
para este arquivo novo todas as entradas
at a de nmero Index (ReadEntry(True)).
D e p o i s ig n ora mo s u m a e nt rad a
(ReadEntry(False)) e copiamos o resto do

arquivo (CopyEntireStream). Em seguida,
substitumos o arquivo final atual pelo
novo e repopulamos as entradas, pois
estas foram modificadas.
Pronto. Isso tudo o que precisvamos
para termos uma classe totalmente fun-
cional com compactao para mltiplos
arquivos. Agora precisamos construir
uma interface com o usurio.
Criando um exemplo completo de
compactao
No projeto atual, voc deve ter ignora-
do o Form padro, gerado pelo Delphi.
Agora, volte a ele, mude seu nome para
fmCompression e adicione um com-
ponente TToolBar. A este, adicione cinco
TToolButtons (tbNew, tbOpen, tbA-
dd, tbRemove e tbExtract). Adicione
tambm um TDBGrid(dbgEntries),
um TClientDataSet (cdsEnt r ies),
um TDataSource (dsEntries), dois
TOpenDialogs(OpenDialog e AddFile-
Dialog) e um TSaveDialog(SaveDialog).
Opcionalmente, adicione um TImageList
para adicionar imagens ao TToolBar.
Configure dbgEntries, apontando-o
para dsEntries e este para o cdsEntries.
Na propriedade Options de dbgEntries,
acrescente dgMultiSelect. Adicione o
seguinte filtro aos componentes Open-
Dialog e SaveDialog: ClubeDelphi Zip
File (*.cdz)|*.cdz. Seu filtro inicial deve
ser configurado para *.cdz. D tambm
um ttulo aos dilogos. Adicione a opo
ofAllowMultiSelect propriedade Options
do componente AddFileDialog.
Abra o Fields Editor do componente cd-
sEntries e adicione os seguintes campos:
PATH (string - size: 256), FILE_SIZE
(largeint) e ENTRY_INDEX (integer - visi-
ble: False). Agora clique com o boto direito
em cdsEntries e selecione Create DataSet.
O componente cdsEntries armazenar
as entradas do TCompressor. Estamos
utilizando um TClientDataSet com dados
em memria pela facilidade em se tra-
balhar com os dados e com o TDBGrid.
Opcionalmente, voc pode configurar
a propriedade IndexFieldNames do cd-
sEntries para PATH para ordenar as
entradas por este campo. Posicione os
componentes conforme a Figura 1.
Antes da implementao de qualquer
evento, declare FCompressor (TCompressor)
EXPERT
Listagem 1. Mtodos GetDestStream e CleanDestStream
function TCompressor.GetDestStream(const DestFilePath:
string): TStream;
begin
Result := TFileStream.Create(DestFilePath, fmCreate);
end;
procedure TCompressor.CleanDestStream(const DestStream: TStream);
begin
DestStream.Free;
end;
Listagem 2. Mtodo ReadEntry
procedure TCompressor.ReadEntry(WriteResult: Boolean);
var
Buffer: TBuffer;
NameLength: Integer;
begin
FStreamRead.Read(Buffer, 4);
if WriteResult then
FStreamWrite.Write(Buffer, 4);
NameLength := BinToInt(CopyFromBuffer(Buffer, 4));
FStreamRead.Read(Buffer, NameLength);
if WriteResult then
FStreamWrite.Write(Buffer, NameLength);
FStreamRead.Read(Buffer, 8);
if WriteResult then
FStreamWrite.Write(Buffer, 8);
ReadFile(BinToInt64(CopyFromBuffer(Buffer, 8)), WriteResult);
end;
Listagem 3. Mtodo Delete
procedure TCompressor.Delete(Index: Integer);
var
i: Integer;
ATempStream: TFileStream;
begin
RestartStream(fmOpenRead);
try
ATempStream := TFileStream.Create(FFilePath + .tmp, fmCreate);
try
FStreamWrite := TCompressionStream.Create(clMax, ATempStream);
FStreamRead := TDecompressionStream.Create(FInternalStream);
for i := 0 to Index - 1 do
ReadEntry(True);
ReadEntry(False);
CopyEntireStream;
finally
CloseStreams;
ATempStream.Free;
end;
finally
CloseStreams;
end;
DeleteFile(FFilePath);
RenameFile(FFilePath + .tmp, FFilePath);
RestartStream(fmOpenRead);
FStreamRead := TDecompressionStream.Create(FInternalStream);
try
PopulateEntries;
finally
CloseStreams;
end;
end;
na seo private da classe TfmCompression ser implementado da mesma maneira.
e vamos implementao do mtodo Re- Porm, troque SaveDialog por OpenDia-
loadEntries conforme a Listagem 4. log e de True para False na construo
Este mtodo muito simples, estamos de FCompressor. Agora, uma vez criado
apagando os dados de cdsEntries e adi- FCompressor, necessrio destru-lo. Fa-
cionando a ele todas as entradas do com- remos isso atravs do evento OnDestroy
pressor. Alm de estarmos controlando do formulrio:
a atualizao do dbgEntries atravs dos
if Assigned(FCompressor) then
mtodos DisableControls e EnableControls. FreeAndNil(FCompressor);
Vamos implementar as operaes New
e Open. Para isto, manipule o evento Finalmente, vamos as outras operaes.
OnClick do boto tbNew de acordo com Comecemos pelo Add. Portanto manipu-
a Listagem 5. le o evento do boto tbAdd seguindo a
O evento OnClick do boto tbOpen deve codificao prevista na Listagem 6.
Edio 94 - ClubeDelphi 9
 Mais um mtodo bastante simples, no
Listagem 4. Cdigo do mtodo ReloadEntries
qual passamos ao FCompressor todos os
procedure TfmCompression.ReloadEntries;
var arquivos a serem adicionados. Para a
i: Integer; operao de Extract, implemente o evento
Entry: TCompressionEntry;
begin OnClick do boto tbExtract (Listagem 7)
cdsEntries.DisableControls;
cdsEntries.EmptyDataSet; A funo SelectDirectory no muito
try
for i := 0 to FCompressor.EntriesCount - 1 do
conhecida. Esta serve para que o usu-
begin rio possa selecionar um diretrio,
Entry := FCompressor.Entries[i];
como um dilogo qualquer. Passamos
cdsEntries.Append;
cdsEntriesPATH.AsString := Entry.Path; o Caption, o diretrio inicial e para
cdsEntriesFILE_SIZE.AsLargeInt := Entry.
FileSize;
onde enviar o diretrio selecionado.
cdsEntriesENTRY_INDEX.AsInteger := i; Ento, para cada linha selecionada no
cdsEntries.Post;
end; dbgEntries estamos chamando o m-
finally
cdsEntries.EnableControls; todo Extract do compressor passando
end;
end;
o Index da entrada, armazenado no
mtodo ReloadEntries.
Listagem 5. Cdigo do boto Novo Novamente, o caso mais complicado.
procedure TfmCompression.tbNewClick(Sender: TObject); Manipule o evento OnClick do boto tbDe-
var
AFileName: string;
lete para usando o cdigo da Listagem 8.
begin Para entender o cdigo anterior, preci-
if SaveDialog.Execute then
begin samos pensar em uma operao na qual
AFileName := SaveDialog.FileName;
if Assigned(FCompressor) then esto sendo removidos vrios registros
FCompressor.Free; de uma coleo. Caso removamos um
FCompressor := TCompressor.Create(AFileName,True);
Caption := ExtractFileName(AFileName); registro e, posteriormente, tentemos re-
ReloadEntries;
end; mover outro de ndice maior, o segundo
end;
registro estar sendo removido de ma-
neira incorreta. Portanto, vamos fazer a
operao pegando do maior ndice a ser
removido para o menor.
Por facilidade, vamos utilizar um
TStringList para armazenar os ndices.
A primeira tarefa ento alimentar o
TStringList com os ndices das entradas a
serem removidas. A segunda compreen-
de procurar o prximo ndice mais alto
da lista, guard-lo e salvar sua posio
na coleo de ndices. Aps isso, deleta-
mos a entrada e a exclumos da coleo.
Quando todos os registros forem remo-
vidos, simplesmente carregamos todas
as entradas novamente.
Pronto. Nossa verso simplificada do
WinZip para trabalhar com arquivos .cdz
est pronta para ser utilizada. Voc pode
agora tentar adicionar outros recursos
como criptografia ao seu arquivo com-
pactado. Alm disso, como criamos uma
Figura 1. Interface grfica do projeto Compression classe, voc pode embutir essa ferramen-
ta em sua aplicao para transportar
arquivos com mais facilidade.

Trabalhando com Resources

Todo programa Windows de interface
grfica apresenta uma srie de recursos que
no so apenas cdigo compilado, como:

10 ClubeDelphi - Streams
 EXPERT

cones, cursores, sons, imagens, dentre Listagem 6. Cdigo do boto Add

outros. O prprio Windows nos permite procedure TfmCompression.tbAddClick(Sender: TObject);
inserir, em nossos executveis, qualquer var
i: Integer;
tipo de arquivo. Estes podem ser compila- Entry: TCompressionEntry;
begin
dos em arquivos de recursos (.RES) e ento cdsEntries.DisableControls;
try
embutidos em uma aplicao. if AddFileDialog.Execute then
Esta a receita de bolo para a utilizao begin
for i := 0 to AddFileDialog.Files.Count - 1 do
de arquivos de recursos: begin
Entry := FCompressor.Add(AddFileDialog.
1. Criamos um arquivo .RC, referencian- Files[i]);
cdsEntries.Append;
do os arquivos que iro constar no .RES; cdsEntriesPATH.AsString := Entry.Path;
2. Compilamos o arquivo .RC para .RES; cdsEntriesFILE_SIZE.AsLargeInt := Entry.
FileSize;
3. No Delphi, utilizamos a diretiva {$R cdsEntriesENTRY_INDEX.AsInteger := FCompressor.
EntriesCount - 1;
Arquivo.RES} para importar o arquivo cdsEntries.Post;
end;
de recursos; end;
4. Fazemos uso da classe TResourceStre- finally
cdsEntries.EnableControls;
am para a leitura dos arquivos. end;
end;

Nosso primeiro exemplo um clssico Listagem 7. Cdigo do boto de extrao

da customizao dos recursos de uma procedure TfmCompression.tbExtractClick(Sender: TObject);
aplicao. Certamente, se nunca utilizou, var
ExtractTo: string;
ir utiliz-lo um dia em sua aplicao. i: Integer;
begin
muito comum fazermos uso de biblio- if SelectDirectory(Extract to, c:\, ExtractTo)
then
tecas externas ao nosso programa. Con- begin
cdsEntries.DisableControls;
tudo, o fato de termos de distribu-las try
junto ao nosso executvel nos incomoda for i := 0 to dbgEntries.SelectedRows.Count-1 do
begin
bastante. Portanto, vamos inclu-las em cdsEntries.GotoBookmark(Pointer(dbgEntries.
SelectedRows.Items[i]));
nossa aplicao. Deste modo, podera- FCompressor.Extract(cdsEntriesENTRY_INDEX.
AsInteger, ExtractTo);
mos embutir tambm o executvel final end;
finally
e extrair todos eles antes da execuo cdsEntries.EnableControls;
propriamente dita. end;
end;
Crie (com o prprio bloco de notas) um end;

arquivo com a extenso .RC no disco

Listagem 8. Cdigo para remoo de arquivo
(por exemplo: Recursos.RC na pasta da
aplicao). Seu contedo ficaria parecido procedure TfmCompression.tbRemoveClick(Sender: TObject);
var
com o seguinte: i: Integer;
ToRemove: TStrings;
EntryIndexToRemove, iToRemove: Integer;
DLL DLLFILE caminho_para_biblioteca.dll begin
cdsEntries.DisableControls;
ToRemove := TStringList.Create;
A primeira coluna contm a chave que try
identificar o arquivo como recurso e for i := 0 to dbgEntries.SelectedRows.Count-1 do
begin
poder ser representada por qualquer cdsEntries.GotoBookmark(Pointer(dbgEntries.
SelectedRows.Items[i]));
palavra. A segunda coluna contm o ToRemove.Add(cdsEntriesENTRY_INDEX.AsString);
end;
tipo de arquivo. Os mais comuns so: while ToRemove.Count > 0 do
begin
BITMAP, ICON, CURSOR, JPEG, WAVE, EntryIndexToRemove := -1;
TEXT e RCDATA (genrico). A terceira iToRemove := -1;
for i := 0 to ToRemove.Count - 1 do
coluna contm o caminho (absoluto ou begin
if StrToInt(ToRemove[i])>EntryIndexToRemove
relativo) para o arquivo. Lembre-se de then
begin
que inmeras linhas (entradas) podem iToRemove := i;
ser adicionadas ao arquivo .RC. Aponte EntryIndexToRemove := StrToInt(ToRemove[i]);
end;
para qualquer biblioteca em seu sistema end;
FCompressor.Delete(EntryIndexToRemove);
para testar. ToRemove.Delete(iToRemove);
end;
Com o fonte .RC pronto, devemos finally
cdsEntries.EnableControls;
compil-lo para um .RES. Para isso, voc ToRemove.Free;
pode utilizar o programa BRCC32.exe, na end;
ReloadEntries;
pasta bin do Delphi. Abra uma linha de end;

comando e digite:

Edio 94 - ClubeDelphi 11
[caminho para a pasta bin]\brcc32.exe
[arquivo .RC]
Na pasta atual ser gerado um arquivo
.RES com o mesmo nome de seu fonte
.RC. Crie um novo projeto e salve-o
como ResourceDLL.dpr. Na unit do
formulrio principal, digite:
{$R caminho_para_o_arquivo_de_recurso_
compilado.RES}
Adicione um boto ao formulrio e
implemente seu evento OnClick igual a
Listagem 9. Inicie o programa e clique no
boto. A DLL ser extrada para a mesma
pasta, com o nome extracted.dll.
Relembrando o conceito de streams do
incio do artigo, finalmente fechamos as
principais classes que o assunto abran-
Listagem 9. Cdigo do boto de extrao dos recursos
procedure TForm1.Button1Click(Sender: TObject);
var
Stream: TResourceStream;
const
EXTRACTED_DLL_NAME = extracted.dll;
begin
Stream := TResourceStream.Create(HInstance, DLL,
DLLFILE);
try
Stream.SaveToFile(EXTRACTED_DLL_NAME);
MessageDlg(Arquivo extrado para: +
IncludeTrailingPathDelimiter(ExtractFilePath(
Application.ExeName)) + EXTRACTED_DLL_NAME,
mtInformation, [mbOk], 0);
finally
FreeAndNil(Stream);
end;
end;
Figura 2. Simple Resource Editor
12 ClubeDelphi - Streams
ge. O TResourceStream muito parecido
com o TMemoryStream e necessita de
trs parmetros para sua construo. O
primeiro o HModule, ou seja, o handle
do mdulo retornado no carregamento
de uma aplicao/DLL. No caso, o ar-
quivo de recursos foi compilado junto
aplicao corrente, portanto, utiliza-
remos HInstance. No caso de querermos
carregar recursos de outras aplicaes
passaramos o HModule da aplicao
desejada. O segundo parmetro a cha-
ve que identifica o recurso, informada
no .RC. E o terceiro o tipo de recurso,
tambm informado no .RC.
A classe TResourceStream, bem como
o TMemoryStream, herdam de TCustom-
MemoryStream. Esta ltima introduz dois
mtodos especiais: SaveToFile e SaveToS-
tream. Isso muito til porque no preci-
samos de um TFileStream para salvar seu
contedo. O mtodo SaveToFile j faz isso
para ns. E esta a operao presente em
nosso exemplo. Estamos simplesmente
criando o stream e chamando seu mtodo
SaveToFile. Muito simples, no?
Como dica, podemos utilizar o plug-in
Simple Resource Editor (Figura 2), de minha
autoria, para a manipulao dos arqui-
vos .RC. Com ele voc pode facilmente
adicionar novos arquivos (buscando-os
por dilogos especiais), compilar para
arquivos .RES, dentre outras funciona-
lidades bastante teis. O assistente lhe
ajuda inclusive a, rapidamente, selecio-
nar o tipo de recurso a ser adicionado.
Seu download pode ser feito atravs
do CodeCentral da CodeGear (cc.codegear.
com), procurando-se pelo autor Gustavo
Chaurais. Seu cdigo fonte est incluso e
muito interessante para estudo.
www.devmedia.com.br/clubedelphi/portal.asp
Acesse agora o mesmo o portal do assinante ClubeDelphi e assista a uma
vdeo aula de Adriano Santos que mostra como trabalhar com o plug-in
Simple Resource Editor.
www.devmedia.com.br/articles/viewcomp.asp?comp=5476&hl=
Vamos agora misturar um pouco as
coisas. Construiremos um exemplo que
utilizar um arquivo comprimido atra-
vs do exemplo Compression.
Crie um novo projeto e salve-o como
ResourceZip.dpr. Adicione a ele uma nova
Unit e salve-a como ResCompressor.pas.
Adicione tambm a Unit Compressor.pas,
construda anteriormente.
Na seo Uses de ResCompressor, insira:
Compressor, Classes, SysUtils e Windows.
Agora, declare uma classe TResCompres-
sor, estendendo TCompressor. Declare e
implemente o seguinte mtodo (com a
diretiva reintroduce):
constructor TResCompressor.Create(const
ResName:
string);
begin
FResName := ResName;
inherited Create(, False);
end;
E declare FResName na seo private
como sendo do tipo string. Declare tam-
bm e implemente o seguinte mtodo:

procedure TResCompressor.
ExtractToStream(Index:
Integer; const ExtractTo: TStream);
begin
FDestStream := ExtractTo;
inherited Extract(Index, );
end;
Adicione tambm FDestStream seo
private da classe. Este mtodo ser utili-
zado para extrairmos um resource para
um stream qualquer.
Voc se lembra dos trs mtodos
virtuais da classe TCompressor? Pois,
tenha certeza de que no esto na seo
private da classe TCompressor (devem
estar preferencialmente em protected) e
redeclare-os na classe TResCompressor
com a diretiva override. O atributo de
TCompressor, FInternalStream, tambm
deve ser colocado preferencialmente na
sua seo protected.
O mtodo RestartStream deve ser utili-
zado para a inicializao do stream inter-
no. Portanto, o inicializaremos como um
TResourceStream conforme segue:
procedure TResCompressor.RestartStream(
Mode: Word);
begin
FInternalStream := TResourceStream.Create(
HInstance, FResName, RT_RCDATA);
end;
O mtodo GetDestStream utilizado para
a inicializao de uma string onde ser
gravado o arquivo extrado. Neste caso,
quando for chamado o mtodo Extract-
ToStream, o stream desejado ser gravado
localmente em FDestStream. Podemos
ento simplesmente retorn-lo. Veja:
function TResCompressor.GetDestStream(const
DestFilePath: string): TStream;
begin
Result := FDestStream;
end;
E, uma vez que o stream veio de fora para
o ExtractToStream, no nossa responsa-
bilidade limp-lo. Provavelmente, quem
chamou o mtodo vai querer ler o que foi
extrado. Portanto, o mtodo CleanDestS-
tream ficar vazio. Note a seguir:
procedure TResCompressor.
CleanDestStream(const
DestStream: TStream);
begin
end;
Para fechar esta classe, voc pode, op-
cionalmente, disparar uma exceo caso
sejam chamados os mtodos Add, Delete
e Extract. Para tanto, declare-os como
virtual na classe TCompressor e override
na classe TResCompressor.
EXPERT
Agora, vamos construir nosso arquivo E, se voc ainda no cansou de exem-
de recursos. Abra o programa Compres- plos, vamos finalizar com um muito
sion e crie um arquivo contendo algumas pouco conhecido: como alterar resources
figuras do tipo jpg. Crie um arquivo .RC de outras aplicaes.
e adicione a ele a seguinte linha: Ainda no exemplo anterior, adicione a
seguinte linha na seo Interface da Unit
IMAGESZIP RCDATA caminho_para_arquivo_
compactado.cdz do formulrio:
resourcestring
Compile o .RC para um .RES e o refe- TITLE = not changed;
rencie no formulrio principal, atravs da
diretiva {$R Arquivo.RES}. Adicione ao for- Resource Strings so como constantes. No
mulrio principal da aplicao um TPaint- entanto, podemos modificar seu contedo
Box (aba System). Na sua Unit, insira jpeg na utilizando programas que alterem resour-
seo Uses e manipule o evento OnCreate ces como o Resource Hacker ou o Workshop
digitando o cdigo da Listagem 10. Editor. Essas so muito utilizadas em
O que este mtodo est fazendo se programas que desejamos internaciona-
refere criao de um TResCompressor, lizar, pois podemos alterar seu contedo
o qual ir carregar o .RES, contendo o para outra lngua sem ter de recompilar a
arquivo das figuras compactado. Aps aplicao toda. Adicione como primeira
sua abertura, podemos chamar seu linha do manipulador do evento OnCreate
mtodo ExtractToStream passando um do formulrio o seguinte:
ndice aleatrio. Finalmente, carregamos
Caption := TITLE;
figura em FJpeg (declare-a na classe do
formulrio). Utilizamos um TMemoryS- Crie um novo projeto e salve-o como
tream para carreg-la. Agora, no evento ResourceUpdate.dpr. No formulrio
OnPaint do TPaintBox, implemente o principal, adicione: trs TLabel, trs
cdigo seguinte. TEdit(edProgram, edResKey e edVa-
lue), trs TButton(btList, btRCDATA
procedure TForm1.PaintBox1Paint(Sender:
TObject); e btString) e um TMemo(mmList).
begin
if Assigned(FJpeg) then Posicione os componentes e configure
PaintBox1.Canvas.Draw(0, 0, FJpeg);
end;
seus Captions conforme a Figura 3.
Vamos iniciar pela listagem dos re-
Pronto. Agora, toda vez que voc entrar cursos. Implemente o tratamento para
no programa, uma figura aleatria de o evento OnClick do btList observando o
sua lista ser carregada no TPaintBox. cdigo da Listagem 11.
Voc pode utilizar isso no splash screen Estamos, primeiramente, utilizando
de sua aplicao, por exemplo. a funo LoadLibraryEx para carregar
Listagem 10. Cdigo OnCreate do formulrio
procedure TForm1.FormCreate(Sender: TObject);
var
AResCompressor: TResCompressor;
AIndex: Integer;
AMemoryStream: TStream;
begin
AResCompressor := TResCompressor.Create(IMAGESZIP);
try
AMemoryStream := TMemoryStream.Create;
try
Randomize;
AIndex := RandomRange(0, AResCompressor.EntriesCount);
AResCompressor.ExtractToStream(AIndex, AMemoryStream);
AMemoryStream.Position := 0;
FJpeg := TJpegImage.Create;
FJpeg.LoadFromStream(AMemoryStream);
finally
AMemoryStream.Free;
end;
finally
AResCompressor.Free;
end;
end;
Edio 94 - ClubeDelphi 13
 o programa. Esta funo pode ser exe- O mtodo implementado, conforme co-
cutada tanto para bibliotecas quanto mentado, ser chamado para cada recurso
executveis e retorna o handle do m- encontrado. Se o recurso for um RCDATA,
dulo. Aps isso, chamamos o mtodo apenas adicionamos na lista o nome do
EnumResourceNames, uma vez para o recurso. Caso seja um String Table, var-
tipo RCDATA e uma vez para o tipo remos a tabela lendo cada string atravs
STRING. Passamos tambm um pon- do mtodo LoadString. Para pegarmos o
teiro para a funo que ser chamada nome de recurso da tabela, utilizamos a
para cada recurso (@EnumResNames- funo LoWord, pois, nos interessa apenas
Proc) e um ponteiro para a lista de os bytes menos significativos.
strings do mmList. A lista j est pronta para ser preen-
Feito isso, declare (logo acima do m- chida. Voc ver primeiro os recursos
todo recm implementado, sem ser da RCDATA do aplicativo e, depois, os re-
classe TForm1) a funo EnumResNma- cursos do tipo String Table. No segundo
esProc (Listagem 12). caso, aparecer tambm a chave identi-
Quando o recurso for do tipo string, na ficadora de cada string.
verdade, ele ser um StringTable. Essas Agora, declare e implemente o mtodo
tabelas so a maneira que strings so UpdateResourceInProgram (Listagem 13).
adicionadas aos arquivos de recurso. Este o mtodo que ser utilizado
Em cada uma, teremos at 16 strings. para a modificao efetiva dos resources.
Cada string identificado por uma cha- Ele consiste em chamarmos BeginU-
ve prpria, que calculada da seguinte pdateResource para iniciar a alterao, o
forma: ([NOME DO RECURSO] 1) * qual nos retorna o Handle do programa.
16. Posteriormente, podemos utilizar a Se a alterao for do tipo RCDATA,
funo LoadString passando esta chave iniciamos um stream para a leitura do
Figura 3. Interface do exemplo ResourceUpdate para lermos cada string. arquivo que ir substituir o recurso
atual; reservamos memria para todo
este valor (note que o arquivo ser
Listagem 11. Cdigo do evento OnClick do boto btList totalmente carregado em memria);
procedure TForm1.btListClick(Sender: TObject);
lemos o arquivo no buffer e, por fim,
var chamamos UpdateResource. Este o
AHandle: THandle;
begin mtodo que ir modificar o recurso e,
mmList.Clear;
AHandle := LoadLibraryEx(PChar(edProgram.Text), 0, LOAD_LIBRARY_AS_DATAFILE); para ele, devemos passar: o Handle da
try aplicao a modificar, o tipo de recur-
mmList.Lines.Add(RCDATA RESOURCES);
EnumResourceNames(AHandle, RT_RCDATA, @EnumResNamesProc, Integer(mmList.Lines)); so, o nome do recurso ( interessante
mmList.Lines.Add();
mmList.Lines.Add(STRING TABLES); utilizar a funo MakeIntResource para
EnumResourceNames(AHandle, RT_STRING, @EnumResNamesProc, Integer(mmList.Lines));
finally a formatao do valor), a linguagem do
FreeLibrary(AHandle); recurso (0 = Neutral), o buffer com os
end;
end; bytes e o tamanho a ser gravado.
Caso estejamos interessados na altera-
Listagem 12. Funo EnumResNamesProc
o de uma string, chamamos o mtodo a
function EnumResNamesProc(Module: HMODULE; ResType, ResName: PChar; ser implementado GetStringTable e grava-
Strings: TStrings): Boolean; stdcall;
var mos, agora, toda a String Table novamente
InitialString, i: Integer;
Buffer: array[0..1023] of Char; na posio correta (retornada por GetRes-
begin
if ResType = RT_STRING then NameOfStrId. Para aplicar as atualizaes,
begin chamamos EndUpdateResource.
InitialString:=(LoWord(Cardinal(ResName))-1) * 16;
for i := 0 to 15 do Finalmente, implemente os mtodos
begin
if LoadString(Module,InitialString+i, relacionados construo do String Table
Buffer,1024) <> 0 then
Strings.Add(> + IntToStr(InitialString + i)
conforme a Listagem 14.
+ - + string(Buffer)); Para a montagem do String Table,
end;
end necessrio lermos todas as strings
else if ResType = RT_RCDATA then
begin novamente, adicionando-as na tabela
Strings.Add(> + ResName);
end;
e alterando somente a string desejada.
Result := True; Perceba que as strings esto presentes
end;
na tabela da seguinte forma: [LENG-

14 ClubeDelphi - Streams
 EXPERT

TH][STRING]. O clculo da posio

Listagem 13. Mtodo UpdateResourceInProgram
inicial feito com base no nome do
procedure TForm1.UpdateResourceInProgram(const recurso correspondente String Table
ResType: PChar);
var em questo. J o Offset representa a
TempStream: TStream;
ResHandle: THandle; posio da string a ser alterada na
Buffer: PChar;
StringTable: WideString; tabela. Para finalizar, devemos gerar
begin o mesmo nmero de caracteres nulos
ResHandle := BeginUpdateResource(PChar(
edProgram.Text), False); correspondentes ao tamanho gerado.
try
if ResType = RT_RCDATA then Assim, fechamos a construo de um
begin
TempStream := TFileStream.Create(
String Table completo. J o mtodo Ge-
edValue.Text, fmOpenRead); tResNameOfStrId um simples clculo
try
GetMem(Buffer, TempStream.Size); para se saber o resource name do String
TempStream.Read(Buffer^, TempStream.Size);
UpdateResource(ResHandle, RT_RCDATA, Table com base no id de um string.
MakeIntResource(edResKey.Text), 0,
Buffer, TempStream.Size);
Teste seu programa apontando para o
finally executvel anteriormente criado Resour-
TempStream.Free;
end; ceZip.exe e clicando em btList. Voc ver a
FreeMem(Buffer); lista com os recursos do programa. Para
end
else if ResType = RT_STRING then
alterar um string, coloque no segundo
begin TEdit o id da string (copie da lista) e d
StringTable := GetStringTable(StrToInt(
edResKey.Text), edValue.Text); um novo valor. Por exemplo, procure
UpdateResource(ResHandle, RT_STRING,
MakeIntResource(GetResNameOfStrId(StrToInt( por not changed, correspondente ao
edResKey.Text))), 0, PWideChar(StringTable), resourcestring anteriormente adicionado,
Length(StringTable));
end; mude seu valor e execute o programa.
finally
EndUpdateResource(ResHandle, False); Voc ver que a string foi modificada
end;
end; com sucesso, atravs da barra de ttu-
los. Gere tambm outro arquivo .cdz
Listagem 14. Implementao dos mtodos GetStringTable e GetResNameOfStrId com diferentes figuras jpeg e faa uma
function TForm1.GetStringTable(StrId: Integer; const modificao apontando para o nome do
NewValue: string): WideString;
var recurso (IMAGESZIP) e para o caminho
ResName: Integer; ao arquivo .cdz. Abra o programa e voc
Offset: Integer;
StartPos: Integer; ver as imagens novas.
i: Integer;
AHandle: THandle;
Buffer: array[0..1023] of Char;
StrRead: string; Concluso
begin Por mais que achemos que sabemos
ResName := GetResNameOfStrId(StrId);
Offset := StrId mod 16; tudo, sempre h algo para aprender.
StartPos := (ResName - 1) * 16;
Result := ; Streams no so um contedo difcil,
AHandle := LoadLibraryEx(PChar(edProgram.Text), 0,
LOAD_LIBRARY_AS_DATAFILE);
porm, necessitam ser exercitados. Alm
try disso, aumentamos um pouco mais
for i := 0 to 15 do
begin nosso arsenal de possibilidades, com
if i = Offset then
begin a utilizao de poderosos compactado-
Result := Result + Char(Length(NewValue)) +
NewValue;
res de arquivos e arquivos de recurso
end bastante flexveis. Agora, s esperar a
else
begin oportunidade certa para aplicar o que foi
if LoadString(AHandle, StartPos + i, Buffer,
1024) <> 0 then explicado em um cenrio real.
begin
StrRead := string(Buffer);
Result := Result + Char(Length(StrRead)) +
StrRead;
end;
end;
end; D seu feedback sobre esta edio! Feedback
eu
s

Result:= Result + StringOfChar(#0,Length(Result));

D

finally
A Java Magazine tem que ser feita ao seu
sobre e

FreeLibrary(AHandle);
end; gosto. Para isso, precisamos saber o que
s

end;
ta
edio
function TForm1.GetResNameOfStrId(StrId: voc, leitor, acha da revista!
Integer): Integer;
begin D seu voto sobre este artigo, atravs do link:
Result := (StrId div 16) + 1;
end;
www.devmedia.com.br/javamagazine/feedback

Edio 94 - ClubeDelphi 15
Seo DELPHI Seo EASY DELPHI
Nesta seo voc encontra artigos intermedirios
sobre Delphi Win32 e Delphi .NET
Anlise de Pontos de Funo
Saiba mensurar o tamanho de seu software e estimar o tempo que levar
para ficar pronto
Carmo Crdiney de Melo
(carmo@jfnet.com.br)
Possui experincia desde 1990 em Tecnolo-
gia da Informao. Bacharel em Sistemas de
Informao pela Faculdade Metodista Gran-
bery (FMG). Acumula sete anos de estudos
acadmicos na rea de tecnologia e na rea
de Gesto de Projetos. Possui capacitao em
Rational Unified Process (RUP), Arquitetura
J2EE, Linux, Gesto de Projeto de Tecnologia e
Anlise de Pontos de Funo.
Marco Antnio Pereira Arajo
(maraujo@granbery.edu.br)
Professor do Curso de Bacharelado em Sis-
temas de Informao da Faculdade Metodista
Granbery, Doutorando e Mestre em Engenharia
de Sistemas e Computao pela COPPE/UFRJ,
Especialista em Mtodos Estatsticos Compu-
tacionais e Bacharel em Matemtica com Ha-
bilitao em Informtica pela UFJF, Analista de
Sistemas da Prefeitura de Juiz de Fora.
16 ClubeDelphi - Anlise de Pontos de Funo
Seo PHP
U
m dos grandes desafios atual-
mente em projetos de software
garantir que estimativas de
tamanho, custo e cronograma sejam
realistas, tanto em projetos de desen-
volvimento quanto de manuteno.
Entretanto, as crescentes necessidades
dos usurios, a alta complexidade e
baixo entendimento do domnio das
aplicaes a serem construdas, aliadas
s constantes mudanas tecnolgicas, para planejar as suas iteraes, prever o
promovem um alto grau de incerteza
nas estimativas para o cumprimento das
metas estabelecidas.
Como resultado, os desenvolvedores tm
enfrentado problemas de subestimativas,
culminando em atrasos no cronograma e
descumprimento de oramentos. Por outro
lado, entende-se que os usurios tambm
precisam de respostas rpidas em relao
ao tempo e custos envolvidos em projetos
de software. No sentido de obter estima-
tivas mais confiveis, necessita-se lanar
mo de tcnicas especficas para esse fim,
como a Anlise de Pontos de Funo (do
ingls FPA - Function Point Analysis).
Dessa forma, pode-se estimar o tama-
nho das funcionalidades de um sistema
e, em funo disso, definir o tempo
e recursos para o projeto em questo
com base na produtividade da equipe
ou na taxa de entrega de projetos se-
melhantes. Essas estimativas definidas
no incio do projeto so determinantes
custo e elaborar o oramento detalhado
do projeto, minimizando os riscos que
o projeto termine fora do prazo ou do
oramento previsto.
Assim, o objetivo deste artigo descre-
ver como obter o tamanho de sistemas
atravs da tcnica de contagem de Pontos
de Funo, atravs de um prottipo de
interface de uma aplicao de exemplo.
No se tem a pretenso de apresentar
todas as regras de FPA, mas introduzir
os conceitos bsicos para a contagem em
projetos de desenvolvimento.
 EXPERT

O estudo de caso apresentado neste Contagem de Pontos de Funo A partir dessa janela, o sistema deve
artigo relativo contagem de Pontos de A contagem de pontos de funo rea- possibilitar a manuteno no cadastro
Funo de um fragmento de um sistema lizada atravs de um conjunto de passos de cursos contendo cdigo e descrio do
de Controle Acadmico. previamente determinados. Para facilitar mesmo, alm do tipo do curso, que pode
o entendimento desse processo, cada um ser de graduao ou ps-graduao. Para
Introduo anlise de desses passos ser apresentado e aplicado cursos de graduao informa-se tambm
Pontos de Funo a um estudo de caso que demonstrar o nmero de perodos, enquanto que,
A FPA foi desenvolvida em meados da como a contagem pode ser feita. para cursos de ps-graduao, informa-
dcada de 70 na tentativa de minimizar Nesse sentido, o artigo conduzir um se a carga horria (Figura 2).
as dificuldades associadas medio de estudo de caso relacionado ao cadastro Ao final de qualquer dos processos de
tamanho de software atravs de linhas de de cursos e alunos de uma faculdade. O manuteno, o sistema deve emitir uma
cdigo-fonte, alm de prover um mecanis- cadastramento de cursos iniciado pelo mensagem de confirmao ao usurio.
mo que pudesse prever o esforo associado usurio e apresenta uma lista dos cursos Aps o cadastramento de cursos, po-
ao desenvolvimento de software. j cadastrados, permitindo pesquisa a demos matricular os alunos. Da mesma
Em 1984, uma verso mais refinada partir da descrio do curso e oferecendo maneira, existe uma janela de pesquisa
foi lanada e, posteriormente, com o as opes de cadastro relativas incluso, de alunos, praticamente igual de pes-
aumento da utilizao da FPA, tornou- alterao, excluso e consulta (Figura 1). quisa de cursos, exceto que oferece ainda
se necessrio definir um guia que
interpretasse as regras originais para
novos ambientes. Devido a essa neces-
sidade, em 1986 foi criado o Internatio-
nal Function Point Users Group (IFPUG).
No Brasil, esse grupo representado
pelo BFPUG (Brazilian Function Point
Users Group).
O clculo de Pontos de Funo (PF)
segue um conjunto de diretrizes des-
critas no manual de Prticas de Con-
tagem de Pontos de Funo do IFPUG.
Entretanto, divergncias de como
aplicar essas regras fazem com que as
contagens nem sempre resultem num
mesmo valor.
No sentido de criar um mtodo mais
rigoroso nesse processo de contagem,
surgiu a norma ISO/IEC 14143, que
estabelece uma srie de padres para
contagem funcional. Em 2002, a verso
4.1 do manual do IFPUG foi aprovada Figura 1. Janela de pesquisa de cursos
como aderente a essa norma.
Dessa forma, a FPA permite uma con-
tagem indicativa do tamanho do projeto
no incio do seu desenvolvimento, sem
conhecer detalhes de modelos de dados
ou de classes. Posteriormente, na fase de
construo, essa contagem representa
uma estimativa com maior preciso da
complexidade das funes e, ao trmino
da construo do software, na etapa de
transio, realizada uma contagem
detalhada, obtida a partir do grau de
complexidade das funes levantadas
no processo funcional, modelo de dados
ou modelo de classes, descrio de telas
e relatrios. Figura 2. Janela de cadastro de cursos

Edio 94 - ClubeDelphi 17
uma possibilidade de filtrar os alunos
por um curso especfico (Figura 3).
O cadastramento de alunos, tambm
semelhante ao de cursos, possui matr-
cula, nome, dados pessoais (Figura 4),
dados de endereo (Figura 5) e dados
de documentao (Figura 6). Aps o
cadastramento de um aluno, o sistema
dever exibir para o usurio o valor da
mensalidade a ser pago pelo aluno.
Para o clculo da mensalidade, um
valor base utilizado para cada tipo de
curso e considera ainda o nmero de
perodos para cursos de graduao e a
carga horria para cursos de ps-gradu-
ao. Os valores base das mensalidades
so mantidos por um sistema financeiro
e esto fora dos limites dessa aplicao,
sendo consultados por ela.
Para a construo dessas funcionalidades,
ser primeiramente determinado o tama-
nho da aplicao que ser desenvolvida, de
forma a orientar as estimativas de prazo e
Figura 3. Janela de pesquisa de alunos
Figura 4. Janela de Cadastro de Alunos Dados Pessoais
18 ClubeDelphi - Anlise de Pontos de Funo
custo. Assim, para estimar o tamanho do
software de acordo com a FPA, segue-se
um procedimento de contagem, que est
representado no esquema da Figura 7.
A seguir, cada uma dessas atividades
ser descrita e aplicada ao estudo de caso
apresentado.
1) Tipo de Contagem: existem trs tipos
de contagem de pontos de funo. A di-
ferena no procedimento adotado entre
esses tipos de contagem est nas frmulas
aplicadas na contagem. So eles:
Projeto de desenvolvimento: mede todas
as funes que sero entregues com o
projeto em sua primeira verso. o tipo de
contagem que ser utilizada neste artigo;
Projeto de melhoria: mede as funciona-
lidades alteradas, includas e excludas
ao projeto;
Aplicao: mede as funes de uma
aplicao j instalada.
2) Escopo da Contagem: a fronteira
da aplicao. Define as funes que sero
Figura 5. Janela de Cadastro de Alunos Dados de Endereo
Figura 6. Janela de Cadastro de Alunos Dados de Documentao
includas em uma determinada contagem
de pontos de funo. No nosso estudo de
caso, o escopo da contagem restringe-se
s funcionalidades de pesquisa e cadas-
tramento de cursos e alunos, conforme
apresentado anteriormente;
3) Funes de Dado: consiste na con-
tagem dos tipos de dados utilizados
nas funcionalidades a serem desen-
volvidas. Esses tipos de dados podem
ser agrupados em um Arquivo Lgico
Interno (ALI) que representa grupos
de dados relacionados e reconhecidos
pelo usurio, dentro da fronteira da
aplicao; ou um Arquivo de Interface
Externa (AIE) que representa dados
referenc iados pela apl icao mas
mantidos dentro da fronteira de outra
aplicao. No exemplo temos:
ALI: Curso, Aluno
AIE: Mensalidade
Para calcular a complexidade das
funes de dados, deve-se contar o
 EXPERT

nmero de Tipos de Dados (TD) e Tipos para a contagem um nico ALI com dois ALI Aluno de complexidade baixa, pois
de Registros (TR) de cada uma dessas Tipos de Registros. possui um TR e 23 TDs e, por fim, o AIE
funes. Um TD refere-se a um campo Identificados os TDs e TRs, pode-se Mensalidade tambm de complexidade
nico reconhecido pelo usurio, sem calcular a complexidade de cada ALI/AIE baixa, pois possui um TR e dois TDs.
repetio, ou seja, se um campo se re- atravs da Tabela 4. Analisando-a, obser- 4) Funes de Transao: representam os
petir mais de uma vez numa interface, va-se que o ALI Curso de complexidade processos elementares fornecidos pela apli-
conta-se apenas uma vez. baixa, pois possui dois TRs e cinco TDs, o cao ao usurio, onde um processo elemen-
Um TR refere-se a um subgrupo de tipos
de dados, tambm reconhecidos pelo
usurio e componente de um ALI ou AIE.
No exemplo, os TDs esto apresentados
nas Tabelas 1 a 3, representando os arqui-
vos Curso, Aluno e Mensalidade, respec-
tivamente. Como Curso apresenta dois
tipos de registro (cursos de graduao e
de ps-graduao com dados especficos),
considera-se TR igual a 2.
Os demais possuem TR igual a 1. Se os
cursos estivessem divididos em mais de
um arquivo como, por exemplo, um ar-
quivo para cursos de graduao e outros
de ps, mesmo assim, consideraramos

TD Tipo de Dado
1 Cdigo do curso
2 Descrio do curso
3 Tipo do curso (1=Graduao / 2=Ps-Graduao)
4 Quantidade de perodos
5 Carga horria
Tabela 1. Tipos de Dados de Curso

TD Tipo de Dado
1 Matrcula do aluno
2 Nome do aluno
3 Data de nascimento
4 Identificador do curso
5 Ano de incio
6 Semestre de incio
7 Email
8 Telefone residencial
9 Telefone comercial
10 Telefone celular
11 Foto
12 Logradouro
13 Nmero
14 Complemento
15 Bairro
16 Cidade
17 UF
18 CEP
19 CPF
20 Nmero identidade
21 rgo expedidor
22 UF rgo expedidor
23 Data expedio
Tabela 2. Tipos de Dados de Aluno Figura 7. Processo de contagem de pontos de funo.

Edio 94 - ClubeDelphi 19
tar identifica a menor unidade funcional do AR: Para cada ALI lido ou mantido pela
ponto de vista do usurio, e pode ser: aplicao, ou AIE lido, conta-se um;
Entrada Externa (EE): para sua identifi- TD:
cao devem ser analisados todos os pro- - Entrada Externa (EE): contam-se
cessos elementares que processam dados os atributos que so atualizados e
vindos de fora da fronteira da aplicao e determina-se a complexidade conforme
que atualizam um ou mais ALIs; a Tabela 6;
Sada Externa (SE): o processo gera - Sada Externa (SE): contam-se os
dados para fora da fronteira da aplicao, atributos da sada, alm de atributos cal-
tendo por objetivo principal apresentar culados, e determina-se a complexidade
dados ao usurio atravs de lgica de conforme Tabela 7;
processamento que no apenas a recu- - Consulta Externa (CE): em um processo
perao de dados; de entrada de dados, contam-se os atributos
Consulta Externa (CE): processo que de seleo, alm de mensagem ao usurio
envia dados para fora da fronteira da quando for o caso. Em um processo de
aplicao, apresentando dados ao usu- sada de dados, contam-se os atributos de
rio por meio de uma simples recuperao sada. Em processos de entrada e sada,
de informaes de ALI ou AIE. somam-se os dois resultados. Determina-se
No estudo de caso deste artigo, podem- a complexidade conforme a Tabela 7.
se identificar os processos elementares No estudo de caso deste artigo, con-
conforme apresentado na Tabela 5. sideram-se as anlises apresentadas na
As regras para definir a complexidade Tabela 8.
de EE, SE ou CE consideram o nmero de Os processos elementares Listar Cursos
Arquivos Referenciados (AR) e o nmero e Listar Alunos consideraram TD igual a
de Tipo de Dados (TD) utilizados, sendo: dois por ser esse o nmero de atributos
TD Tipo de Dado
1 Tipo do curso (1=Graduao / 2=Ps-Graduao)
2 Valor Base da Mensalidade
Tabela 3. Tipos de Dados de Mensalidade
Tipos de Dados (TD)
Tipos de Registro (TR)
Abaixo de 20 20 a 50 Acima de 50
1 Baixa Baixa
2a5 Baixa Mdia
Acima de 5 Mdia Alta
Tabela 4. Complexidade das funes de dados (ALI e AIE)
Funcionalidade Processo Elementar
Listar Cursos
Pesquisa de Cursos
Pesquisar Curso
Incluir Curso
Alterar Curso
Cadastramento de Cursos Excluir Curso
Consultar Curso
Exibir Mensagem de Curso Cadastrado
Listar Alunos
Pesquisa de Alunos Pesquisar Aluno
Filtrar Alunos por Curso
Incluir Aluno
Alterar Aluno
Excluir Aluno
Cadastramento de Alunos
Consultar Aluno
Exibir Cursos Cadastrados na Caixa de Combinao
Exibir Clculo de Valor da Mensalidade
Tabela 5. Processos Elementares identificados no estudo de caso
20 ClubeDelphi - Anlise de Pontos de Funo
exibidos como resultado na interface
com o usurio. Pesquisar Curso e Pesquisar
Aluno consideram AR igual a um, pois
cada processo obtm informaes de um
nico ALI e TD igual a trs, pois, por ser
um processo de entrada e sada, recebe
o parmetro a ser consultado e exibe os
dados previstos nas respectivas telas de
pesquisa (cdigo e descrio para cursos
e matrcula e nome para alunos).
Filtrar Alunos por Curso considera um AR
a mais por ter que exibir os cursos cadas-
trados. O processo elementar Exibir Men-
sagem de Curso Cadastrado no considera
nenhum AR, pois no obtm informaes
de nenhum ALI ou AIE e considera TD
igual a um em funo da mensagem
exibida. Os processos elementares Incluir,
Alterar, Excluir e Consultar Alunos conside-
ram dois AR por atualizar o ALI Aluno e
obter dados do ALI Curso.
O processo elementar Exibir Clculo de
Valor da Mensalidade considerou AR igual
a um por ler o AIE Mensalidade e TD igual
a dois, em virtude de ler o valor da mensa-
lidade em funo do tipo de curso.
5) Pontos de Funo No Ajustados:
aps identificar as funes de dados e os
processos elementares, multiplica-se o
total de ALI, AIE, EE, SE e CE pelo respec-
tivo valor de ponto de funo da tabela de
complexidade (Tabela 9) para determinar
o valor total que ser o PF no ajustado.
Mdia
A Tabela 10 exibe o resultado final do
Alta
clculo de pontos de funo no ajusta-
Alta
dos para o estudo de caso deste artigo.
6) Valor do Fator de Ajuste: represen-
Tipo ta a influncia de requisitos tcnicos e
CE de qualidade no tamanho do software.
calculado com base em 14 caracters-
CE
EE ticas gerais de um sistema, onde cada
EE uma delas deve ser analisada com re-
EE lao ao seu nvel de influncia sobre
CE o sistema e pontuada de 0 (nenhuma
CE influncia) a 5 (grande influncia).
CE A descrio completa de cada carac-
CE terstica e as tabelas para avaliao dos
CE valores de pontuao, pode ser obtida
EE no manual de Prticas de Contagem
EE de Pontos de Funo do IFPUG. Para
EE este exemplo, as caractersticas foram
CE descritas a seguir, bem como os valores
CE considerados para cada uma delas:
SE 1. Comunicao de Dados: considera se
so utilizados recursos de comunicao
 EXPERT

pela aplicao. Neste exemplo, ser con- Tipos de Dados (TD)

Arquivos Referenciados (AR)
siderado o valor quatro, que relativo Abaixo de 5 5 a 15 Acima de 15
a aplicaes on-line, suportadas por 0 ou 1 Baixa Baixa Mdia
algum protocolo de comunicao; 2 Baixa Mdia Alta
2. Processamento Distribudo: relativo Acima de 2 Mdia Alta Alta
transferncia de dados entre os com- Tabela 6. Complexidade de Entrada Externa (EE)
ponentes da aplicao. Foi considerado
o valor um, uma vez que no realiza Tipos de Dados (TD)
processamento distribudo, fazendo uso Arquivos Referenciados (AR)
Abaixo de 6 6 a 19 Acima de 19
apenas de um sistema de gerenciamento 0 ou 1 Baixa Baixa Mdia
de banco de dados; 2 ou 3 Baixa Mdia Alta
3. Performance: determina como o tempo Acima de 3 Mdia Alta Alta
de resposta influencia a aplicao. Foi con-
Tabela 7. Complexidade de Sada Externa (SE) e Consulta Externa (CE)
siderado zero, uma vez que no foi indicada
nenhuma restrio a esse respeito;
Processo Elementar Tipo AR TD Complexidade
4. Configurao Altamente Utilizada: define
Listar Cursos CE 1 2 Baixa
o nvel de restries impostas pelo usurio.
Pesquisar Curso CE 1 3 Baixa
Tambm foi considerado o valor zero uma
Incluir Curso EE 1 5 Baixa
vez que nenhuma restrio foi imposta;
Alterar Curso EE 1 5 Baixa
5. Volume de Transaes: refere-se ao Excluir Curso EE 1 5 Baixa
volume de informaes processados pela Consultar Curso CE 1 5 Baixa
aplicao. Considerou-se o valor um, Exibir Mensagem de Curso Cadastrado CE 0 1 Baixa
uma vez que previsto um nmero de Listar Alunos CE 1 2 Baixa
transaes mais elevado em alguns pe- Pesquisar Aluno CE 1 3 Baixa
rodos especficos, como a cada perodo Filtrar Alunos por Curso CE 2 3 Baixa
de matrculas de alunos; Incluir Aluno EE 2 23 Alta
6. Entrada de Dados On-line: considera a Alterar Aluno EE 2 23 Alta
quantidade de transaes feitas on-line. Excluir Aluno EE 2 23 Alta
Foi considerado o valor cinco uma vez Consultar Aluno CE 2 23 Alta
que o sistema apresenta todas as transa- Exibir Cursos Cadastrados na Caixa de Combinao CE 1 1 Baixa
es como sendo desse tipo; Exibir Clculo de Valor da Mensalidade SE 1 2 Baixa
7. Eficincia do Usurio Final: refere-se a Tabela 8. Complexidade dos processos elementares identificados no estudo de caso.
facilidades oferecidas ao usurio final,
como ajuda on-line, auxlio navegao Processo Elementar Tipo Complexidade Pontos Funo
por teclas de funo, menus, dentre outros. Curso ALI Baixa 7
Foi considerado o valor um por apresen- Aluno ALI Baixa 7
tar algumas poucas caractersticas desse Mensalidade AIE Baixa 5
tipo, como a exibio dos cursos em caixa Listar Cursos CE Baixa 3
de combinao para facilitar a seleo do Pesquisar Curso CE Baixa 3
usurio no cadastramento de alunos; Incluir Curso EE Baixa 3
8. Atualizao On-line: define se os ar- Alterar Curso EE Baixa 3
quivos lgicos internos so atualizados Excluir Curso EE Baixa 3
on-line. Foi utilizado o valor trs, pois Consultar Curso CE Baixa 3
todos os arquivos internos so atualiza- Exibir Mensagem de Curso Cadastrado CE Baixa 3
dos dessa forma; Listar Alunos CE Baixa 3
9. Complexidade de Processamento: deter- Pesquisar Aluno CE Baixa 3
mina a complexidade de processamento Filtrar Alunos por Curso CE Baixa 3
Incluir Aluno EE Alta 6
Funo Baixa Mdia Alta Alterar Aluno EE Alta 6
Consulta Externa (CE) 3 4 6 Excluir Aluno EE Alta 6
Entrada Externa (EE) 3 4 6 Consultar Aluno CE Alta 6
Sada Externa (SE) 4 5 7 Exibir Cursos Cadastrados na Caixa de Combinao CE Baixa 3
Arquivo de Interface Externa (AIE) 5 7 10 Exibir Clculo de Valor da Mensalidade SE Baixa 4
Arquivo Lgico Interno (ALI) 7 10 15 Total de Pontos de Funo 80
Tabela 9. Contribuio de ponto de funo por complexidade Tabela 10. Identificao dos processos elementares e suas complexidade

Edio 94 - ClubeDelphi 21
das funcionalidades da aplicao. Foi
considerado o valor zero, por ser uma
aplicao bastante simples;
10. Reutilizao: identifica se o cdigo
foi projetado para ser reaproveitado
em outras aplicaes. O valor zero foi
considerado por essa no ter sido uma
preocupao no projeto;
11. Facilidade de Instalao: considera
se existem ferramentas de converso e
instalao da aplicao. Tambm foi con-
siderado o valor zero por essa preocupa-
o no ter sido levada em considerao
no estudo de caso;
12. Facilidade de Operao: considera
aspectos de segurana e recuperao de
informaes. Como isso tambm no foi
considerado, assumido o valor zero;
13. Mltiplos Locais: se a aplicao foi
projetada e desenvolvida para ser utili-
zada em diferentes locais. Essa restrio
tambm no foi considerada e assumido
o valor zero;
14. Facilidade de Mudanas: se a aplicao
foi projetada para facilitar mudanas
na lgica de processamento ou em suas
estruturas de dados. O valor zero foi
utilizado nesse caso.
Somam-se ento essas pontuaes para
obter o nvel total de influncia (TDI Total
Degree of Influence). Da basta aplicar a se-
guinte frmula para obter o valor do fator
de ajuste (VAF Value Adjustment Factor):
Valor do Fator de Ajuste (VAF) =
(TDI x 0,01) + 0,65
No caso do exemplo deste artigo:
VAF = (15 x 0,01) + 0,65 = 0,8
Atualmente esse um passo opcional
do processo de contagem. Muitas orga-
nizaes desconsideram o fator de ajuste
e usam apenas a medio dos pontos de
funo no ajustados. Isso se deve ao
fato de que as caractersticas gerais de
um sistema, apresentadas anteriormen-
te, so consideradas desatualizadas ou
incompletas em relao s tecnologias
atualmente utilizadas, fazendo com que
sua utilidade seja questionada.
Isso fica mais evidenciado quando a
norma ISO/IEC 14143 considera apenas
os pontos de funo no ajustados em
suas estimativas de medio funcional.
7) Pontos de Funo Ajustados: Os PFs
22 ClubeDelphi - Anlise de Pontos de Funo
ajustados so calculados a partir dos PFs
no ajustados multiplicado pelo fator de
ajuste. No caso de processos de desen-
volvimento, funes para converso de
dados tambm devem ser consideradas
e sua complexidade em pontos de fun-
o deve ser adicionada aos pontos de
funo no ajustados.
Assim, a seguinte frmula para proces-
sos de desenvolvimento aplicada:
PF Desenvolvimento = (PF No Ajustado +
PF Converso de Dados) * Fator Ajuste (VAF)
Para o caso do exemplo utilizado, como
no foi considerada a converso de dados:
PF Desenvolvimento = (80 + 0) * 0,8 = 64 PFs
Estimativas de esforo e prazo a partir
da Contagem de Pontos de Funo
Pontos de Funo tm por objetivo a
medio do tamanho funcional de uma
aplicao. Entretanto, no incomum que
desenvolvedores queiram estimar esforo
e prazos a partir do nmero de pontos
de funo. Deve-se tomar cuidado com
essa situao, pois a produtividade de
diferentes equipes de desenvolvimento
pode variar consideravelmente, inclusive
em funo das tecnologias utilizadas.
A falta de conhecimento da produ-
tividade da equipe pode fazer com
que as estimativas de esforo sejam
erradas, sem que pontos de funo
sejam os culpados por isso. Outra si-
tuao preocupante utilizar tabelas
de produtividade por ponto de funo
disponveis na internet, onde os dados
ali apresentados podem no refletir a
capacidade de produo de qualquer
equipe de desenvolvimento e, muitas
vezes, no levam em considerao as
caractersticas de diferentes tecnologias
que podem ser utilizadas.
Portanto, o conhecimento da produti-
vidade de cada equipe fundamental
para estimativas de esforo e prazo a
partir da contagem de pontos de funo.
No estudo de caso deste artigo, vamos
considerar hipoteticamente a situao de
que um ponto de funo desenvolvido
em uma hora de trabalho de um desen-
volvedor (1 homem/hora).
Assim, o esforo para esse projeto,
considerando-se os pontos de funo
ajustados, seria de 64 horas de traba-
lho de um nico desenvolvedor. Outra
situao que merece ateno utilizar
o valor real de produtividade de um de-
senvolvedor, uma vez que dificilmente
algum tem produtividade igual a sua
carga horria total de trabalho.
Neste exemplo hipottico, se considerar-
mos que um desenvolvedor produz cerca
de 35 horas reais por semana, o estudo de
caso deste artigo levaria menos de duas
semanas para ser desenvolvido, se condu-
zido por um nico desenvolvedor.
Concluso
Contagem de Pontos de Funo repre-
senta uma tcnica de clculo do tamanho
de uma aplicao, no de esforo para
seu desenvolvimento. Sua correta utili-
zao, baseada nas regras descritas no
manual de Prticas de Contagem de Pon-
tos de Funo do IFPUG, pode ajudar na
medio da funcionalidade de sistemas
e apoiar estimativas de esforo e prazo
baseadas na produtividade conhecida de
uma equipe de desenvolvimento.
Pode-se ainda encontrar diversas
ferramentas ou planilhas eletrnicas de
diferentes fornecedores para apoiar os
procedimentos de clculo de pontos de
funo de forma a facilitar o processo de
contagem. Este artigo procurou apresen-
tar de forma prtica as principais regras
de contagem de pontos de funo atravs
de um estudo de caso prtico.
Referncias
Site do IFPUG: International Function Point Users Group
www.ifpug.org
Site do BFPUG-Brazilian Function Point Users Group
www.bfpug.com.br
Livro Anlise de Pontos de Funo Medio,Estimativas
e Gerenciamento de Projetos de Software
3. edio, Carlos Eduardo Vazquez, Guilherme Siqueira
Simes e Renato Machado Albert.
Editora rica, 2003.
D seu feedback sobre esta edio! eu
Feedback
s
D
A Java Magazine tem que ser feita ao seu
sobre e
gosto. Para isso, precisamos saber o que
s
ta
e
voc, leitor, acha da revista!
d i o
D seu voto sobre este artigo, atravs do link:
www.devmedia.com.br/javamagazine/feedback
Seo DELPHI Seo EASY DELPHI
Nesta seo voc encontra artigos intermedirios
sobre Delphi Win32 e Delphi .NET
Usando todo o poder do TDataSetProvider
Usufrua de todos os recursos do DataSetProvider em suas aplicaes
Adriano Santos
(falecom@adrianosantos.pro.br)
desenvolvedor Delphi desde 1998. Professor
e programador PHP. Bacharel em Comunicao
Social pela Universidade Cruzeiro do Sul, SP.
Editor Tcnico, Colunista e Membro da Comisso
Editorial da revista ClubeDelphi e WebMobile.
Mantm o blog Delphi to Delphi (www.delphi-
todelphi.blogspot.com) com dicas, informaes
e tudo sobre desenvolvimento Delphi.
24 ClubeDelphi - Usando todo o poder do TDataSetProvider
Seo PHP
S
em dvida nenhuma, um dos
componentes mais poderosos da
VCL o DataSetProvider, que, alm
de prover dados a toda a aplicao,
capaz de auxiliar em uma srie de fun-
cionalidades no sistema.
Veremos o que h de mais i nte-
ressante nesse componente e dicas
avanadas para usufruir ao mximo
de suas propriedades e mtodos. Em
conjunto com os componentes DBEx-
press o DataSetProvider capaz de
realizar inmeras tarefas. Veremos
nesse artigo:
Introduo ao DataSetProvider;
Como usar o UpdateMode e Provi-
derFlags;
Configurando dinamicamente o
UpdateMode e ProviderFlags;
Uso de Constraints;
Criaremos diversos exemplos para
entendermos corretamente cada funcio-
nalidade do DataSetProvider;
Entendendo o DataSetProvider
Basicamente o DataSetProvider respon-
svel por enviar e receber os Data Packets
da aplicao cliente para a o servidor de
dados. Os Data Packets so os pacotes de
dados trafegados na rede em uma aplica-
o duas camadas (two-tier ou client/
server) ou n camadas (n-tier). Toda
e qualquer requisio feita pela aplicao
cliente enviada ao DataSetProvider que
por sua vez se encarrega de solicitar os
dados ao servidor de aplicao. O result
set, ou seja, o resultado da requisio
empacotado (Data Packets) e enviado
de volta aplicao cliente. Qualquer
exceo levantada, seja na requisio ou
no recebimento dos dados, retornada a
aplicao cliente.
Pode-se dizer que a utilizao mais
comum do DataSetProvider feita em
conjunto dos componentes da paleta
DBExpress acrescido do componente
ClientDataSet. Um exemplo de uso pode
ser visto na Figura 1.

O que pouca gente sabe que o Data-
SetProvider pode se tornar mais do que
um simples componente de conexo
com o banco de dados por ser farto de
propriedades e eventos.
Constraints e DataSetProvider
Como sabemos, as constraints de
uma aplicao podem ser inseridas
de diversas formas em uma aplicao.
Em aplicaes two-tier, por exemplo,
temos apenas dois lugares onde elas
podem ser includas: no lado servidor
ou na aplicao cliente. No servidor
devemos inseri-las diretamente no
SGBD atravs de Stored Procedures,
domains, rules, triggers etc. uma
excelente idia, pois centralizamos
nossas regras de negcios em um
nico lugar. Porm, corremos o risco
de ficarmos presos ao banco de dados
que estamos trabalhando por conta da
linguagem empregada no SGBD. Em
outras palavras quando programamos
diretamente no banco necessitamos
usar a linguagem de programao
SQL, tambm chamada ANSI, para
criar nossas prprias instrues. Isso
pode se tornar uma dor de cabea em
uma eventual mudana de banco de
dados ou mesmo se o produto vier a
ser comercializado com BDs diferen-
tes. Imagine um software que precisa
ser capaz de se conectar aos bancos
Interbase/Firebird, SQL Server 2005
Express e Oracle. De incio j teremos
algumas complicaes entre Interbase
e Firebird dependendo da verso de
ambos, haja vista que muitas modifi-
caes no BD foram feitas ao longo dos
anos. Por isso, da mesma forma que o
esquema interessante, tambm pode
tornar-se um trauma.
Por outro lado possvel incluir cons-
traints diretamente na aplicao cliente,
porm temos uma enorme desvanta-
gem: a decentralizao de nossas regras
de negcios. Elas precisam ser refeitas
para cada nova aplicao e espalhadas
por todo o cdigo fonte ou em Units,
componentes ou dlls. Essa prtica
altamente perigosa, pois podem ocor-
rer momentos em que uma regra de
negcio pode no ser alterada por
esquecimento dos membros da equipe
de desenvolvimento, o que acarretaria
em inconsistncia dos dados.
Em aplicaes n-tier (multi-camadas)
podemos recorrer ao poderoso DataSnap
e programar nossas regras de negcio
diretamente no servidor de aplicao,
tornando a aplicao mais consistente
e inteligente. Essas regras residem no
cdigo fonte do servidor de aplicaes,
e ficam centralizadas.
Resumindo, uma das melhores alterna-
tivas certamente fazer uso desta ltima
opo, ou seja, utilizar um servidor de
aplicao que far o intercmbio entre
bando de dados (SGBD) e aplicao cliente,
pois alm de propiciar maior controle
sobre as regras de negcios, ainda po-
demos disponibilizar a aplicao para
acesso remoto atravs da internet.
Propriedades do TField
Alg umas propriedades to TField
so automaticamente passadas da
aplicao servidora para o cliente e a
maioria dos valores so determinados
em tempo de projeto baseando-se
na estrutura da tabela no SGBD. Po-
demos usufruir de alguns recursos
somente disponveis nas propriedades
do TField, seja em aplicaes single
tier, two-tier ou n-tier e que no esto
disponveis no DataSnap. Em suma,
possvel criarmos pequenas constraints
diretamente na aplicao cliente e que
podem ser facilmente configuradas.
Figura 1. Exemplo de uso do componente DataSetProvider
MO NA MAS S A
Isso bastante interessante, visto
que reduz drasticamente a quantida-
de desnecessria de cdigo e ainda
permite que sejam personalizadas as
mensagens de exceo geradas. Essas
propriedades so:
Read Only: Como o prprio nome
indica, podemos setar um campo
como somente leitura;
Required: Essa propriedade estando
configurada como True, faz com que
a aplicao obrigue o usurio final a
digitar um valor nela. Grosseiramente
falando, campos Not Null no banco de
dados so fortes candidatos a serem
campos Required, tanto , que quando
adicionamos um campo Not Null aos
Fields Editors do DataSet, este j vem
como True em sua propriedade;
DefaultExpression: Valor padro
para insero no banco de dados. Aqui
podemos configurar um valor que ser
gravado no banco caso esteja vazio;
CustomConstraint: exatamente
nessa propriedade que definimos nossa
constraint. Digitamos a expresso e poste-
riormente o sistema far a validao. Ex.:
X > 100 and X < 200;
www.devmedia.com.br/clubedelphi/portal.asp
Acesse agora o mesmo o portal do assinante ClubeDelphi e assista a uma
vdeo aula de Guinther Pauli que mostra como trabalhar com constraints
e ClientDataSet.
www.devmedia.com.br/articles/viewcomp.asp?comp=567&hl=
Edio 94 - ClubeDelphi 25
 ConstraintErrorMessage: Por ltimo
a mensagem de erro que ser exibida ao
usurio final da aplicao;
Devemos nos lembrar que isso tudo
s possvel com campos persistentes,
ou seja, com tipificao de campos no
projeto. Esse recurso utilizado quando
adicionamos os campos da tabela no
Fields Editor do TDataSet, do contrrio
no ser possvel.
Outras duas informaes so importan-
tssimas. A primeira que as mensagens
de erro so resultantes da violao das
regras impostas nos TFields do TDataSet,
e conseqentemente geraro excees. Se
outras regras tambm forem definidas no
servidor de dados, ou seja, diretamente no
SGBD, estas tambm levantaro excees,
porm somente uma das duas mensagens
ser exibida. A segunda informao diz
respeito alterao de regras no SGBD.
Algumas das regras de negcios im-
postas diretamente no BD precisam ser
replicadas para a aplicao, como o caso
de campos requeridos (Requires). Caso
modifique de True para False ou vice-versa
em um determinado campo, este precisa
ser removido ou alterado em tempo de
projeto. Vejamos um exemplo:
Abra o Delphi e crie uma nova aplicao
usando File|New>Application e salvando-a
como Properties.dpr e o formulrio
principal como Principal.pas. Insira no
formulrio um componente SQLConnec-
tion e um TSQLDataSet, ambos da paleta
Figura 2. Estrutura da tabela SALES do banco Employee.fdb
26 ClubeDelphi - Usando todo o poder do TDataSetProvider
dbExpress. D um clique duplo no SQL-
Connection e crie uma nova conexo com
o banco de dados Employee.fdb presente no
diretrio de instalao do Firebird, nor-
malmente em C:\Arquivos de Programas\
Firebird\Firebird_Verso\examples\emp-
build\Employee.fdb. Conecte o SQLDataSet
ao SQLConnection usando a propriedade
SQLConnection e em seguida digite a
instruo SQL a seguir para selecionar os
dados da tabela SALES do banco.
SELECT * FROM SALES
Arraste agora um DataSetProvider e
um ClientDataSet da paleta Data Access.
Ligue o DataSetProvider ao SQLDataSet
pela propriedade DataSet e o ClientDa-
taSet ao Provider usando ProviderName.
Abra seu gerenciador de banco de dados
preferido e visualize a estrutura da ta-
bela SALES (Figura 2).
Note que os campos PO_NUMBER,
CUST_NO, ORDER_STATUS, ORDER_
DATE, QTY_ORDERED, TOTAL_VALUE,
DISCOUNT e ITEM_TYPE, esto marca-
dos como Not Null, ou seja, no permitem
que sejam gravados sem nenhum valor.
Experimente adicionar todos os campos
da tabela SALES ao Fields Editor do Clien-
teDataSet usando o menu de contexto e a
opo Add all fields. Em seguida clique
em cada campo e observe a propriedade
Required. Perceba que cada campo Not
Null teve sua propriedade Required mo-
dificada para True, isso significa que o
sistema obrigar o usurio a inserir um
valor nesses campos (Figura 3).
Propriedade adicionais do TField
usadas pelo DataSetProvider
Agora vejamos algumas das proprie-
dades mais importantes em um TField
e que so utilizadas fortemente pelo
DataSetProvider. A propriedade Options
do DSP (DataSetProvider) suporta a
passagem de propriedades adicionais
do TFields. Quando configuramos como
True a propriedade poIncFieldProps, pode-
mos passar propriedades do TField para
o DSP. Essas propriedades so:
Alignment;
Currency;
DisplayFormat;
DisplayLabel;
DisplayWidth;
EditFormat;
EditMask;
MaxValue;
MinValue;
Visible;
O que poucos sabem, que podemos
configurar outras propriedades do DSP
capazes de nos auxiliar em diversas
tarefas. Ainda na propriedade Options
vejamos algumas delas:
poReadOnly: Desabilita qualquer al-
terao no DataSet ligado a ela;
poDisableInserts: Desabilita a insero
de dados na tabela;
poDisableEdits: Dasativa a edio dos
registros;
poDisableDeletes: No permite a exclu-
so de registros;
Retorne ao projeto criado anterior-
mente e desenhe uma tela semelhante
Figura 4. Selecione o DataSerProvider e
configure a propriedade Options>poRead
Only para True, ative o ClientDataSet e
execute a aplicao. Perceba que o DB-
Navigator permite apenas a navegao
dos registros (Figura 5) e no mais as
demais opes.
Seguindo a mesma linha de racioc-
nio, agora modifique a propriedade
Options>DisableEdits, salve o projeto
e execute. Na seqncia, experimente
clicar no boto de alterao e note o
erro (Figura 6).

Figura 3. Configurao do TField adicionado automaticamente
Isso acontece, porque informamos ao
DSP que no permitida a alterao de
registros por parte da aplicao cliente,
logo a mensagem ClientDataSet1: Mo-
difications are note allowed., tradu-
zindo, ClientDataSet1: Modificaes
no so permitidas..
Usando os eventos do DSP
Podemos utilizar trs eventos para vali-
dar constraints em uma aplicao usando
o DataSetProvider. So eles:
BeforeUpdateRecord: Acontece antes
que os dados sejam atualizados na apli-
cao remota;
OnUpdateData: Acontece ao aplicar os
dados recebidos pela aplicao cliente,
no servidor de dados;
OnUpdateError: Quando ocorrem
erros ao tentar efetuar o Update.
Usamos o evento BeforeUpdateRecord
quando necessitamos fazer a validao
individual dos registros enviados ao
servidor. Tambm podemos modificar
dados recebidos da aplicao cliente. A
assinatura completa do evento podemos
ver a seguir, juntamente com a descrio
de cada parmetro:
BeforeUpdateRecord(Sender: TObject;
SourceDS: TDataSet; DeltaDS:
TClientDataSet;
UpdateKind: TUpdateKind;
var Applied: Boolean);
Sender: DataSetProvider que disparou
o evento;
SourceDS: Grosseiramente falando
a fonte de dados, os dados em si;
DeltaDS: Pacote de dados enviado
pela aplicao cliente;
UpdateKind: Tipo de update, atualiza-
o, que ser feita. Os valores possveis
so: ukInsert, ukModify e ukDelete;
Applied: Indica se as modificaes
sero aplicadas.
Usando o evento
BeforeUpdateRecord
Vejamos um exemplo prtico. No even-
to BeforeUpdateRecord digite o cdigo da
Listagem 1. Nesse caso estamos verifi-
cando primeiramente se o tipo de atua-
MO NA MAS S A
lizao no uma instruo para deletar
o registro, pois caso seja no h necessi-
dade em se validar um registro que ser
apagado. Em seguida testamos se o valor
recebido diferente de Null(VarIsNull)
e diferente de vazio(VarIsEmpty). Por
fim, verificamos se o valor do campo
ORDER_DATE no superior ao SHIP_
DATE. Havendo quaisquer divergncia
uma exceo levantada.
Usando o evento OnUpdateData
O evento OnUpdateData ocorre uma
vez ao iniciar a aplicao dos dados no
servidor, ou seja, no recebimento dos
registros Delta do ClientDataSet. nesse
momento que interceptamos as modifi-
caes e aceitamos ou at modificamos
os dados se necessrio. Aqui tambm
podemos enviar mensagens aplicao
cliente caso seja necessrio.
Veja a assinatura do evento logo em
seguida:
OnUpdateData(Sender: TObject; DataSet:
TClientDataSet);
Edio 94 - ClubeDelphi 27
 Sender: DSP que disparou o evento;
DataSet: Pacote de dados, Data Packet;
No caso do evento anterior, BeforeUpdate-
Data, no temos acesso total aos dados que
esto vindo, e sim a um registro em particu-
lar. J no caso do OnUpdateData, recebemos
o DataSet, que contm todos os dados altera-
dos e no alterados. Sendo assim, podemos
ler individualmente o status de cada regis-
tro da tabela atravs do Delta. Insira mais
um componente ClientDataSet(Delta) e
um DataSource(DataSource1) ao sistema.
Desconecte o ClientDataSet do provider
limpando a propriedade ProviderName.
Conecte o DataSource1 ao Delta. Insira um
Button e um DBGrid. Ligue o DBGrid ao
dsDelta e digite o cdigo da Listagem 2 no
evento OnClick do Button (Figura 7).
O que estamos fazendo muito sim-
ples. Apenas atribumos propriedade
Data do Delta o contedo da propriedade
Delta do ClientDataSet1, que contm os
dados originais acrescido das alteraes
efetuadas. Execute o programa, efetue
algumas alteraes na tabela e em segui-
da clique no boto Delta. Perceba que o 2
DBGrid mostra apenas alguns registros.
Eles fazem parte do Data Packet, ou seja, o
pacote de dados que ser enviado ao DSP
para montagem das instrues de inclu-
so, alterao e excluso dos registros na
base de dados. So assim que chegam os
dados ao DSP (Figura 8).
O primeiro registro com o cdigo
V91E0210, foi marcado para excluso. J

Figura 5. DBNavigator apenas com funes de navegao

Figura 6. Exceo gerada pelo DSP

www.devmedia.com.br/clubedelphi/portal.asp

Acesse agora o mesmo o portal do assinante ClubeDelphi e assista a uma

vdeo aula de Guinther Pauli que mostra como funciona a arquitetura do
Data e Delta do ClientDataSet.
www.devmedia.com.br/articles/viewcomp.asp?comp=5717&hl=

Nota do DevMan
Se voc quiser mostrar mensagens personalizadas de
erros em seu DSP, basta fazer uso dos eventos OnEditError,
OnPostError e OnDeleteError presentes no ClientDataSet.
Para isso basta acessar o evento que deseja modificar e
inserir a mensagem desejada. Ex:
Figura 4. Exemplo de tela
procedure TForm1.ClientDataSet1EditError
(DataSet: TDataSet;
E: EDatabaseError; var Action:
Listagem 1. Cdigo do evento BeforeUpdateRecord TDataAction);
begin
procedure TForm1.DataSetProvider1BeforeUpdateRecord( MessageDlg(No so permitidas
Sender: TObject; SourceDS: TDataSet; DeltaDS: alteraes nessa tabela.,
TClientDataSet; UpdateKind: TUpdateKind; mtInformation, [mbOk], 0);
var Applied: Boolean); Action := daAbort;
begin end;
if UpdateKind <> ukDelete then
if ((VarIsNull(DeltaDS.FieldByName(ORDER_DATE)
.NewValue) = False) and Note que estamos alterando o parmetro Action
(VarIsEmpty(DeltaDS.FieldByName(ORDER_DATE)
.NewValue) = False)) then para daAbort, dessa forma a mensagem original do
if DeltaDS.FieldByName(ORDER_DATE).NewValue >
DeltaDS.FieldByName(SHIP_DATE).OldValue then ClientDataSet no ser exibida, mostrando apenas nossa
raise Exception.Create(Data do pedido no pode ser
superior a data de compra.);
caixa de dilogo.
end;

28 ClubeDelphi - Usando todo o poder do TDataSetProvider

 MO NA MAS S A

o segundo registro, V92J1003, teve o cam-

po CUST_NO alterado de 1010 para 300,
por isso aparece na visualizao apenas
o campo CUST_NO alterado. Por fim os
dois ltimos registros foram inclusos
na tabela. A partir do momento que o
mtodo ApplyUpdates do ClientDataSet Listagem 2. Cdigo do boto Delta
for chamado, o DSP far a montagem das procedure TForm1.Button2Click(Sender: TObject);
instrues SQL e as enviar ao servidor begin
try
de dados, que por sua vez executar todo Delta.Close;
Delta.Data := ClientDataSet1.Delta;
o processo de atualizao. Delta.Open;
except
MessageDlg(Sem registros no Delta,
Usando o evento OnUpdateError end;
mtWarning, [mbOK], 0);

Nas sees anteriores vimos que end;

possvel incluir mensagens persona-
lizadas na aplicao para lidar com
erros do sistema. Aqui veremos como
trabalhar com o evento OnUpdateEr-
ror. Nele podemos interceptar o erro,
process-lo, corrigi-lo e at mesmo
modific-lo para que o usurio final
tenha mais confiana no aplicativo e
entenda melhor tudo que est acon-
tecendo. A seguir encontramos uma
breve descrio de cada parmetro do
evento, bem como sua assinatura:
OnUpdateError(Sender: TObject;
DataSet: TClientDataSet;
E: EUpdateError;
UpdateKind: TUpdateKind;
var Response: TResolverResponse);

Sender: DataSerProvider que disparou

o erro;
DataSet: DataSet temporrio para
acessar o erro;
E: Objeto de exceo;
UpdateKind: Tipo de update;
Response: Ao de resposta ao erro;

Assim como os eventos que j vi-

mo s, aq u i n s p o de mo s u s a r o s
valores NewValue(Novo Valor) e
OldValue(Valor Anterior) do TField.
Tambm possvel utilizar o valor Cur-
Value (Valor atual), que indica o valor
atual do banco de dados. Com isso po-
demos visualizar o valor original, valor
armazenado atualmente e o valor que
dever ser aplicado.

www.devmedia.com.br/clubedelphi/portal.asp

Acesse agora o mesmo o portal do assinante ClubeDelphi e assista a uma

vdeo aula de Guinther Pauli que mostra como a arquitetura os Data
Packets no ClientDataSet.
www.devmedia.com.br/articles/viewcomp.asp?comp=5932&hl= Figura 7. Exemplo de tela com o Delta

Edio 94 - ClubeDelphi 29

Figura 8. Delta do ClientDataSet1 sendo visualizado
Figura 9. Mensagem personalizada no evento OnUpdateError
30 ClubeDelphi - Usando todo o poder do TDataSetProvider
O parmetro de exceo, E, possui uma
propriedade chamada OriginalException.
Ele permite que voc obtenha o valor ori-
ginal da exceo gerada pelo erro. Com
BDE podemos usar a classe EDBEngine-
Error para obter o cdigo de erro.
importante lembrar que dependendo
da quantidade de erros mencionada na
chamada ao ApplyUpdates, as excees
no sero propagadas, isso porque pode-
mos limitar o nmero de erros tolerados
pelo ClientDataSet.
Experimente digitar o cdigo da Lista-
gem 2 no evento OnUpdateError do DSP,
execute a aplicao e digite um valor
qualquer no campo Status. Depois salve
e clique em Apply. Repare na mensagem
que exibida na Figura 9.
Configurando UpdateMode e
ProviderFlags
Trabalhar com DSP no to difcil
quanto se pensa, mas muitos se atra-
palham com suas configuraes. Uma
das coisas que mais sou indagado, diz
respeito s propriedades UpdateMode do
DataSetProvider e ProviderFlags do Clien-
tDataSet. No h segredos mirabolantes
nessas duas propriedades, vejamos o que
cada uma significa e como funciona.
Em suma temos apenas trs estados do
UpdateMode que so:
upWhereAll: Utiliza todos os campos na
clusula Where para encontrar o registro;
upWhereChanged: Utiliza apenas os
campos alterados na clusula Where para
encontrar os registros;
upWhereKeyOnly: Utiliza apenas os
campos chave para procurar os registros.
Bem, pra ser mais objetivo toda vez
que chamamos o mtodo ApplyUpdates,
o ClientDataSet envia os Data Packets
para o DSP que se encarrega de varr-lo
e montar as instrues SQL que sero
enviadas ao servidor e posteriormente
aplicadas ao banco. Quando passamos
para o DSP a opo upWhereAll, ele
montar uma instruo utilizando
todos os campos da tabela em sua
clusula Where para que o registro seja

atualizado. Supondo que nossa tabela
possui os campos ID, NOME, ENDE-
RECO, CIDADE, ESTADO e TELEFONE,
sendo que apenas o campo ID chave,
imagine a instruo montada pelo DSP
quando apenas o campo TEFONE fosse
alterao. Veja:
UPDATE CLIENTES SET TELEFONE=555-5525
WHERE ID=ID, NOME=NOME, ENDERECO=ENDERECO,
CIDADE=CIDADE, TELEFONE=TELEFONE
Perceba que a clusula Where possui
todos os campos da tabela, o que desne-
cessrio. Se o mesmo caso fosse aplicado
utilizando a opo upWhereChanged a
instruo seria:
UPDATE CLIENTES SET TELEFONE=555-5525
WHERE TEFONE=TELEFONE
Nesse caso teramos problemas, pois po-
deramos perder a referncia e atualizar
o registro incorreto. O melhor de todos
os casos usar a opo upWhereKeyOnly
que monta a instruo usando apenas os
campos da chave primria, ex:
UPDATE CLIENTES SET TELEFONE=555-5525
WHERE ID=ID
Por fim restam as configuraes dos
campos no ClientDataSet. Nesse caso a
configurao acontece campo a campo
nos Fields Editor do objeto. O principal
objetivo dos ProviderFlags informar
ao DataSetProvider qual a providncia
ser tomada com cada campo. O mais
importante entender que nem todos
os campos precisam ser alterados no
banco de dados, como campos vindos de
Joins com outras tabelas. Como informar
DSP que determinado campo pertence a
outra tabela e no necessrio grav-lo?
a que entram os ProviderFlags. Suas
opes so:
pf InUpdate: Campo incluso nos
Updates;
pfInWhere: Campo incluso na clusu-
la Where; Usado para encontrar o registro
original;
pfInKey: Campo chave; Usado para
encontrar o registro original;
pfHidden: Campo oculto; Campo in-
cluso do Data Packet, mas usado apenas
para encontrar o registro original;
Para ser mais direto, cada campo
em um Fields Editor pode receber um
ProviderFlag diferente. Ento pensamos
na seguinte situao: nosso usurio
entrou na tela de cadastro de Clientes
e alterou apenas o nome do cliente.
Ao efetuar um ApplyUpdates, o DSP
entra em ao e far a montagem da
instruo. A instruo mais sensata
que o DSP precisa montar consiste
apenas em fazer um Update usando
como campo de alterao o Nome, e
na clusula Where necessitamos apenas
dos campos da chave, que nesse caso
vamos imaginar o ID do cliente. Uma
instruo seria:
UPDATE CLIENTES SET NOME=JOSE DA SILVA
WHERE ID=ID
Para configurar o ClientDataSet de tal
forma que essa seja a instruo base,
precisamos modificar os ProviderFla-
gs do campo ID parara [pf InUpdate,
pfInWhere, pfInKey]. Os demais campos
ficam configurados apenas com as
duas primeiras opes. Dessa forma
garantimos que os dados sero atuali-
zados corretamente.
Configurando dinamicamente
UpdateMode e ProviderFlags
Essa ltima etapa de nosso artigo
demonstra como fazer a configurao
do UpdateMode e ProviderFlags dina-
micamente, o que na verdade no h
segredo algum.
A propriedade UpdateMode do DataSe-
tProvider possui apenas trs opes, e
para modific-la em tempo de execuo
apenas atribua o valor diretamente a sua
propriedade, veja:
DataSerProvider1.UpdateMode := upWhereAll;
J o ClientDataSet a histria muda de
figura. Nele, sua propriedade Provi-
derFlags do tipo enumerado, ou seja,
pode ter mais de um valor. Mesmo
assim ainda bastante simples de
fazer a implementao. Apenas atri-
bua o valor entre colchetes ao campo
que deseja adicionar os ProviderFlags,
como segue:
ClientDataSet1.FieldByName(CustNo).
ProviderFlags := [pfInUpdate,pfInKey];
Como pode ver, muito simples. S
preciso tomar muito cuidado em qual
o momento que sero adicionados ou
MO NA MAS S A
retirados os atributos do ProviderFlags,
pois toda a regra de negcio ou parte
dela, depende dessas propriedades bem
configuradas.
Consideraes finais
O componente TDataSetProvider ainda
possui uma srie de outras funcionali-
dades que no puderam ser vistas aqui
por conta da sua complexidade, como
por exemplo Nested DataSets e o uso de
pacotes de dados personalizados para
montagem de tokens de validao ou
logs de evento.
altamente recomendvel fazer um
estudo aprofundado de todos os me-
canismos e tcnicas pra utilizao de
todos ou pelo menos grande parte dos
recursos desse fantstico componente.
Importante tambm lembrar que
perfeitamente possvel utilizar outras
estruturas de componentes com o DSP,
como por exemplo TDataBases> TQuery
>TDataSetProvider>TClientDataSet.
Concluso
Falar sobre TDataSetProvider no
fcil, visto que sua complexidade
bastante alta e a quantidade de re-
cursos existentes fantstica. O uso
de DataSetProvider no dia-a-dia, faz
com que a programao seja sempre
uma caixinha de surpresa, j que so-
mos capazes de descobrir inmeras
finalidades e funcionalidades para o
componente. Por isso recomendvel
que se estude a fundo todas as suas
particularidades. Nesse artigo vimos
os principais aspectos da programa-
o com DSP e seus principais recur-
sos, dicas e macetes.
Espero que tenham gostado. Um forte
abrao e at a prxima.
D seu feedback sobre esta edio! eu
Feedback
s
D
A Java Magazine tem que ser feita ao seu
sobre e
gosto. Para isso, precisamos saber o que
s
ta
edio
voc, leitor, acha da revista!
D seu voto sobre este artigo, atravs do link:
www.devmedia.com.br/javamagazine/feedback
Edio 94 - ClubeDelphi 31
Seo DELPHI Seo EASY DELPHI
Nesta seo voc encontra artigos intermedirios
sobre Delphi Win32 e Delphi .NET
ClientDataSet
Automatizando o tratamento de Erros
Rodrigo Lazoti
(rodrigolazoti@yahoo.com.br)
programador e desenvolvedor Delphi, .Net,
Java,Php e Asp. Possui certificao SCJP e atu-
almente trabalha como consultor J2EE.
32 ClubeDelphi - ClientDataSet
Seo PHP
Q
uem j criou algum tipo de
aplicativo que fizesse acesso
com banco de dados e que
teve que implementar alguma forma
para tratar os erros retornados pelo
SGBD, sabe o quanto vai ser til a
utilizao desse componente (criado
neste artigo), pois com ele no ser
mais necessrio ter que implementar
a lg u m mtodo de t rata mento em
todos os componentes ClientDataset
espalhados pelo aplicativo.
O principal objetivo desse compo-
nente retirar do desenvolvedor a
necessidade de implementar rotinas
para tratar os erros retornados no ban-
co de dados atravs dos eventos On-
ReconcileError e OnPostError. Nesse
artigo irei criar esse novo componente
derivado da classe TClientDataset.
Os erros tratados pelo componente
so baseados nas mensagens retor-
nadas utilizando o banco de dados
Firebird.
Criando o componente
MyClientDataset
Vamos iniciar a criao de componente,
para isso inicie o Delphi (estou utilizan-
do a verso 7, mas nada impede que se
use outra verso), no menu principal,
entre na opo Component >> New
Component. Com isso ser aberta a tela
da Figura 1. Veja a Tabela 1.
Aps informar os valores acima, clique
em OK, ser criado o arquivo fonte do
nosso componente. Agora s precisamos
implementar as novas funcionalidades
no componente. Vamos iniciar incluindo
no uses do nosso componente as units
necessrias para compilao e criar um
novo tipo chamado TMyErrors para iden-
tificar os erros retornados (Listagem 1).
Com isso concludo, vamos inserir
os mtodos, o construtor e o destrutor
do componente, irei criar duas funes
sobrecarregadas com o nome de Detec-
tarErros para identificar o erro retornado
pelo SGBD, ver em qual opo do nosso
 MO NA MAS S A

tipo criado a mensagem de erro se en-

quadra e retorn-la como resultado da
funo. Criarei tambm dois procedi-
mentos sobrecarregados com o nome de
RetornarErros que tem como finalidade
disparar uma nova exceo tratada para
o aplicativo. E para finalizar criarei dois
mtodos para fazer o vnculo com os
eventos onReconcileError e onPostError
do componente. Primeiro vamos incluir
as declaraes da sesso private do com-
ponente (Listagem 2).
Antes de criarmos o corpo desses mto-
dos vamos incluir os mtodos restantes
para criar o corpo de todos os mtodos
de uma vez. Veja na Listagem 3 os m-
todos da sesso public.
Pronto, agora j temos todos os mto-
dos que iremos usar em nosso compo-
nente declarados. Aperte Ctrl+Shift+C
para que seja criado automaticamente
o corpo de todos os mtodos do compo- Figura 1. Criando um novo componente derivado da classe TClientDataset

Edio 94 - ClubeDelphi 33
 Campo Valor Descrio
Ancestor type TClientDataset Contm a classe que nosso componente ser derivado.
Class name TMyClientDataset O nome da classe do novo componente
Palette Page ClubeDelphi O nome da aba onde o componente ser instalado.
Unit file name C:\Arquivos de programas\Borland\Delphi7\Lib\MyclientDataset.pas Nome e local do arquivo fonte do componente criado.
Tabela 1. Informaes iniciais para criao do componente

Listagem 1. Declarando o novo tipo de retorno e incluindo as units no uses nente e insira a codificao dos mtodos
unit MyClientDataSet;
conforme a Listagem 4.
O cdigo est todo comentado para
interface
fcil entendimento. Pronto, nosso com-
uses
SysUtils, Classes, DB, DBClient; ponente est finalizado, salve a unit.
type
No menu principal do Delphi clique em
TMyErrors = (meViolacaoChave, meValidacao, meChavePrimaria, meChaveEstrangeira, Component >> Install Component. Na
meConflito, meOutros);
opo Unit file name informe o local e
type
TMyClientDataSet = class(TClientDataSet) nome da unit criada, clique em OK, ser
private aberta uma janela com o pacote DCLUSR.
{ Private declarations }
protected DPK, compile o pacote, com isso o novo
{ Protected declarations }
public componente j estar disponvel para o
{ Public declarations }
published uso. Experimente utilizar o novo compo-
{ Published declarations } nente com os componentes do dbExpress
end;
acessando o Firebird, e veja que erros do
procedure Register;
servidor, como violao de chave, sero
implementation
automaticamente tratados.
procedure Register;
begin
RegisterComponents(ClubeDelphi, [TMyClientDataSet]);
end;
Concluso
Como vimos nesse artigo, a criao
end.
de componentes pode nos ajudar a no
escrever cdigos repetitivos, tornando
Listagem 2. Declarando novos mtodos no componente a criao a manuteno dos aplicativos
private mais fcil.
{ Private declarations }
FTratarErros :Boolean;
function DetectarErros(e: EReconcileError): TMyErrors; overload;
function DetectarErros(e: EDatabaseError): TMyErrors; overload;
procedure RetornarErros(cds: TClientDataSet; Err :EReconcileError); overload;
procedure RetornarErros(cds: TClientDataSet; Err :EDataBaseError); overload;

Listagem 3. Declarando novos mtodos no componente

public
{ Public declarations }
constructor Create(aOwner :TComponent); override;
destructor Destroy; override;
procedure MyReconcileError(DataSet: TCustomClientDataSet; E: EReconcileError;
UpdateKind: TUpdateKind; var Action: TReconcileAction);
procedure MyPostError(DataSet: TDataSet; E: EDatabaseError;
var Action: TDataAction);

34 ClubeDelphi - ClientDataSet
 MO NA MAS S A

Listagem 4. Codificando os mtodos do componente

constructor TMyClientDataSet.Create(aOwner: TComponent); Valor invlido ou nulo foi encontrado em campos que contm restries. +
begin Motivo: + Err.Message);
// Associa os eventos aos mtodos meChavePrimaria:
inherited Create(aOwner); raise Exception.Create(Erro ao salvar + cds.Name + .+#10#13+
Self.OnPostError := MyPostError; O registro no pode ser gravado, ocorreu um erro de duplicidade na chave primria. +
Self.OnReconcileError := MyReconcileError; Motivo: + Err.Message);
end; meChaveEstrangeira:
destructor TMyClientDataSet.Destroy; raise Exception.Create(Erro ao efetuar operao + cds.Name +
begin .+#10#13+Dependncia invlida entre tabelas ligadas. +
inherited Destroy; Motivo: + Err.Message);
end; meConflito:
function TMyClientDataSet.DetectarErros(e: EReconcileError): TMyErrors; raise Exception.Create(Erro ao salvar + cds.Name + .+#10#13+
begin O registro foi modificado ou deletado por outro usurio. +
// Verifica qual o erro ocorrido pela mensagem Motivo: + Err.Message);
if (Pos(VALIDATION ERROR, UpperCase(E.Message))<>0) then else
Result := meValidacao raise Exception.Create(Erro ao salvar + cds.Name + .+#10#13+
else if (Pos(VIOLATION OF FOREIGN KEY, UpperCase(E.Message))<>0) then Erro desconhecido: +err.Message);
Result := meChaveEstrangeira end;
else if (Pos(VIOLATION OF PRIMARY OR UNIQUE KEY, end;
UpperCase(E.Message))<>0) then
Result := meChavePrimaria Procedure TMyClientDataSet.RetornarErros(cds: TClientDataSet;
else if (Pos(RECORD NOT FOUND OR CHANGED BY ANOTHER USER, Err: EDataBaseError);
UpperCase(E.Message))<>0) then Begin
Result := meConflito cds.CancelUpdates;
else cds.Refresh;
Result := meOutros; case DetectarErros(Err) of
end; meViolacaoChave:
function TMyClientDataSet.DetectarErros(e: EDatabaseError): TMyErrors; raise Exception.Create(Erro ao salvar +cds.Name+ .+
begin J existe um registro com o cdigo informado!);
// Trata Key Violation else
if (Pos(KEY VIOLATION, UpperCase(E.Message))<>0) then raise Exception.Create(Erro ao salvar + cds.Name + .+#10#13+
Result := meViolacaoChave Erro desconhecido: +err.Message);
else end;
Result := meOutros; end;
end; procedure TMyClientDataSet.MyPostError(DataSet: TDataSet;
procedure TMyClientDataSet.RetornarErros(cds: TClientDataSet; E: EDatabaseError; var Action: TDataAction);
Err: EReconcileError); begin
Begin RetornarErros(Self, E);
// Faz o tratamento do OnReconcileError end;
// Cancela o Update procedure TMyClientDataSet.MyReconcileError(
cds.CancelUpdates; DataSet: TCustomClientDataSet;
cds.Refresh; E: EReconcileError; UpdateKind: TUpdateKind;
// Trata o tipo de erro var Action: TReconcileAction);
case DetectarErros(Err) of begin
meValidacao: RetornarErros(Self, E);
raise Exception.Create(Erro ao salvar + cds.Name + .+#10#13+ end;

Edio 94 - ClubeDelphi 35
Seo DELPHI Seo EASY DELPHI Seo PHP

Nesta seo voc encontra artigos intermedirios

sobre Delphi Win32 e Delphi .NET

Controle on-line de vdeo-locadora - Parte 2

Veja como criar um sistema on-line de controle para uma vdeo-locadora

Maikel Marcelo Scheid
(maikelscheid@gmail.com)
tcnico em Informtica com nfase em An-
lise e Programao de Sistemas. Atua na rea
de Desenvolvimento de Softwares em Delphi
para plataforma Win32 e .NET com banco de
dados Firebird e MS SQL. membro da equipe
Editorial ClubeDelphi.
N
este artigo veremos a continu-
ao da criao de um sistema
online para vdeo-locadora,
onde faremos a concluso dos princi-
pais processos que envolvem reservas,
retiradas e devoluo de filmes por
meio de usurios e tambm a dispo-
nibilidade de consultas. Nesta etapa
do artigo faremos a criao de pginas
para autenticao de usurios e tambm
para autenticao de administradores
do sistema de locadora.
Para reservas, criaremos uma pgina
especfica aos usurios onde os mes-
mos podero realizar buscas de filmes
e reservar os mesmos para retirada na
locadora. Tambm a criao de uma
rea administrativa para efetivao das
retiradas feitas por meio de reservas
online e manutenes de emprstimos, Projects>New ASP.NET Files>ASP.NET
podendo registrar novas locaes ou
devolvendo filmes locados, centrali-
zando este processo aos administra-
dores da locadora.
Relembrando o artigo anterior, criamos
o banco de dados com toda a estrutura de
tabelas necessrias, alm da configura-
o da conexo do sistema com o banco
de dados utilizando os componentes
especficos para conexo com o Firebird.
Criamos tambm no artigo anterior as
pginas de manuteno dos gneros e
vdeos da locadora, onde criamos todos
os nossos componentes de conexo e
pesquisas no cdigo da pgina (runtime),
processo este que ter continuao nesta
segunda etapa do artigo.
Login de Usurios
Retomando o projeto criado no artigo
anterior, aps reaberto o mesmo adicio-
ne uma nova ASP.NET Page, atravs do
menu File|New>Other>Delphi for .NET
Page e altere seu nome para login.
aspx. Adicione ao corpo da pgina
uma tabela de 4 linhas e 1 coluna com
300 pixels de largura. Na primeira linha

36 ClubeDelphi - Controle on-line de vdeo-locadora - Parte 2


digite o texto Login de Clientes e faa
a formatao do texto. Na segunda linha
da tabela adicione uma nova tabela com
2 linhas e 2 colunas ocupando 100% da
largura disponvel, onde dever digitar
nas linhas da primeira coluna o texto
Usurio e Senha e nas linhas da Uses da pgina o namespace FirebirdSQL.
segunda coluna adicionar dois compo-
nentes TextBox(txtUser, txtSenha)
alterando a propriedade TextMode do
txtSenha para Password. Adicione na
linha 3 um Button(btnLogin) e na
ltima linha da tabela crie um link para
o login dos administradores, direcio-
nando pgina login_adm.aspx que ser
criada no decorrer do artigo.
Acessando o cdigo da pgina (use
a tecla de atalho F12), crie a constante
strConexao na rea Interface da pgina
informando a string de conexo com o
banco. Esse valor ser usado mais adian-
te para que o componente fbConnection
acesse o BD. Da mesma maneira como
utilizado no artigo anterior, declare a
constante conforme cdigo a seguir:
const
strConexao = User=SYSDBA;
Password=masterkey;
Database=<Caminho>LOCADORA.FDB;;
De volta ao corpo da pgina (F12),
com um duplo clique sobre o btnLogin,
adicione ao seu evento OnClick o cdigo
da Listagem 1 responsvel por realizar a
autenticao do usurio e senha digitados
e direcionar o usurio a pgina corres-
pondente no sistema. O cdigo utilizado
acompanha a metodologia empregada
no artigo da edio anterior, onde logo
de incio criamos todos os componentes
e atribumos a string de conexo com o
banco ao Conn, componente de conexo.
Em seguida atribumos a conexo ao
objeto interno do DataAdapter chamado
SelectCommand. ele que receber a ins-
truo SQL de seleo dos dados em sua
propriedade CommandText.
Em seguida atribumos os parme-
tros de usurio e senha para a SQL de
seleo do CommandText atravs do
objeto FbParameter criado e instanciado
separadamente para cada parmetro
adicionado, onde ao final executamos
a consulta e relacionamos o resultado a
um objeto FbDataReader que ser verifi-
cado quanto ao sucesso do login. No caso
WEB M INI- C URSO M O NA MAS S A
de informaes corretas na autenticao, A existncia de um bloco try..except
algumas informaes contidas no objeto muito importante neste trecho do cdigo
sero armazenadas em variveis de para interpretar a seguinte situao:
sesso (Session) para serem usadas futu- - Supondo que o usurio esteja logado
ramente para identificao e validao no sistema, logo a Session[NOME] ter
de usurios. Adicione tambm junto as um valor relacionado e o mesmo ser
exibido no LblUsuario, mas no caso de
Data.Firebird que possibilitar o trabalho o usurio no ter realizado a autenti-
com o objetos de conexo e pesquisa cao e a seo Nome no existir, um
para Firebird. tratamento de erros faz com que o bloco
except redirecione o usurio de volta
Validando usurios na pgina pgina de login, inibindo seu acesso a
A validao dos usurios na pgina todas as pginas onde o User Control
bastante simples de ser implementada. estiver sendo utilizado.
Localize no projeto o User Control uccon-
trole.ascx criado j no incio do artigo e Pgina de Reservas OnLine do
com um duplo clique sobre uma rea em cliente
branco, acesse o evento Load do mesmo No menu File|New>Other>Delphi for
onde dever digitar as seguintes linhas .NET Projects>New ASP.NET Files>ASP.
de cdigo: NET Page crie uma nova pgina salvan-
try do-a como user_reservas.aspx. Adi-
LblUsuario.Text := Session[NOME].
ToString;
cione ao corpo da pgina uma tabela
except de 11 linhas e 1 coluna com 700 pixels
Response.Redirect(login.aspx);
end; de largura. Adicione alguns compo-
Listagem 1. Evento Click para autenticao de usurio e senha dos clientes
procedure TWebForm1.btnLogin_Click(sender:
System.Object; e: System.EventArgs);
var
Comand: FbCommand;
DataAdapter: FbDataAdapter;
Conn: FbConnection;
prUser : FbParameter;
prSenha : FbParameter;
fbReader : FbDataReader;
begin
{ Criao dos objetos de conexo }
Conn := FbConnection.Create;
DataAdapter := FbDataAdapter.Create;
Comand := FbCommand.Create;
{ Atribuio da string de conexo e abertura do BD}
Conn.ConnectionString := strConexao;
Conn.Open;
{ Atribuio dos atributos de seleo dos dados }
DataAdapter.SelectCommand := Comand;
DataAdapter.SelectCommand.Connection := Conn;
DataAdapter.SelectCommand.CommandText :=
select clientes.nome, clientes.cod_cliente +
from clientes where ((clientes.login = ?) and
(clientes.senha = ?));
prUser := FbParameter.Create;
prSenha := FbParameter.Create;
DataAdapter.SelectCommand.Parameters.Add(prUser);
DataAdapter.SelectCommand.Parameters.Add(prSenha);
DataAdapter.SelectCommand.Parameters[0].Value :=
txtUser.Text;
DataAdapter.SelectCommand.Parameters[1].Value :=
txtSenha.Text;
fbReader := DataAdapter.SelectCommand.ExecuteReader;
if fbReader.Read then
begin
Session[USUARIO] := txtUser.Text;
Session[NOME] := fbReader[NOME].ToString;
Session[CODIGO] := fbReader[COD_CLIENTE]
.ToString;
Response.Redirect(user_reservas.aspx);
end else
RegisterStartupScript(erro,<script>javascript
:alert(Usurio ou Senha incorretos!);
</script>);
end;
Edio 94 - ClubeDelphi 37
nentes ao corpo dela, organizando-os
respect ivamente de acordo com o
layout exibido na Figura 1. Arraste
na primeira linha da tabela o User
Control uccontrole.ascx, aps insira um
Button(btnSair) na segunda linha,
seguido de uma linha com o texto
Minhas Locaes Ativas identifi-
cando o contedo a ser carregado no
DataGrid(gridLocacao) da linha se-
guinte. Uma linha em branco com um
espao ir separar o contedo do texto
Minhas Reservas Ativas identifican-
do o DataGrid(gridReservas) que ser
preenchido com as reservas ativas do
usurio. As ltimas da tabela sero
caracterizadas por cadastrar novas
reservas, onde alm do texto informa-
tivo Criar nova reserva um compo-
nente DropDowList(ddlVideos) para
listagem dos vdeos disponveis para
reserva e um Button(btnReservar)
para salvar o processo da reserva.
Selecionando o gridLocacao, faremos
agora algumas configuraes necess-
rias antes da codificao dos proces-
sos que iro exibir as informaes na
pgina. Com o boto direito do mouse
Figura 1. Layout da pgina de reservas do usurio
38 ClubeDelphi - Controle on-line de vdeo-locadora - Parte 2
sobre o DataGrid acesse sua proprieda-
de Auto Format e aplique um estilo de
formatao desejado. Novamente com
o boto direito do mouse, acesse agora
o item Property Builder onde iremos
modificar a estrutura da categoria
Columns. Desmarque o item Create
columns automatically at run time. Em
seguida clique no item Bound Column
em Available columns e envie-o para
Selected columns. Agora selecione-o e
atribua o valor COD_LOCACAO na
propriedade Data Field, onde rece-
beremos o valor do campo na tabela
Locacao atravs do result set da Select
que faremos nos registros com status
N indicando Locao. Desmarque
tambm a opo Visible da coluna.
Agora insira uma nova coluna, ou seja,
clique novamente em Bound Column e
envie-o para a rea Selected columns. Na
propriedade Header text (Texto de cabe-
alho), digite Titulo e em Data Field o
valor TITULO que justamente o campo
resultante de um Inner Join da tabela
Locacao com a tabela Videos semelhante
como no passo anterior. Por fim, adicione
uma nova coluna e altere sua proprieda-
de Header text para Prev. Dev. em Data
Field digite o valor PREV_DEVOLUCAO
e em Data Formatting Expression o valor
{0:dd/MM/yyyy} que far a formata-
o da forma de exibio da data.
Selecionando o gridReservas, faremos
configuraes semelhantes as aplica-
das na configurao do gridLocacao.
Com o boto direito do mouse sobre o
DataGrid acesse sua propriedade Auto
Format e aplique um estilo de formata-
o ao mesmo. Novamente com o boto
direito do mouse, acesse agora o item
Property Builder onde iremos modifi-
car a estrutura da categoria Columns,
onde no topo da janela desmarque o
item Create columns automatically at run
time. Em seguida clique no item Bound
Column em Available columns e envie-o
para Selected columns. Agora selecione-
o e atribua o valor COD_LOCACAO na
propriedade Data Field, onde recebere-
mos o valor do campo na tabela Locacao
atravs do result set da Select que fare-
mos nos registros com Status R para
Reservas. Desmarque tambm a opo
Visible da coluna.
Agora insira uma nova coluna, ou
seja, cl ique nova mente em Bound
Column e envie-o para a rea Selected
columns. Na propriedade Header text
(Texto de cabealho), digite Titulo
e em Data Field o valor TITULO que
justamente o campo resultante de um
Inner Join da tabela Locacao com a ta-
bela Videos semelhante como no passo
anterior. Por fim, adicione uma nova
coluna e altere sua propriedade Hea-
der text para Data Reserva. em Data
Field digite o valor DATA e em Data
Formatting Expression o valor {0:dd/
MM/yyyy} que far a formatao da
forma de exibio da data.
Selecionando o ddlVideos, adicione a
sua propriedade DataValueField o valor
Nota do DevMan
Para alterar a largura das colunas, basta entrar novamente
no Property Builder e selecionar o item Format. Nele
podemos definir atributos para vrias caractersticas do
componente Data Grid. Note que temos a opo Columns.
Expanda este item e clique na ltima coluna (Alterar).
direita digite 50 no campo Width (largura) e confirme.

COD_VIDEO e para DataTextField o valor
TITULO, sendo estas duas colunas de in-
formaes que sero carregadas atravs var
do result de um select em todos os vdeos
disponveis para reserva.
O processo para carregamento das in-
formaes requer que 1 procedure e uma
function sejam criadas, especificando
para cada uma delas componentes que
sero criados em tempo de execuo
conforme exemplos anteriores e que
requerem a criao de uma constante
strConexao e incluso da namespace
FirebirdSQL.Data.Firebird na clusula
Uses. Declare na seo Private do cdigo
a procedure e tambm a function conforme
lista adiante e adicione a cada uma delas
os respectivos cdigos encontrados na
Listagem 2, sendo que todos os pro-
cessos encontram-se comentados entre
as linhas do mesmo. Observe que para
carregar as locaes e reservas ativas
utilizamos apenas uma funo, a qual
requer a passagem do parmetro Status
de acordo com a situao cadastral dos
registros que desejamos exibir:
procedure CarregaVideos;
function CriaListaVideos(Status:
String):DataSet;
Finalizada a criao e codificao
dos mtodos para carregar os dados
de locaes, reservas e vdeos preci-
samos fazer a chamada dos mesmos.
Para isso usaremos o evento Load da
pgina onde dever digitar as seguin-
tes linhas do cdigo, que iro jogar o
resultado aos componentes relaciona-
dos. Observe que estamos utilizando
a mesma f uno para carregar as
reservas e locaes, alterando apenas
o valor do parmetro Status repassada
para a function:
gridLocacao.DataSource :=
CriaListaVideos(N);
gridLocacao.DataBind;
gridReservas.DataSource :=
CriaListaVideos(R) AND
(LOCACAO.PREV_DEVOLUCAO >= TODAY);
gridReservas.DataBind;
CarregaVideos;
Se executar a pgina neste momento,
j poder perceber que todas as infor-
maes sero listadas, porm ainda est
disponvel o cadastro de novas reservas.
Uma nova reserva ser realizada a partir
do click ao boto btnReservar no qual
adicione o cdigo da Listagem 3.
WEB M INI- C URSO M O NA MAS S A
Listagem 2. Codificando as aes para carregamento de vdeos, reservas e locaes
procedure TWebForm2.CarregaVideos;
Comand: FbCommand;
DataAdapter: FbDataAdapter;
Ds: DataSet;
Conn: FbConnection;
begin
{ Criao dos objetos de conexo }
Conn := FbConnection.Create;
DataAdapter := FbDataAdapter.Create;
Comand := FbCommand.Create;
{ Atribuio da string de conexo e abertura
do BD}
Conn.ConnectionString := strConexao;
Conn.Open;
{ Atribuio dos atributos de seleo dos dados }
DataAdapter.SelectCommand := Comand;
DataAdapter.SelectCommand.Connection := Conn;
DataAdapter.SelectCommand.CommandText :=
SELECT V.COD_VIDEO, V.TITULO FROM VIDEOS V +
WHERE V.COD_VIDEO NOT IN (SELECT LOCACAO.VIDEO
FROM LOCACAO +
WHERE ((LOCACAO.VIDEO = V.COD_VIDEO) AND
((LOCACAO.STATUS = R) +
OR (LOCACAO.STATUS = N)))) ORDER BY V.TITULO;
{ Criao em memria do DataSet auxliar }
Ds := DataSet.Create;
DataAdapter.Fill(Ds, Titulo);
Try
{ Popularizao dos vdeos no componente da
pgina }
ddlVideos.DataSource := Ds;
ddlVideos.DataBind;
finally
Conn.Close;
end;
end;
function TWebForm2.CriaListaVideos(Status: String):
DataSet;
var
Comand: FbCommand;
DataAdapter: FbDataAdapter;
Ds: DataSet;
Conn: FbConnection;
prCliente : FbParameter;
begin
{ Criao dos objetos de conexo }
Conn := FbConnection.Create;
DataAdapter := FbDataAdapter.Create;
Comand := FbCommand.Create;
{ Atribuio da string de conexo e abertura do BD}
Conn.ConnectionString := strConexao;
Conn.Open;
{ Atribuio dos atributos de seleo dos dados }
DataAdapter.SelectCommand := Comand;
DataAdapter.SelectCommand.Connection := Conn;
DataAdapter.SelectCommand.CommandText :=
SELECT LOCACAO.COD_LOCACAO, VIDEOS.TITULO,
CLIENTES.NOME, +
LOCACAO.PREV_DEVOLUCAO, LOCACAO.DATA FROM +
LOCACAO +
INNER JOIN VIDEOS ON (LOCACAO.VIDEO = +
VIDEOS.COD_VIDEO) +
INNER JOIN CLIENTES ON (LOCACAO.CLIENTE = +
CLIENTES.COD_CLIENTE) +
WHERE ((LOCACAO.STATUS = + Status + )
AND (LOCACAO.CLIENTE = ?)) ORDER BY +
LOCACAO.DATA;
{ Criao dos parmetros da pesquisa. O Status
ser configurado ao chamar a function }
prCliente := FbParameter.Create;
DataAdapter.SelectCommand.Parameters.Add(
prCliente);
DataAdapter.SelectCommand.Parameters[0].Value :=
Session[CODIGO].ToString;
{ Criao em memria do DataSet auxliar }
Ds := DataSet.Create;
DataAdapter.Fill(Ds, Titulo);
try
{ Joga o resultado do Select para o Result
da funo }
Result := Ds;
finally
Conn.Close;
end;
end;
Edio 94 - ClubeDelphi 39
 O c d igo t a mb m s e ut i l i z a da
Listagem 3. Cdigo para reservar um vdeo
criao dos componentes em runti-
procedure TWebForm2.btnReservar_Click(sender:
System.Object; e: System.EventArgs);
me onde passamos uma instruo
SQL ao objeto InsertCommand do
var
Comand: FbCommand; Dat a Adapter e c on f ig u ra o do s
DataAdapter: FbDataAdapter;
Conn: FbConnection; parmetros de cadastros. Ao execu-
prVideo : FbParameter; tarmos a instruo, e o resultado for
prCliente : FbParameter;
prData : FbParameter; de sucesso, chamamos os mtodos
prStatus : FbParameter;
prDev : FbParameter; para que a pgina seja recarregada e
begin
as informaes atualizadas. Lembre-
{ Criao dos objetos de conexo } se de adicionar nas Uses da pgina o
Conn := FbConnection.Create;
DataAdapter := FbDataAdapter.Create; namespace DateUtils da qual estamos
Comand := FbCommand.Create;
chamando uma funo para incremen-
{ Atribuio da string de conexo e abertura do BD} tar certa quantidade de dias data de
Conn.ConnectionString := strConexao;
Conn.Open; vencimento da reserva.
{ Atribuio dos atributos de seleo dos dados } Adicione tambm ao evento OnClick do
DataAdapter.InsertCommand := Comand;
DataAdapter.InsertCommand.Connection := Conn;
btnSair o cdigo adiante para fazer o re-
DataAdapter.InsertCommand.CommandText := direcioamento da pgina e aps execute
INSERT INTO LOCACAO +
(VIDEO, CLIENTE, DATA, STATUS, PREV_DEVOLUCAO) a pgina fazendo uma nova reserva para
VALUES (?, ?, ?, ?, ?);
o usurio autenticado.
prVideo := FbParameter.Create;
prCliente := FbParameter.Create;
Response.Redirect(login.aspx);
prData := FbParameter.Create;
prStatus := FbParameter.Create;
prDev := FbParameter.Create;
DataAdapter.InsertCommand.Parameters.Add(prVideo);
DataAdapter.InsertCommand.Parameters.Add(prCliente);
Concluso
DataAdapter.InsertCommand.Parameters.Add(prData); No perca a prxima parte deste artigo,
DataAdapter.InsertCommand.Parameters.Add(prStatus);
DataAdapter.InsertCommand.Parameters.Add(prDev); onde continuaremos a implementao
DataAdapter.InsertCommand.Parameters[0].Value :=
ddlVideos.SelectedValue; das retiradas e devoluo de filmes por
DataAdapter.InsertCommand.Parameters[1].Value := meio de usurios e tambm a disponi-
Session[CODIGO].ToString;
DataAdapter.InsertCommand.Parameters[2].Value := bilidade de consultas.
DateTime.Today.ToString(dd.MM.yyyy);
DataAdapter.InsertCommand.Parameters[3].Value := R;
DataAdapter.InsertCommand.Parameters[4].Value :=
System.&String.Format({0:dd/MM/yyyy},
IncDay(DateTime.Today, 7));{Uses DateUtils} D seu feedback sobre esta edio! Feedback
eu

s
D
if DataAdapter.InsertCommand.ExecuteNonQuery> 0 then
begin A Java Magazine tem que ser feita ao seu

sobre e
gridReservas.DataSource := CriaListaVideos(R)
AND (LOCACAO.PREV_DEVOLUCAO >= TODAY); gosto. Para isso, precisamos saber o que

s
ta
e
gridReservas.DataBind; voc, leitor, acha da revista!
d i o
CarregaVideos;
end;
end; D seu voto sobre este artigo, atravs do link:
www.devmedia.com.br/javamagazine/feedback

40 ClubeDelphi - Controle on-line de vdeo-locadora - Parte 2

Seo DELPHI Seo EASY DELPHI
Nesta seo voc encontra artigos intermedirios
sobre Delphi Win32 e Delphi .NET
Desenvolvendo uma Aplicao Completa com
PocketStudio
Aprenda a criar aplicaes para o sistema operacional PalmOS Parte 3
Ricardo C. Boaro
(rboaro@aquasoft.com.br)
trabalha com desenvolvimento de sistemas
em Delphi h mais de 10 anos e PocketStudio
h 3 anos. Atualmente gerente de inform-
tica na Di Hellen Indstria de Cosmticos, e
atual como instrutor certificado Borland na
Aquasoft Tecnologia da Informao parceira
da Borland, em Porto Alegre RS. Borland
Instrutor, Delphi 7, 2007 e Certified.
42 ClubeDelphi - Desenvolvendo uma Aplicao Completa com PocketStudio
Seo PHP
N
o artigo anterior, aprendemos
a criar uma tabela e fazer refe-
rncia a ela em nosso formul-
rio de consulta de clientes. Com base no
mesmo conceito e aprendizado, faremos
a incluso de novas telas em nosso sis-
tema, tais como: cadastro de produtos e
digitao de pedidos.
Lembrando que nossas telas no sistema
apenas consultam a base de dados no
possibilitando a incluso de registros.
Essa tarefa ser efetuada atravs do sin-
cronismo entre dispositivo e PC.
Poderamos criar e utilizar a tela para
editar os registros e envi-los ao PC,
porm em nosso exemplo ser apenas
mais uma janela de consulta. As telas
que iro manipular informaes so as
de pedidos e itens do pedido.
O primeiro passo criarmos a tabela
produtos para armazenarmos os dados
e podermos navegar entre os registros.
Lembrando que essa tabela ser preen-
chida no momento do sincronismo com
o PC. Para isso devemos criar uma nova
Unit, como vimos no artigo anterior.
Acesse o menu File|New>Unit, salve-a
com o nome de ProdutosDB.pas. Vale
lembrar que podemos utilizar as teclas
de atalhos CTRL + Shift + S para salvar
nosso projeto. Feito isso vamos montar
a tabela de produtos.
Logo abaixo da palavra reservada
Interface declare uma seo Uses para
adicionarmos a PSL que a Library do
PocketStudio onde esto os mtodos
necessrios para manipularmos o BD
dentro da Unit PSDatabase. Aps a seo
Uses declaramos uma nova seo Const
onde informaremos o DBName, DBType
e os ndices para recuperao e configu-
rao dos valores nos campos da tabela
de Produtos.
Aps a definio dos campos e seus
respectivos ndices, declaramos uma se-
o Var, onde informaremos ao PocketS-
tudio o FieldDefs e um array. Tambm
iremos declarar as variveis globais que
 TUTORIAL M INI-CURSO

iro referenciar nossa base de dados em
todo projeto. A estrutura de todas as ta-
belas criadas no PocketStudio sempre
a mesma, como uma receita de bolo. Mu-
damos apenas nome da tabela e campos,
mas a maneira de montar e manipular
exatamente igual para todas.
Como no artigo anterior criamos a tabe-
la de clientes, no vou entrar em detalhes
de como funciona cada funo criada em
nossa tabela. Altere a Unit ProdutosDB
conforme a Listagem 1.
Criando a Tela de Consulta a
Produtos
Criada a tabela de produtos, vamos adi-
cionar um novo formulrio para criarmos
a tela de consulta. No menu principal
do PocketStudio acesse File|New>Form
e salve-o como UDadosProdutos.pas
usando File>Save ou pelas teclas de atalho
CTRL + S. Altere a propriedade Name
para FrmDadosProdutos e seus Title
artigo anterior para incluso de Bitmaps navegarmos entre os registros. Para isso
e associao deles aos botes da parte in- utilizaremos as funes da PSDataBase
ferior. O boto que ficar ao lado do ttulo da PSL. Pressione F12 no formulrio para
do formulrio se chamar BtnVoltar. visualizar a pgina de cdigo e localize
Antes de codificarmos os botes, pre- a palavra reservada Implementation.
cisamos criar uma funo para carregar Declare o procedimento da Listagem 2
os dados na tela de consulta conforme abaixo de Implementation.
Listagem 1. Cdigo completo da tabela de Produtos
unit ProdutosDB;
interface
uses PSL;
const
ProdutosDBName = ProdutosDB;
ProdutosDBType = Rsc(DBPR);
Prod_Codigo = 0;
Prod_DescProd = 1;
Prod_Preco = 2;
Prod_Estoque = 3;
Prod_Tam = 4;
Prod_Un = 5;
var
FieldDefs : array[0..5] of TFieldDef =
((DataType: ftUInt16),
(DataType: ftString),
(DataType: ftDouble),
(DataType: ftUInt32),
(DataType: ftString),
(DataType: ftString));
bProdutosInclui : Boolean;
DBPro : TDatabase;

para Consulta a Produtos. Desenhe function Open: Boolean;

function Close: Boolean;
uma tela semelhante a Figura 1. function ProcuraCodigo(Codigo: UInt16): Boolean;
Nomeie os componentes do tipo Field implementation
com os nomes FldCodigo, FldDescri-
function Open: Boolean;
cao, FldPreco, FldEstoque, FldTa- var
Atributos : UInt16;
manho e FldUn, respectivamente. begin
Result := PSDatabase.Open(DBPro, ProdutosDBName,
Insira cinco botes, sendo, quatro na dmModeReadWrite);
parte inferior que se chamaro BtnPri- if not Result then
begin
meiro, BtnAnterior, BtnProximo e Result := PSDatabase.CreateDatabase(ProdutosDBName,
Creator, ProdutosDBType);
BtnUltimo, seguindo da esquerda para if Result then
Result := PSDatabase.Open(DBPro, ProdutosDBName,
a direita. Aproveite e repita os passos do dmModeReadWrite);
end;
if not Result then
begin
ShowSystemError(PSDatabase.LastError);
Exit;
end;
PsDataBase.DataBaseAttributes(ProdutosDBName,
Atributos);
Atributos := Atributos and $FFF7;
PsDataBase.SetDataBaseAttributes(ProdutosDBName,
Atributos);
PSDatabase.SetFieldDefs(DBPro, FieldDefs[0],
SizeOf(FieldDefs) div SizeOf(FieldDefs[0]));
end;
function Close: Boolean;
begin
Result := PSDatabase.Close(DBPro);
end;

function ProcuraCodigo(Codigo: UInt16): Boolean;

begin
PSDatabase.First(DBPro);
while not PSDatabase.EOF(DBPro) do
begin
if PSDatabase.FieldUInt16(DBPro, Prod_Codigo) =
Codigo then
begin
Result := True;
exit;
end;
PSDatabase.Next(DBPro);
end;
Result := False;
end;
end.
Figura 1. Exemplo de tela de Consulta a Produtos

Edio 94 - ClubeDelphi 43
 Na funo CarregaProdutos utilizamos
uma varivel Buffer que um Array de
Char para auxiliar a transformao do
cdigo do produto de UInt16 para String.
Para isso utilizamos a funo StrIToA.
Aps isso recuperamos o valor do campo
cdigo da tabela e o transformarmos
String. Por fim recebemos o valor con-
Nota do DevMan
Nas verses mais antigas do PocketStudio, principalmente
as verses Trial, a Unit LibAll, que possue diversas funes
de converso, no vinha instalada no diretrio de instalao
do PS. Por isso, caso tenha problemas ao compilar a
aplicao, recomendado que salve o arquivo LibAll.pas
no diretrio do seu cdigo fonte. Esse arquivo pode ser
encontrado juntamente com os fontes de exemplo desse
artigo. Acesse o portal DevMedia e localize a pgina de
downloads das revistas ClubeDelphi.
Listagem 2. Procedimento de carga de Produtos
procedure CarregaProdutos;
var
Buffer: Array [0..10] of Char;
begin
if PsDataBase.RecordCount(DBPro) > 0 then
begin
StrIToA(Buffer, PsDataBase.FieldUInt16(DbPro,
Prod_Codigo));
PsField.SetText(FldCodigo, Buffer);
PsField.SetText(FldDescricao, PsDatabase.
FieldStringPtr(DbPro, Prod_DescProd));
FormatFloat(Buffer, PSDatabase.FieldDouble(DBPro,
Prod_Preco), 2);
PsField.SetText(FldPreco, Buffer);
StrIToA(Buffer, PsDataBase.FieldUInt32(DbPro,
Prod_Estoque));
PsField.SetText(FldEstoque, Buffer);
PsField.SetText(FldUn, PsDatabase.FieldStringPtr(
DbPro, Prod_Un));
PsField.SetText(FldTamanho, PsDatabase.
FieldStringPtr(DbPro, Prod_Tam));
end;
end;
Listagem 3. Cdigo dos botes de navegao
procedure BtnPrimeiroSelect;
begin
PsDataBase.First(DBPro);
CarregaProdutos;
end;
procedure BtnAnteriorSelect;
begin
PsDataBase.Prior(DBPro);
CarregaProdutos;
end;
procedure BtnProximoSelect;
begin
PsDataBase.Next(DBPro);
CarregaProdutos;
end;
procedure BtnUltimoSelect;
begin
PsDataBase.Last(DBPro);
CarregaProdutos;
end;
44 ClubeDelphi - Desenvolvendo uma Aplicao Completa com PocketStudio
vertido na propriedade Text do Field.
Para isso utilizamos a Unit PsField da
PSL e o mtodo SetText. Um passo im-
portante na funo CarregaProdutos
fazer um teste para saber se existem
registros na tabela, pois caso no exis-
tam, uma exceo ser gerada. Para
isso usamos o mtodo RecourdCount
da Unit PsDataBase.
O prximo passo codificarmos os
botes, por isso iniciaremos pelo bo-
to de Voltar. D um clique duplo no
boto BtnVoltar e seremos levados ao
fonte da Unit no evento Select. Digite
apenas o cdigo que segue:
FrmGotoForm(FrmPrincipal);
Para que possamos fazer referncia
ao formulrio principal e s funes
de nossa tabela de produtos declare as
Units ProdutosDB e UPrincipal no Uses
do formulrio atual. Observe o cdigo
a serguir:
implementation
uses
ProdutosDB, UPrincipal;
Em seguida podemos codificar o
restante dos botes. Na Listagem 3
encontramos o cdigo de cada boto.
Observe que a codificao muito sim-
ples. Apenas chamamos os mtodos
First (primeiro), Prior (anterior), Next
(prximo) e Last (ltimo), apropriado
para cada boto.
Note que em todos os botes utilizamos
a PsDataBase e os mtodos de navegao
passando como parmetro a varivel
DBProd. Essa varivel faz referncia a
nossa tabela de produtos.
Para finalizar a codificao da tela de
consulta de produtos vamos codificar o
evento OnOpen do formulrio para apre-
sentarmos os dados da tabela. Clique no
formulrio e pressione F11 para visuali-
zar suas propriedades e eventos. Na aba
Events clique duas vezes sobre o evento
OnOpen e acrescente uma chamada ao
procedimento CarregaProdutos. O cdigo
completo ficar como a seguir:
procedure FrmDadosProdutosOpen;
begin
CarregaProdutos;
PSForm.Draw;
end;
O nico detalhe agora que devemos
incluir uma chamada ao formulrio de
produtos na tela principal de nosso sis-
tema, por isso volte ao formulrio princi-
pal, clique duas vezes no boto Produtos
e digite a chamada como segue:
FrmGotoForm(FrmDadosCliente);
H mais uma configurao necessria
a ser feita em nosso projeto para que os
formulrios sejam efetivamente cha-
mados. Assim como fizemos no artigo
anterior, teremos que alterar o mtodo
ApplicationHandleEvent de forma que
possa chamar o formulrio que dese-
jamos. Para isso, abra o arquivo Vendas
equivalente ao Project>Source do Delphi.
Pressione CTRL + F12 e selecione-o.
Ser necessrio fazer a alterao apenas
do case..of ao final do procedimento.
Veja a seguir:
 TUTORIAL M INI-CURSO

case FormID of
FrmPrincipal: Listagem 4. Cdigo completo do evento ApplicationHandleEvent
FrmSetEventHandler(Form, uPrincipal.
HandleEvent); function ApplicationHandleEvent(var Event: EventType)
FrmClientes: : Boolean;
FrmSetEventHandler(Form,UDadosClientes. var
HandleEvent); FormID: UInt16;
FrmDadosProdutos: Form: FormPtr;
FrmSetEventHandler(Form, begin
UDadosProdutos.HandleEvent); Result := False;
end; if Event.eType = frmLoadEvent then
begin
Veja que adicionamos o formulrio FormID := Event.frmLoad.formID;
Form := FrmInitForm(FormID);
FrmDadosProdutos ao case..of. Cada FrmSetActiveForm(Form);
case FormID of
formulrio que vamos adicionando ao FrmPrincipal: FrmSetEventHandler(Form,
sistema, necessrio fazer alterao uPrincipal.HandleEvent);
FrmClientes: FrmSetEventHandler(Form,
nesse evento. Veja o evento completo na UDadosClientes.HandleEvent);
FrmDadosProdutos: FrmSetEventHandler(Form,
Listagem 4. UDadosProdutos.HandleEvent);
end;
Result := True;
Criando a tela de Pedidos e Itens end
end;
O primeiro passo antes de criarmos a
tela propriamente dita, criar as tabelas
necessrias para armazenar os dados
digitados. Uma boa dica, seguir os mes-
mos passos usados para criar a tabelas de
clientes e produtos. Vejamos os principais
passos a executar:
Crie uma nova Unit usando o menu
File|New>Unit e salve-a com o nome que
preferir. Nessa srie de artigos estamos
usando NomeDaTabelaDB.pas, ex:
ProdutosDB.pas;

Nota do DevMan
Formulrios Destrutivos e No Destrutivos
At agora trabalhamos apenas com formulrios
Destrutivos, mas existem duas formas de se trabalhar com
formulrios no PocketStudio como podemos ver a seguir:
Modo Destrutivo: neste modo todos os objetos visuais
do formulrio atual e seu contedo sero perdidos.
Se necessitarmos preservar os dados informados no
formulrio precisamos criar funes para salvar e restaurar
os dados. Nesse modo utilizamos a funo FrmGotoForm
para alternar entre os formulrios.
Modo No Destrutivo: o problema dessa abordagem
que no podemos dar mais de um passo, ou seja,
imaginemos trs formulrios. Podemos navegar do
primeiro para o segundo e voltar para o primeiro, mas
se tentarmos navegar do primeiro direto para o terceiro
formulrio, uma exceo ser gerada. Nessa abordagem
usamos a funo FrmPopupForm para ir para o formulrio
e FrmReturnToForm para retornar.
Tenha em mente que se precisarmos navegar entre vrios
formulrios e voltar aleatoriamente entre eles, devemos
utilizar o modo destrutivo. Tambm devemos considerar
o que o modo No Destrutivo ir carregar a memria do
dispositivo medida que os formulrios so chamados.
Em resumo, precisamos considerar cada situao e analisar
o que realmente necessrio, evitando maiores problemas
na aplicao.

Edio 94 - ClubeDelphi 45
 Crie as constantes de nome de cam-
pos e as funes necessrias para abrir
e fechar a tabela;
Crie uma funo para naveo dos
dados, CarregaDados por exemplo;
No caso de Pedidos e Itens de Pedidos,
devemos criar duas novas Units, que se
chamaro PedidosDB.pas e ItemPe-
Listagem 5. Cdigo da tabela PedidosDB
unit PedidosDB;
interface
uses PSL;
const
PedidosDBName = PedidosDB;
PedidosDBType = Rsc(DBPE);
Ped_NumeroPedido = 0;
Ped_CodCli = 1;
Ped_Emissao = 2;
Ped_Cond = 4;
Ped_Total = 5;
var
FieldDefs : array[0..4] of TFieldDef =
((DataType: ftUInt32),
(DataType: ftUInt16),
(DataType: ftDateTime),
(DataType: ftString),
(DataType: ftDouble));
bPedidosInclui
dPedidoData
DBPed
function Open: Boolean;
function Close: Boolean;
function ProcuraCodigo(Codigo: UInt32): Boolean;
implementation
dDB.pas. O cdigo fonte completo da
criao de ambas tabelas podemos ver
nas Listagens 5 e 6.
Desenhando a tela de pedidos
A tela de pedidos e itens de pedido fu-
gir um pouco do que j vimos at agora.
Crie um novo formulrio usando o menu
: Boolean;
: DateTimeType;
: TDatabase;
File|New>Form e salve-o como UPedidos.
pas e seu Name modifique para FrmPe-
didos. Modifique tambm a propriedade
Title para Cabealho do Pedido. Desenhe
uma tela semelhante a Figura 2.
H trs novidades aqui, ou seja, trs no-
vos componentes que no vimos at ago-
ra. So eles, PopupTrigger, SelectorTrigger e
List. O componente PopupTrigger em con-
junto com List funciona como se fosse um
ComboBox do Delphi. Isso significa que
podemos simular listas suspensas. Para
isso insira no formulrio um componente
PopupTrigger(PopCondicoes) da paleta
Form. Altere o seu Caption para Cond.
Pagto, assim enquanto no houver um
item selecionado, a indio de Condies
de Pagamento estar ativa. Inclua agora
um componente List(LstCondicoes)
e insira alguns itens na propriedade
Items do controle. Em seguida retorne ao
componente PopCondicoes e selecione o
LstCondicoes na propriedade PopupList.
Isso far com que a lista de condies de
pagamento aparea ao clicar no Popup-
Trigger. Para evitar que o PopCondicoes
aparea constantemente, marque sua
propriedade Visible com o valor False.

function Open: Boolean;

begin www.devmedia.com.br/clubedelphi/portal.asp
Result := PSDatabase.Open(DBPed, PedidosDBName,
dmModeReadWrite); Acesse agora o mesmo o portal do assinante ClubeDelphi e assista a
if not Result then
begin uma vdeo aula de Ricardo Boaro que mostra como trabalhar com os
Result := PSDatabase.CreateDatabase(PedidosDBName, componentes SelectorTrigger e List.
Creator, PedidosDBType);
if Result then www.devmedia.com.br/articles/viewcomp.asp?comp=7606
Result := PSDatabase.Open(DBPed, PedidosDBName,
dmModeReadWrite);
end;

if not Result then

begin
ShowSystemError(PSDatabase.LastError);
Exit;
end;

PSDatabase.SetFieldDefs(DBPed, FieldDefs[0],
SizeOf(FieldDefs) div SizeOf(FieldDefs[0]));
end;

function Close: Boolean;

begin
Result := PSDatabase.Close(DBPed);
end;

function ProcuraCodigo(Codigo: UInt32): Boolean;

begin
PSDatabase.First(DBPed);
while not PSDatabase.EOF(DBPed) do
begin
if PSDatabase.FieldUInt32(DBPed, Ped_NumeroPedido)
= Codigo then
begin
Result := True;
exit;
end;
PSDatabase.Next(DBPed);
end;
Result := False;
end;
end.
Figura 2. Exemplo de tela de Consulta a Pedidos

46 ClubeDelphi - Desenvolvendo uma Aplicao Completa com PocketStudio

 TUTORIAL M INI-CURSO

Os nomes dos componentes seguem a
mesma linha empregada nas telas ante-
riores. Use o prefixo Fld para campos
e Btn para botes. Nessa janela en-
contramos os campos FldNumPedido,
FldCliCodigo, FldCliNome e Fld-
ValTotal. E ainda os botes BtnNovo,
BtnItens, BtnPrimeiro, BtnAnte-
rior, BtnProximo, BtnUltimo, Btn-
Fim e BtnGravar, respectivamente da
esquerda para a direita.
Listagem 6. Cdigo da tabela ItemPedDB
unit ItemPedDB;
interface
uses PSL;
const
ItemPedDBName = ItemPedDB;
ItemPedDBType = Rsc(DBIP);
Itp_NumeroPed = 0;
Itp_CodProd = 2;
Itp_Qtde = 3;
Itp_Preco = 4;
Abaixo do campo Emisso, insira um
boto comum e troque seu Caption para
Localiza Cliente. Aproveite e modifi-
que a propriedade Frame usando a opo
frNone, assim retiramos sua borda.
Com exceo dos controles SelectorTri-
gger, PopupTrigger e List, j trabalhamos
com os componentes utilizados nessa
tela, sendo assim cabe um explicao
sobre os novos componentes.
SelectorTrigger: Este componente
da famlia dos botes, portanto uti-
lizamos a Unit PsButton da PSL para
trabalharmos com ele. A diferena
que podemos chamar formulrios em
modo modal com ele. Esse componente
ser usado na Emisso, portanto insira
um SelectorTrigger(SltEmissao) logo
direita do Label Emisso;
PopupTrigger: Mais um componente
da famlia dos botes e sua funciona-
lidade depende do uso em conjunto
com um objeto lista. Ele sozinho no
tem utilidade, imaginemos ele como o
conhecido ComboBox do Delphi, em
run-time ele muito similar;
List: Lista um objeto bastante uti-
lizado por ns desenvolvedores, pois
est disponvel em praticamente todos
os ambientes de desenvolvimento. Du-
rante o desenvolvimento da nossa srie

var Listagem 7. Cdigo de todos os botes da tela de Pedidos

FieldDefs : array[0..3] of TFieldDef =
((DataType: ftUInt32),
procedure BtNovoSelect;
(DataType: ftUInt16),
begin
(DataType: ftUInt16),
PsDataBase.Insert(DBPed);
(DataType: ftDouble));
end;
procedure BtPedItensSelect;
bItemPedInclui : Boolean;
begin
DBItp : TDatabase;
FrmGotoForm(FrmPedidoItem);
end;
function Open: Boolean;
procedure BtInicioSelect;
function Close: Boolean;
begin
function ProcuraCodigo(Codigo: UInt16): Boolean;
PsDataBase.First(DBPed);
end;
implementation
procedure BtAnteriorSelect;
begin
function Open: Boolean;
PsDataBase.Prior(DBPed);
begin
end;
Result := PSDatabase.Open(DBItp, ItemPedDBName, dmModeReadWrite);
procedure BtProximoSelect;
if not Result then
begin
begin
PsDataBase.Next(DBPed);
Result := PSDatabase.CreateDatabase(ItemPedDBName, Creator, ItemPedDBType);
end;
if Result then
procedure BtFimSelect;
Result := PSDatabase.Open(DBItp, ItemPedDBName, dmModeReadWrite);
begin
end;
PsDataBase.Last(DBPed);
end;
if not Result then
procedure BtGravarSelect;
begin
begin
ShowSystemError(PSDatabase.LastError);
PsDataBase.Post(DBPed);
Exit;
end;
end;
procedure BtExcluirSelect;
begin
PSDatabase.SetFieldDefs(DBItp, FieldDefs[0],
PsDataBase.Delete(DBPed);
SizeOf(FieldDefs) div SizeOf(FieldDefs[0]));
end;
end;
procedure BtnVoltarSelect;
begin
function Close: Boolean;
FrmGotoForm(FrmPrincipal);
begin
end;
Result := PSDatabase.Close(DBItp);
end;
Listagem 8. Cdigo dos botes Produtos e Pedidos
function ProcuraCodigo(Codigo: UInt16): Boolean;
begin
..
PSDatabase.First(DBItp);
uses
while not PSDatabase.EOF(DBItp) do
UDadosClientes, UDadosProdutos,
begin
UDadodsPedidos;
if PSDatabase.FieldUInt16(DBItp, Itp_NumeroPed) = Codigo then
..
begin
procedure btnProdutosSelect;
Result := True;
begin
exit;
FrmGotoForm(FrmDadosProdutos);
end;
end;
PSDatabase.Next(DBItp);
end;
procedure btnPedidosSelect;
Result := False;
begin
end;
FrmGotoForm(FrmDadosPedidos);
end.
end;

Edio 94 - ClubeDelphi 47
de artigos trabalharemos muito com Precisamos agora preparar o sistema dever adicionar ao Uses do formulrio
a List e entenderemos suas principais para que possa abrir as novas telas a principal as duas Units para referncia.
funcionalidades. partir do formulrio principal. Por- Se preferir veja o trecho cdigo dos dois
Aps entendermos o funcionamento tanto, retorne o formulrio principal e botes na Listagem 8.
dos novos componentes, vamos codificar codifique, no evento OnSelect dos botes Apenas para lembrar, devemos acres-
nosso fonte. Na Listagem 7 encontramos Produtos e Pedidos, uma chamada ao centar o formulrio de pedidos no Unit
o cdigo de cada boto incluso no exem- mtodo FrmGotoForm indicando qual principal do projeto, na funo Appli-
plo. Codifique conforme necessrio. formulrio ser aberto. No esquea que cationHandleEvent, para que o sistema
operacional do PalmOS reconhea o
Listagem 9. Cdigo do mtodo ApplicationHandleEvent alterado formulrio de Pedidos e Produtos como
function ApplicationHandleEvent(var Event: EventType):
parte da aplicao. Abra a unit Vendas
Boolean; e adicione a chamada ao case..of no
var
FormID: UInt16; mtodo. Veja o cdigo completo na
Form: FormPtr;
begin Listagem 9.
Result := False; Aproveitando que estamos mexendo
if Event.eType = frmLoadEvent then
begin na Unit Vendas, precisamos fazer dois
FormID := Event.frmLoad.formID;
Form := FrmInitForm(FormID); ltimos ajustes. Precisamos abrir e fe-
FrmSetActiveForm(Form);
case FormID of char as tabelas ProdutosDB, PedidosDB e
FrmPrincipal: FrmSetEventHandler(Form, ItemPedDB nos mtodos StopApplication
uPrincipal.HandleEvent);
FrmClientes: FrmSetEventHandler(Form, e StartApplication.
UDadosClientes.HandleEvent);
FrmDadosProdutos: FrmSetEventHandler(Form, Localize-os e altere conforme a Lis-
UDadosProdutos.HandleEvent);
FrmDadosPedidos: FrmSetEventHandler(Form,
tagem 10. Observe que o evento Sto-
UDadodsPedidos.HandleEvent); pApplication fecha as tabelas usando o
end;
Result := True; mtodo Close e o evento StartApplication
end.
end; abre-as usando o mtodo Open. A nica
particularidade, que na abertura das
Listagem 10. Cdigo dos eventos StopApplication e StartApplication alterados
tabelas, ns testamos se a tabela pode ser
function StartApplication: Boolean; aberta. Em caso negativo enviamos uma
begin
{ Abre o banco de dados de Clientes. Se no conseguir mensagem informando que a tabela no
abrir, }
{ no executa a aplicao}
pode ser encontrada.
if not ClientesDB.Open then
begin
ShowMessage(Tabela de Clientes no encontrada!); Concluso
Result := False;
Exit; Nesse artigo criamos a tela de consulta
end;
if not ProdutosDB.Open then
a produtos, o banco de dados de pedidos
begin e itens do pedido, conhecemos os concei-
ShowMessage(Tabela de Produtos no encontrada!);
Result := False; tos de formulrios do Palm, destrutivo
Exit;
end; e no destrutivo, e criamos a tela do
if not PedidosDB.Open then cabealho do pedido. No prximo artigo
begin
ShowMessage(Tabela de Itens no encontrada!); criaremos a tela de Itens do Pedido e
Result := False;
Exit; construiremos o Conduit. At o prximo
end;
if not ItemPedDB.Open then artigo, e bons cdigos a todos!
begin
ShowMessage(Tabela de Itens no encontrada!);
Result := False;
Exit;
end;
Result := PSApplication.CheckROMVersion($2003000);
if not Result then
begin
FrmCustomAlert(AlertIncompatible,2.0, nil, nil);
Exit;
end;
D seu feedback sobre esta edio! Feedback
eu
FrmGotoForm(FrmPrincipal);
s
D

end;
A Java Magazine tem que ser feita ao seu
sobre e

procedure StopApplication; gosto. Para isso, precisamos saber o que

begin
s

ta
e
voc, leitor, acha da revista!
d i o
ClientesDB.Close;
ProdutosDB.Close;
PedidosDB.Close;
ItemPedDB.Close;
D seu voto sobre este artigo, atravs do link:
FrmCloseAllForms;
end; www.devmedia.com.br/javamagazine/feedback

48 ClubeDelphi - Desenvolvendo uma Aplicao Completa com PocketStudio

 AMIGO
...s pra lembrar,
Existem coisas sua assinatura pode
estar acabando!
que no
conseguimos
ficar sem!
Renove J!

www.devmedia.com.br/renovacao
Para mais informaes:
www.devmedia.com.br/central
Seo DELPHI Seo EASY DELPHI
Nesta seo voc encontra artigos para iniciantes
na linguagem Delphi
Envio de E-mails com componentes
da paleta Indy
Veja como enviar e-mails utilizando os componentes da paleta Indy
Maikel Marcelo Scheid
(maikelscheid@gmail.com)
tcnico em Informtica com nfase em An-
lise e Programao de Sistemas. Atua na rea
de Desenvolvimento de Softwares em Delphi
para plataforma Win32 e .NET com banco de
dados Firebird e MS SQL. membro da Equipe
Editorial ClubeDelphi.
50 ClubeDelphi - Envio de E-mails com componentes da paleta Indy
Seo PHP
O
envio de e-mails automatizado
em sistemas simplesmente
uma ferramenta fantstica.
Atravs de componentes e mtodos, o
desenvolvedor disponibiliza em seu
sistema uma agenda de e-mails, que ao
ser configurada dispara e-mails com re-
latrios, avisos, entre outros, automatica-
mente aos seus destinatrios. No Delphi,
podemos contar com os componentes
da paleta Indy para criar um sistema de
envio de e-mails.
Neste artigo veremos a criao de um
sistema simples de envio de mensagens
eletrnicas (e-mail), onde faremos alm
das configuraes normais de remetente,
destinatrio, assunto e mensagem a confi-
gurao de autenticao dos usurios por
SMTP, tambm a configurao para que o
e-mail possa ser enviado com anexos.
Criando a aplicao
Utilizaremos o Delphi 7 para a cria-
o do sistema de envio de e-mail
com componentes da paleta Indy.
Com o Delphi aberto, utilize o menu
File|New>Application para criar uma
nova aplicao. Altere a propriedade
Name do formulrio principal para frm-
SendMail e o Caption altere para Envio
de E-mails. Salve a Unit do formulrio
principal como uEmail.pas e o projeto
salve como prjEmail.dpr.
Nota do DevMan
De forma bem simples, o envio de e-mails funciona
basicamente atravs de um cliente de e-mail acessado
pelo browser de internet ou atravs de gerenciadores
instalados e configurados nas estaes de trabalho,
tais como Microsoft Outlook, Outlook Express, Mozilla
Thunderbird entre outros. O usurio que necessita de sua
utilidade precisa ter uma credencial de cadastro (usurio
e senha) em um servidor de e-mails SMTP (Simple Mail
Transfer Protocol) para o envio dos e-mails. Toda vez
que a ao de envio for requisitada ao gerenciador, uma
autenticao ser realizada no servidor, e este por sua
vez ir proceder com o envio do texto/arquivo para o
destinatrio pr-informado.
 EASY DELPH I

Ajuste as dimenses do formulrio al-

terando sua propriedade Height para 580
e Width para 510. Logo no cabealho do
formulrio arraste da paleta Standard um
componente GroupBox(gbSMTP), alte-
rado sua propriedade Caption para Au-
tenticao de Usurios SMTP. Dentro
do componente gbSMTP adicione ao topo Figura 1. Componentes para autenticao SMTP
um componente CheckBox(CkSMTP),
alterando sua propriedade Caption para
Meu servidor requerer uma autentica-
o SMTP para envio de e-mails, que
ser utilizado nos casos em que neces-
sria autenticao para realizar o envio
da mensagem. Adicione logo abaixo do
ckSMTP trs componentes Label, alteran-
do a propriedade Caption de ambos para
Host, Usurio e Senha, respecti-
vamente. Logo abaixo cada Label adicio-
nado iremos inserir trs componentes
de texto. Arraste da paleta Additional
um componente MaskEdit(edtHost) e
altere sua propriedade EditMask para
999\.999\.999\.999;1;_, sendo esta a
Figura 2. Cabealho do E-mail
mscara para formatao do endereo
TCP/IP do servidor de autenticao
SMTP a ser utilizado para o envio.
Altere tambm a propriedade Text do
componente para 000.000.000.000.
Arraste agora da paleta Standard dois
componentes Edit, alterando a proprie-
dade Name de ambos para edtUsuario
e edtSenha, respectivamente de acordo
com os Captions dos Labels acima. Seu
gbSMTP ficar semelhante imagem
ilustrada na Figura 1.
Ad ic ione i med iata mente aba i xo
ao gbSMTP um novo componente
GroupBox(gbEmail), alterando seu Cap-
tion para Cabealho do E-mail. Dentro
do gbEmail adicione ao topo um Label
com o Caption De: e imediatamente
abaixo arraste da paleta Standard um
Edit(emailDe) e remova o valor da sua
propriedade Text deixando-o em branco.
Logo abaixo ao emailDe, arraste um novo
Label com o Caption Para: inserindo em
seguida da paleta Standard um compo-
nente Memo(edtPara) e removendo seu
texto na propriedade Lines. Altere tam-
bm a propriedade ScrollBars do edtPara
para ssVertical fazendo com que uma
barra de rolagem no sentido vertical seja
exibida no componente. Ainda abaixo
do mesmo, arraste um Label com o Cap- Figura 3. Formulrio de envio de e-mails

Edio 94 - ClubeDelphi 51
tion Assunto e insira um componente
Edit(edtAssunto), removendo tambm
o seu Text. Ao final desta configurao,
seu formulrio dever estar de acordo
com a Figura 2.
Para incluso de anexos ao e-mail, adi-
cione logo abaixo ao gbEmail um novo
GroupBox(gbAnexo), alterando seu
Caption para Anexo e arraste para
dentro do mesmo um componente
ListView(emailAnexo) da paleta Win32.
Ainda abaixo ao gbAnexo, adicione mais um
GroupBox(gbMensagem) e defina seu Cap-
tion para Mensagem. Arraste para dentro
do gbMensagem um componente RichEdit
(emailMensagem) da paleta Win32 e re-
mova o texto da sua propriedade Lines.
Listagem 1. Adicionando anexos ao e-mail
procedure TfrmSendMail.Anexararquivo1Click(Sender: TObject);
var
files: TListItem;
begin
if OpenAnexo.Execute then
begin
files := emailAnexo.Items.Add;
files.Caption := OpenAnexo.FileName;
end;
end;
Listagem 2. Cdigo para excluso de anexo
procedure TfrmEmails.Excluir1Click(Sender: TObject);
var
Arquivo : string;
begin
Arquivo := ExtractFileName(emailAnexo.Items.Item[
emailAnexo.ItemIndex].Caption);
if Application.MessageBox(PAnsiChar(Deseja excluir
o arquivo + Arquivo + ?), Excluir anexo,
MB_YESNO) = idYes then
emailAnexo.Items.Delete(emailAnexo.ItemIndex);
end;
Ao final do formulrio, adicione ainda
da paleta Additional dois componentes
BitBtn(btnEnviar e btnCancelar).
Altere a propriedade Caption de ambos
para ENVIAR e CANCELAR, respec-
tivamente. Inclua, atravs da propriedade
Glyph, uma imagem a cada um dos botes.
Ao final seu formulrio estar com o Layout
e semelhante a Figura 3. Veremos a seguir
os componentes necessrios para envio do
e-mail e adio dos anexos mensagem.
Componentes para envio do e-mail
e adio de anexos
Veremos a seguir os componentes ne-
cessrios a serem adicionados no formu-
lrio para o envio do e-mail. Ao lado de
Figura 4. Envio do e-mail
cada componente, veja para qual funo
ser utilizado e quais as configuraes
necessrias:
- IdSMTP (CompSMTP) da paleta
IndyClients: ser o responsvel pela
comunicao direta com o servidor de
autenticao e envio dos e-mails SMTP.
As configuraes de suas propriedades
sero realizadas em tempo de execuo
e veremos a seguir.
- IdMessage (CompMensagem) da
paleta Indy Misc: componente no qual
criamos o e-mail. Nele que sero adi-
cionados o assunto, mensagem, entre
outras partes do e-mail. Sua configu-
rao tambm ser realizada em tempo
de execuo.
- IdAntiFreeze (AntiGelo) da paleta
Indy Misc: sua utilidade no deixar a
aplicao congelar enquanto o e-mail
est sendo enviado. O componente man-
tm o formulrio atualizado, permitindo
que at durante o envio o usurio possa
continuar interagindo com o sistema.
- OpenDialog (OpenAnexo) da paleta
Dialogs: ser utilizado para localizar os
anexos a serem adicionados ao e-mail.
No requer nenhuma configurao es-
pecial, pois ser utilizado apenas para
localizar os arquivos.
- PopupMenu (MenuAnexo) da pa-
leta Standard: relacione o componente
propriedade PopupMenu do componente
emailAnexo. Ser utilizado no clique do bo-
to direito sobre o componente emailAnexo
para adicionar ou remover arquivos. Com
um duplo clique sobre o componente Me-
nuAnexo, crie dois itens de menu (Anexar
arquivo e Excluir arquivo).
- ImageList (Imagens) da paleta Win32:
componente onde iremos adicionar duas
imagens que sero listadas junto com o
componente MenuAnexo. Com um duplo
clique sobre o componente Imagens utilize
o boto Add e localize dois cones relacio-
nados aos menus criados no PopupMenu.
Por default voc ir encontrar cones para
serem adicionados no caminho C:\Arqui-
vos de programas\Arquivos comuns\Borland
Shared\Images\Buttons.
Aps adicionadas duas imagens, volte
ao componente MenuAnexo e relacione
a propriedade Images ao componente
Imagens. Com um duplo clique sobre
o componente, selecione cada um dos

52 ClubeDelphi - Envio de E-mails com componentes da paleta Indy


itens de menu adicionados e na pro-
priedade ImageIndex selecione o cone
correspondente.
Anexando arquivos ao E-mail
Com um clique duplo sobre o componen-
te MenuAnexo, selecione o item de menu
Anexar arquivo e adicione a seu evento
OnClick o cdigo da Listagem 1, obedecen-
do a criao de uma varivel do tipo TLis-
tItem para que seja instanciado o arquivo
selecionado e exibido no emailAnexo.
O cdigo bem simples, apenas cria-
mos uma varivel do tipo TListItem e
chamamos o mtodo Execute do controle
OpenAnexo. Aps a seleo de um arqui-
vo na caixa de dilogo, adicionamos um
novo item ao emailAnexo, componente
ListView, e configuramos o seu Caption
com o nome do arquivo selecionado.
J no item de menu Excluir arqui-
vo removemos o arquivo da lista de
anexos. Primeiro copiamos o nome do
arquivo selecionado em uma varivel
do tipo String e em seguida chamamos
o mtodo Delete do componente emailA-
nexo. Veja a Listagem 2.
Enviando o e-mail
Para realizar o envio do e-mail pre-
cisamos criar em tempo de execuo
algumas configuraes relacionadas aos
componentes adicionados. Adicione ao
evento OnClick do btnEnviar o cdigo da
Listagem 3, que encontra-se comentado de
acordo com cada ao que est ocorrendo
durante o processo de envio do e-mail.
muito importante que todo o cdigo
seja mantido em um bloco try..finally
sendo que entre o finally..end dever
estar a linha para desconectar ao servi-
dor SMTP. Tanto num caso de sucesso
do envio do e-mail ou num caso em
que ocorra uma falha, o componente
desconectado no deixando nenhuma
porta de ligao aberta.
O cancelamento do envio do e-mail na
verdade trata-se de uma sada do for-
mulrio. Para tanto adicione ao evento
OnClick do btnCancelar uma chamada
ao mtodo Close.
Configurados todos os eventos da
aplicao, execute a mesma e faa o teste
de envio. Certifique-se antes de que est
usando um IP vlido para autentica-
EASY DELPH I
o SMTP como servidor de sada das da formatao do texto a ser enviado.
mensagens. Estando corretas todas as Aplique este recurso ao seu sistema dei-
informaes, seu e-mail ser enviado xando-o mais funcional e atrativo para
com sucesso (Figura 4). seu cliente. Abrao e at a prxima.
Concluso D seu feedback sobre esta edio! eu
Feedback
s
Neste artigo aprendemos a criar uma
D
A Java Magazine tem que ser feita ao seu
sobre e
aplicao de envio de e-mails utilizan-
gosto. Para isso, precisamos saber o que
do os componentes da paleta Indy do
s
ta
edio
voc, leitor, acha da revista!
Delphi. Com estes cdigos voc poder
implementar novas funcionalidades, D seu voto sobre este artigo, atravs do link:
como por exemplo opes de solicitao www.devmedia.com.br/javamagazine/feedback
de entrega e leitura da mensagem, alm
Listagem 3. Enviando o e-mail
procedure TfrmSendMail.btnEnviarClick(Sender: TObject);
var
i : integer;
begin
try
{ Verifica se o campo remetente foi preenchido }
if emailDe.Text <> then
begin
{ Verifica se o campo destinatsio foi preenchido }
if emailPara.Text <> then
begin
{ Verifica se o campo assunto foi preenchido }
if emailAssunto.Text <> then
begin
{ Verifica se a mensagem foi preenchida }
if emailMensagem.Lines.Text <> then
begin
{ Verifica se o servidor de SMTP requer autenticao. De acordo com a
seleo, o tipo de autenticao do componente ser alterada }
if ckSMTP.Checked then
CompSMTP.AuthenticationType := atLogin else
CompSMTP.AuthenticationType := atNone;
{ Configura o Host do servidor de SMTP a ser utilizado para o envio do e-mail }
CompSMTP.Host := edtHost.Text;
{ Configurao do usurio e senha para autenticao no Host de SMTP }
CompSMTP.Username := edtUsuario.Text;
CompSMTP.Password := edtSenha.Text;
{ Faz a conexo ao servidor SMTP }
CompSMTP.Connect;
{ Verifica se o servidor SMTP foi conectado }
if CompSMTP.Connected then
begin
{ Configura a mensagem a ser enviada. Passagem de valores as propriedades }
CompMensagem.Clear;
CompMensagem.Priority:=mpHighest;
{ Low = baixo / High = alto / mpHighest = urgente }
CompMensagem.ContentType := text/html;
CompMensagem.From.Text := emailDe.Text;
CompMensagem.Recipients.EMailAddresses := emailPara.Lines.Text;
CompMensagem.Subject := emailAssunto.Text;
CompMensagem.Body.Text := emailMensagem.Text;
{ Anexa os arquivos ao e-mail }
for i := 0 to emailAnexo.Items.Count - 1 do
TIdAttachment.Create(CompMensagem.
MessageParts, TFileName(emailAnexo.
Items[i].Caption));
{ Faz o envio do e-mail }
CompSMTP.Send(CompMensagem);
MessageDlg(E-mail enviado com sucesso!,mtInformation, [mbOK], 0);
end;
end
else
ShowMessage(Informe a mensagem do e-mail);
end
else
ShowMessage(Informe o assunto do e-mail!);
end
else
ShowMessage(Informe o destinatrio do e-mail!);
end
else
ShowMessage(Informe o e-mail do remetente!);
Finally
{ desconecta do servidor SMTP }
CompSMTP.Disconnect;
end;
end;
Edio 94 - ClubeDelphi 53
 Seo DELPHI Seo EASY DELPHI
Nesta seo voc encontra artigos para iniciantes
na linguagem Delphi
Editor de Textos com RichEdit
Veja como criar seu prprio editor de textos com o componente RichEdit
Maikel Marcelo Scheid
(maikelscheid@gmail.com)
tcnico em Informtica com nfase em An-
lise e Programao de Sistemas. Atua na rea
de Desenvolvimento de Softwares em Delphi
para plataforma Win32 e .NET com banco de
dados Firebird e MS SQL. membro da Equipe
Editorial ClubeDelphi.
54 ClubeDelphi - Editor de Textos com RichEdit
Seo PHP
M
uitas vezes utilizamos em nos-
sas aplicaes o componente
RichEdit, que possibilita aos
programadores aplic-los em inmeras
situaes durante o desenvolvimento de
suas aplicaes. Entre as diversas utili-
dades esto formulrios de cadastros
como notcias, formulrios de envio de
e-mail ou a criao de seu prprio editor
de textos. Com o componente RichEdit
voc pode criar e aperfeioar muitas das
utilidades que o Notepad (Bloco de No-
tas) do Windows possui. Pode inovar
na criao de um Layout e na aplicao
de ferramentas e configuraes na digi-
tao de textos, salv-los e reabri-los sem
perder nenhuma formatao.
Veja neste artigo a criao de um
simples editor usando o componente
RichEdit e aprenda maneiras de como
utilizar suas propriedades codificando
situaes de formatao de textos, tais
como alterao da fonte, tamanho e
cor da letra, utilizao de estilos de
formatao como negrito, sublinhado
entre outros. Tambm alinhamentos e
espaamentos de pargrafos. Faremos
uso tambm, em algumas situaes, de
alguns componentes da paleta Dialogs do
Delphi com a funo de definir o Layout
de impresso, salvar e abrir documentos
salvos pelo editor de textos ou at mesmo
por outros editores.
Criando a aplicao
A criao do editor de textos trata-se de
uma simples aplicao na qual utilizaremos
o Delphi 7 para a criao do aplicativo
Win32. No ser necessria a utilizao de
nenhuma espcie de banco de dados ou ins-
talao de componentes de terceiros. Sero
apenas utilizados componentes nativos das
paletas do Delphi. Crie a aplicao no menu
File|New>Application e altere a propriedade
Caption do formulrio principal para Meu
editor de Textos e em seguida nomeie o
formulrio para frmEditor. Salve a Unit
do formulrio como uPrincipal.pas e o

projeto como TextEditor.dpr. Adicione
ao formulrio principal um componente
MainMenu(MainMenu1) da paleta Stan-
dard e com duplo clique do mouse crie uma
estrutura de menus conforme ilustrado na
Figura 1. Esta estrutura de menus tambm
ser utilizada mais adiante para a criao
dos atalhos de acesso rpido.
Definida agora toda a estrutura de me-
nus e opes do nosso editor de textos,
vamos adicionar da paleta Win32 um
componente ToolBar(BarraButtons)
para que possamos criar alguns atalhos
de acesso rpido a algum menus do siste-
ma. Com o clique do boto direito sobre
a ToolBar selecione a opo New Button,
criando assim um novo boto (btNovo)
na barra de atalhos. Crie logo aps mais
trs botes utilizando o mesmo mtodo.
Nomeie os botes como btAbrir, bt-
Salvar e btImprimir, respectivamente.
Dessa forma acabamos de criar os botes
de atalho para os principais itens do
menu Arquivo e vamos criar agora para
os itens do menu Editar.
Antes de criar um novo boto na barra
de atalhos, vamos adicionar um sepa-
rador a fim de organizar melhor e cate-
gorizar por grupos de funes na barra
de atalhos. Clicando sob a barra com o
boto direito do mouse e selecionando
a opo New Separator.
Criado um separador logo aps o pri-
meiro grupo de botes, criaremos agora
os botes para relacionar atalhos aos itens
do menu Editar. Crie trs botes destinados
a este grupo com os nomes btCopiar,
btRecortar e btColar. Logo aps adi- atalho, arraste para o formulrio um
cione um novo separador ao menu.
Sendo nossa idia a de criar um editor
de textos, interessante que para uma
fcil edio do mesmo o usurio tenha
sempre de fcil acesso os tipos de fontes
para que a qualquer momento possa
alter-la em trechos do seu texto. Para
oferecer esta opo ao usurio, adicio-
naremos tambm barra de atalhos um
componente ComboBox(ckFontes) da
paleta Standard que ser povoado logo
mais com toda a lista de fontes instaladas
no Windows. Adicionado o componente,
crie um novo separador na barra de ata-
lhos. Alm da alterao do tipo de fonte
em um texto, o usurio precisa tambm
ter sempre de fcil acesso a alterao do
EASY DELPH I
tamanho da fonte que est utilizando, componente BarraButtons relacione a
e para isso adicione barra um novo propriedade Images do mesmo ao AtalhoI-
componente ComboBox(ckTamanho), mages, observando que alguns atalhos j
e na sua propriedade Items adicione assumiram de forma automtica alguns
as variaes de tamanhos que deseja cones de identificao.
disponibilizar. No editor de itens do Para editar os cones de cada boto e
componente adicione, separados por adequ-los ao cone de sua respectiva
linha, os seguintes valores: funcionalidade, clique sobre a propriedade
ImageIndex e na lista de imagens disponveis
6, 8, 10, 11, 12, 14, 16, 18, 20, 22, 24,
28, 30, 32, 40. selecione qual corresponde sua funo.
Ao final da edio das imagens, a barra de
A alterao das cores de um texto que se atalhos do sistema dever ficar estruturada
est digitando tambm uma caracters- de forma semelhante a Figura 3.
tica muito importante durante a criao A configurao dos cones de menu
de um editor. Inclua na barra de atalhos tambm dever ser realizada no compo-
um componente ColorBox(ckCor) da nente MainMenu1, onde tambm dever
paleta Additional e em seguida insira relacionar sua propriedade Images ao
mais um separador barra. AtalhoImages e com um duplo clique
Para permitir a formatao e aplicao ao abrir o editor de menus, selecione
de estilos de formatao para textos com cada um deles alterando o cone rela-
negrito, itlico, sublinhado e riscado, cionado a sua propriedade ImageIndex.
adicione barra de atalhos quatro botes, Alterados e configurados todos os cones
btNegrito, btItalico, btSublinhado de identificao de menus e atalhos do
e btRiscado. Insira um novo separador. editor, vamos agora adicionar o principal
Por ltimo, inclua na barra de atalhos mais componente da nossa aplicao ao for-
trs botes btEsquerda, btCentro e mulrio. Na paleta Win32 adicione um
btDireita que sero utilizados com a fi- componente RichEdit(TextEditor), de-
nalidade de alinhar o texto para esquerda, fina sua propriedade Align para alClient
centralizar e organizar direita.
Nossa aplicao est aparecendo ago-
ra de uma forma um tanto estranha,
temos apenas o menu e uma barra de
atalhos com vrios botes, sendo que
nenhum deles ainda dispe de qualquer
tipo de identificao visual para sua
funcionalidade. Para definir um estilo
de layout e caracterizar cada boto de
componente ImageList(AtalhoImages)
da paleta Win32. Com um clique duplo
sobre o mesmo abra seu editor e adicione
uma srie de imagens de acordo com as
funcionalidades que queremos atribuir ao
nosso editor de textos. As imagens a serem
adicionadas devero estar com formatos
de arquivo como *.bmp ou *.ico e podero
ser facilmente localizadas no diretrio de
imagens instaladas pelo prprio Delphi,
encontradas no caminho padro em C:\
Arquivos de programas\Arquivos comuns\
Borland Shared\Images\Buttons. Cada ima-
gem adicionada para o componente Image-
mList recebe um nmero de identificao
que usaremos para definir os atalhos nos
botes (Figura 2). Selecionando agora o Figura 1. Estrutura de menus do sistema
Edio 94 - ClubeDelphi 55
e remova o texto padro exibido na sua
propriedade Lines.
Posicionado agora sob a paleta Dialogs,
adicione ao formulrio os componentes
PrintDialog(dlgPrint) que ser utiliza-
do para configurao e envio do texto
impressora, SaveDialog(dlgSave)
utilizado para salvar e armazenar o
texto do editor como um documento em
qualquer unidade de armazenamento
do computador e tambm adicione um
OpenDialog(dlgOpen) utilizado para
localizar documentos armazenados no
computador e reabri-los a fim de ler ou
continuar com a edio do texto.
O formato de arquivo que utilizaremos
ser o .rtf, ao qual iremos definir um filtro
para a propriedade Filter dos componen-
tes dlgSave e dlgOpen. Abrindo o editor
de filtros dos componentes, defina dois
filtros em linhas diferentes, obedecendo
o Filter Name como Arquivos de Texto
(*.rtf) e Todos os arquivos e na coluna
Filter obedea *.rft e *.*, respectivamente
(Figura 4). Essas configuraes iro fazer
com que apenas arquivos com esta exten-
so sejam exibidos na hora de salvar ou
localizar documentos nas unidades de
armazenamento do computador. Confi-
gure ainda em ambos os componentes a
propriedade DefaultExt, atribuindo-lhes o
valor *.rtf que ser a extenso padro que
adotamos para nosso sistema.
Figura 2. Adicionando imagens para ImageList
Figura 3. Barra de atalhos do Editor de Textos
56 ClubeDelphi - Editor de Textos com RichEdit
Ao final da adio e configurao de
todos os componentes ao formulrio,
sua aplicao dever estar semelhante
aplicao da Figura 5, na qual passare-
mos a partir deste momento a codificar
as funes do nosso editor.
Codificando a aplicao
A codificao de todo o processo do
editor de textos no ser muito compli-
cada, vemos que se trata de pequenos
blocos de comandos que sero facilmente
entendidos e podero ser aplicadas a
vrias outras situaes que voc poder
se deparar enquanto desenvolver sua
aplicao. A primeira codificao que
veremos ser quanto a criao do formu-
lrio (evento OnCreate) onde iremos re-
alizar algumas configuraes que sero
os Default do nosso editor. Acessando o
editor de cdigos do formulrio, declare
na seo private a seguinte procedure que
ser responsvel por capturar todas as
fontes instaladas no Windows e preen-
cher a lista no componente ckFontes.
procedure ObtemFontes;
Posicionado sobre a declarao da
procedure utilize as teclas Ctrl+Shift+C
para que o Delphi crie o cabealho do
procedimento, e adicione ao mesmo o
cdigo da Listagem 1, onde criaremos
uma function derivada dentro da proce-
dure que ser referenciada como forma
de ponteiro e referncia a um espao de
memria a ser locado no sistema. Ainda
dentro da procedure criamos uma vari-
vel do tipo LongWord que usada para
carregar os nomes das fontes e logo mais
so atribudas ao componente ckFontes.
No evento OnCreate do formulrio, adi-
cione as seguintes linhas de cdigo, que
iro chamar a procedure do carregamento
das fontes recm criada e definir nos
componentes ckFontes e ckTamanho o tipo
e tamanho das configuraes padro que
esto definidas no sistema, trazendo-as
selecionadas:
ObtemFontes;
ckFontes.Text := DefFontData.Name;
ckTamanho.Text :=
IntToStr(-MulDiv(DefFontData.Height, 72,
Screen.PixelsPerInch));
Nas prximas linhas de cdigo, vamos
atribuir funcionalidades aos menus do
sistema (MainMenu1), e para os casos de
existir um atalho rpido na barra corres-
pondente a um item do menu original
(menu Abrir por exemplo), iremos apenas
relacionar o boto ao item atravs da
sua propriedade MenuItem que veremos
tambm mais a seguir.
Clique duas vezes no MainMenu1 e com
ele aberto navegue ao item Arquivo>Novo.
Automaticamente o Delphi nos cria o
cabealho do evento OnClick desse item
ao qual digitaremos as seguintes linhas
de comando:
if TextEditor.Modified then
ShowMessage(Deseja salvar arquivo)
else
TextEditor.Lines.Clear;
No cdigo verificamos se houve al-
guma alterao do texto digitado e
perguntamos se o usurio deseja salvar
o contedo ou seno limpamos todos os
valores existentes na linhas.
Repita esse processo e digite o cdigo
da Listagem 2 no evento OnClick do
menu Arquivo>Abrir. Esse evento ir
executar uma caixa de pesquisa do
componente dlgOpen e ao selecionar
um arquivo que o usurio deseja abrir,
verificamos se a extenso do mesmo
corresponde ao tipo de arquivos com
que estamos trabalhando carregando-
o no editor, caso contrario voc ser
notificado de que o formato do arquivo
selecionando no corresponde aos ar-
 EASY DELPH I

quivos suportados pelo nosso editor e a CutToClipBoard e PasteToClipBoard que, dado ao seu texto. Antes de adicionar
ao ser ignorada. respectivamente, copiam, recortam e o cdigo, declare nas uses do projeto a
Para salvar o contedo digitado no edi- colam o contedo de ou para a memria Unit Dialogs.
tor, atribua ao evento OnClick do menu (ClipBoard).
Arquivo>Salvar o cdigo da Listagem 3 No menu Recuo do pargrafo adicione //Adicionar uses Dialogs
TextEditor.Paragraph.FirstIndent :=
que ao executar o componente de di- ao evento OnClick as seguintes linhas TextEditor.Paragraph.FirstIndent +
StrToInt(InputBox(Digite o
logo dlgSave ir verificar se o nome do de cdigo, que iro abrir uma caixa de espaamento,Recuo do Texto (em mm),
IntToStr(TextEditor.Paragraph.
arquivo fornecido pelo usurio j existe digitao para que o usurio possa de- FirstIndent)));
na pasta selecionada. Havendo o arquivo finir qual espaamento deseja que seja
ele ser sobrescrito. Em caso contrrio
ser criado um novo arquivo com o nome
fornecido na pasta de destino seleciona- Nota do DevMan
da pelo usurio. Por fim a propriedade
Modified do editor ser repassada como Se voc estiver trabalhando no Windows VISTA, ser
False, fornecendo assim que no existe necessrio executar o Visual Web Developer como
administrador, para que a aplicao tenha direitos
contedo modificado sem ser salvo caso suficientes para gravar no log de Eventos.
deseje criar um novo documento.
Para executar o Visual Web Developer como administrador,
A codificao do menu Salvar Como clique com o boto direito sobre o seu cone no menu, e
tambm se d de forma bastante simples, escolha a opo Executar como administrador ou Run as
pois nenhuma verificao precisa ser re- administrator.
Figura 4. Configurao dos filtros
alizada, necessitando apenas executar o
dilogo do dlgSave e salvar o contedo na
pasta selecionada com o nome fornecido.
O cdigo a seguir dever ser adicionado
ao seu evento OnClick:
if dlgSave.Execute then
begin
TextEditor.Lines.SaveToFile(
dlgSave.FileName);
TextEditor.Modified := false;
end;

Pelo fato de termos adicionado ao for-

mulrio um componente para dilogo
da impressora, a impresso tambm
de forma muito simples. Basta adicionar
ao evento OnClick do menu Imprimir o
cdigo a seguir, que ser responsvel por
chamar o dilogo e enviar a impressora:

if (dlgPrint.Execute) then
TextEditor.Print(Text);

No evento OnClick do menu Sair adi-

Figura 5. Estrutura do Editor de Textos
cione o cdigo da Listagem 4. Aqui
verificamos se houve alteraes no
componente RichText. Em caso positivo Listagem 1. Implementao da procedure ObtemFontes
perguntamos ao usurio se ele deseja procedure TfrmEditor.ObtemFontes;
salvar o arquivo, caso contrrio apenas function EnumFontsProc(var LogFont: TLogFont; var
TextMetric: TTextMetric; FontType: Integer;
fechamos o aplicativo. Data: Pointer): Integer; stdcall;
begin
Para codificao dos trs dos itens do TStrings(Data).Add(LogFont.lfFaceName);
Result := 1;
menu Editar observe na Listagem 5 os end;
cdigos referentes a cada item de menu var
DC: HDC;
digitando os respectivos cdigos para as begin
DC := GetDC(0);
aes de Copiar, Recortar e Colar. EnumFonts(DC, nil, @EnumFontsProc,
Pointer(ckFontes.Items));
O componente RichText possui trs m- ReleaseDC(0, DC);
todos distintos para se tratar mensagens ckFontes.Sorted := True;
end;
em memria que so CopyToClipBoard,

Edio 94 - ClubeDelphi 57
 No cdigo anterior atribumos o valor
digitado pelo usurio propriedade
FirstIdent do Paragraph. O Paragraph uma
propriedade do controle RichText res-
ponsvel por alterar as configuraes de te. Repita o mesmo procedimento em
pargrafo, como o prprio nome sugere.
Finalizada a atribuio dos cdigos aos
itens de menu do componente MainMe-
nu1, precisamos relacionar os atalhos
rpidos queles itens que j foram co-
dificados, como o caso dos atalhos de
Listagem 2. OnClick para o menu Abrir
procedure TfrmEditor.Abrir1Click(Sender: TObject);
begin
if dlgOpen.Execute then
begin
if ExtractFileExt(dlgOpen.FileName) = .rtf then
begin
TextEditor.Lines.LoadFromFile(dlgOpen.FileName);
dlgSave.FileName := dlgOpen.FileName;
TextEditor.Modified := false;
end
else
MessageDlg(Formato de arquivo no suportado,mtInformation,[mbOk],0)
end;
end;
Listagem 3. OnClick do menu Arquivo|Salvar
procedure TfrmEditor.Salvar1Click(Sender: TObject);
begin
if FileExists(dlgSave.FileName) then
TextEditor.Lines.SaveToFile(dlgSave.FileName)
else
begin
if dlgSave.Execute then
begin
TextEditor.Lines.SaveToFile(dlgSave.FileName);
end;
end;
TextEditor.Modified := false;
end;
Listagem 4. Evento ativado ao sair do editor de textos
procedure TfrmEditor.Sair1Click(Sender: Tobject);
begin
if TextEditor.Modified then
begin
if Application.MessageBox(Deseja salvar as
alteraes?, Salvar,MB_YESNO) = IdYes then
begin
if dlgSave.Execute then
TextEditor.Lines.SaveToFile(dlgSave.FileName);
Close;
end
else
Close;
end
else
Close;
end;
Listagem 5. Copiar, Recortar e Colar
procedure TfrmEditor.Copiar1Click(Sender: TObject);
begin
TextEditor.CopyToClipboard;
end;
procedure TfrmEditor.Recortar1Click(Sender: TObject);
begin
TextEditor.CutToClipboard;
end;
procedure TfrmEditor.Colar1Click(Sender: TObject);
begin
TextEditor.PasteFromClipboard;
end;
58 ClubeDelphi - Editor de Textos com RichEdit
Novo, Abrir e Salvar.
Selecionando o boto correspondente,
v at a propriedade MenuItem e localize
o nome do item de menu corresponden-
todos os botes.
Alterando tipo, tamanho
e cor da fonte
Temos adicionado a nossa barra de
atalhos rpidos trs funcionalidades,
do os valores taLeftJustify(esquerda),
as quais ainda no foram mencionadas
em nenhuma codificao e que so
indispensveis a um editor de textos.
Alterao do tipo, tamanho e cor de fon-
tes. Podemos selecionar trechos do texto
e facilmente editar qualquer uma das
propriedades apenas mudando o item
selecionando no ComboBox relacionado
a opo. Os cdigos so simples e aplica-
dos ao evento OnChange de cada um dos
componentes, conforme poder observar
nos cdigos e comentrios relacionados
na Listagem 6 a seguir. Os cdigos esto
comentados e no h segredo.
Tambm atalhos que ainda no fo-
ram codificados, temos os botes para
aplicao do estilos de Negrito, Itlico,
Sublinhado e Riscado sobre os trechos
de textos selecionado. Na codificao
de todos estes botes, verificamos se o
estilo j se encontra aplicado aos trechos
selecionados, e no caso de j existir,
o mesmo ser removido deixando o
texto sem o estilo clicado. Adicione a
cada um dos botes a linha de cdigo
correspondente que est prevista na
Listagem 7. Em resumo, o que estamos
fazendo adicionar ou remover o estilo
empregado propriedade SelAttributes
do componente RichText.
Temos ainda a codificao dos trs
ltimos botes de acesso rpido do
nosso sistema, correspondentes ao ali-
nhamento do texto ao lado esquerdo,
centralizado e direita do editor. Para
alinhar o texto selecionado, modifica-
mos a propriedade Alignment atribuin-
taCemter(centro) ou taRigthJustify
(direita) ao evento OnClick dos botes
btnEsquerda, btnCentro e btnDireita,
respectivamente. Veja o cdigo do bo-
to btnEsquerda. Repita o cdigo para
os demais botes trocando apenas a
atribuio final:
TextEditor.Paragraph.Alignment :=
taLeftJustify;
Aps todo esse processo de codificao
dos menus e botes de acesso rpido do
sistema, acabamos com a criao do nos-
so prprio editor de textos, que poder
ser testado e utilizado para aplicao de
diversos estilos.
Execute-o e faa a digitao de valores,
 EASY DELPH I

utilizando todas as propriedades aqui con-

Listagem 6. Alterao do tipo, tamanho e cor da fonte do texto
figuradas. Veja que inmeras aes com o
procedure TfrmEditor.ckFontesChange(Sender: TObject); texto podem ser selecionadas (Figura 6).
begin
{ Altera o tipo da fonte no texto selecionado. }
TextEditor.SelAttributes.Name :=
ckFontes.Items[ckFontes.ItemIndex]; Concluso
end;
procedure TfrmEditor.ckTamanhoChange(Sender: TObject);
Vimos com essa criao do editor de
begin textos que podemos criar nossas pr-
{ Altera o tamanho da fonte no texto selecionado. }
TextEditor.selattributes.Size := prias ferramentas de trabalho. Imagine
StrToInt(ckTamanho.Items[ckTamanho.ItemIndex]);
end; neste caso a substituio do bloco de
procedure TfrmEditor.ckCorChange(Sender: TObject);
notas pelo seu prprio editor de textos
begin e quem sabe com mais funcionalidades.
{ Altera a cor da fonte no texto selecionado. }
TextEditor.selattributes.Color := ckCor.Selected; Crie agora formulrios personalizados
end;
e programe novas utilidades ao editor,
Listagem 7. Aplicao de estilos ao texto. adicione mtodos para marcadores e nu-
meradores de pargrafos, espaamento
procedure TfrmEditor.btNegritoClick(Sender: TObject);
begin do texto entre linhas e letras, pesquisas
if (fsBold in TextEditor.selattributes.Style) then
TextEditor.selattributes.Style := TextEditor.SelAttributes.Style - [fsBold] else por palavras, substituio de textos,
TextEditor.selattributes.Style := TextEditor.SelAttributes.Style + [fsBold]; entre outras inmeras funcionalidades
end;
procedure TfrmEditor.btItalicoClick(Sender: TObject); que podero ser configuradas.
begin
if (fsItalic in TextEditor.selattributes.Style) then Abrao e at a prxima.
TextEditor.selattributes.Style := TextEditor.SelAttributes.Style - [fsItalic]
else
TextEditor.selattributes.Style := TextEditor.SelAttributes.Style + [fsItalic];
end;
procedure TfrmEditor.btSublinhadoClick(Sender: TObject); D seu feedback sobre esta edio! Feedback
begin eu

s
D
if (fsUnderline in TextEditor.selattributes.Style)
then A Java Magazine tem que ser feita ao seu

sobre e
TextEditor.selattributes.Style := TextEditor.SelAttributes.Style - [fsUnderline]
else gosto. Para isso, precisamos saber o que

s
ta
TextEditor.selattributes.Style := TextEditor.SelAttributes.Style + [fsUnderline]
edio
end;
voc, leitor, acha da revista!
procedure TfrmEditor.btRiscadoClick(Sender: TObject);
begin D seu voto sobre este artigo, atravs do link:
if (fsStrikeOut in TextEditor.selattributes.Style)
then www.devmedia.com.br/javamagazine/feedback
TextEditor.selattributes.Style := TextEditor.SelAttributes.Style - [fsStrikeOut]
else
TextEditor.selattributes.Style := TextEditor.SelAttributes.Style + [fsStrikeOut]
end;

Figura 6. Utilizando funcionalidades do Editor de textos

Edio 94 - ClubeDelphi 59
 Seo DELPHI Seo EASY DELPHI
Nesta seo voc encontra artigos sobre
a linguagem PHP e a ferramenta Delphi for PHP
Orientao a Objetos no Delphi for PHP
Como aplicar conceitos de POO em aplicaes PHP Parte 2
Rodrigo Carreiro Mouro
(rodrigocarreiro@tdstecnologia.com.br)
Consultor da TDS Tecnologia RJ atuando na
rea de desenvolvimento de projetos Orienta-
dos a Objetos, Design Patterns, MVC. BDS2006
Win32 Product Certified. Borland Instructor
Certified. Instrutor de treinamento oficiais
CodeGear DelphiWin32, Delphi for PHP, Delphi
.Net. Palestrante da Borland Conference 2007.
60 ClubeDelphi - Orientao a Objetos no Delphi for PHP
09 - Rodrigo - DelphiforPHP.indd 60
Seo PHP
C
omo prometido em meu primei-
ro artigo vamos dar continui-
dade a este assunto to extenso
que a orientao a Objetos. Como dito
anteriormente toda linguagem dita OO
deve estar apoiada nos pilares desta
filosofia que so: Herana, Encapsula-
mento, Abstrao e Polimorfismo e o PHP 5
implementa essas quatro caractersticas
inclusive o polimorfismo que o foco do
nosso artigo.
Muitos programadores vem a herana
como a soluo de seus problemas, po-
rm se usada indiscriminadamente ele
pode ser um feitio que se vira contra o
feiticeiro, isto porque se no tomarmos os
devidos cuidado acabamos por acoplar
todo o nosso cdigo atravs da herana.
Porm se h algo que justifique o uso da
herana este se chama polimorfismo.
O polimorfismo um dos assuntos mais
importantes na POO. Com o uso de clas-
ses e heranas conseguimos facilmente
descrever uma situao da vida real alm
de conseguir estender projetos por meios
da reutilizao de cdigo. Mas se de um
lado o polimorfismo um dos assuntos
mais importantes da POO tambm sem
dvida nenhuma um dos mais difceis
de ser compreendido. Isto porque muitos
que se aventuram pela primeira vez na
OO entram ainda com uma mentalidade
procedural e enxergando as classes como
entidades do banco de dados tornando
mais difcil a compreenso da POO como
um todo.
Polimorfismo
Teoricamente e a grosso modo entende-
se por polimorfismo a capacidade que
um mesmo mtodo tem de se comportar de
maneira diferente dependendo de qual classe
ele foi chamado. Ns conseguimos isso
declarando um mtodo em uma classe
base e o sobrescrevemos em uma classe
herdada, facilitando assim o desenvolvi-
mento e reaproveitamento cdigos.
Antes de mais nada importante dei-
25.03.08 16:48:23
 D ELPHI F O R PH P

xar claro que a linguagem que estamos

Listagem 1. Polimorfismo no Delphi Win32
trabalhando o PHP e que o mesmo
unit SeresVivos;
interpretado, fracamente tipado e sendo
assim no h a necessidade de se decla- interface

rar variveis com seus tipos. Mas o que type

TServivo = class
isso tem a ver com polimorfismo? Tudo! procedure ProduzirSom;
end;
Observe o cdigo da Listagem 1.
No cdigo da Listagem 1 ser levan- TCachorro = class(TServivo)
procedure ProduzirSom;
tada uma exceo no evento OnClick do end;

boto com a mensagem Nem todo ser THomem = class(TServivo)

procedure ProduzirSom;
vivo produz som!!! mesmo um objeto end;
do tipo THomem sendo instanciado para
implementation
a varivel Ser. Isso acontece porque no
uses
Delphi os mtodos so estticos por pa- SysUtils, Dialogs;
dro. Isso significa que independente do { TCachorro }
objeto que seja instanciado na varivel
procedure TCachorro.ProduzirSom;
vale para ela o tipo que foi declarado. begin
ShowMessage(Cachorro Latindo !!!);
Para conseguirmos o efeito desejado, end;
ou seja, o mtodo ProduzirSom da classe { TServivo }
THomem seja chamado, preciso de-
procedure TServivo.ProduzirSom;
clarar o mtodo ProduzirSom na classe begin
raise Exception.Create(Nem todo ser vivo produz
TSerVivo como Virtual. som !);
Isso faz com que o Delphi crie uma end;

VMT(Virtual Method Table) uma ta- { THomem }

bela com os ponteiros dos mtodos que procedure THomem.ProduzirSom;

begin
foram declarados como virtuais para ShowMessage(Homem Falando !!!);
que possam ser sobrescritos em tempo end;

de execuo. Na Listagem 2 vemos como end.

ficaria o cdigo. procedure TForm1.Button1Click(Sender: TObject);

var
No PHP nada disso necessrio, como Ser: TSerVivo;
ele e fracamente tipado, ou seja, no begin
Ser := THomem.Create;
Ser.ProduzirSom;
end;

Listagem 2. Mtodos Virtuais

Nota do DevMan unit SeresVivos;

interface
O termo Programao Procedural (ou programao
procedimental) s vezes utilizado como sinnimo de type
TServivo = class
Programao Imperativa (paradigma de programao que procedure ProduzirSom;virtual;
especifica os passos que um programa deve seguir para end;
alcanar um estado desejado), mas o termo pode se referir
TCachorro = class(TServivo)
(como neste artigo) a um paradigma de programao procedure ProduzirSom;override;
baseado no conceito de chamadas a procedimentos. end;
Procedimentos, tambm conhecidos como rotinas, sub-
THomem = class(TServivo)
rotinas, mtodos, ou funes simplesmente contm um procedure ProduzirSom;override;
conjunto de passos computacionais a serem executados. end;
Um dado procedimento pode ser chamado a qualquer
implementation
hora durante a execuo de um programa, inclusive por
outros procedimentos ou por si mesmo. end.

Edio 94 - ClubeDelphi 61
precisamos declarar o tipo de nossas
variveis, no h porque os mtodos
serem estticos, e nem podem. Como
no h um tipo definido para o objeto
que ser instanciado, por padro ser
chamado o mtodo do objeto que foi ins-
tanciado para aquela varivel. Por isso
podemos dizer que no PHP os mtodos
so Virtuais e isto facilita a implemen-
tao do polimorfismo reduzindo assim
o uso de controles de fluxos como Ifs
para tornar nosso cdigo mais robusto
e expansvel.
Voc deve estar se perguntando: Se
no precisamos declarar o tipo de nossas
variveis e de nossos objetos, como saber
se um objeto pertence a uma determinada
hierarquia ou possui o mtodo que queremos
chamar?.
Para isto temos no PHP 5 o operador
instanceof. Ele verifica se um objeto
qualquer possui um relacionamento
um com uma classe especfica. Ele na
verdade uma modificao da j existen-
te funo is_a() que foi descontinuada,
pois o primeiro um operador binrio
lgico permitindo criar sentenas como
a seguir:
if($c instanceof Cliente) {
echo $c um cliente;
} capacidade que um mesmo mtodo tem de se
Para exemplificar essa facilidade ob-
serve o cdigo da Listagem 3.
Podemos notar facilmente que o cdigo
escrito no est expansvel. Imagine que
voc decida criar em seu modelo mais
cinco animais cada um produzindo
seu respectivo som, isso se tornaria
para voc um tormento, pois teria que
adicionar outros cinco blocos elseif para
fazer a verificao. Isso fere o conceito
de reaproveitamento de cdigo e pior
do que isso imagine o sofrimento que
seria para dar manuteno em um c-
digo deste porte. Ento esse cdigo est
totalmente fora de cogitao.
O uso da herana com o polimorfismo
nos ajuda a resolver este problema, a
inteno fazer a mesma coisa, porm de
uma maneira que nos ajude a expandir
nosso cdigo, reaproveit-lo e mais do
que isso que facilite a manuteno do
mesmo. Isso aplicado na prtica se torna
o cdigo descrito na Listagem 4.
62 ClubeDelphi - Orientao a Objetos no Delphi for PHP
Note que agora criamos uma classe
SerVivo que servir de base para todas
as outras classes de animais que iremos
criar e que iro produzir algum som.
nesta classe que est declarado o mtodo
que ser sobrescrito nas classes descen-
dentes porm no h aqui a necessidade
de nenhum parmetro ou diretiva para
tornar este mtodo virtual e passvel
de ser sobrescrito. Observe que desta
maneira o nosso cdigo no fica en-
gessado. Se por exemplo decidirmos
criar uma classe Gato em nada teremos
que alterar o mtodo GetSom. Basta que
a classe Gato herde de SerVivo para que
seja aceita no mtodo GetSom e feito isso
sobrescrevemos o mtodo ProduzirSom
na classe herdada.
Perceba que foi utilizado em nosso cdi-
go o operador instanceof para verificar se
o objeto passado como parmetro para o
mtodo GetSom pertence classe SerVivo
ou herda da mesma. Se esta condio for
satisfeita podemos ter a certeza que ele
ter em sua estrutura o mtodo Produzir-
Som. Agora qual mensagem ser exibida
por este mtodo vai depender do tipo
do objeto que estiver instanciado ali no
momento. Com isso voltamos definio
do incio do nosso artigo: Polimorfismo: a
comportar de maneira diferente dependendo
de qual classe ele foi chamado.
Claro que muito mais pode ser feito
para tornar nosso cdigo mais coeso,
por exemplo, se nem todos os seres vivos
produzem som no h porque o mtodo
ProduzirSom na classe SerVivo tenha
implementao. Neste caso aplica-se um
mtodo abstrato.
Mtodos e Classes Abstratas
No PHP5 temos tambm o conceito de
classes e mtodos abstratos. Diz abstrato
um mtodo que no possui implemen-
tao ou uma classe que no deve ser propriedades e mtodos. Isso significa
instanciada, que serve apenas de refe-
rncia para ser herdada e o mtodo para
ser sobrescrito.
Isto muito comum em OO, pois quando
trabalhamos com grandes equipes e em
grandes projetos geralmente queremos
garantir que determinadas classes tenham
certos mtodos essenciais ao funciona-
mento do modelo e como so vrios os
programadores envolvidos no processo
definimos esses mtodos como abstratos
demonstrando assim a nossa inteno de
que ele seja sobrescrito na classe que o
herdou. Com isso temos um cdigo mais
organizado, mais coeso. A prpria classe
nos lembra que precisamos implementar
esse mtodo em algum momento. No BDS
2006, quando temos um mtodo abstrato
em uma classe e herdamos da mesma, ao
utilizarmos o CodeCompletion este mtodo
aparece em vermelho indicando que pre-
cisa ser implementado.
Um fato importante a ser lembrado que,
no PHP se uma classe possui ao menos um
mtodo abstrato ela deve ser declarada
como abstrata diferente de outras lingua-
gens de programao. Essa dupla definio
existe para permitir a voc declarar uma
classe como abstrata mesmo que a mesma
no possua mtodos abstratos.
No exemplo dos nossos seres vivos fica
claro que nem todos os seres produzem
som, assim este mtodo nesta classe no
deve ter implementao ficando nossa
classe como a da Listagem 5.
Note na Listagem 5 que a classe SerVivo
agora foi declarada como abstract, pois dos
trs mtodos que a mesma possui um de-
les abstrato e por isso temos que declarar
a classe como abstrata tambm. Assim Ser-
Vivo no poder ser instanciada e tambm
no haver necessidade, pois esta classe
apenas uma base para as demais.
Como todo ser vivo nasce, cresce, se re-
produz e morre, podemos observar que
temos algumas dessas fases em forma de
mtodos em SerVivo, no como abstratos,
mas passveis de serem sobrescritos.
Mtodos e Propriedades Estticas
de conhecimento geral que uma
classe pode declarar n propriedades e
mtodos. Cada instncia desta classe, ou
seja, cada objeto possui uma cpia destas
que podem receber valores distintos e
seus mtodos serem chamados de forma
independente. Porm em OO temos um
conceito chamado de propriedades est-
ticas e mtodos estticos. So elementos
que pertencem classe e no ao objeto,
com isto eles podem ser acessados e
invocados a partir da classe sem a neces-
sidade de se instanciar o objeto.
 D ELPHI F O R PH P

Podemos ter vrios objetos, mas todos
eles oriundos de uma nica classe. Como
as propriedades e mtodos pertencem
classe podemos deduzir que essas pro-
priedades e mtodos so compartilhados
por todos os objetos.
H algumas consideraes sobre o uso
de mtodos e propriedades estticas no
PHP. Por exemplo, para se acessar pro-
priedades estticas de dentro da prpria
classe temos que utilizar o operador
Self:: que aqui tem uma funo oposta
a do Delphi onde o Self usado para
fazer referncia ao objeto do contexto
enquanto no PHP usamos para acessar a
classe. Outro detalhe que para acessar
uma propriedade ou mtodo deste tipo
temos que faz-lo atravs da classe de
duas maneiras:
Classe::Propriedade
Classe::Mtodo()
Mas voc deve estar se perguntando se
realmente far uso deste tipo de recurso
e se ele realmente necessrio. Pois en-
to observe o cdigo da Listagem 6.
O que temos aqui uma classe cliente
comum e simples, porm com um contador
que registra a quantidade de objetos desta
classe que foram instanciados. Por isso a
propriedade esttica $Contador, proprieda-
de esta que pertence classe e no ao objeto,
compartilhada por todas as instncias.
Observe que no construtor acessamos esta
propriedade atravs do operador Self e o in-
crementamos em um. Feito isso atribumos
o valor do contador propriedade $id, essa
sim pertencente ao objeto.
O mtodo CriarClientes executa um
lao for e instancia dez objetos Clientes e
logo aps mostra no navegador o valor
da propriedade $id.
Poderamos incluir nesta classe Cliente
um mtodo para obter o valor atual do
contador da classe. Este mtodo dever
ser esttico para evitar que se tenha
que instanciar a classe para invocar
o mtodo. Veja como ficaria com essa
modificao na Listagem 7.
Observe que adicionamos a nossa
classe Cliente um mtodo esttico que
retorna a posio atual do contador. Para
invoc-lo utilizamos a prpria classe
sem a necessidade de se instanciar um
objeto: Cliente::GetCount().
Criando um exemplo
notrio que os exemplos citados aci-
ma servem apenas para exemplificar os
conceitos abordados aqui. Para que voc
possa ter uma noo de como o polimor-
fismo auxilia em tarefas dirias vamos
construir um pequeno exemplo abordan-
do o conceito acima. Abra o Delphi for

Listagem 3. Codigo PHP sem polimorfismo Listagem 5. Classes abstratas no PHP

<?php <?php
class Cachorro{ abstract class SerVivo{
function Latir(){ function Nascer(){
echo Cachorro Latindo !; echo Nascendo !!!;
} }
} function Crescer(){
class Homem{ echo Crescendo !!!;
function Falar{ }
echo Homem Falando !; abstract function ProduzirSom();
} }
}
function ProduzirSom($Obj){ class Cachorro extends SerVivo{
if ($Obj instaceof Cachorro){ function ProduzirSom(){
$Obj->Latir(); echo Cachorro Latindo !;
}elseif($Obj instanceof Homem){ }
$Obj->Falar(); }
}else{
echo O objeto passado no produz som; class Homem extends SerVivo{
} function ProduzirSom{
} echo Homem Falando !;
}
?> }
function GetSom($Obj){
if ($Obj instaceof SerVivo){
Listagem 4. Polimorfismo aplicado no PHP $Obj->ProduzirSom();
}else{
<?php echo O objeto passado no um ser vivo !;
class SerVivo{ }
function ProduzirSom(){ }
echo Nem todo ser vivo produz som !; ?>
}
}
class Cachorro extends SerVivo{ Listagem 6. Propriedade Esttica no PHP
function ProduzirSom(){
echo Cachorro Latindo !; <?php
} class Cliente{
} static $Contador = 0;
class Homem extends SerVivo{ public $id;
function ProduzirSom{ function __construct(){
echo Homem Falando !; self::$Contador++;
} $this->id = self::$Contador;
} }
function GetSom($Obj){ }
if ($Obj instaceof SerVivo){ function CriarClientes(){
$Obj->ProduzirSom(); for($i=0;$i<=9;$i++){
}else{ $cliente = new Cliente();
echo O objeto passado no um ser vivo !; echo $cliente->id.<br>;
} }
} }
?> ?>

Edio 94 - ClubeDelphi 63
PHP e crie uma nova aplicao. Para isso
acesse o menu File|New>Application.
Sa lve a apl ic a o pre s sion a ndo
Ctrl+Shift+S ou escolha File>Save Pro-
ject As com o nome PrjPolimorfismo.
phprj e em seguida salve a Unit como
index.php. Altere a propriedade Name
do formulrio para FrmIndex. Este
formulrio ser utilizado para criar a
interface visual do nosso exemplo.
Adicione neste formulrio trs Edits
da paleta Standard. Altere seus nomes
para EdtNome, EdtEmail, EdtRe-
gistro, respectivamente. Adicione trs
Labels, tambm da paleta Standard, um
para cada Edit e troque seus Captions
Figura 1. Exemplo de layout
de acordo com cada campo. Adicone
tambm dois Buttons(BtnSalvar e
BtnListar) e um RadioGroup. Adicione
ao RadioGroup dois itens a sua proprie-
dade Items. Digite Pessoa Fsica e
Pessoa Jurdica. Altere a propriedade
Orientation para orHorizontal. Na Figura
1 temos uma sugesto de layout.
Concludo o layout passaremos agora
para a criao de nossas classes. No irei
me apronfundar na sintaxe OO no PHP
pois este foi escopo do primeiro artigo.
Acesse o menu File|New>Unit e crie as propriedades publicadas.
uma nova Unit salvando-a com o nome
Model.php. Nesta Unit iremos criar
um modelo onde teremos uma classe
Pessoa com as propriedades Nome e
Telefone comum a todo o tipo de pessoa.
Faremos um especializao de Pessoa em
PessoaFisica e PessoaJurica cada uma com
uma propriedade exclusiva CPF e CNPJ
respectivamente. Na Unit criada digite
o cdigo da Listagem 8.
No cdigo da Listagem 8 apenas cria-
mos a estrutura das classes que sero usa-
das em nosso exemplo. Posicione o cursor
na rea da classe Pessoa e pressione Ctrl +
Shift + Alt + U para publicar as proprie-
dades. No dilogo que se abre preencha
os campos conforme a Figura 2.
Repare que o Delphi for PHP j adiciona
classe um campo protegido $_nome com
os mtodos Get e Set para acesso a este
Field. Isso far que no Code Completion
voc possa acessar a propriedade Nome
atravs de Pessoa->Nome embora o GetNo-
me e o SetNome no sejam invocados.
Retornando ao exemplo, repita o passo
anterior e faa o mesmo para publicar
em Pessoa a propriedade Telefone. Em
PessoaFisica publique a propriedade CPF
e em PessoaJuridica a propriedade CNPJ.
Observe na Listagem 10 as classes com
A princpio voc dever notar que no
foge muito a regra de criao de classe
em comparao com o Delphi Win32.
Temos em Pessoa as propriedades perti-
nentes a todo tipo de pessoa. PessoaFisica
herda de Pessoa, e por esse motivo traz
consigo, devido a herana, as proprieda-
des Nome e Telefone. Precisamos apenas
adicionar a propriedade CPF assim como
acontece em PessoaJuridica, sendo que
nesta temos o CNPJ como diferencial.
Se notou bem, publicamos o mtodo
Save() em Pessoa como abstract indicando
assim a inteno que temos em sobres-
crev-lo nas classes descendentes e isso
que faremos agora. Na classe PessoaFisica
sobrescreva a funo Save() conforme a
Listagem 11. Faa o mesmo para Pessoa-
Fisica conforme Listagem 12.

Listagem 7. Mtodo Esttico no PHP

<?php
Nota do DevMan
class Cliente{
static $Contador = 0;
public $id; Para que os mtodos Get e Set possam ser invocados
function __construct(){ automaticamente como no Delphi Win32 suas classes
self::$Contador++;
$this->id = self::$Contador; precisam possuir os mtodos __set() e __get ou
} simplesmente herdar suas classes da classe Object do
static function GetCount(){ Delphi for PHP o que no acontece automaticamente
return self::$Contador;
} como no caso so Delphi Win32. A classe object j intercepta
} o acesso a propriedade e delega a chamada aos respectivos
function CriarClientes(){ gets e sets. Oberve na Listagem 9 a estrutura em Object.
for($i=0;$i<=9;$i++){
$cliente = new Cliente(); Declaramos os mtodos __get() e __set() e preparamos
echo $cliente->id.<br>;
} ambos para que localizem a herana e retornem o
echo Cliente::GetCount(); resultado. Caso no seja encontrada, uma exceo
} levantada informando que o mtodo no existe.
?>

Listagem 8. Estrutura das classes

abstract class Pessoa{

protected abstract function Save();
}
class PessoaFisica extends Pessoa{
}
class PessoaJuridica extends Pessoa{

Figura 2. Publicando a Propriedade Nome

64 ClubeDelphi - Orientao a Objetos no Delphi for PHP

 D ELPHI F O R PH P

Esses so os mtodos que sero fruto do
polimorfismo. Teremos uma outra classe
que servir como lista de pessoas, onde
guardaremos todos os objetos criados na
aplicao. O boto listar servir para per-
correr toda a lista e invocar o mtodo Save()
dos objetos contidos nela. No sabemos ao
certo se so pessoas fsicas ou jurdicas.
Apenas sabemos que so pessoas e se so
pessoas possuem o mtodo Save().Na mes-
ma Unit do modelo, model.php, crie a classe
ListaPessoa conforme Listagem 13.
Nesta classe temos um Array Private
onde guardaremos todos os objetos
criados na aplicao. O mtodo pblico
AddPessoa serve para que possamos ter
uma maneira de adicionarmos itens ao
Array que privado. Repare no parme-
tro da funo que colocamos o tipo do
parmetro antes do mesmo. O PHP no
tipado, porm temos este recurso que
chamado de Hint de Classe.
evento digite o cdigo da Listagem 14. Listagem 9. Mtodos __get e __set em Object.
O procedimento simples. Primeiro
<?php
verificamos a opo selecionada no Ra- function __get($nm){
$method=get.$nm;
dioGroup atravs da propriedade ItemIn- if (method_exists($this,$method)){
return ($this->$method());
dex. Feito isso criamos o objeto de acordo }else{
com a opo do usurio e j carregamos $method=read.$nm;
if (method_exists($this,$method)){
o valor do edtRegistro para a propriedade return ($this->$method());
}else{
CPF ou CNPJ dependendo do caso. if ($this->inheritsFrom(Component)){
if( isset($this->_childnames[$nm]) )
Em seguida carregamos para as pro- return $this->_childnames[$nm];
priedades Nome e Email os valores de seus }
throw new EPropertyNotFound(
respectivos Edits. Por fim verificamos se $this->ClassName()...$nm);
}
h na seo uma varivel Obj. Se ela no }
existir criamos um objeto e o colocamos }
function __set($nm, $val){
na seo para poder pass-lo para outra $method=set.$nm;
if (method_exists($this,$method)){
pgina. Se a varivel de seo j existir $this->$method($val);
}else{
ento apenas invocamos de dentro da $method=write.$nm;
seo a funo AddPessoa passando o ob- if (method_exists($this,$method)){
$this->$method($val);
jeto criado. Ao final teremos na seo um }else{
throw new
objeto ListaPessoa com todas as pessoas EPropertyNotFound($this->
ClassName()...$nm);
criadas a cada clique de boto. }
Para concluir nosso exemplo no OnClick }
}
do boto Listar Todos chamaremos uma ?>

Com isso um erro ser gerado se ten- pgina (lista.php) e nela exibiremos o
Listagem 10. Classes com propriedades publicadas
tarmos adicionar no Array um objeto contedo de nossa lista de pessoas. Para
que no seja do tipo pessoa. A funo isso codifique o boto em questo fazen- <?php
/* Classe principal Pessoa */
publicar em ListaPessoa apenas faz um do uma chamada ao mtodo redirect do abstract class Pessoa{
protected $_nome=;
loop no Array onde cada interao, ou PHP, conforme a seguir: function getNome(){
return $this->_nome;
seja, cada vez que passa por um objeto o }
redirect(lista.php);
mtodo Save() invocado, publicando no function setNome($value){
$this->_nome=$value;
browser as informaes do objeto. Esta pgina ainda no foi criada ento }
function defaultNome(){
Para testar nosso modelo vamos ao proceda com a criao em File|New>Form. return;
}
evento OnClick do boto Salvar. Neste Salve-a como lista.php e modifique protected $_email=;
function getEmail(){
return $this->_email;
}
function setEmail($value){
$this->_email=$value;
}
function defaultEmail(){
return;
}
protected abstract function Save();
}
/* Classe PessoaFisica */
class PessoaFisica extends Pessoa{
protected $_cpf=;
function getCPF(){
return $this->_cpf;
}
function setCPF($value){
$this->_cpf=$value;
}
function defaultCPF(){
return;
}
}
/* Classe PessoaJuridica */
class PessoaJuridica extends Pessoa{
protected $_cnpj=;
function getCNPJ(){
return $this->_cnpj;
}
function setCNPJ($value){
$this->_cnpj=$value;
}
function defaultCNPJ(){
return;
}
}
?>
Figura 3. Cadastrando Pessoas na Lista

Edio 94 - ClubeDelphi 65
 seu Name para FrmLista. No OnShow
Listagem 11. Metodo Save() na classe PessoaFisica
dessa pgina digite o cdigo a seguir:
public function Save(){
echo <font size=6 color=darkblue.
face=Tahoma>.$this->Nome.</font><br>. $L = $_SESSION[Obj];
Email...: .$this->Email.<br>. $L->Publicar();
CPF....: .$this->CPF.<br>.
Tipo...: Pessoa Fisica <hr>;
} Este cdigo apenas invoca o mtodo
Listagem 12. Metodo Save() na classe PessoaJuridica Publicar do objeto ListaPessoa que est na
seo. Este mtodo por sua vez faz um
public function Save(){
echo <font size=6 color=darkblue. loop no Array invocando o mtodo Save()
face=Tahoma>.$this->Nome.</font><br>.
Email...: .$this->Email.<br>. de cada item da lista. Com isso quando
CNPJ...: .$this->CNPJ.<br>.
Tipo...: Pessoa Juridica <hr>;
esta pgina for carregada exibir no
} browser todas as pessoas cadastradas na
lista devidamente formatadas.
Listagem 13. Classe Pessoa Lista
Execute a aplicao. Selecione o tipo de
class ListaPessoa{
static private $instance;
pessoa, informe os dados e clique no bo-
private $_list = array(); to Salvar. Veja a aplicao em execuo
function AddPessoa(Pessoa $Obj){ nas Figuras 3 e 4.
$this->_list[] = $Obj;
}

function Publicar(){
Concluso
for ($i = 0; $i < count($this->_list); $i++){ Com os conceitos aprendidos at o mo-
$this->_list[$i]->Save();
} mento j possvel adicionar aos nossos
}
projetos um aspecto mais profissional, e
Listagem 14. Criando os objetos do modelo claro, facilitar bastante o nosso trabalho.
Confesso que para quem no tem um
function BtnSalvarClick($sender, $params){
certo conhecimento em OO pode parecer
switch ($this->RadioGroup1->ItemIndex) {
case 0: a primeira vista um tanto complicado
$Pessoa = new PessoaFisica; aplicar todos esses conceitos, mas com
$Pessoa->CPF = $this->Edit3->Text;
break; o tempo voc ir perceber que as coisas
case 1:
$Pessoa = new PessoaJuridica; no so to complicadas como parecem.
$Pessoa->CNPJ = $this->Edit3->Text;
} O mundo de programao OO fas-
cinante e requer muita dedicao por
$Pessoa->Nome = $this->Edit1->Text;
$Pessoa->Email = $this->Edit2->Text; parte daqueles que se lanam nele. Por
if (!isset($_SESSION[Obj])){ isso dedique-se. Lembre-se que OO OO
$_SESSION[Obj] = new ListaPessoa;
}
independente da linguagem. Habitue-se
a pensar OO, pois todas as grandes lin-
$_SESSION[Obj]->AddPessoa($Pessoa);
} guagens e por conseqncia ferramentas
esto apoiadas nesta filosofia.
Um grande abrao a todos e at o
prximo artigo, onde trataremos de um
assunto um tanto interessante: Design
Patterns em PHP.
Eu sou Rodrigo Carreiro e pela sua
ateno muito obrigado.

D seu feedback sobre esta edio! Feedback

eu
s
D

A Java Magazine tem que ser feita ao seu

sobre e

gosto. Para isso, precisamos saber o que

s

ta
e
voc, leitor, acha da revista!
d i o

D seu voto sobre este artigo, atravs do link:

www.devmedia.com.br/javamagazine/feedback
Figura 4. Publicando contedo da lista

66 ClubeDelphi - Orientao a Objetos no Delphi for PHP

09 - Rodrigo - DelphiforPHP.indd 67 24.03.08 06:16:40
09 - Rodrigo - DelphiforPHP.indd 68 24.03.08 06:16:44