índice Delphi Delphi Editorial Delphi .NET .NET Desafio The Club Dicas Legenda

Transcrição

1 setembro 2010

2 setembro 2010

3 índice Editorial Delphi Delphi Agosto é o mês em que temos de Novo Delphi XE redobrar nossa atenção com escadas e gatos pretos, afinal ninguém quer que o azar bata a porta Autor: Antonio Spitaleri Utilizando o Ribbon Controls 08 Autor:Bruno Alcarás Delphi.NET.NET Tlist e Event Handlers em Delphi 13 Autor: Leonora Golin Usando Crystal Reports 16 Autor: Luciano Pimenta Criar consumir e debugar WCF services com 26 Silverlight Autor: Djonatas Tenfen Dicas Desafio The Club - Dicas Delphi 29 - Cruzada 30 Legenda Iniciante Intermediário Avançado setembro

4 Bem-vindo Este mês completamos mais um ano de existência do The Club. Já são 16 anos auxiliando programadores de todo o Brasil no desenvolvimento de softwares em Delphi e Visual Studio. Nesse mês temos também o lançamento da nova versão do Delphi. Trata-se da versão XE, que traz boas novidades. Em meu artigo Novo Delphi XE, mostro de forma geral as novidades da ferramenta. Nas edições seguintes iremos conhecer em maiores detalhes a nova versão do Delphi. Nosso consultor Bruno Alcaras traz, em seu artigo: Utilizando o Ribbon Controls a utilização de Ribbon Controls em Delphi. Ribbon Controls são componentes que permitem melhorar bastante o visual de aplicações Delphi. Leonora Golin aborda nesse mês a classe TList em conjunto com Event Handlers em seu artigo TList e EventHandlers em Delphi. Um assunto mais técnico porém de grande valor para agregar potencialidade as aplicações Delphi. Em nossa seção.net temos dois artigos: No primeiro, Luciano Pimenta aborda o uso do gerador de relatórios Crystal Report no artigo Usando Crystal Report. Na sequência Djonatas Tenfen mostra Como consumir e debugar WCF services em Silverlight., mostrando mais um recurso dessa fantástica ferramenta que é o Silverlight. É isso. Boa leitura a todos e que venham os próximos 16 anos! Av. Profº Celso Ferreira da Silva, 190 Jd. Europa - Avaré - SP - CEP Informações: (14) Suporte: (14) Internet Cadastro: cadastro@theclub.com.br Suporte: suporte@theclub.com.br Informações: info@theclub.com.br Skype Cadastro: theclub_cadastro Skype Suporte: theclub_linha1 theclub_linha2 theclub_linha3 Copyright The Club Megazine 2009 Diretor Técnico Marcos César Silva Diagramação e Arte Vitor M. Rodrigues Revisão Tassiane Fileto Colunistas Antonio Spitaleri Neto Bruno Alcarás Leonora Golin Luciano Pimenta Impressão e acabamento: GRIL - Gráfica e Editora Taquarituba-SP - Tel. (14) Reprodução A utilização, reprodução, apropriação, armazenamento em banco de dados, sob qualquer forma ou meio, de textos, fotos e outras criações intelectuais em cada publicação da revista The Club Megazine são terminantemente proibidos sem autorização escrita dos titulares dos direitos autorais. Antonio Spitaleri Neto - Editor Chefe antonio@theclub.com.br Delphi é marca registrada da Borland International, as demais marcas citadas são registradas pelos seus respectivos proprietários. 04 setembro 2010

5 Delphi Novo Delphi XE No início do mês de setembro, a comunidade Delphi recebeu a notícia do lançamento do Delphi XE, que faz parte da suíte RAD Studio XE, que além do Delphi XE inclui C++ Builder XE, Delphi Prism XE e RADPHP XE. Ao contrário das últimas versões, onde o ano de lançamento constituía o nome da versão, dessa vez a Embarcadero optou pelo XE, que realça o suporte heterogêneo a vários bancos de dados, uma das grandes características dessa versão. O grande foco do Delphi XE é o desenvolvimento ágil de aplicações e integração fácil com as demais ferramentas da suíte RAD Studio. Nesse artigo estarei falando sobre as principais características da nova versão do Delphi em uma visão mais geral. Em artigos posteriores estaremos abordando com maiores detalhes as funcionalidades do Delphi XE. Instalação do Delphi XE Como já é tradição, a Embarcadero disponibiliza a versão trial do Delphi e demais ferramentas da suíte XE. A versão trial pode ser obtida em: O instalador guarda muitas semelhanças com a versão 2010 do Delphi, como poderá ser visto nas figuras a seguir. Esse instalador é online, ou seja, a maior parte dos arquivos será baixada no momento da instalação, isso torna o instalador mais leve, porém aumenta o tempo de instalação. Em relação à instalação do Delphi 2010, houve um aumento no tempo de instalação. Outra diferença é que nesta instalação temos além do Delphi XE a instalação conjunta de algumas ferramentas de terceiros. São elas: - AQ Time; - Final Builder; - CodeSite; - Rave Reports; - CollabNet client subversion; Essas ferramentas oferecem recursos bastante interessantes para o desenvolvimento de aplicações com o novo Delphi XE. Com isso o desenvolvimento sobre a plataforma Delphi ganha em recursos. Mais adiante darei detalhes sobre ferramentas extras do novo Delphi XE. Veja alguns screenshots da instalação: Layout Após a instalação, será apresentada uma tela de registro e depois o Delphi XE estará pronto para uso. A primeira funcionalidade a ser destacada são os layouts para as janelas. No Delphi XE temos três opções padrão de setembro

6 utilizar o Layout: Default, com janelas fixas semelhantes a versões como o Delphi Ou então o layout Classic Undocked, que torna a disposição das janelas igual ao Delphi 7. Para os desenvolvedores mais acostumados as versões antigas do Delphi essa opção é uma boa saída. Temos ainda a opção de Debug Layout, que dá destaque para o código. A paleta de componentes também pode ser colocada na parte superior da tela, ao estilo Delphi 7 ou então ser mantida na lateral. Veja as opções Classic e Default de Layout: Ve a imagem Default: Veja a imagem Classic: Integração com Subversion Subversion é uma tecnologia para controle de versões alternativo ao conhecido CVS. Nos últimos anos a utilização do SubVersion tem crescido bastante entre os profissionais que trabalham com desenvolvimento em equipe. Para o pessoal que utiliza SubVersion, a boa notícia é que o Delphi XE oferece integração dos projetos com essa tecnologia. Através da IDE Delphi é possível fazer todas as operações no repositório SubVersion, como Commit, Merge, etc... DataSnap XE Uma das maiores e melhores novidades na versão 2010 do Delphi foi o novo DataSnap e seus recursos poderosos para multi camadas. No Delphi XE, além de todos os recursos já existentes foram adicionadas facilidades e um novo Wizard para a criação do Server Module, o que agrega produtividade ao desenvolvimento DataSnap. Além disso, o DataSnap XE agora possui integração com Cloud Computing, permitindo o acesso a servidores em plataformas como o Windows 06 setembro 2010

7 Azure. Essa novidade, aliada a integração com Delphi Prism para desenvolvimento Web, torna o Delphi uma boa opção para o desenvolvimento para internet. Ferramentas para agilizar o desenvolvimento O Delphi XE traz integrada a sua IDE as ferramentas FinalBuilder, CodeSite e AQTime. Essas ferramentas permitem ao desenvolvedor um controle altamente profissional e gerenciamento mais profissional das aplicações na plataforma Delphi. A melhoria no gerenciamento permite um menor gasto de tempo com planejamento e controle e um maior investimento em desenvolvimento. Isso gera grandes ganhos de produtividade. Default Conclusão Nesse artigo procurei apenas fazer um rápido preview das novidades do Delphi XE. Como foi possível perceber o foco dessa nova versão é a produtividade. Nos artigos seguintes estaremos vendo com maiores detalhes todas as principais funcionalidades dessa nova versão do Delphi. Referência: Blog Andreano Lanusse: Classic Sobre o autor Antonio Spitaleri Neto Consultor Técnico The Club. antonio@theclub.com.br setembro

8 Utilizando o Ribbon Controls Criado pela Microsoft visando facilitar o acesso aos itens de seus menus através de poucos cliques e dar um visual mais sofisticado as suas aplicações, os Ribbon Controls estão presentes no Delphi desde sua versão 2009, e são uma ótima maneira de darmos um algo a mais para nossas aplicações. Esse componente com certeza se bem usado pode ser um diferencial na sua aplicação, já que muitas vezes o mais importante para os usuários de nossos sistemas é a beleza do mesmo, em detrimento das muitas facilidades e benefícios que ele terá adotando o nosso sistema. Uma coisa importante a se atentar antes de dar início ao seu projeto utilizando o RibbonControls é que para isso, é necessária uma autorização especial da Microsoft, essa licença é gratuita mas impõe algumas limitações quanto a forma com que esses componentes devem ser utilizados. Para obter essa licença acesse com/pt-br/office/aa973809(en-us).aspx leia atentamente a licença de uso e o guia de Design do RibbonControls e se cadastre. Algumas partes importantes dessa licença dizem que o usuário não pode modificar essa tecnologia a torto e a direito, as possíveis modificações devem seguir as regras impostas no Guia de Design, e o mais importante, essa tecnologia não deve ser usada em programas concorrentes aos programas do pacote Office (Word, Excel, PowerPoint, Outlook, Access ou qualquer outro presente nesse pacote), o que faz todo sentido, afinal de contas a Microsoft gastou muito dinheiro para desenvolver essa inovação e quer proteger a todo custo seus direitos. Estou utilizando, para esse artigo, a versão 2010 do Delphi, mas vale lembrar que esse exemplo também pode ser feito com o Delphi 2009 que também conta com os componentes Ribbon Controls. Imagem 1 Veja na imagem 1. Paleta Ribbon Controls Os componentes desse pacote são encontrados na paleta Ribbon Controls do Delphi: Eles são os seguintes - TRibbon é a base do Ribbon, nele serão inseridas todas as páginas, os grupos, os componentes, e através dele será feita a ligação com o ActionManager que cuidará de todas as ações que serão executadas pelos componentes inseridos no Ribbon; - TRibbonComboBox um Combo- Box que interage diretamente com o Ribbon; 08 setembro 2010

9 - TRibbonSpinEdit um SpinEdit criado especialmente para ser usado em conjunto com o Ribbon; - TScreenTipsManager esse componente é muito interessante e vai ser melhor explorado durante o desenvolvimento desse artigo, ele permite que sejam adicionados tips (dicas) a cada um dos itens do Ribbon. Essas dicas seguem o mesmo estilo do Office, como nesse exemplo: Imagem 2 - TScreenTipsPopup esse componente serve para dar aos componentes que não estão no Ribbon o mesmo estilo de dicas que são dados aos componentes do Ribbon. Antes de dar início a uma demonstração de seu uso vamos conhecer o principal componente, o TRibbon, visualmente e dar uma olhada em algumas propriedades específicas dele: TRibbon Veja a imagem 2. O TRibbon é o início dos trabalhos para criar um Menu com Ribbon Controls, quando adicionado ao form ele se ajusta automaticamente a largura do form. Para prover a comunicação entre os componentes do Ribbon e as ações que cada um deles executará, devemos inserir o componente ActionManager da paleta Additional.O Tribbon conta com algumas propriedades interessantes e que são muito úteis durante o desenvolvimento do menu, são elas: ActionManager por essa propriedade o Ribbon é ligado ao seu gerenciador de ações; ApplicationMenu ao clicar no (+) para expandir as opções são apresentadas algumas opções para personalização desse item. O ApplicationMenu é aquele botão localizado na parte superior esquerda do Menu (dê uma olhada no Office 2007) e que traz algumas das opções mais usadas e, no caso de Excel ou Word, os documentos recentemente abertos pelo usuário. O seu uso será explorado mais adiante nesse artigo; Imagem 3 Exemplo: Veja a imagem 3. DocumentName nessa propriedade definimos o nome do documento ou tela que está aberto no momento, e que aparecerá ao lado do Caption que definirmos para o Ribbon, podemos por exemplo definir nessa propriedade, via código, o nome da janela que está aberta no momento; QuickAccessTollbar por aqui definimos as como será exibido o QuickAccessTollbar. O QuickAccessToolbar é um local de acesso rápido e está localizado ao lado do ApplicationMenu; Imagem 4 Luna Imagem 5 Obsidian Imagem 6 Silver ScreenTips é a ligação ao TScreenTips- Manager, que irá gerenciar as dicas que aparecerão quando o cursor estiver sobre um componente que tenha uma dica definida; ShowHelpButton essa propriedade é definida como True ou False e indica se o botão de ajuda, que fica no canto superior direito da tela será exibido ou não; Style aqui é definido como será o estilo de seu Menu, estão disponíveis três estilos (Luna(o estilo padrão), Obsidian e Silver), escolha o que você mais gostar: Veja nas imagens 4, 5 e 6: setembro

10 Tabs podem ser adicionadas ou mudadas de ordem as abas que foram adicionadas ao Ribbon. Para dar início aos trabalhos com o Ribbon, deve-se incluir no form o componente ActionManager e ligá-lo a propriedade ActionManager do componente TRibbon. Somente após isso poderão ser incluídas abas no Ribbon. Imagem 7 Ribbon Page Para incluir uma aba use a propriedade Tabs ou então clique com o botaão direito e escolha a opção Add Tabs, nesse momento será incluída uma aba no Ribbon, da seguinte forma: Veja a imagem 7. Esse componente tem uma propriedade interessante, essa propriedade é a Key Tip, essa propriedade designa um atalho a página quando estiver pressionada a tecla ALT. Ribbon Group Depois de incluída uma aba poderemos incluir um Grupo, que é o local onde ficarão o itens do menu, essa inserção segue o mesmo estilo da inserção de uma aba, botão direito e Add Groups. As principais propriedades desse componente são as seguintes: DialogAction chama uma ação através de um pequeno botão que é inserido na parte inferior direita do Group, dê uma olhada no Office ou então espere o desenvolvimento desse artigo para ver um exemplo; GroupAlign define como serão organizados os itens dentro do grupo, se na horizontal ou na vertical; GroupIndex define, quando na ocorrência de mais de um grupo dentro da aba, a ordem que esse grupo ocupará; KeyTip funciona da mesma maneira que o KeyTip da aba.; Rows o número de linhas que ocuparão os objetos dentro do grupo ActionManager O ActionManager é com certeza o mais importante componente usado durante o desenvolvimento do Menu, ele que executará todas as ações correspondentes aos itens do Ribbon, vale lembrar que sem esse item incluído e ligado ao Ribbon não é possível fazer nada relacionado ao menu, as principais propriedades desse componente são: DisableImages, Images,LargeDisablesImages e LargeImages são definidas as imagens que aparecerão nos itens do Ribbon, quando desativados ou ativados; Projeto Exemplo Imagem 8 Agora vamos dar início ao nosso exemplo, nesse exemplo não será montado um menu completo com vários botões, páginas, etc., somente será dada uma base a tudo que o desenvolvedor precisa saber para criar seu próprio menu, vamos ao exemplo. Inicie um novo projeto e adicione a ele: 1 TRibbon(da paleta RibbonControls); 1 ActionManager(da paleta Additional) e; 1 ImageList(da paleta Win32). Nomeie esse componente da seguinte forma: Images. Ligue a propriedade ActionManager do Ribbon ao ActionManager adicionado e o ImageList a propriedade do ActionManager: Images. Vamos programar algumas ações simples para entender a interação entre esses componentes. Primeiramente adicione uma aba ao Ribbon (botão direito/add Tab) e a nomeie como desejar, dentro dessa aba adicione um grupo (botão direito/add Group) e fique a vontade para nomeá-lo também. Para criarmos a primeira ação dê um duplo clique no ActionManager, neste momento será aberta uma tela como a que se vê a seguir: Veja a imagem 8. Para criar uma ação clique com o botão direito em Actions e escolha a opção New Action, ou então clique no ícone. Veremos agora algumas propriedades de um TAction: 10 setembro 2010

11 Category indica a categoria de que aquela ação faz parte, para criar uma categoria escreva o nome da categoria nessa propriedade; Image Index indica qual imagem do ImageList servirá como imagem da ação; ShortCut entre as opções apresentadas, define qual será o atalho para essa ação. Vamos criar uma ação básica, que servirá só para ilustrar esse exemplo, dê um duplo clique em Action1 em Actions e escreva o seguinte código: Imagem 9 ShowMessage( Utilizando Ribbon Controls!!!! ); Depois adicione uma imagem ao ImageList e a ligue a essa ação através de ImageIndex. O próximo passo é clicar e arrastar a ação recém-criada no ActionManager e arrasta-lá até o RibbonGroup, nesse momento será criado um TActionClientItem, que também tem algumas propriedades que permitem sua personalização, são elas: CommandProperties/ButtonSize define o tamnho do botão no Ribbon, se grande ou pequeno; ButtonType define o botão como simples ou como dropdown. Se definido como DropDown, podemos adicionar mais ações a ele, que serão encontradas quando clicarmos na seta; CommandStyle podemos definir de que tipo é esse TActionClientItem, se um Radio- Button, um CheckBox, um Button, etc; Items aqui são adicionadas as ações que serão encontradas em um botão definido como DropDown. Para tanto basta clicar em Items, na tela que se abrirá clicar com o botão direito, add e ligar o TActionClientItem a ação desejada, anteriormente criada no ActionManager. Vale lembrar que essas opções estarão disponíveis apenas se o ButtonStyle estiver definido com DropDown. Existem ainda ações pré-definidas, como ações de colar, recortar, copiar, entre outras que podem ser criadas escolhendo New Standard Action no ActionManager. Adicione mais algumas ações, as separando por categorias, isso será útil para demonstração do uso do Application Menu. Imagem 10 ApplicationMenu Vamos adicionar agora um ApplicationMenu, para tanto clique no Ribbon com o botão direito e escolha a opção Add Application Menu, nesse momento será adicionado ao Ribbon o seguinte item:. Para editar esse item vá até a propriedade ApplicationMenu do Ribbon, as principais propriedades encontradas são: Caption o que será exibido no item, por padrão está definido Recent Documents; CommandType define o que será exibido na parte à direita do AplicationMenu, se comandos ou itens recentes. Para um exemplo de itens recentes verifique o exemplo de Ribbon presente na pasta de exemplos do Delphi; Icon pode ser definido um ícone para esse Application Menu; IconSize o tamanho do ícone é definido por essa propriedade; KeyTip funciona da mesma forma do KeyTip das abas ou grupos. Para adicionar as ações ao ApplicationMenu, proceda da mesma forma que o Ribbon, vá até o ActionManager e arraste as ações para dentro do componente. Arraste também uma categoria interira para dentro do componente, serão criados subitens dentro do Application, como no caso de Arquivo na imagem. Veja a imagem 9. Para adicionarmos botões ao Application- Menu, como o de Opções e o de sair do Office, acesse o RibbonApplicationMenuBar através do Object TreeView do Delphi e em sua propriedade Options insira um novo OptionItem e o ligue a ação desejada no ActionManager. Veja a imagem 10. Percebam que foi criado o botão Sair na parte inferior do componente. QuickAccessToolbar Para usar o Quick Access Toolbar não existema segredos. Para adiciona-lo clique com o botão direito no Ribbon e escolha Add Quick Access Tollbar, ao setembro

12 lado do ApplicationMenu será criado um local para acesso rápido as funções do sistema. Para utiliza-lo é usado o mesmo procedimento de sempre: arraste a ação do ActionManager para o QuickAccess e pronto, essa opção já estará disponível. ScreenTipsManager Para deixar os hints de seu Ribbon com o estilo Office é necessária a inclusão do componente ScreenTipsManager. Para utilizá-lo primeiramente devemos ligá-lo a propriedade ScreenTips do Ribbon, depois ligaremos a propriedade LinkedActionList desse componente ao ActionManager, para isso clique na propriedade, botão direito Add e ligue ao ActionManager. É possível editar a aparência do tip de forma padrão para todos através das propriedades do componente ou então individualmente usando o duplo clique no ScreenTipsManager. Após isso será visualizada a seguinte tela: Veja a imagem 11. Através dela será feita a edição das Tips, ela é dividida em algumas partes: TreeView todas as ações que foram criadas no ActionManager estão nele, prontas para receber um Tip; Mode se estará ativado ou não este tip; ShowImage, ShowFooter e Preview define se nesse tip aparecerá uma imagem, se definida, se aparecerá o rodapé Press F1 for more help. O botão preview serve para uma prévisualização do tip; Imagem 11 Display o posicionamento do tip em relação à tela; Option se aparecerão o título e um possível atalho, se o mesmo estiver disponível para aquela ação; Footer o que será exibido no rodapé do tip pode ser definida uma imagem. Veja um exemplo de um tip editado pelas essas opções: Conclusão A beleza dos nossos aplicativos é um grande atrativo para os usuários e o RibbonControls pode valorizar muito nossos sistemas, com certeza vale passar algumas horas estudando-o e descobrindo os muitos recursos que o mesmo pode oferecer no intuito de facilitar e deixar os nossos sistemas mais bonitos. Para um completo exemplo do seu uso, estude os exemplos que ficam da pasta RibbonControls no diretório de Demos do Delphi. E isso é tudo pessoal, até outra hora. - aqui definimos o texto do Tip e se queremos alguma imagem ao lado dele; Sobre o autor Bruno Alcarás Consultor Técnico The Club. BorderStyle é definido o estilo da borda, se normal ou arredondado; Color - para formar um gradiente, devemos informar a cor de inicio e a cor final; bruno@theclub.com.br 12 setembro 2010

13 TList e Event Handlers em Delphi O conceito de multidifusão ou multicasting foi introduzido pela tecnologia.net que permite atribuir métodos distintos para o mesmo manipulador de eventos. O desenvolvedor Delphi não possui essa funcionalidade, porém o MultiCast pode ser simulado através do uso conjunto de Tlist e Event Handlers. Com essa simulação é possível especificar que dois ou mais métodos (procedures e funções) sejam chamados quando um evento for disparado. Para facilitar, seguem algumas definições: -Eventos Multicast: Eventos que disparam múltiplos métodos simultaneamente; -Manipuladores de eventos (Event Handlers): São propriedades associadas aos objetos da VCL que são ativadas quando os objetos recebem uma determinada ação (como um clique, por exemplo). À ocorrência dessas ações ou eventos estarão associadas à execução de métodos (procedures ou funções); -Tlist: É uma classe cuja função é armazenar uma lista de ponteiros. É usado para manter listas de objetos. Traz propriedades e métodos para: Adicionar ou deletar objetos em uma lista. Reorganizar os objetos em uma lista. Localizar e acessar os objetos em uma lista. Classificar os objetos em uma lista. -Objeto TMethod: Uma estrutura que armazena código e campos de dados para representar um método. Para que? Os eventos multicast podem ser muito úteis na criação de aplicações com bancos de dados, quando houver a necessidade de que mais de uma procedure entre em execução quando o evento OnAfterScroll for disparado, por exemplo. Como? Para conseguir esse recurso no Delphi Win32 é preciso simular a criação de eventos multicast através da criação de uma classe. Segue o exemplo simples, lembrando que vamos simular a manipulação de eventos multicast através da construção de um objeto Delphi Win32 que mantenha uma lista dos métodos que um evento disparará. Criar uma classe simples, TmultiEventClass, com apenas um evento de tipo TmultiEvent. Criar um objeto Tlist cuja característica é ser um MultiEventHandler, ou Manipulador de Eventos para armazenar uma lista de métodos que serão chamados quando o evento for disparado (o FireMultiEvent). Utilizar um tipo Tmethod para representar cada método (função ou procedure). Um tipo Tmethod pode ser usado para executar um método pelo seu nome. setembro

14 Segue código da interface da classe TmultiEvent. type PMethod = ^TMethod; TMultiEvent = procedure(const Value : string) of object; TMultiEventClass = class Private fmultieventhandlers : TList; // fmultieventhandlers é a Tlist que será usada para armazenar ponteiros para métodos que serão disparados por um evento de tipo TEvent. Public constructor Create; destructor Destroy; override; procedure AddMultiEvent(const Value: TMultiEvent); //adicionar um manipulador de eventos; procedure RemoveMultiEvent(const Value: TMultiEvent); //remover um manipulador de eventos; procedure FireMultiEvent; Segue a implementação: { TMultiEventClass } //cria o armazém dos manipuladores de evento constructor TMultiEventClass.Create; begin inherited Create; fmultieventhandlers := TList.Create; //limpa destructor TMultiEventClass.Destroy; var cnt: Integer; begin for cnt := 0 to -1 + fmultieventhandlers.count do Dispose (fmultieventhandlers[cnt]); fmultieventhandlers.free; inherited; //adicionar um manipulador de eventos à lista} procedure TMultiEventClass. AddMultiEvent(const Value: TMultiEvent); var h: PMethod; begin h := New(PMethod); h^.code := TMethod(Value).Code; h^.data := TMethod(Value).Data; fmultieventhandlers. Add(h); //remover um manipulador de eventos da lista procedure TMultiEventClass. RemoveMultiEvent(const Value: TMultiEvent); var cnt: Integer; begin for cnt := 0 to -1 + fmultieventhandlers.count do begin if (TMethod(Value). Code = TMethod(fMultiEven thandlers[cnt]^).code) and (TMethod(Value). Data = TMethod(fMultiEventHandler s[cnt]^).data) then begins Dispose(fMultiEventH andlers[cnt]); fmultieventhandlers. Delete(cnt); Break; //dispara evento (chama todos os manipuladores). A procedure //FireMultiEvent simula um evento com mais de um manipulador //de evento. procedure TMultiEventClass. FireMultiEvent; var cnt: Integer; msg : string; begin for cnt := 0 to -1 + fmultieventhandlers.count do begin msg := Format( %d/%d %s, [1 + cnt, fmultieventhandlers.count, fired! ]); TmultiEvent(fMultiEven thandlers[cnt]^)(msg); Agora, um exemplo simples. 1) Arraste um TButton em um formulário e especifique o seguinte código para o evento OnClick. { TForm1 } procedure TForm1. Button1Click(Sender: TObject); var test : TMultiEventClass; begin test := TMultiEventClass.Create; //criado objeto test que irá armazenar referência para dois // métodos try test. AddMultiEvent(Handler1); test. AddMultiEvent(Handler2); test. RemoveMultiEvent(Handler1); //handler1 é removido test. AddMultiEvent(Handler3); //outro método é adicionado test.firemultievent; //dispara os manipuladores de eventos finally test.free; Os três métodos Handler 1, Handler2 e Handler3 são definidos como: 14 setembro 2010

15 procedure TForm1. Handler1(const value: string); begin ShowMessage( h1: + value); procedure TForm1. Handler2(const value: string); begin ShowMessage( h2: + value); procedure TForm1. Handler3(const value: string); begin ShowMessage( h3: + value); Na execução, as procedures de exibição de ShowMessages serão disparadas: Conclusão Espero ter conseguido o objetivo de esclarecer o funcionamento e a funcionalidade dos manipuladores de eventos que são propriedades de alguns objetos que, ao receber uma ação (evento), ativam essa propriedade e disparam vários métodos simultâneos e não apenas um. Esta é uma desvantagem do DelphiWin32 com relação ao.net que pode ser facilmente sanada com algumas linhas de código. Então... Mãos à obra... E fire, fire, fire!! O layout da aplicação exemplo deverá ficar como na figura que segue: Sobre o autor Leonora Golin Consultora Técnica The Club. antonio@theclub.com.br setembro

16 Usando Crystal Reports Relatórios são uma característica do sistema que poucos desenvolvedores gostam, pelo menos, conheço alguns que preferem criar sistemas complexos, a fazer um relatório. Quando falamos em relatórios na Web então, parece o caos, pois teremos de usar HTML, CSS etc. Com o Crystal Reports, podemos criar relatórios robustos e poderosos em aplicações ASP.NET, como várias funcionalidades, como: parâmetros, fórmulas, grupos, subrelatórios, gráficos etc. Essas funcionalidades veremos como criar, usando apenas alguns cliques neste artigo. Para mais informações da versão beta, você pode acessar: weblogs?blog=/pub/wlg/ Criando a aplicação ASP.NET Abra o Visual Studio 2008 e crie uma nova aplicação ASP.NET (File>New>Web Site). Usaremos a linguagem C# e digite a pasta virtual para salvar o projeto (Figura 1). Veja a Figura 1. Existe um template chamado ASP.NET Crystal Reports Web Site que cria uma aplicação ASP.NET, onde é adicionado um controle CrystalReportViewer (para exibir o relatório) e um CrystalReportSource (objeto que disponibiliza o relatório para o CrystalReportViewer). Nota: Usaremos nesse artigo, o Visual Studio Você pode estar perguntando, por que não usar a nova versão, Visual Studio 2010? No Visual Studio 2010, o Crystal Reports deixou de fazer parte da ferramenta, ele terá de ser instalado em separado. A versão que suporta o Visual Studio 2010, ainda esta em fase beta, então, achei melhor, mostrar os exemplos no Visual Studio Vale lembrar que os exemplos têm 100% de chance de serem compatíveis com a versão do Crystal Reports para Visual Studio Figura 1. Criando o projeto ASP.NET 16 setembro 2010

17 Não existem muitas diferenças em relação ao projeto que criamos, mas fique a vontade de usar essa opção. Criando o primeiro relatório Com a aplicação ASP.NET criada, clique com o botão direito no nome do projeto e escolha a opção Add New Item. Na janela, escolha o item Crystal Report e dê um nome ao relatório (Figura 2). Veja a Figura 2.. Clique em Add para finalizar. Será criado um arquivo CrystalReport.rpt no Solution Explorer e para configurar o relatório será mostrado um wizard (Figura 3). Figura 2. Criando o primeiro relatório Figura 3. Wizard para criação do banco de dados Clique em OK e no próximo passo, vamos escolher a tecnologia para acesso ao banco de dados. Escolha Create New Conecction>OLE DB. Será aberto um editor, selecione Microsoft OLE DB Provider for SQL Server e clique em Next. A seguir, adicione as configurações do banco de dados SQL Server (usarei nos exemplos, o banco de dados Northwind do SQL Server 2008 Express). Clique em Next e em Finish para terminar a configuração do banco. Voltamos agora para a tela que mostra a conexão com o banco criada, onde podemos escolher a(s) tabela(s) que trabalharemos (escolha Customers), bastando arrastar a(s) mesma(s) para a seção Selected Tables (Figura 4). Figura 4. Conexão com o banco criada e escolhendo as tabelas Veja a Figura 4. C Clique em Next. Agora podemos escolher os campos (Fields) que serão mostrados no relatório. Escolha os campos necessários e clique em Next. A próxima etapa indica se vamos criar um grupo para o relatório, clique em Next. Nota: Podemos adicionar um grupo após a criação do relatório. Clique em Next novamente e escolha um estilo para o relatório na última tela do wizard. Clique em Finish para finalizar a criação do relatório (Figura 5). setembro

18 Veja a Figura 5. Temos um treeview com várias opções, entre elas: acesso aos campos da consulta, fórmulas, grupos, parâmetros, campos especiais (que mostra data de criação do relatório, total de registros, número da página etc), entre outros. No relatório temos cinco seções: Report Header (cabeçalho do relatório), Page Header (cabeçalho da página), Details (seção onde serão mostrados os dados), Report Footer (rodapé do relatório) e Page Footer (rodapé da página). Para visualizar o relatório, crie um novo Web Form (menu Website>Add New Item), dando o nome de preview.aspx e adicionando um CrystalReportViewer. Na Smart Tag do controle, escolha New report source no item Choose Report Source. Será aberto um editor para escolher o relatório que desejamos exibir. Figura 5. Relatório fica dockado no IDE do Visual Studio Escolha CrystalReport.rpt na opção Specify a Crystal Report for the CrystalReportSource control e clique em OK (Figura 6). Veja a Figura 6. Note que o relatório é mostrado em tempo de execução (sem os valores reais). Também podemos visualizar o relatório através da opção Main Report Preview na tela das seções do relatório. No formulário Default.aspx, adicione um botão e adicione o seguinte código: Response. Redirect( preview.aspx ); Figura 6. Escolhendo o relatório para ser exibido Execute a aplicação e veja o relatório em execução (Figura 7). Veja a Figura 7. A barra de ferramentas do relatório tem as opções para: exportação, impressão, navegação entre as páginas do relatório, busca de textos e zoom etc. Na exportação, temos a opção de exportar para os formatos: Crystal Report (RPT), Acrobat (PDF), Word (DOC), Excel (XLS) e Rich Text Format (RTF). Podemos configurar (remover/adicionar opções, inclusive a própria barra de ferramentas como um todo), através das propriedades do CrystalReportViewer. Figura 7. Executando o relatório na aplicação ASP.NET 18 setembro 2010

19 Agrupamento Para criar um relatório agrupado, é bastante simples. Poderíamos ter configurado essa funcionalidade no próprio wizard de criação do relatório. Mas com o relatório pronto, basta clicar com o botão direito e escolher a opção Insert>Group. Será aberta uma janela, onde devemos informar o campo que vamos agrupar. Escolha City e clique em OK. Rode a aplicação novamente e veja como o relatório ficou agrupado pelo campo City. Será mostrada uma lista dos grupos ao lado do relatório, onde ao escolher um item, o mesmo será marcado e seus dados mostrados em destaque. Para os próximos relatórios criados no artigo, para visualizá-los em tela, basta alterar o relatório no CrystalReportSource adicionado na tela de preeview. Veja a Figura 8. Figura 8. Relatório agrupado e um treeview para navegação dos grupos Agrupamento por período ou valores O cliente solicitou um relatório sobre a venda dos funcionários para serem agrupadas por um período de valores, por exemplo. Um grupo com os funcionários que venderam até R$ ,00, outro com os funcionários entre R$ ,00 e R$ ,00 e outro com os funcionários que tiveram vendas acima de R$ ,00. Com o Crystal esse tipo de relatório é fácil de ser desenvolvido. Crie um novo relatório e vamos customizar a consulta, usando um comando SQL ao invés de uma tabela do banco. Na tela de escolha das tabelas do banco, de um duplo clique no item Add Command. No editor que será mostrado, adicione a consulta SQL da Listagem 1. Listagem 1. Customizando a consulta que retornará os dados select Employees. EmployeeID, Employees. FirstName, Employees. LastName, SUM([Order Details]. UnitPrice * [Order Details].Quantity) as TotalVenda from Employees inner join Orders on Employees.EmployeeID = Figura 9. Criando grupos personalizados Orders.EmployeeID inner join [Order Details] on [Order Details].OrderID = Orders.OrderID group by Employees. EmployeeID, Employees. FirstName, Employees. LastName Essa consulta retorna o total de vendas de cada funcionário. Crie o relatório normalmente, com todos os campos da consulta. Após criar o relatório, vamos inserir um grupo para o campo TotalVenda, semelhante ao exemplo anterior, com a única diferença que no editor de grupos, vamos escolher a opção in specified order (Figura 9). Veja a Figura 9. Será mostrada a aba Specified order onde vamos adicionar os períodos que queremos. Clique em New e vamos criar os critérios para os grupos. Digite Até ,00, escolha is less than e escreva ,00. Clique em OK. Crie mais dois critérios, com as opções is between (valores entre ,01 e ,00 ) e is greater than para o valor ,01. O responsável pela correta criação dos grupos é a opção do tipo do critério: is less then (menos que), is between (entre dois valores) e is greater setembro

20 than (maior que). Clique em Finish. Salve o relatório, altere a propriedade ReportSource do CrystalReportViewer para o relatório recém criado. Rode a aplicação e veja o relatório com agrupamento por valores, semelhante ao mostrado na Figura 10. Veja a Figura 10. Fórmulas Em algumas situações, ao construir um relatório, torna-se necessário inserir informações (cálculos etc) que não constam na tabela ou comando SQL que preenche o relatório. Nesses casos, podemos usar fórmulas com vários recursos, como a possibilidade de ser usado em agrupamentos do relatório. Figura 10. Relatório com agrupamento por valores Crie um novo relatório, acessando os dados da tabela Products. No relatório, clique com o botão direito em Formula Fields e escolha New. Dê o nome de Soma e clique em Use Editor. Veja na Figura 11 o editor de fórmulas do Crystal Report. Veja a Figura 11. Veja que temos acesso aos campos da consulta, várias funções e operadores prontos para serem usados. Podemos trabalhar com a linguagem Basic Syntax (semelhante ao Visual Basic) e Crystal Syntax (semelhante ao Pascal), onde podemos em um relatório ter fórmulas de diferentes linguagens (mas não na mesma fórmula). Digite o seguinte código, que fará a soma do preço do produto com a quantidade em estoque: Figura 11. Editor de fórmulas do Crystal Report {Products. UnitPrice}*{Products. UnitsInStock} Você pode verificar a sintaxe da fórmula, através do botão Check. Clique em Save and close para salvar as alterações da fórmula e fechar o editor. Arraste a fórmula para a seção Details do relatório, pois usaremos a fórmula como um campo qualquer no relatório. Rode a aplicação e veja o resultado na Figura 12. Veja a Figura 12. Figura 12. Relatório com fórmulas, sendo executado 20 setembro 2010