Criando documento de Texto no com Macros e

  • View
    216

  • Download
    4

Embed Size (px)

Text of Criando documento de Texto no com Macros e

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

    2

  • 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/macroshttp://openoffice.org.br/files/addons1_1_pt_br.zip

    Ferramenta Xray..........................................................................................................................31

  • Criando documentos de texto no BrOffice com macros e formulrios

    O modeloO 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

    4

  • 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

    6

  • 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

    8

  • 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 bookm