Criando documentos de texto no BrOffice com macros e formulrios

Introduo
Como forma de compartilhar a experincia acumulada no processo de criao de formulrios e macros do BrOffice.org, para confeco de documentos de comunicao administrativa escrita utilizados pela CAIXA ECONMICA FEDERAL, elaboramos esta cartilha tcnica, que descreve cada etapa do processo de desenvolvimento. O presente documento destinado a pessoas e organizaes interessadas em utilizar o BrOffice, para criao de documentos padronizados e direcionado a usurios e desenvolvedores com conhecimento bsico na formatao de documentos com editor de textos e na linguagem BASIC. As etapas do desenvolvimento compreendem: - A preparao do modelo, que consiste na confeco de um arquivo de texto que vai servir de base para criar um novo documento; - A criao do formulrio e macro, que consiste em escrever a macro que vai interagir com o usurio; - E por fim, o empacotamento e instalao. Como resultado teremos um suplemento do BrOffice que pode ser distribudo e instalado em outras mquinas. A seguir, detalhamos cada uma destas etapas.

Sumrio
Introduo........................................................................................................................... 2 O modelo............................................................................................................................. 4
Estilos de pgina........................................................................................................................... 5 Estilos de pargrafo....................................................................................................................... 6 Estilos de lista................................................................................................................................ 7 Inserindo os favoritos.....................................................................................................................8

A macro............................................................................................................................. 12
Desenhando o formulrio............................................................................................................ 13 Escrevendo a macro.................................................................................................................... 16

O Suplemento................................................................................................................... 23
Criando o suplemento..................................................................................................................23 Instalando o suplemento..............................................................................................................29

Leitura complementar...................................................................................................... 31
Developer's Guide....................................................................................................................... 31 Como distribuir suas macros com um addon.............................................................................. 31 http://www.broffice.org.br/macros http://openoffice.org.br/files/addons1_1_pt_br.zip Ferramenta Xray.......................................................................................................................... 31

Criando documentos de texto no BrOffice com macros e formulrios

O modelo
O modelo um documento de texto que usado como base para se criar os novos documentos. Preparar o modelo consiste em formatar as margens, cabealhos, rodaps, fontes, pargrafos e os favoritos (ou bookmarks). Para criarmos o modelo, iniciamos o Writer com um novo documento em branco. O prximo passo efetuar a formatao do documento. Para tanto utilizaremos o recurso de estilos do Writer. Os estilos so manipulados pelo painel Estilos e formatao. O Writer divide os estilos em categorias. Estilos de pargrafo, estilos de caractere, estilos de quadro, estilos de pgina, e estilos de lista. (figura 2). O acesso ao painel feito pelo menu Formato, opo Estilos e formatao, ou pela tecla de atalho F11. (figura 1)

Figura 1: Menu de acesso ao painel Estilos e formatao

Figura 2: Painel Estilos e formatao

Estilos de pgina

Figura 3: Dilogos de formatao de estilos de pgina

Criando documentos de texto no BrOffice com macros e formulrios

O estilo de pgina controla, entre outras coisas, margens, tamanho do papel, cabealhos e rodaps. Cada novo documento possui naturalmente um estilo de pgina associado, nomeado de padro. Em alguns documentos a primeira pgina possui caractersticas diferentes das demais. Para essa formatao, preciso aplicar um estilo diferente na primeira pgina. No painel Estilos e formatao escolha a opo estilos de pgina, e efetue um duplo-clique sobre o estilo existente Primeira pgina. Isso ir aplicar o estilo na pgina atual do documento, ou seja, a pgina 1. Como dito antes, o estilo inicial o estilo padro. O prximo passo ajustar o estilo para refletir o formato do documento. No painel, clique sobre o nome do estilo (boto direito) e selecione modificar. No dilogo estilo de pgina (figura 3) ajuste o tamanho do papel, as margens, e se necessrio, o cabealho e rodap. Observe na aba organizador que no campo prximo estilo o valor "padro". Isto significa que o estilo padro ser aplicado s pginas subseqentes do documento, quando o documento tiver mais de uma pgina. necessrio, portanto, formatar tambm o estilo padro repetindo os passos anteriores. Verifique que isso s se justifica quando a primeira pgina possui alguma formatao diferente das demais. Se o documento a ser criado possuir um formato nico em todas as pginas, basta ajustar o estilo padro. Prxima etapa, formatar os estilos de pargrafo.

Estilos de pargrafo

Figura 4: Dilogos de formatao de estilos de pargrafo

Finalizados os estilos de pgina, devemos formatar os estilos de pargrafo. Essa formatao inclui principalmente a definio da fonte, do alinhamento do texto, do espaamento entre pargrafos. Crie ou modifique tantos estilos quantos forem necessrios, de acordo com a complexidade do seu documento. No painel Estilos e formatao clique no cone Estilos de pargrafo. Com um clique direito sobre um estilo escolha Novo... ou Modificar..., para modificar um estilo ou criar um novo. No dilogo Estilo de pargrafo (figura 4), faa os ajustes necessrios. Estilos normalmente necessrios em um documento formatam os tpicos, assinaturas, vocativos, endereos, cabealhos e rodaps. Esta etapa compreende apenas a criao dos estilos. A aplicao dos mesmos se dar posteriormente. A prxima etapa formatar os estilos de lista.

Estilos de lista
Os estilos de lista so usados para formatar as listas numeradas ou de marcadores. Por exemplo, se o documento possuir tpicos numerados, aqui que definimos o estilo de numerao. O procedimento idntico a formatao dos estilos de pgina e de pargrafo. Aqui configuramos o estilo dos nmeros, espaamento do texto, subnveis, entre outros. Ao fim do processo, precisamos associar o estilo de numerao a um estilo de pargrafo. Uma hiptese termos criado um estilo de pargrafo chamado tpicos, para formatar os tpicos do documento. E criamos um estilo de lista chamado numerao de tpicos para formatar a numerao. Para associarmos os dois estilos, vamos ao dilogo estilos de pargrafo (figura 4), para modificar o estilo tpicos e na aba Numerao selecionamos o estilo recm criado. Feito isto, quando for ativada a numerao em um pargrafo de estilo tpicos, a numerao ir seguir a formatao do estilo numerao de tpicos. Alm destes, temos tambm os estilos de caractere e de quadro, que no sero abordados nesta cartilha. O passo seguinte preparar o documento, aplicando os estilos aos pargrafos e inserindo os favoritos.

Inserindo os favoritos
Depois de formatar os estilos, passamos a etapa de aplicar os estilos ao documento, e inserir os favoritos. Os favoritos, tambm chamados de bookmarks, so marcas em pontos diversos do documento que utilizaremos para insero de texto atravs da macro. Os bookmarks devem ser

Criando documentos de texto no BrOffice com macros e formulrios

estrategicamente posicionados de acordo com o documento que ser criado. Considerando um documento simples de exemplo como o da figura 5, teramos o seguinte cenrio:

Figura 5: Documento de exemplo com os bookmarks (itens numerados)

tem 1 - Neste ponto vai ficar o primeiro bookmark, que vamos chamar de identificacao, para incluso da identificao e nmero do documento; tem 2 - bookmark chamado local, para incluso do local e data. tem 3 - bookmark destinatario; tem 4 - bookmark vocativo; tem 5 - bookmark texto; tem 6 - bookmark encerramento e tem 7 - bookmark assinatura.

A incluso do bookmark feita pelo menu Inserir, opo "Favoritos...". A incluso no

documento ocorre na posio corrente do cursor, ento precisamos posicionar o cursor na posio desejada e acessar o menu, conforme figura 6.

Figura 6: Menu de acesso a incluso de bookmarks

Aps escolher a opo no menu, exibido o dilogo de incluso, onde informamos o nome do bookmark a ser criado. Neste dilogo so listados os bookmarks existentes no documento. (figura 7).

Figura 7: Menu de acesso a incluso de bookmarks

preciso repetir esse processo para os 7 (sete) bookmarks do nosso exemplo.

Criando documentos de texto no BrOffice com macros e formulrios

Observe que o bookmark includo no aparece no documento, isto , ele fica invisvel. Mais a frente veremos como verificar os bookmarks existentes e testar o seu funcionamento. Aps o trmino do procedimento, o documento estar como a figura 8. Como no possvel visualizar o bookmark utilizamos a ferramenta navegador, disponvel no menu Editar, opo Navegador, ou pela tecla de atalho F5. Sob o tem Marcadores (figura 9), podemos visualizar os bookmark recm criados.

Figura 8: Documento aps a criao dos bookmarks (indicados em verde)

Para verificar se os bookmark foram posicionados corretamente, efetuamos um duplo-clique sobre o nome do bookmark no navegador (figura 9), o que faz com que o foco do cursor mova-se para o bookmark selecionado.

Figura 9: Navegador, com destaque para os bookmarks (marcadores)

E para finalizar esta etapa precisamos salvar o documento no formato de um modelo do Writer.

10

No menu Arquivo, opo Salvar como..., alteramos o tipo de arquivo de "Texto do OpenDocument (.odt)" para "Modelo de texto do OpenDocument (.ott)". O modelo salvo ser usado na prxima etapa, que a criao da macro.

A macro
Nesta etapa vamos escrever a macro e o formulrio para interagir com o modelo que criamos. Dentre as linguagens suportadas utilizaremos o StarBasic, visto que o Broffice possui um editor integrado. Acessamos o editor interno atravs do menu Ferramentas, opo Macros, Organizar macros, BrOffice.org Basic... No dilogo Macros do BrOffice.org Basic,vamos no boto Organizador. No dilogo Organizador de Macros, vamos na aba Bibliotecas, e ento escolhemos o boto "Nova...". A biblioteca permite organizar nossas macros e formulrios, fazendo um isolamento de outras macros. Vamos nomear a nova biblioteca de minhaBiblioteca. (figura 10)

Figura 10: Sequncia de dilogos para criar uma nova biblioteca

Ainda no dilogo Organizador de macros, vamos na aba Caixas de dilogo, selecionamos a biblioteca criada no passo anterior e no boto "Novo..." criamos nosso formulrio que vai se chamar meuFormulario. (figura 11).

Criando documentos de texto no BrOffice com macros e formulrios

Figura 11: Sequncia de dilogos para criar um novo formulrio

Por fim, na aba Mdulos, boto "Novo...", criamos o mdulo meuModulo.(figura 12).

Figura 12: Sequncia de dilogos para criar um novo mdulo

Agora podemos fechar os dilogos abertos e voltar ao editor.

Desenhando o formulrio
Antes de escrever qualquer macro vamos preparar o formulrio que far a interao com o usurio. Para isso, no editor de cdigo, selecionamos a aba meuFormulario. Para montar o dilogo temos a caixa de ferramentas, localizada no menu Exibir, opo Barra de

12

ferramentas. Atravs dessa barra, desenharemos o formulrio incluindo os controles e ajustando suas propriedades. A figura 13 mostra a caixa de ferramentas e o dilogo em si. Para incluirmos controle no dilogo basta selecionar na caixa de ferramentas e desenhar diretamente no formulrio, similar a outros ambientes de desenvolvimento. Na caixa de ferramentas, alm dos controles comuns de texto, rtulo, boto de opo, caixa de seleo, de listagem e de combinao, temos controles especializados para criar campos de data, hora, moeda, nmero, seleo de arquivos, e outros. A figura 14, mostra a descrio de alguns botes encontrados na barra de ferramentas.

Figura 13: Barra de ferramentas e o dilogo meuFormulario

No nosso formulrio de exemplo, vamos utilizar os controles :

campo de rtulo: para criar as legendas dos campos; caixa de texto: para entrada da cidade, destinatrio e assinatura do documento; caixa de combinao: para selecionar a forma de tratamento, a expresso de encerramento e o destinatrio; campo numrico: para entrada do nmero do documento; campo de data: para seleo da data do documento no calendrio e; boto: para os botes "Ok" e "Cancelar";

Figura 14: Descrio dos botes

Aps a incluso dos controles, nosso formulrio, ou caixa de dilogo, deve estar como na figura 15.

Criando documentos de texto no BrOffice com macros e formulrios

Figura 15: Formulrio aps incluso dos controles

Cada tipo de controle possui propriedades particulares, que so usadas para configurar o seu comportamento. Por exemplo, em um controle do tipo campo de data podemos definir a data mnima e mxima permitidas, o formato da data, se vai estar disponvel um calendrio para seleo de data, etc. Nas caixas de combinao devemos criar a lista com os valores, como nos exemplos na figura 16.

Figura 16: Exemplo de valores para uso nos controles do formulrio

Dentre as propriedades de cada controle, devemos dar ateno especial ao nome, pois a referncia ao controle na macro feita pelo nome. Obedecendo a seqncia de campos da figura 15, temos: txtNumero, txtData, txtCidade, cboDestinatario, txtDestinatario, cboTratamento, cboEncerramento e txtAssinatura. Este o fim desta etapa. Nosso formulrio est pronto.

Escrevendo a macro
Agora estamos prontos para escrever a macro. No editor, alternamos para o mdulo criado anteriormente: meuModulo.

14

O primeiro passo declarar uma varivel para referenciar o formulrio. Embora a declarao de variveis no seja obrigatria no basic, precisamos que esta assuma o escopo global. Portanto ela deve ser declarada fora de uma funo ou subrotina no mdulo. Para declarar uma varivel usamos a instruo "dim".
REM ***** BASIC *****

' Declarao Dim dlg As Object

No prximo passo, vamos escrever a subrotina que carrega e mostra o formulrio. Vamos utilizar a subrotina Main que foi criada junto com o mdulo.
Sub Main DialogLibraries.LoadLibrary("minhaBiblioteca") dlg = CreateUnoDialog(DialogLibraries.minhaBiblioteca.meuFormulario) dlg.Execute() End Sub

Nestas linhas, basicamente, carregamos a Biblioteca "minhaBiblioteca", para depois carregamos o formulrio atravs a funo CreateUnoDialog e o atribumos a varivel dlg. Por fim, chamamos o mtodo Execute() do dilogo. Executando essa poro de cdigo o dilogo vai ser exibido, porm ainda no funcional. Precisamos escrever as rotinas que vo responder aos eventos de clique nos botes Cancelar e Ok. Vamos comear pelo boto Cancelar. O cdigo o seguinte:
Sub btnCancel_click dlg.endExecute() End End Sub

Primeiro chamamos o mtodo endExecute() do dilogo, que encerra sua execuo. Depois usamos a instruo End para finalizar a macro em si. Por fim escrevemos a rotina btnOk_click que vai responder ao evento clique no boto OK.

Sub btnOk_click End Sub

As etapas seguintes so :

Criando documentos de texto no BrOffice com macros e formulrios

1. Armazenar os controles do dilogo em variveis. Fazemos isso com o mtodo getControl() do dilogo.
Sub btnOk_click txtNumero = dlg.getControl("txtNumero") End Sub

Este cdigo armazena o campo txtNumero na varivel de mesmo nome. Fazemos isso para todos os campos do formulrio. 2. Validar o preenchimento do formulrio, verificando se os campos foram corretamente preenchidos.
If txtNumero.Text = "" Then MsgBox "Informe o nmero do documento.", 48, "Ateno" txtNumero.SetFocus() Exit Sub End If

Neste trecho de cdigo verificamos apenas se o campo txtNumero est vazio, atravs da propriedade Text. Caso no esteja preenchido emitimos uma mensagem ao usurio, movemos o foco para o controle e interrompemos a execuo da rotina. Ou seja, enquanto o campo no for preenchido a macro no ser executada. Fazemos isso para os campos que forem obrigatrios. Alm da validao de preenchimento, podemos fazer qualquer outro tipo de validao aqui. 3. Criar o documento.
Dim doc, url, args() url = ConvertToURL("c:\meuModelo.ott") doc = StarDesktop.loadComponentFromUrl(url, "_blank", 0, args())

Usamos a funo ConvertToURL() para transformar o caminho onde est o modelo em uma url para uso com a prxima instruo. Esta funo pode receber como parmetro o caminho para um arquivo no disco local, um caminho UNC, um endereo HTTP, entre outros. Da criamos o documento, baseado no modelo, e armazenamos na varivel doc. 4. Inserir o texto no documento.

doc.Bookmarks.getByName("identificacao").Anchor.setString("Documento N " & txtNumero.Text) ... ... doc.currentController.viewCursor.gotoRange(doc.Bookmarks.getByName ("texto").Anchor, false)

16

O texto deve ser inserido nos bookmark criados anteriormente. Utilizamos o mtodo getByName() da coleo Bookmarks do documento, para recuperar o bookmark e em seguida utilizamos o mtodo setString() da propriedade Anchor do bookmark. Repetimos esse processo para todos os bookmark, exceto o bookmark texto. O bookmark texto usado para posicionarmos o cursor naquele ponto. Usamos o mtodo gotoRange(), passando como parmetro a propriedade Anchor do bookmark. A digitao a partir deste ponto ser feita pelo usurio. Por fim precisamos fechar o dilogo e encerrar a execuo da macro. Podemos usar a rotina btnCancel_click que foi escrita justamente para este fim. A seguir, como vai ficar o cdigo da macro depois de finalizado.
REM ***** BASIC *****

' Declaraes Dim dlg As Object

' Rotina principal Sub Main ' carrega a bilioteca minhaBibilioteca, cria e exibe o dilogo DialogLibraries.LoadLibrary("minhaBiblioteca") dlg = CreateUnoDialog(DialogLibraries.minhaBiblioteca.meuFormulario) dlg.Execute() End Sub

' Boto cancelar Sub btnCancel_click ' fecha o dilogo e termina a macro dlg.endExecute() End End Sub

' Boto Ok Sub btnOk_click ' recupera os controles no dilogo txtNumero = dlg.getControl("txtNumero") txtData = dlg.getControl("txtData") txtCidade = dlg.getControl("txtCidade") cboDestinatario = dlg.getControl("cboDestinatario") txtDestinatario = dlg.getControl("txtDestinatario") cboTratamento = dlg.getControl("cboTratamento") cboEncerramento = dlg.getControl("cboEncerramento") txtAssinatura = dlg.getControl("txtAssinatura")

Criando documentos de texto no BrOffice com macros e formulrios

' validao dos dados digitados ' somente 1 campo para fins de exemplo If txtNumero.Text = "" Then MsgBox "Informe o nmero do documento.", 48, "Ateno" txtNumero.SetFocus() Exit Sub End If ' dados validados. continua ' cria o documento Dim doc, url, args() url = ConvertToURL("c:\meuModelo.ott") doc = StarDesktop.loadComponentFromUrl(url, "_blank", 0, Args()) ' insere o texto nos bookmark doc.Bookmarks.getByName("identificacao").Anchor.setString("Documento N " & txtNumero.Text) doc.Bookmarks.getByName("local").Anchor.setString(txtCidade.Text & ", " & txtData.Text) doc.Bookmarks.getByName("destinatario").Anchor.setString(cboDestinatario .Text & Chr(10) & txtDestinatario.Text) doc.Bookmarks.getByName("vocativo").Anchor.setString(cboTratamento.Text) doc.Bookmarks.getByName("encerramento").Anchor.setString(cboEncerramento .Text) doc.Bookmarks.getByName("assinatura").Anchor.setString(txtAssinatura .Text) ' move o foco para o bookmark "texto" doc.currentController.viewCursor.gotoRange(doc.Bookmarks.getByName ("texto").Anchor, false) ' fecha o dilogo e termina a macro btnCancel_click End Sub

Resta agora associar as rotinas com os botes do formulrio. No formulrio, vamos na folha de propriedades do boto Cancelar, aba eventos. Da lista de eventos vamos selecionar o evento "Ao iniciar", clicando no boto "..." conforme (figura 17).

18

Figura 17: Folha de propriedades do boto cancelar, aba Eventos

No dilogo seguinte, figura 18, selecionamos a opo atribuir. Nesta tela possvel associar macros a outros eventos e no apenas ao evento selecionado na tela anterior, bastando para isso selecionar um evento diferente na lista.

Figura 18: Dilogo Atribuir macro

Ao clicarmos no boto "atribuir", temos o dilogo "Seletor de macro". (figura 19).

Criando documentos de texto no BrOffice com macros e formulrios

Figura 19: Deletor de macro

Navegamos at o mdulo meuModulo e selecionamos a macro btnCancel_click e confirmamos pelo boto Ok. Agora ao clicarmos no boto Cancelar no formulrio, ser executada a macro associada. Repetimos esse processo para o boto Ok, associando o evento "Ao iniciar" macro btnOk_click A partir deste ponto, j podemos testar o funcionamento da macro. Para isso vamos a janela do moduloPrincipal e clicamos no boto "Executar o Basic" localizado na barra de ferramentas "Macro". (figura 20)

Figura 20: Barra de ferramentas Macro, com destaque para o boto Executar o BASIC

Ao clicarmos neste boto, ser executada a subrotina Main(), que a rotina que carrega e mostra o formulrio Continuando o teste preenchemos o formulrio conforme figura 21 e clicamos Ok.

20

Figura 21: Formulrio preenchido

Ser ento executada a macro que cria o novo documento e insere o texto nos bookmark. A macro btnOk_click. O documento criado vai ficar como na figura 22.

Figura 22: Documento criado pela macro

Observe que o cursor fica posicionado no pargrafo exato para que o usurio faa a digitao do texto. A fonte, margens, o espaamento entre pargrafos o definido no modelo, permitindo que os documentos criados pela macro sigam sempre o mesmo padro, que o nosso objetivo. A prxima etapa o empacotamento como um suplemento do BrOffice.

Criando documentos de texto no BrOffice com macros e formulrios

O Suplemento
Para distribuir nossa macro vamos utilizar o recurso de suplementos do BrOffice, tambm chamados de Add-On. O suplemento permite a distribuio das macros e formulrios, e a sua fcil instalao em outras mquinas.

Criando o suplemento
Para executar esta tarefa vamos precisar dos arquivos da macro e do formulrio que criamos. Os arquivos, no windows xp, ficam salvos no caminho "<perfil do usurio>\Dados de aplicativos\BrOffice.org2\user\basic\minhaBiblioteca", conforme figura 23.

Figura 23: Arquivos para a criao do suplemento

Precisamos copiar a pasta "minhaBiblioteca" para outro local no disco, por exemplo C:\minhaBiblioteca. Depois, no Organizador de macros, figura 10, devemos excluir a biblioteca que criamos nos passos anteriores. Para criao do suplemento podemos utilizar uma ferramenta disponvel no endereo de internet http://openoffice.org.br/files/addons1_1_pt_br.zip. ou em http://www.broffice.org.br/macros. Trata-se de um documento de texto do BrOffice intitulado "Como distribuir suas macros com um Addon" com orientaes detalhadas sobre o suplemento e suas possibilidades, alm de ter uma macro que auxilia no processo de criao e compresso do suplemento. O documento foi escrito por Bernard Marcelly e traduzido para o portugus por Noelson Alves Duarte e distribudo sob a licena LGPL. No subitem "2.2 Criao do arquivo de configurao", temos o boto "Criar arquivo XML" que executa o assistente parar criarmos o arquivo de configurao addon.xcu, base para criao do suplemento. Clicando no boto "Prximo >>" temos o dilogo da figura 24.

22

Figura 24: Criando o suplemento passo 1

Na caixa arquivo de script principal, selecionamos o arquivo script.xlb localizado na pasta minhaBiblioteca. Tambm informamos um nome para o suplemento. Depois, basta clicar Ok para ir para o prximo passo.

Figura 25: Criando o suplemento passo 2

No passo 2 escolhemos a opo Adicionar um item de menu no menu Principal. E vamos para o prximo passo.

Figura 26: Criando o suplemento passo 3

Criando documentos de texto no BrOffice com macros e formulrios

O passo 3, figura 26, consiste em selecionar em que contexto do BrOffice vai ser criado o menu. O padro todos. Clicamos no boto "Prximo >>".

Figura 27: Criando o suplemento passo 4

A figura 27 ilustra o passo 4, onde informamos o ttulo do menu e clicamos no boto "Adicione este texto". Ao fazer isso a caixa Ttulos j definidos aqui vai ter seu valor alterado de 0 para 1. Ao clicar em "Concludo", recebemos uma mensagem que agora devemos criar um submenu, O que ser feito pelo dilogo da figura 28.

Figura 28: Criando o suplemento passo 5

Para criarmos o submenu, o procedimento o mesmo. Informamos o ttulo, clicamos em "Adicione este texto" e em seguida em "Concludo". A diferena do menu para o submenu que ao concluirmos este ltimo, somos direcionados para tela onde devemos informar qual ao ser executada quando um usurio selecionar esta opo no menu. Vamos escolher a opo "Execute a macro", informando o nome da biblioteca, do mdulo e finalmente da macro que ser executada. (figura 29)

24

Figura 29: Criando o suplemento passo 6

Clicando em "Prximo >>" vamos para o dilogo que permite selecionar uma imagem para usar como cone do menu, figura 30.

Figura 30: Criando o suplemento passo 7

Vamos escolher a opo "Sem imagem", e vamos para o passo 8. Na sequncia, temos a opo de criar outro submenu ou concluirmos nosso arquivo de configurao, figura 31.

Criando documentos de texto no BrOffice com macros e formulrios

Figura 31: Criando o suplemento passo 8

No nosso exemplo, vamos escolher "Concludo" e criar o arquivo addon.xcu.

Figura 32: Criando o suplemento passo 9

O ltimo passo, na figura 32, mostra a mensagem que o arquivo foi criado e um resumo das aes, que foram criar um menu Principal chamado Meus Formulrios, e um submenu chamado Meu Documento, que ao ser acionado vai executar a macro minhaBiblioteca.meuModulo.Main. Ainda nesta tela temos o boto "Comprimir o Addon". Clicando nesta opo vamos finalmente gerar nosso suplemento que ser salvo como "C:\minhaBiblioteca.zip".

26

Instalando o suplemento
Para o teste final vamos instalar nosso suplemento. Isto feito com o aplicativo unopkg, localizado no caminho: <pasta de instalao do BrOffice>\program\. A instalao feita digitando o comando a seguir, numa janela prompt de comandos do windows:
<instalao_BrOffice>\program\unopkg add --shared c:\minhaBiblioteca.zip

Uma lista completa das opes do aplicativo unopkg pode ser obtida passando o argumento -help, como no exemplo abaixo:
<instalao_BrOffice>\program\unopkg --help

A instalao do addon pode ser feita tambm em modo grfico, porm o aplicativo em modo texto permite que a instalao seja feita atravs de script, o que se torna interessante quando a distribuio ocorrer em grande quantidade de mquinas. Para testar nosso suplemento, aps instalado, basta abrirmos o BrOffice e vamos percerber um tem novo no menu, figura 33. O menu Meus Formulrios e o submenu Meu Documento.

Figura 33: Barra de menus com destaque para o novo menu criado pelo suplemento

Selecionando o menu Meu Documento, vamos executar a macro que vai nos mostrar o formulrio e permitir criarmos o documento. Figura 34.

Criando documentos de texto no BrOffice com macros e formulrios

Figura 34: Testando o suplemento

Ainda, para o correto funcionamento da macro, no podemos esquecer que o modelo precisa estar acessvel, seja no sistemas de arquivo local, na rede ou num endereo http.

28

Leitura complementar
Developer's Guide
http://wiki.services.openoffice.org/wiki/Documentation/Dev_Guide/OpenOffice.org_Developers_Guide

Como distribuir suas macros com um addon

Orientaes de como distribuir as macros atravs de suplementos http://www.broffice.org.br/macros http://openoffice.org.br/files/addons1_1_pt_br.zip

Ferramenta Xray
Xray uma ferramenta para o programador de macros Basic usando a API do OpenOffice. Seu propsito exibir as propriedades, mtodos, servios e interfaces de uma varivel do tipo objeto. http://www.broffice.org.br/macros http://openoffice.org.br/files/xraytool51_br.zip