diff options
author | Slávek Banko <[email protected]> | 2012-08-20 20:02:39 +0200 |
---|---|---|
committer | Slávek Banko <[email protected]> | 2012-08-20 20:02:39 +0200 |
commit | e2a67e0b1f3ee8890ba2fce71d41def0e114aca2 (patch) | |
tree | ccbc5b26503151ec4eeb450a3b4498924ad7cb55 /koffice-i18n-pt/docs/koffice/kugar | |
download | koffice-i18n-e2a67e0b1f3ee8890ba2fce71d41def0e114aca2.tar.gz koffice-i18n-e2a67e0b1f3ee8890ba2fce71d41def0e114aca2.zip |
Initial import of extracted tarballs
Diffstat (limited to 'koffice-i18n-pt/docs/koffice/kugar')
-rw-r--r-- | koffice-i18n-pt/docs/koffice/kugar/Makefile.am | 4 | ||||
-rw-r--r-- | koffice-i18n-pt/docs/koffice/kugar/datadtd.docbook | 90 | ||||
-rw-r--r-- | koffice-i18n-pt/docs/koffice/kugar/dataref.docbook | 162 | ||||
-rw-r--r-- | koffice-i18n-pt/docs/koffice/kugar/designer.docbook | 679 | ||||
-rw-r--r-- | koffice-i18n-pt/docs/koffice/kugar/index.docbook | 197 | ||||
-rw-r--r-- | koffice-i18n-pt/docs/koffice/kugar/progguide.docbook | 669 | ||||
-rw-r--r-- | koffice-i18n-pt/docs/koffice/kugar/starting.docbook | 100 | ||||
-rw-r--r-- | koffice-i18n-pt/docs/koffice/kugar/template-elements.docbook | 3577 | ||||
-rw-r--r-- | koffice-i18n-pt/docs/koffice/kugar/template.docbook | 515 | ||||
-rw-r--r-- | koffice-i18n-pt/docs/koffice/kugar/templatedtd.docbook | 522 | ||||
-rw-r--r-- | koffice-i18n-pt/docs/koffice/kugar/tutorial.docbook | 380 |
11 files changed, 6895 insertions, 0 deletions
diff --git a/koffice-i18n-pt/docs/koffice/kugar/Makefile.am b/koffice-i18n-pt/docs/koffice/kugar/Makefile.am new file mode 100644 index 00000000..6869837a --- /dev/null +++ b/koffice-i18n-pt/docs/koffice/kugar/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = pt +SUBDIRS = $(AUTODIRS) +KDE_DOCS = AUTO +KDE_MANS = AUTO diff --git a/koffice-i18n-pt/docs/koffice/kugar/datadtd.docbook b/koffice-i18n-pt/docs/koffice/kugar/datadtd.docbook new file mode 100644 index 00000000..a103ada6 --- /dev/null +++ b/koffice-i18n-pt/docs/koffice/kugar/datadtd.docbook @@ -0,0 +1,90 @@ +<!-- To validate this document separately, uncomment this prolog +<?xml version="1.0" ?> +<!DOCTYPE appendix PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> +--> + +<sect1 id="kugardata-dtd"> +<sect1info> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Pedro</firstname +><surname +>Morais</surname +><affiliation +><address +><email +>[email protected]</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +</sect1info> +<title +>DTD (Document Type Definition) do <sgmltag class="element" +>KugarData</sgmltag +></title> + +<synopsis +><?xml version="1.0" encoding="UTF-8"?> + +<!DOCTYPE KugarData [ + <!ELEMENT <link linkend="kugar-data-element" +>KugarData</link +> (<link linkend="row-element" +>Row</link +>*)> + <!ATTLIST KugarData + <link linkend="template-att" +>Template</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="row-element" +>Row</link +> EMPTY> + <!ATTLIST Row + <link linkend="level-att" +>level</link +> CDATA #REQUIRED + <link linkend="column-att" +>col1</link +> CDATA #IMPLIED + <link linkend="column-att" +>col2</link +> CDATA #IMPLIED + <link linkend="column-att" +>...</link +> CDATA #IMPLIED + <link linkend="column-att" +>coln</link +> CDATA #IMPLIED> + ]> +</synopsis> +</sect1> diff --git a/koffice-i18n-pt/docs/koffice/kugar/dataref.docbook b/koffice-i18n-pt/docs/koffice/kugar/dataref.docbook new file mode 100644 index 00000000..6f586f7f --- /dev/null +++ b/koffice-i18n-pt/docs/koffice/kugar/dataref.docbook @@ -0,0 +1,162 @@ +<!-- if you want to validate this file separately, uncomment this prolog: + +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> + +--> + +<sect1 id="kugardata-element"> +<sect1info> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Pedro</firstname +><surname +>Morais</surname +><affiliation +><address +><email +>[email protected]</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +</sect1info> +<title +><sgmltag class="element" +>Elemento KugarData</sgmltag +></title> + +<para +>O elemento <sgmltag class="element" +>KugarData</sgmltag +> define uma fonte de dados do relatório. A estrutura básica é uma colecção de linhas e colunas. Este documento não define os tipos de dados nem os seus atributos. O modelo do relatório define a informação do tipo de dados da coluna. </para> + +<para +>O criador do documento poderá aplicar uma folha de estilo &XSL; para um documento existente de modo a convertê-lo neste formato. Se for usada a &XSL;, o criador poderá aplicar macros personalizadas com ela para os cálculos das colunas, a ordenação, &etc;. </para> + +<synopsis +><!ELEMENT KugarData (Row*)> +<!ATTLIST KugarData + Template CDATA #REQUIRED> + +<!ELEMENT Row EMPTY> +<!ATTLIST Row + level CDATA #REQUIRED + col1 CDATA #IMPLIED + col2 CDATA #IMPLIED + ... CDATA #IMPLIED + coln CDATA #IMPLIED> +</synopsis> + + +<sect2 id="kugar-data-element"> +<title +>Elemento dados Kugar (KugarData)</title> +<para +>O elemento <sgmltag class="element" +>KugarData</sgmltag +> contém zero ou mais elementos <sgmltag class="element" +>Row</sgmltag +>. Um elemento <sgmltag class="element" +>Row</sgmltag +> deverá conter um atributo <sgmltag class="attribute" +>level</sgmltag +> com o valor correspondente ao nível de detalhe do modelo. Os outros atributos representam as colunas de dados. </para> +<para +><anchor id="template-att"/>O valor do atributo <sgmltag class="attribute" +>Template</sgmltag +> é o &URL; do modelo de relatório usado para formatar os dados. </para> +<!-- +<variablelist> +<varlistentry id="template-att"> +<term +><sgmltag class="attribute" +>Template</sgmltag +></term> +<listitem> +<para> +This is an attribute of the <sgmltag class="element" +>KugarData</sgmltag> +element. The value of the attribute is the &URL; of the report template +used to format the data. +</para> +</listitem> +</varlistentry> +--> +</sect2> + +<sect2 id="row-element"> +<title +>Elemento linha (Row)</title> + +<variablelist> + +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> + +<varlistentry> +<term +><anchor id="level-att"/><sgmltag class="attribute" +>level</sgmltag +></term> +<listitem> +<para +>O valor do atributo indica qual o detalhe no modelo de relatório que é usado para mostrar os dados. As linhas poderão conter vários conjuntos de colunas para vários níveis, como tal, qualquer atributo excepto o <sgmltag class="attribute" +>level</sgmltag +> deverá ser indicado como #IMPLIED (implícito). </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="column-att"/><sgmltag class="attribute" +>column</sgmltag +></term> +<listitem> +<para +>O nome do atributo é o nome da coluna, o qual usa o formato que é indicado na definição do <sgmltag class="element" +>KugarData</sgmltag +>. O nome do atributo é usado no modelo do relatório para associar os dados aos campos do relatório. </para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +</sect1> + diff --git a/koffice-i18n-pt/docs/koffice/kugar/designer.docbook b/koffice-i18n-pt/docs/koffice/kugar/designer.docbook new file mode 100644 index 00000000..0dbaf544 --- /dev/null +++ b/koffice-i18n-pt/docs/koffice/kugar/designer.docbook @@ -0,0 +1,679 @@ +<!-- If you want to validate or edit this document separately, uncomment +this prolog + +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> + +--> +<chapter id="designer-manual"> +<chapterinfo> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Pedro</firstname +><surname +>Morais</surname +><affiliation +><address +><email +>[email protected]</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Manual do Desenhador de Modelos de Relatórios</title> + +<para +>O &kudesigner; permite a criação e modificação interactiva das modificações nos modelos de relatórios, assim como a colocação das secções e dos itens dos relatórios num dado relatório.</para> + +<para +>O &kudesigner; é uma aplicação <acronym +>WYSIWYG</acronym +>. O <guilabel +>Tamanho da página do relatório</guilabel +> define as dimensões do relatório no ecrã. No momento presente, a escala é igual a 100% automaticamente e não poderá ser alterada.</para> + +<itemizedlist> +<title +>Todos os modelos de relatórios poderão conter as seguintes secções:</title> +<listitem +><para +>Cabeçalho do Relatório</para +></listitem> +<listitem +><para +>Cabeçalho da Página</para +></listitem> +<listitem +><para +>Cabeçalho do Detalhe</para +></listitem> +<listitem +><para +>Detalhe</para +></listitem> +<listitem +><para +>Rodapé do Detalhe</para +></listitem> +<listitem +><para +>Rodapé da Página</para +></listitem> +<listitem +><para +>Rodapé do Relatório</para +></listitem> +</itemizedlist> + +<itemizedlist> +<title +>As secções dos relatórios podem conter os seguintes itens de relatório:</title> +<listitem +><para +>Legenda</para +></listitem> +<listitem +><para +>Campo</para +></listitem> +<listitem +><para +>Campo Calculado</para +></listitem> +<listitem +><para +>Campo Especial</para +></listitem> +<listitem +><para +>Linha</para +></listitem> +</itemizedlist> + +<para +>As secções e os itens do relatório poderão ser colocados no modelo do relatório, usando para tal os menus ou barras de ferramentas.</para> + +<para +>Todos os elementos, como o modelo do relatório, a secção do relatório ou um item, têm as suas próprias propriedades. Estas propriedades definem os parâmetros geométricos, textuais ou outros diversos. De cada vez que o elemento é colocado, é aplicado um conjunto de propriedades por omissão. Por exemplo, quando é colocado o elemento <guilabel +>Legenda</guilabel +>, o valor da sua propriedade Text é configurado como <quote +>Text</quote +>.</para> + +<para +>Para mudar as propriedades, use a janela das <guilabel +>Opções do Item do Relatório</guilabel +>. Esta janela poderá ser chamada ao carregar com o &RMB; num item ou com o botão para <guilabel +>Editar as Propriedades</guilabel +> da <guilabel +>Barra de Edição</guilabel +>. Veja a imagem em baixo (as propriedades de um item Campo): </para> + +<para +>Para remover um item, carregue com o &MMB; nele ou use o botão <guilabel +>Remover</guilabel +> da <guilabel +>Barra de Edição</guilabel +>. </para> + +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="props.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Janela <guilabel +>Novo Relatório</guilabel +></phrase> +</textobject> +</mediaobject> +</screenshot> + +<variablelist> +<title +>Referência do menu do &kudesigner;</title> +<varlistentry> +<term +><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl; <keycap +>N</keycap +></keycombo +> </shortcut +> <guimenu +>Ficheiro</guimenu +> <guimenuitem +>Novo</guimenuitem +> </menuchoice +></term> +<listitem> +<para +><action +>Mostra</action +> a janela de <guilabel +>Novo Relatório</guilabel +> para criar um novo modelo de relatório.</para> +<para +>Tal como foi visto na imagem, o tamanho da página do relatório, a orientação e as margens precisam ser configurados antes de o relatório poder ser criado. </para> +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="file_new.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Janela de <interface +>Novo Relatório</interface +></phrase> +</textobject> +</mediaobject> +</screenshot> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>O</keycap +> </keycombo +></shortcut +> <guimenu +>Ficheiro</guimenu +> <guimenuitem +>Abrir...</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Abre</action +> um modelo de relatório gravado anteriormente.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Ficheiro</guimenu +> <guimenuitem +>Abrir um Recente</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Mostra</action +> uma lista com os modelos abertos recentemente. Seleccione um ficheiro para o abrir.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>S</keycap +> </keycombo +></shortcut +> <guimenu +>Ficheiro</guimenu +> <guimenuitem +>Gravar</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Grava</action +> o modelo actual do relatório num ficheiro de texto no formato &XML;.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Ficheiro</guimenu +> <guimenuitem +>Gravar Como...</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Grava</action +> o modelo de relatório actual num ficheiro e atribui-lhe outro nome.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>W</keycap +> </keycombo +></shortcut +> <guimenu +>Ficheiro</guimenu +> <guimenuitem +>Fechar</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Fecha</action +> o modelo de relatório actual.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>P</keycap +> </keycombo +></shortcut +> <guimenu +>Ficheiro</guimenu +> <guimenuitem +>Imprimir</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Imprime...</action +> o modelo de relatório actual como texto no formato &XML;.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>Q</keycap +> </keycombo +></shortcut +> <guimenu +>Ficheiro</guimenu +> <guimenuitem +>Sair</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Sai</action +> do programa.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Editar</guimenu +> <guimenuitem +>Limpar a Selecção</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Cancela</action +> qualquer acção de edição, de modo que nenhuma propriedade será editada nem nenhum item removido.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Editar</guimenu +> <guimenuitem +>Editar as Propriedades</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Edita</action +> as propriedades do item seleccionado.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Editar</guimenu +> <guimenuitem +>Apagar</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Remove</action +> o item seleccionado.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Secções</guimenu +> <guimenuitem +>Cabeçalho do Relatório</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca a secção do Cabeçalho do Relatório</action +> no modelo de relatório.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Secções</guimenu +> <guimenuitem +>Cabeçalho da Página</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca a secção do Cabeçalho da Página</action +> no modelo de relatório.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Secções</guimenu +> <guimenuitem +>Cabeçalho do Detalhe</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca a secção do Cabeçalho do Detalhe</action +> no modelo de relatório.</para> +<para +>Antes de colocar a secção, a janela para <guilabel +>Adicionar o Cabeçalho do Detalhe</guilabel +> será mostrada para indicar o nível de detalhe. O cabeçalho de Detalhe será adicionado à secção de detalhe no nível indicado.</para> +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="add_detail_header.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Janela para <guilabel +>Adicionar o Cabeçalho do Detalhe</guilabel +></phrase> +</textobject> +</mediaobject> +</screenshot> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Secções</guimenu +> <guimenuitem +>Detalhe</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca a secção de Detalhe</action +> no modelo de relatório.</para> +<para +>Antes de colocar a secção, a janela para <guilabel +>Adicionar Detalhe</guilabel +> será mostrada para indicar o nível de detalhe.</para> +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="add_detail.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Janela <interface +>Adicionar Detalhe</interface +></phrase> +</textobject> +</mediaobject> +</screenshot> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Secções</guimenu +> <guimenuitem +>Rodapé do Detalhe</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca a secção de Rodapé do Detalhe</action +> no modelo de relatório.</para> +<para +>Antes de colocar a secção, a janela para <guilabel +>Adicionar o Rodapé do Detalhe</guilabel +> será mostrada para indicar o nível de detalhe. O rodapé do detalhe será adicionado à secção de detalhe do nível indicado.</para> +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="add_detail_footer.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Janela para <guilabel +>Adicionar Rodapé do Detalhe</guilabel +></phrase> +</textobject> +</mediaobject> +</screenshot> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Secções</guimenu +> <guimenuitem +>Rodapé da Página</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca a secção do Rodapé da Página</action +> no modelo de relatório.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Secções</guimenu +> <guimenuitem +>Rodapé do Relatório</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca a secção do Rodapé do Relatório</action +> no modelo de relatório.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Itens</guimenu +> <guimenuitem +>Limpar a Selecção</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Limpa</action +> a selecção de itens, de modo a que não seja adicionado nenhum item do relatório à secção.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Itens</guimenu +> <guimenuitem +>Legenda</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca o elemento Legenda</action +> na secção.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Itens</guimenu +> <guimenuitem +>Campo</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca o elemento Campo</action +> na secção.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Itens</guimenu +> <guimenuitem +>Campo Calculado</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca o elemento Campo Calculado</action +> na secção.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Itens</guimenu +> <guimenuitem +>Campo Especial</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca o elemento Campo Especial</action +> na secção.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Itens</guimenu +> <guimenuitem +>Linha</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca o elemento Linha</action +> na secção.</para +></listitem> +</varlistentry> + +</variablelist> +</chapter> diff --git a/koffice-i18n-pt/docs/koffice/kugar/index.docbook b/koffice-i18n-pt/docs/koffice/kugar/index.docbook new file mode 100644 index 00000000..065781f5 --- /dev/null +++ b/koffice-i18n-pt/docs/koffice/kugar/index.docbook @@ -0,0 +1,197 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY kudesigner "Kugar Report Designer"> + <!ENTITY kugar "Kugar"> + <!ENTITY kappname "&kugar;"> + <!ENTITY package "koffice"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % Portuguese "INCLUDE"> + <!ENTITY template SYSTEM "template.docbook"> + <!ENTITY templatedtd SYSTEM "templatedtd.docbook"> + <!ENTITY templateelements SYSTEM "template-elements.docbook"> + <!ENTITY datadtd SYSTEM "datadtd.docbook"> + <!ENTITY dataelements SYSTEM "dataref.docbook"> + <!ENTITY progguide SYSTEM "progguide.docbook"> + <!ENTITY starting SYSTEM "starting.docbook"> + <!ENTITY designermanual SYSTEM "designer.docbook"> + <!ENTITY tutorial SYSTEM "tutorial.docbook"> +]> + +<book lang="&language;"> + +<bookinfo> +<title +>O Manual do &kugar;</title> + +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Pedro</firstname +><surname +>Morais</surname +><affiliation +><address +><email +>[email protected]</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +<copyright> +<year +>2000</year> +<year +>2001</year> +<holder +>Phil Thompson</holder> +</copyright> +<copyright> +<year +>2002</year> +<holder +>Alexander Dymo</holder> +</copyright> +<!--&underFDL;--> +<legalnotice +>&FDLNotice;</legalnotice> + +<date +>2002-06-11</date> +<releaseinfo +>1.02.00</releaseinfo> + +<!-- Abstract about this handbook --> + +<abstract> +<para +>O &kugar; é um motor de relatórios &XML; baseado em modelos. O &kudesigner; é uma flexível interface gráfica de construção de modelos de relatórios para o motor de relatórios &kugar;. </para> +</abstract> + +<keywordset> +<keyword +>KDE</keyword> +<keyword +>kdeutils</keyword> +<keyword +>kugar</keyword> +<keyword +>kudesigner</keyword> +<keyword +>relatório</keyword> +<keyword +>gerador</keyword> +<keyword +>motor</keyword> +<keyword +>desenho</keyword> +</keywordset> + +</bookinfo> + +<chapter id="introduction"> +<title +>Introdução</title> + +<para +>O &kugar; é uma ferramenta de criação de relatórios para o &Qt; e &kde;. Inclui um desenhador em &GUI; de modelos de relatórios, motor de relatórios, componente para o &konqueror; para fácil visualização dos relatórios e um conjunto de exemplos.</para> + +<para +>O &kudesigner; é um ferramenta de criação de modelos de relatórios para o motor de relatórios &kugar;. O motor de relatórios utiliza um ficheiro de modelo de relatório baseado em &XML; (que pode ser criado manualmente ou utilizando o &kudesigner;) e ficheiro de dados (também em formato &XML;) para criar relatórios. Para obter mais informações acerca do &kudesigner;, consulte o <link linkend="designer-manual" +>Manual do Desenhador de Modelos de Relatório</link +>. </para> + +<para +>Veja a <link linkend="template-dtd" +>Definição do Tipo de Documento KugarTemplate</link +> para um resume do <acronym +>DTD</acronym +> (formato de ficheiro) dos modelos, <link linkend="kugardata-dtd" +>Definição do Tipo de Documento KugarData</link +> e o <link linkend="tutorial" +>Tutorial</link +> para uma explicação passo-a-passo de como criar relatórios. </para> + +<para +>Os programadores também devem consultar o <link linkend="prog-guide" +>Guia de programação</link +> para saber como utilizar o &kugar; nas suas aplicações.</para> +</chapter> + +&tutorial; + +&starting; + +&designermanual; + +&progguide; + +<chapter> +<title +>Créditos e Licença</title> + +<para +>&kugar; </para> + +<para +>Copyright 2000 Mutiny Bay Software </para> +<para +>Copyright 2000, 2001, Phil Thompson </para> +<para +>Copyright 2002 Alexander Dymo </para> + +<para +>Partes da documentação Copyright 2000, 2001 Phil Thompson e Copyright 2002 Alexander Dymo</para> + +<para +>Tradução de Pedro Morais <email +>[email protected]</email +></para +> +&underFDL; &underGPL; </chapter> + +<appendix id="document-structure"> +<title +>Estrutura do Documento</title> +&templatedtd; +&template; +&templateelements; +&datadtd; +&dataelements; +</appendix> + +<appendix id="installation"> +<title +>Instalação</title> + +&install.intro.documentation; +&install.compile.documentation; +</appendix> + +</book> diff --git a/koffice-i18n-pt/docs/koffice/kugar/progguide.docbook b/koffice-i18n-pt/docs/koffice/kugar/progguide.docbook new file mode 100644 index 00000000..4734b914 --- /dev/null +++ b/koffice-i18n-pt/docs/koffice/kugar/progguide.docbook @@ -0,0 +1,669 @@ +<!-- If you want to validate or edit this document separately, uncomment +this prolog + +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> + +--> + +<chapter id="prog-guide"> +<chapterinfo> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Pedro</firstname +><surname +>Morais</surname +><affiliation +><address +><email +>[email protected]</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Guia do Programador</title> + +<sect1 id="how-to-use-in-progs"> +<title +>Como usar o &kugar; para criar relatórios nos seus próprios programas</title> + +<itemizedlist> +<title +>Há várias maneiras de utilizar o &kugar;</title> +<listitem> +<para +>Crie um ficheiro temporário e preencha-o com dados, organizados de acordo com a <link linkend="kugardata-dtd" +>Definição do Tipo de Documento KugarData</link +>. De seguida, invoque o comando <command +>kugar</command +> ( <cmdsynopsis +> <command +>kugar</command +> <group +> <option +>-d <replaceable +>ficheiro de dados do Kugar</replaceable +></option +> </group +> <group +> <option +>-r <replaceable +>ficheiro de modelo do Kugar</replaceable +></option +> </group +> </cmdsynopsis +> ) para antever e imprimir o relatório. Veja a secção <link linkend="prog-using-for-preview" +>Usar o &kugar; para antever os relatórios</link +> para uma descrição detalhada. </para> +</listitem> +<listitem> +<para +>Use o &kugar; directamente no código da aplicação. Veja a secção <link linkend="prog-using-widget" +>Usar as classes do &kugar; para a geração de relatórios</link +> para uma descrição detalhada. </para> +</listitem> +<listitem> +<para +>Crie um 'plugin' no &Qt; designer, use-o para criar a &GUI; da aplicação no desenhador e compile dinamicamente com o programa. Veja a secção <link linkend="prog-designer-plugin" +>Criar um 'plugin' do &Qt; designer</link +> para uma descrição detalhada. </para> +</listitem> +</itemizedlist> + +<para +>As duas últimas formas são aceitáveis para os programadores de &Qt; e do &kde;, mas o &kugar; está desenhado para ser um gerador de relatórios independente da linguagem de programação e/ou <acronym +>IDE</acronym +>. Ele usa o formato &XML; para descrever os modelos de relatórios e os ficheiros de dados. Como tal, qualquer programa consegue produzir resultados no formato do ficheiro de dados do &kugar; tal como está descrito na <link linkend="kugardata-dtd" +><acronym +>DTD</acronym +> do KugarData</link +> ou mesmo no formato de ficheiro do modelo de relatório (veja a <link linkend="template-dtd" +><acronym +>DTD</acronym +> do KugarTemplate</link +>). Poderá ser usado um comando do &kugar; (visualizador de relatórios) para antever e imprimir os resultados gerados. </para> + +</sect1> + +<sect1 id="prog-using-for-preview"> +<title +>Utilizar o &kugar; para antever relatórios</title> + +<orderedlist> +<title +>A forma de criar e antever (imprimir) um relatório é:</title> +<listitem> +<para +>Criar um ficheiro de modelo de relatório com o &kudesigner; </para> +</listitem> +<listitem> +<para +>Criar um ficheiro de dados com os valores das colunas para as áreas de detalhe do relatório. Use a <link linkend="kugardata-dtd" +><acronym +>DTD</acronym +> do KugarData</link +> para produzir ficheiros de dados correctos. </para> +</listitem> +<listitem> +<para +>Execute a linha de comandos do &kugar; para antever e imprimir um relatório. Por exemplo, para o fazer, invoque nas linguagens C e C++:</para> + +<programlisting +><function +>system(<option +>"kugar -r <replaceable +>ficheiro_modelo.ktf</replaceable +>-d <replaceable +>ficheiro_dados.kdf</replaceable +>"</option +>)</function +>. +</programlisting> + +<para +>Não se esqueça de incluir <filename class="headerfile" +>stdlib.h</filename +>. </para> +</listitem> +</orderedlist> +</sect1> + +<sect1 id="prog-using-widget"> +<title +>Utilizar as classes do &kugar; para relatórios</title> +<para +>A biblioteca &kugar; contém dois elementos para utilizar. </para> +<para +>A classe <classname +>KReportViewer</classname +> está desenhada para os programadores do &kde;. Suporta um sistema de impressão do &kde; e a localização no &UNIX; através das chamadas <function +>i18n()</function +>. </para> +<para +>O <classname +>MReportViewer</classname +> está desenhado para os programadores do &Qt; e possibilita o suporte multi-plataforma real. Pode ser usado não só nas plataformas &UNIX;, mas também no &Windows; e no &MacOS;. </para> +<para +>Para compilar um programa que usa a biblioteca do &kugar;, deverá ser associado à biblioteca dinâmica <filename +>libkugar.so</filename +>, a qual é oferecida com a distribuição do &kugar; em todas as plataformas &UNIX;. </para> +<para +>Os ficheiros a incluir são <filename +>kugarqt.h</filename +> e <filename +>kugar.h</filename +> para programas &Qt; e &kde;, respectivamente. </para> +<para +>Para um exemplo detalhado de como as classes do &kugar; podem ser usadas, veja a pasta <filename class="directory" +>/shell</filename +> no código-fonte do &kugar;. </para> +<para +>A <classname +>MReportViewer</classname +> (e a <classname +>KReportViewer</classname +> too) contêm vários métodos públicos que podem ser usados. </para> +<funcsynopsis> +<funcprototype> +<funcdef +>void <function +>renderReport</function +></funcdef> +<void/> +</funcprototype> +<funcsynopsisinfo +>Mostra o relatório num ecrã.</funcsynopsisinfo> +</funcsynopsis> + +<funcsynopsis> +<funcprototype> +<funcdef +>void <function +>printReport</function +></funcdef> +<void/> +</funcprototype> +<funcsynopsisinfo +>Chama a janela de impressão para imprimir o relatório.</funcsynopsisinfo> +</funcsynopsis> + +<funcsynopsis> +<funcprototype> +<funcdef +>void <function +>clearReport</function +></funcdef> +<void/> +</funcprototype> +<funcsynopsisinfo +>Limpa o relatório no ecrã e liberta os dados do mesmo. Invoque isto antes de abrir o relatório novo.</funcsynopsisinfo> +</funcsynopsis> + +<funcsynopsis> +<funcprototype +><funcdef +>bool <function +>setReportData</function +></funcdef +> <paramdef +>const QString &<parameter +>nome_ficheiro_dados</parameter +></paramdef +> </funcprototype> +<funcsynopsisinfo +>Configura os dados do relatório a partir do ficheiro <replaceable +>nome_ficheiro_dados</replaceable +>.</funcsynopsisinfo> +</funcsynopsis> + +<funcsynopsis> +<funcprototype +><funcdef +>bool <function +>setReportData</function +></funcdef +> <paramdef +>const QIODevice &<parameter +>dispositivo_io_dados</parameter +></paramdef +> </funcprototype> +<funcsynopsisinfo +>Configura os dados do relatório a partir do <replaceable +>dispositivo_io_dados</replaceable +>. O dispositivo de E/S poderá ser qualquer filha da classe <classname +>QIODevice</classname +>. Por exemplo, para obter o modelo do relatório a partir de um armazenamento em rede ou de uma base de dados, crie uma filha da classe QIODevice e redefina toda a funcionalidade necessária. </funcsynopsisinfo> +</funcsynopsis> + +<funcsynopsis> +<funcprototype +><funcdef +>bool <function +>setReportTemplate</function +></funcdef +> <paramdef +>const QString &<parameter +>nome_ficheiro_modelo</parameter +></paramdef +> </funcprototype> +<funcsynopsisinfo +>Configura o modelo do relatório a partir do ficheiro <replaceable +>nome_ficheiro_modelo</replaceable +>.</funcsynopsisinfo> +</funcsynopsis> + +<funcsynopsis> +<funcprototype +><funcdef +>bool <function +>setReportTemplate</function +></funcdef +> <paramdef +>const QIODevice &<parameter +>dispositivo_io_modelo</parameter +></paramdef +> </funcprototype> +<funcsynopsisinfo +>Configura o modelo de relatório a partir do <replaceable +>dispositivo_io_modelo</replaceable +>. O dispositivo de E/S poderá ser qualquer filha da classe <classname +>QIODevice</classname +>. Por exemplo, para obter o modelo do relatório a partir de um armazenamento em rede ou de uma base de dados, crie uma filha da classe QIODevice e redefina toda a funcionalidade necessária. </funcsynopsisinfo> +</funcsynopsis> + +</sect1> + +<sect1 id="prog-designer-plugin"> +<title +>Criar o 'plugin' para o &Qt; designer</title> + +<para +>Este é o código de exemplo de como é criado um 'plugin' do 'designer'. O código em baixo cria um 'plugin' para um item <classname +>KReportViewer</classname +> do &kde;. </para> + +<para +>Se pretender um item do &Qt;, substitua o <classname +>KReportViewer</classname +> pelo <classname +>MReportViewer</classname +> e o <filename +>kugar.h</filename +> pelo <filename +>kugarqt.h</filename +> no código do 'plugin'. </para> + +<sect2 id="plugin-usage"> +<title +>Utilização do 'plugin'</title> +<para +>O 'plugin' do desenhador permitirá o uso do &Qt; Designer para colocar um item <classname +>KReportViewer</classname +> numa janela e antevê-la correctamente. </para> + +<para +>Os programas que tirem partido deste 'plugin' precisam ser compilados dinamicamente com ele. A biblioteca correspondente chama-se <filename +>libkugar_plugin.so</filename +>. Os itens ou janelas que incluam o item <classname +>KReportViewer</classname +> deverão incluir o <kugar.h> na implementação e terem uma declaração antecipada <classname +>class KReportViewer</classname +>. As inclusões poderão ser feitas com o Explorador de Objectos do &Qt; Designer (página de Código). </para> + +<para +>Para compilar o 'plugin' execute: <cmdsynopsis +><command +>qmake</command +> <arg +>kugar_plugin.pro</arg +> </cmdsynopsis> +<cmdsynopsis> +<command +>make</command> +</cmdsynopsis> +</para> + +</sect2> + +<sect2 id="plugin-code"> +<title +>Código do 'plugin'</title> + +<segmentedlist> +<title +>O código do 'plugin' consiste de três ficheiros:</title> +<segtitle +><link linkend="plugin-h-source" +>kugar_plugin.h</link +></segtitle> +<segtitle +><link linkend="plugin-cpp-source" +>kugar_plugin.cpp</link +></segtitle> +<segtitle +><link linkend="plugin-pro-source" +>kugar_plugin.pro</link +></segtitle> +<seglistitem> +<seg +>Um cabeçalho para o <classname +>KugarWidgetPlugin</classname +>, o sucessor de <classname +>QWidgetPlugin</classname +>;</seg> +<seg +>Um ficheiro de código para o <classname +>KugarWidgetPlugin</classname +>, o sucessor de <classname +>QWidgetPlugin</classname +>;</seg> +<seg +>Ficheiro de projecto para o utilitário <application +>QMake</application +>.</seg> +</seglistitem> +</segmentedlist> + +<sect3 id="plugin-h-source"> +<title +>kugar_plugin.h</title> + +<programlisting +>#include <qwidgetplugin.h> + +class KugarWidgetPlugin:public QWidgetPlugin +{ +public: + KugarWidgetPlugin (); + + QStringList keys () const; + QWidget *create (const QString & classname, QWidget * parent = + 0, const char *name = 0); + QString group (const QString &) const; + QIconSet iconSet (const QString &) const; + QString includeFile (const QString &) const; + QString toolTip (const QString &) const; + QString whatsThis (const QString &) const; + bool isContainer (const QString &) const; +}; +</programlisting> +</sect3> + + +<sect3 id="plugin-cpp-source"> +<title +>kugar_plugin.cpp</title> + +<programlisting +>#include "kugar_plugin.h" +#include <kugar.h> + +static const char *kugar_pixmap[] = { + "22 22 127 2", + ".d c #000000", + ".c c #131313", + ".b c #282828", + ".a c #434241", + ".e c #4e463a", + ".# c #595551", + ".G c #66553b", + "#F c #68635f", + "#R c #6b4f23", + "#q c #6e6862", + "#M c #6f5229", + ".n c #6f6146", + ".w c #735310", + ".V c #755c2a", + ".I c #775f34", + ".0 c #77694a", + "#n c #7e6434", + ".o c #806f50", + "#C c #835d2d", + ".P c #837c75", + "#B c #85653a", + "#k c #85827e", + ".x c #866d46", + ".U c #877967", + ".X c #888888", + ".F c #89724d", + "#x c #8b6d2a", + ".S c #8d7759", + ".z c #8e733b", + "#L c #906e49", + "#Q c #947b56", + ".r c #948058", + ".J c #957844", + ".4 c #987736", + ".q c #998969", + ".k c #999897", + ".R c #9a8a75", + "#i c #9f8348", + "#I c #a37c4b", + ".u c #a38d66", + ".E c #a58558", + "#A c #a8834b", + ".s c #a9967a", + ".t c #aa9467", + ".C c #ae9f8d", + "#6 c #afa49d", + "#5 c #afa9a4", + "#W c #b18e4d", + ".K c #b1935a", + ".B c #b39660", + "#V c #b49866", + "#a c #b49d6c", + "## c #b49d72", + ".j c #b5b4b4", + "#0 c #b7a597", + ".O c #b9b1a9", + ".L c #bb9c61", + ".M c #bb9e6b", + ".A c #bca778", + "#j c #bea46b", + ".T c #bfb37d", + ".v c #c0b391", + ".W c #c3a262", + ".i c #c4c4c4", + "#m c #c5b7aa", + "#8 c #c69f80", + ".D c #c6b79b", + "#3 c #c7a589", + ".7 c #c7a76c", + "#u c #c7bbaf", + ".6 c #c8ad74", + "#7 c #c8b7a9", + "#r c #c8beb5", + ".m c #c8c8c8", + "#U c #cbad96", + "#f c #ccb681", + "#h c #cdac6c", + "#P c #cdb49f", + "#X c #cdb8a6", + "#H c #ceb7a4", + ".y c #ceb892", + ".N c #cecac3", + "#Z c #cfb16f", + "#O c #cfbdad", + ".Z c #cfc7c0", + "#w c #d0bcab", + ".5 c #d1ad6b", + "#s c #d1bfb1", + ".h c #d5d5d5", + "#l c #d6cdc6", + "#D c #d8b36e", + ".H c #dac592", + "#t c #dbb977", + ".g c #dcdcdc", + ".1 c #e0dcc1", + ".f c #e0e0df", + "#1 c #e3c8b1", + "#S c #e4cdb9", + ".3 c #e4d9a3", + "#4 c #e6c1a1", + "#2 c #e7c4a5", + "#K c #e9c179", + "#g c #e9c47e", + "#Y c #e9c8ac", + ".2 c #eae6c0", + "#T c #ebcdb3", + ".Q c #ebd4b9", + "#E c #ecca87", + "#z c #ecd799", + ".l c #ececeb", + "#G c #efd7c2", + "#e c #efe3ab", + ".8 c #efe8e3", + "#v c #f1dcca", + "#. c #f2e2d4", + ".p c #f4f4f4", + "#y c #f5daa0", + "#J c #f6cf7f", + ".9 c #f7ede4", + "#p c #f9d995", + ".Y c #fcf9f6", + "#d c #fefcc5", + "#c c #fefdda", + "#b c #fefee1", + "#N c #ffd685", + "#o c #fff0a9", + "Qt c #ffffff", + "QtQtQtQtQtQt.#.a.a.a.b.b.b.c.c.d.d.dQtQtQtQt", + "QtQtQtQtQtQt.e.f.g.g.f.g.g.h.i.j.d.k.dQtQtQt", + "QtQtQtQtQtQt.a.gQtQtQtQtQtQt.l.f.c.m.k.dQtQt", + "QtQtQtQtQt.n.n.n.n.n.o.g.pQtQt.l.bQt.m.k.dQt", + "QtQtQt.q.q.r.q.s.t.r.q.u.u.g.pQt.a.fQt.m.k.d", + "QtQt.s.s.v.w.x.y.y.t.z.A.t.B.i.p.#.a.b.c.d.d", + "Qt.C.C.D.E.F.G.A.H.F.I.J.K.L.M.i.p.l.N.O.P.d", + "Qt.s.v.Q.q.R.S.T.A.R.U.V.L.W.W.X.g.Y.f.Z.k.d", + ".0.s.t.Q.1.U.R.2.3.S.U.4.5.6.6.7.j.8.9#..O.d", + ".G##.V#a#b.1#c#c#d#e#f#g#h#i#j.W#k#l.9#.#m.d", + ".G.4.F#n#c#c#c#d#d#o#p#g.x.w#i.L#q#r#.#.#s.d", + ".e.J.J.I.3#d.H#j.6#f#p#t#n.w.E.L#q#u#.#v#w.d", + ".G.A#x.z#y#z#A#B#B#C#D#E.4.4.6#h#F#m#v#G#H.d", + ".o.s.A#j#E#t#I#I#I#C#A#J#p#p#K#t#F#m#v#G#H.d", + "Qt##.A.6.7#I#I#A.E#L#M.W#N#J#K.a.U#O#G.Q#P.d", + "Qt#a.M.L.J#A#I.4.E#Q.x#R#D#J#g.#.C#S.Q#T#U.d", + "QtQt#V.K.z#Q.s.S.x.S#B#M#W#E.a.U#X.Q#T#Y#U.d", + "QtQtQt.M#i#B.r#Q#Q.r#Q.z#Z.a#q#0#1#T#Y#2#3.d", + "QtQtQtQtQt#j.L.L.W.5#t.a.#.U#0#1#T#Y#2#4#3.d", + "QtQtQtQtQtQt.d#F#q#q#q.P.C#O#S.Q#T#Y#2#4#3.d", + "QtQtQtQtQtQt.d#5#5#6#6#0#7#w#H#P#U#U#3#3#8.d", + "QtQtQtQtQtQt.d.d.d.d.d.d.d.d.d.d.d.d.d.d.d.d" +}; + +KugarWidgetPlugin::KugarWidgetPlugin () +{ +} + +QStringList KugarWidgetPlugin::keys () const +{ + QStringList list; + list << "KReportViewer"; + return list; +} + +QWidget* KugarWidgetPlugin::create (const QString & key, QWidget * parent, + const char *name) +{ + if (key == "KReportViewer") + return new KReportViewer (parent, name); + return 0; +} + +QString KugarWidgetPlugin::group (const QString & feature) const +{ + if (feature == "KReportViewer") + return "Display"; + return QString::null; +} + +QIconSet KugarWidgetPlugin::iconSet (const QString &) const +{ + return QIconSet (QPixmap (kugar_pixmap)); +} + +QString KugarWidgetPlugin::includeFile (const QString & feature) const +{ + if (feature == "KReportViewer") + return "kugar.h"; + return QString::null; +} + +QString KugarWidgetPlugin::toolTip (const QString & feature) const +{ + if (feature == "KReportViewer") + return "Kugar report viewer widget"; + return QString::null; +} + +QString KugarWidgetPlugin::whatsThis (const QString & feature) const +{ + if (feature == "KReportViewer") + return "A widget to view xml reports"; + return QString::null; +} + +bool KugarWidgetPlugin::isContainer (const QString &) const +{ + return FALSE; +} + +Q_EXPORT_PLUGIN( KugarWidgetPlugin ) +</programlisting> +</sect3> + +<sect3 id="plugin-pro-source"> +<title +>kugar_plugin.pro</title> + +<programlisting +>SOURCES += kugar_plugin.cpp +HEADERS += kugar_plugin.h + +DESTDIR = $(QTDIR)/plugins/designer +TARGET = kugar_plugin + +target.path=$$plugins.path +isEmpty(target.path):target.path=$$QT_PREFIX/plugins +PROJECTNAME = KugarPlugin +TEMPLATE = lib +CONFIG += qt warn_on release plugin +unix:LIBS += -lkugar +LANGUAGE = C++ +</programlisting> +</sect3> + +</sect2> + +</sect1> +</chapter> diff --git a/koffice-i18n-pt/docs/koffice/kugar/starting.docbook b/koffice-i18n-pt/docs/koffice/kugar/starting.docbook new file mode 100644 index 00000000..8ed087f3 --- /dev/null +++ b/koffice-i18n-pt/docs/koffice/kugar/starting.docbook @@ -0,0 +1,100 @@ +<!-- If you want to validate or edit this document separately, uncomment +this prolog + +<?xml version="1.0" ?> +<!DOCTYPE appendix PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> + +--> +<chapter id="starting"> +<chapterinfo> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Pedro</firstname +><surname +>Morais</surname +><affiliation +><address +><email +>[email protected]</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Iniciar o &kugar; e o &kudesigner;</title> +<para +>O programa &kugar; recebe dois argumento de linha de comando: </para> + +<cmdsynopsis +><command +>kugar</command +> <group +> <option +>-d <replaceable +>Ficheiro de dados Kugar</replaceable +></option +> </group +> <group +> <option +>-r <replaceable +>Ficheiro de modelo Kugar</replaceable +></option +> </group +> </cmdsynopsis> + +<para +>Por exemplo, <userinput +><command +>kugar</command +> <option +>-d</option +> <parameter +>exemplo1.kdf</parameter +> <option +>-r</option +> <parameter +>exemplo1.ktf</parameter +></userinput +> </para> + +<para +>O programa &kudesigner; pode ser iniciado sem argumentos ou com um ficheiro de modelo de relatório como argumento: </para> +<cmdsynopsis +><command +>kudesigner</command +> <group +> <replaceable +>modelo.ktf</replaceable +> </group +> </cmdsynopsis> + +</chapter> diff --git a/koffice-i18n-pt/docs/koffice/kugar/template-elements.docbook b/koffice-i18n-pt/docs/koffice/kugar/template-elements.docbook new file mode 100644 index 00000000..1d208e9a --- /dev/null +++ b/koffice-i18n-pt/docs/koffice/kugar/template-elements.docbook @@ -0,0 +1,3577 @@ +<!-- If you want to edit or validate this document separately, uncomment --> +<!-- this prolog +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> +--> +<sect1 id="template-elements"> +<sect1info> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Pedro</firstname +><surname +>Morais</surname +><affiliation +><address +><email +>[email protected]</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +</sect1info> +<title +>Elemento de modelo <sgmltag class="element" +>KugarTemplate</sgmltag +></title> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Bandas da secção</entry> +<entry +>Elementos da secções</entry> +</row> +</thead> +<tbody> +<row> +<entry +><link linkend="report-header-and-footer" +><sgmltag class="element" +>ReportHeader</sgmltag +></link +></entry> +<entry +><link linkend="line-element" +><sgmltag class="element" +>Line</sgmltag +></link +></entry> +</row> +<row> +<entry +><link linkend="page-header-and-footer" +><sgmltag class="element" +>PageHeader</sgmltag +></link +></entry> +<entry +><link linkend="label-element" +><sgmltag class="element" +>Label</sgmltag +></link +></entry> +</row> +<row> +<entry +><link linkend="detail-header-and-footer" +><sgmltag class="element" +>DetailHeader</sgmltag +></link +></entry> +<entry +><link linkend="field-element" +><sgmltag class="element" +>Field</sgmltag +></link +></entry> +</row> +<row> +<entry +><link linkend="detail" +><sgmltag class="element" +>Detail</sgmltag +></link +></entry> +<entry +><link linkend="calculated-field-element" +><sgmltag class="element" +>CalculatedField</sgmltag +></link +></entry> +</row> +<row> +<entry +><link linkend="detail-header-and-footer" +><sgmltag class="element" +>DetailFooter</sgmltag +></link +></entry> +<entry +><link linkend="special-element" +><sgmltag class="element" +>Special</sgmltag +></link +></entry> +</row> +<row> +<entry +><link linkend="page-header-and-footer" +><sgmltag class="element" +>PageFooter</sgmltag +></link +></entry> +<entry +>Rodapé da Página</entry> +</row> +<row> +<entry +><link linkend="report-header-and-footer" +><sgmltag class="element" +>ReportFooter</sgmltag +></link +></entry> +<entry +>Rodapé do Relatório</entry> +</row> +</tbody> +</tgroup> +</informaltable> + + +<sect2 id="report-header-and-footer"> +<title +>Secções <sgmltag class="element" +>ReportHeader</sgmltag +> e <sgmltag class="element" +>ReportFooter</sgmltag +></title> + +<para +>Os elementos <sgmltag class="element" +>ReportHeader</sgmltag +> e <sgmltag class="element" +>ReportFooter</sgmltag +> definem secções do relatório que são normalmente impressas no início e no fim do relatório. </para> + +<synopsis +><!ELEMENT ReportHeader (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> +<!ATTLIST ReportHeader + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> +</synopsis> + +<synopsis +><!ELEMENT ReportFooter (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*, <link linkend="calculated-field-element" +>CalculatedField</link +>*)> +<!ATTLIST ReportFooter + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> +</synopsis> + +<variablelist> + +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="rhf-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Escolhe a altura da secção do relatório. Se não o deseja fazer, escolha o valor <sgmltag class="attvalue" +>0</sgmltag +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="rhf-printfrequency"/><sgmltag class="attribute" +>PrintFrequency</sgmltag +></term> +<listitem> +<para +>Escolhe a frequência de impressão da secção. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Frequência de Impressão</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Primeira Página</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Todas as Páginas</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Última Página</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="page-header-and-footer"> +<title +>Secções <sgmltag class="element" +>PageHeader</sgmltag +> e <sgmltag class="element" +>PageFooter</sgmltag +></title> + +<para +>Os elementos <sgmltag class="element" +>PageHeader</sgmltag +> e <sgmltag class="element" +>PageFooter</sgmltag +> definem secções de relatório que são normalmente impressas em todas as páginas do relatório. </para> + +<synopsis +><!ELEMENT PageHeader (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> +<!ATTLIST PageHeader + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> +</synopsis> + +<synopsis +><!ELEMENT PageFooter (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> +<!ATTLIST PageFooter + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> +</synopsis> + +<variablelist> + +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="phf-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Escolhe a altura da secção do relatório. Se não o deseja fazer, escolha o valor <sgmltag class="attvalue" +>0</sgmltag +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="phf-printfrequency"/><sgmltag class="attribute" +>PrintFrequency</sgmltag +></term> +<listitem> +<para +>Escolhe a frequência de impressão da secção. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Frequência de Impressão</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Primeira Página</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Todas as Páginas</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Última Página</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="detail-header-and-footer"> +<title +>Secções <sgmltag class="element" +>DetailHeader</sgmltag +> e <sgmltag class="element" +>DetailFooter</sgmltag +></title> + +<para +>Os elementos <sgmltag class="element" +>DetailHeader</sgmltag +> e <sgmltag class="element" +>DetailFooter</sgmltag +> definem secções do relatório que são impressas antes e depois dos detalhes de um determinado nível e abaixo no relatório. </para> + +<synopsis +><!ELEMENT DetailHeader (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> +<!ATTLIST DetailHeader + Height CDATA #REQUIRED + Level CDATA #REQUIRED> +</synopsis> + +<synopsis +><!ELEMENT DetailFooter (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> +<!ATTLIST DetailFooter + Height CDATA #REQUIRED + Level CDATA #REQUIRED> +</synopsis> + +<variablelist> + +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="dhf-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Escolhe a altura da secção do relatório. Se não o deseja fazer, escolha o valor <sgmltag class="attvalue" +>0</sgmltag +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="dhf-level"/><sgmltag class="attribute" +>Level</sgmltag +></term> +<listitem> +<para +>Escolhe o nível hierárquico da secção. As secções com níveis superior serão impressas antes das secções com níveis inferiores. O nível pode ser qualquer número a partir de 0. </para> + +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="detail"> +<title +>Secção <sgmltag class="element" +>Detail</sgmltag +></title> + +<para +>O elemento <sgmltag class="element" +>Detail</sgmltag +> define a secção do relatório que contém os dados. O relatório pode ter vários detalhes, que são acedidos através do atributo 'Level'. </para> + +<synopsis +><!ELEMENT Detail (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*, <link linkend="field-element" +>Field</link +>*)> +<!ATTLIST Detail + Height CDATA #REQUIRED + Level CDATA #REQUIRED> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="d-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Escolhe a altura da secção do relatório. Se não o deseja fazer, escolha o valor <sgmltag class="attvalue" +>0</sgmltag +>. </para> +</listitem> +</varlistentry> +<varlistentry> +<term +><anchor id="d-level"/><sgmltag class="attribute" +>Level</sgmltag +></term> +<listitem> +<para +>Escolhe o nível hierárquico da secção. As secções com níveis superior serão impressas antes das secções com níveis inferiores. O nível pode ser qualquer número a partir de 0. Isto é um atributo do elemento <sgmltag class="attribute" +>row</sgmltag +> no ficheiro de dados. </para> + +</listitem> +</varlistentry> + +</variablelist> +</listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="line-element"> +<title +><sgmltag class="element" +>Line</sgmltag +></title> + +<para +>O elemento <sgmltag class="element" +>Line</sgmltag +> define um objecto utilizado para desenhar linha num relatório. </para> + +<synopsis +><!ELEMENT Line EMPTY> +<!ATTLIST Line + X1 CDATA #REQUIRED + Y1 CDATA #REQUIRED + X2 CDATA #REQUIRED + Y2 CDATA #REQUIRED + Width CDATA #REQUIRED + Color CDATA #REQUIRED + Style CDATA #REQUIRED> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributos</term> +<listitem> +<variablelist> + +<varlistentry> +<term +><anchor id="l-x1"/><sgmltag class="attribute" +>X1</sgmltag +></term> +<listitem> +<para +>Escolhe a coordenada X inicial (relativa ao campo superior esquerda da secção) da linha. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-y1"/><sgmltag class="attribute" +>Y1</sgmltag +></term> +<listitem> +<para +>Escolhe a coordenada Y inicial (relativa ao campo superior esquerda da secção) da linha. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-x2"/><sgmltag class="attribute" +>X2</sgmltag +></term> +<listitem> +<para +>Escolhe a coordenada X final (relativa ao campo superior esquerda da secção) da linha. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-y2"/><sgmltag class="attribute" +>Y2</sgmltag +></term> +<listitem> +<para +>Escolhe a coordenada Y final (relativa ao campo superior esquerda da secção) da linha. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-width"/><sgmltag class="attribute" +>Width</sgmltag +></term> +<listitem> +<para +>Escolhe a largura da linha. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-color"/><sgmltag class="attribute" +>Color</sgmltag +></term> +<listitem> +<para +>Escolhe a cor da linha. Esta cor é definida como um valor RGB ('Red Green Blue', Vermelho, Verde, Azul) (r, g, b). r, g e b devem estar entre 0 e 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-style"/><sgmltag class="attribute" +>Style</sgmltag +></term> +<listitem> +<para +>Escolhe o estilo de desenho da linha. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Estilo de Linha</entry> +</row> +</thead> + +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Sem Caneta</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Sólido</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Traço</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Ponto</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Traço Ponto</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>Traço Ponto Ponto</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="label-element"> +<title +><sgmltag class="element" +>Label</sgmltag +></title> + +<para +>O elemento <sgmltag class="element" +>Label</sgmltag +> define um objecto que pode ser utilizado para colocar texto fixo no relatório. </para> + +<synopsis +><!ELEMENT Label EMPTY> + <!ATTLIST Label + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="la-text"/><sgmltag class="attribute" +>Text</sgmltag +></term> +<listitem> +<para +>Muda o texto da etiqueta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-x"/><sgmltag class="attribute" +>X</sgmltag +></term> +<listitem> +<para +>Escolhe a coordenada X inicial (relativa ao campo superior esquerda da secção) para posicionar a etiqueta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-y"/><sgmltag class="attribute" +>Y</sgmltag +></term> +<listitem> +<para +>Escolhe a coordenada Y inicial (relativa ao campo superior esquerda da secção) para posicionar a etiqueta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-width"/><sgmltag class="attribute" +>Width</sgmltag +></term> +<listitem> +<para +>Escolhe a largura da etiqueta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Escolhe a altura da etiqueta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-backgroundcolor"/><sgmltag class="attribute" +>BackgroundColor</sgmltag +></term> +<listitem> +<para +>Escolhe a cor de fundo da etiqueta. Esta cor é definida como um valor RGB ('Red Green Blue', Vermelho, Verde, Azul) (r, g, b). r, g e b devem estar entre 0 e 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-foregroundcolor"/><sgmltag class="attribute" +>ForegroundColor</sgmltag +></term> +<listitem> +<para +>Escolhe a cor principal da etiqueta. Esta cor é definida como um valor RGB ('Red Green Blue', Vermelho, Verde, Azul) (r, g, b). r, g e b devem estar entre 0 e 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-bordercolor"/><sgmltag class="element" +>BorderColor</sgmltag +></term> +<listitem> +<para +>Escolhe a cor do contorno da etiqueta. Esta cor é definida como um valor RGB ('Red Green Blue', Vermelho, Verde, Azul) (r, g, b). r, g e b devem estar entre 0 e 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-borderwidth"/><sgmltag class="element" +>BorderWidth</sgmltag +></term> +<listitem> +<para +>Escolhe a largura do contorno da etiqueta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-borderstyle"/><sgmltag class="element" +>BorderStyle</sgmltag +></term> +<listitem> +<para +>Escolhe o estilo do contorno da etiqueta. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Estilo do Contorno</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Nenhum</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Sólido</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Traço</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Ponto</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Traço Ponto</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>Traço Ponto Ponto</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-fontfamily"/><sgmltag class="attribute" +>FontFamily</sgmltag +></term> +<listitem> +<para +>Escolhe a família de letra do texto da etiqueta. </para> +<!--<informalexample> +<para +>For example: <userinput +><sgmltag +class="attribute" +>FontFamily</sgmltag +>="<sgmltag +class="attvalue" +>Helvetica</sgmltag +>"</userinput +></para> +</informalexample +>--> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-fontsize"/><sgmltag class="attribute" +>FontSize</sgmltag +></term> +<listitem> +<para +>Escolhe o tamanho de letra do texto da etiqueta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-fontweight"/><sgmltag class="attribute" +>FontWeight</sgmltag +></term> +<listitem> +<para +>Escolhe a espessura da letra do texto da etiqueta. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Espessura da Letra</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>25</sgmltag +></entry> +<entry +>Leve</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>50</sgmltag +></entry> +<entry +>Normal</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>63</sgmltag +></entry> +<entry +>Semi-Negrito</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>75</sgmltag +></entry> +<entry +>Negrito</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>87</sgmltag +></entry> +<entry +>Negro</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-fontitalic"/><sgmltag class="attribute" +>FontItalic</sgmltag +></term> +<listitem> +<para +>Escolhe ou não colocar em itálico o texto da etiqueta. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Itálico</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>True</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-halignment"/><sgmltag class="attribute" +>HAlignment</sgmltag +></term> +<listitem> +<para +>Muda o alinhamento horizontal do texto. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Alinhamento Horizontal</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Esquerda</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Centro</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Direita</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-valignment"/><sgmltag class="attribute" +>VAlignment</sgmltag +></term> +<listitem> +<para +>Muda o alinhamento vertical do texto da etiqueta. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Alinhamento Vertical</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Topo</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Meio</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Fundo</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-wordwrap"/><sgmltag class="attribute" +>WordWrap</sgmltag +></term> +<listitem> +<para +>Activa ou não a mudança de linha no texto da etiqueta. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Mudança de Linha</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>True</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="field-element"> +<title +><sgmltag class="element" +>Field</sgmltag +></title> + +<para +>O elemento <sgmltag class="element" +>Label</sgmltag +> define um objecto que pode ser utilizado para colocar dados no relatório. </para> + +<synopsis +><!ELEMENT Field EMPTY> +<!ATTLIST Field + Field CDATA #REQUIRED + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED + DataType CDATA #REQUIRED + DateFormat CDATA #REQUIRED + Precision CDATA #REQUIRED + Currency CDATA #REQUIRED + NegValueColor CDATA #REQUIRED + CommaSeparator CDATA #REQUIRED> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="f-field"/><sgmltag class="attribute" +>Field</sgmltag +></term> +<listitem> +<para +>Escolhe o campo de dados do objecto. Isto é um atributo do elemento <sgmltag class="attribute" +>row</sgmltag +> no ficheiro de dados. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-text"/><sgmltag class="attribute" +>Text</sgmltag +></term> +<listitem> +<para +>Não usado. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-x"/><sgmltag class="attribute" +>X</sgmltag +></term> +<listitem> +<para +>Escolhe a coordenada X inicial (relativa ao campo superior esquerda da secção) para posicionar o campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-y"/><sgmltag class="attribute" +>Y</sgmltag +></term> +<listitem> +<para +>Escolhe a coordenada Y inicial (relativa ao campo superior esquerda da secção) para posicionar o campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-width"/><sgmltag class="attribute" +>Width</sgmltag +></term> +<listitem> +<para +>Escolhe a largura do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Escolhe a altura do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-backgroundcolor"/><sgmltag class="attribute" +>BackgroundColor</sgmltag +></term> +<listitem> +<para +>Escolhe a cor de fundo do campo. Esta cor é definida como um valor RGB ('Red Green Blue', Vermelho, Verde, Azul) (r, g, b). r, g e b devem estar entre 0 e 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-foregroundcolor"/><sgmltag class="attribute" +>ForegroundColor</sgmltag +></term> +<listitem> +<para +>Escolhe a cor principal do campo. Esta cor é definida como um valor RGB ('Red Green Blue', Vermelho, Verde, Azul) (r, g, b). r, g e b devem estar entre 0 e 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-bordercolor"/><sgmltag class="attribute" +>BorderColor</sgmltag +></term> +<listitem> +<para +>Escolhe a cor do contorno do campo. Esta cor é definida como um valor RGB ('Red Green Blue', Vermelho, Verde, Azul) (r, g, b). r, g e b devem estar entre 0 e 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-borderwidth"/><sgmltag class="element" +>BorderWidth</sgmltag +></term> +<listitem> +<para +>Escolhe a largura do contorno do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-borderstyle"/><sgmltag class="element" +>BorderStyle</sgmltag +></term> +<listitem> +<para +>Escolhe o estilo do contorno do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Estilo do Contorno</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Nenhum</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Sólido</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Traço</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Ponto</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Traço Ponto</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>Traço Ponto Ponto</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-fontfamily"/><sgmltag class="attribute" +>FontFamily</sgmltag +></term> +<listitem> +<para +>Escolhe a família de letra do texto do campo. </para> +<!--<informalexample> +<para +><userinput +><sgmltag +class="attribute" +>FontFamily</sgmltag +>="<sgmltag +class="attvalue" +>Helvetica</sgmltag +>"</userinput +></para> +</informalexample +>--> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-fontsize"/><sgmltag class="attribute" +>FontSize</sgmltag +></term> +<listitem> +<para +>Escolhe o tamanho de letra do texto do texto. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-fontweight"/><sgmltag class="attribute" +>FontWeight</sgmltag +></term> +<listitem> +<para +>Escolhe a espessura da letra do texto do texto. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Espessura da Letra</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>25</sgmltag +></entry> +<entry +>Leve</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>50</sgmltag +></entry> +<entry +>Normal</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>63</sgmltag +></entry> +<entry +>Semi-Negrito</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>75</sgmltag +></entry> +<entry +>Negrito</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>87</sgmltag +></entry> +<entry +>Negro</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-fontitalic"/><sgmltag class="attribute" +>FontItalic</sgmltag +></term> +<listitem> +<para +>Escolhe ou não colocar em itálico o texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Itálico</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>True</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-halignment"/><sgmltag class="attribute" +>HAlignment</sgmltag +></term> +<listitem> +<para +>Mudar o alinhamento horizontal do texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Alinhamento Horizontal</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Esquerda</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Centro</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Direita</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-valignment"/><sgmltag class="attribute" +>VAlignment</sgmltag +></term> +<listitem> +<para +>Mudar o alinhamento vertical do texto do campo </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Alinhamento Vertical</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Topo</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Meio</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Fundo</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-wordwrap"/><sgmltag class="attribute" +>WordWrap</sgmltag +></term> +<listitem> +<para +>Activa ou não a mudança de linha no texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Mudança de Linha</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>True</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> +<!--</variablelist> +</listitem> +</varlistentry +>--> + +<varlistentry> +<term +><anchor id="f-datatype"/><sgmltag class="attribute" +>DataType</sgmltag +></term> +<listitem> +<para +>Escolhe o tipo de dados do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Tipo de Dados</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Cadeia de Caracteres</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Inteiro</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Real</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Data</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Moeda</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-dateformat"/><sgmltag class="attribute" +>DateFormat</sgmltag +></term> +<listitem> +<para +>Escolhe o formato de data do campo. Para isto funcionar, o formato da data no documento de dados deve estar no formato mm/dd/aaaa ou mm-dd-aaaa, em caso contrário o formato original de data é utilizado. Se o tipo de dados não for data, escolha o valor <sgmltag class="attvalue" +>0</sgmltag +>. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Formato da Data</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>m/d/aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>m-d-aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>mm/dd/aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>mm-dd-aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>m/d/aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>m-d-aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>6</sgmltag +></entry> +<entry +>mm/dd/aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>7</sgmltag +></entry> +<entry +>mm-dd-aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>8</sgmltag +></entry> +<entry +>aaaa/m/d</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>9</sgmltag +></entry> +<entry +>aaaa-m-d</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>10</sgmltag +></entry> +<entry +>dd.mm.aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>11</sgmltag +></entry> +<entry +>dd.mm.aaaa</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-precision"/><sgmltag class="attribute" +>Precision</sgmltag +></term> +<listitem> +<para +>Escolhe a precisão numérica do campo. Se o tipo de dados não é numérico, escolha 0. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-currency"/><sgmltag class="attribute" +>Currency</sgmltag +></term> +<listitem> +<para +>Escolhe o símbolo monetário do campo. Se o tipo de dados não é monetário escolha o valor <sgmltag class="attvalue" +>36</sgmltag +> ($). O valor é um número que representa um caracter Unicode. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-negvaluecolor"/><sgmltag class="attribute" +>NegValueColor</sgmltag +></term> +<listitem> +<para +>Escolhe a cor para os valores numéricos negativos. Esta cor é definida como um valor RGB ('Red Green Blue', Vermelho, Verde, Azul) (r, g, b). r, g e b devem estar entre 0 e 255. Se os dados não são numérico, escolha 255,0,0. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-commaseparator"/><sgmltag class="attribute" +>CommaSeparator</sgmltag +></term> +<listitem> +<para +>Utiliza ou não virgulas nos campos numéricos. Se o tipo de dados não foi numérico escolha o valor <sgmltag class="attvalue" +>0</sgmltag +>. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Separador da Vírgula</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>True</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="calculated-field-element"> +<title +><sgmltag class="element" +>CalculatedField</sgmltag +></title> + +<para +>O elemento <sgmltag class="element" +>CalculatedField</sgmltag +> define um objecto utilizado para colocar valores calculados no relatório. </para> + +<synopsis +><!ELEMENT CalculatedField EMPTY> +<!ATTLIST CalculatedField + CalculationType CDATA #REQUIRED + Field CDATA #REQUIRED + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED + DataType CDATA #REQUIRED + DateFormat CDATA #REQUIRED + Precision CDATA #REQUIRED + Currency CDATA #REQUIRED + NegValueColor CDATA #REQUIRED + CommaSeparator CDATA #REQUIRED> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="c-calculationtype"/><sgmltag class="attribute" +>CalculationType</sgmltag +></term> +<listitem> +<para +>Escolhe o tipo de cálculo para o campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Cálculo</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Quantidade</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Soma</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Média</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Variância</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Desvio Padrão</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-field"/><sgmltag class="attribute" +>Field</sgmltag +></term> +<listitem> +<para +>Escolhe o campo de dados do objecto. Isto é um atributo do elemento <sgmltag class="attribute" +>row</sgmltag +> no ficheiro de dados. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-text"/><sgmltag class="attribute" +>Text</sgmltag +></term> +<listitem> +<para +>Não usado. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-x"/><sgmltag class="attribute" +>X</sgmltag +></term> +<listitem> +<para +>Escolhe a coordenada X inicial (relativa ao campo superior esquerda da secção) para posicionar o campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-y"/><sgmltag class="attribute" +>Y</sgmltag +></term> +<listitem> +<para +>Escolhe a coordenada Y inicial (relativa ao campo superior esquerda da secção) para posicionar o campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-width"/><sgmltag class="attribute" +>Width</sgmltag +></term> +<listitem> +<para +>Escolhe a largura do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Escolhe a altura do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-backgroundcolor"/><sgmltag class="attribute" +>BackgroundColor</sgmltag +></term> +<listitem> +<para +>Escolhe a cor de fundo do campo. Esta cor é definida como um valor RGB ('Red Green Blue', Vermelho, Verde, Azul) (r, g, b). r, g e b devem estar entre 0 e 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-foregroundcolor"/><sgmltag class="attribute" +>ForegroundColor</sgmltag +></term> +<listitem> +<para +>Escolhe a cor principal do campo. Esta cor é definida como um valor RGB ('Red Green Blue', Vermelho, Verde, Azul) (r, g, b). r, g e b devem estar entre 0 e 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-bordercolor"/><sgmltag class="attribute" +>BorderColor</sgmltag +></term> +<listitem> +<para +>Escolhe a cor do contorno do campo. Esta cor é definida como um valor RGB ('Red Green Blue', Vermelho, Verde, Azul) (r, g, b). r, g e b devem estar entre 0 e 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-borderwidth"/><sgmltag class="element" +>BorderWidth</sgmltag +></term> +<listitem> +<para +>Escolhe a largura do contorno do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-borderstyle"/><sgmltag class="element" +>BorderStyle</sgmltag +></term> +<listitem> +<para +>Escolhe o estilo do contorno do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Estilo do Contorno</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Nenhum</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Sólido</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Traço</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Ponto</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Traço Ponto</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>Traço Ponto Ponto</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-fontfamily"/><sgmltag class="attribute" +>FontFamily</sgmltag +></term> +<listitem> +<para +>Escolhe a família de letra do texto do campo. </para> +<!--<informalexample> +<para +><userinput +><sgmltag +class="attribute" +>FontFamily</sgmltag +>="<sgmltag +class="attvalue" +>Helvetica</sgmltag +>"</userinput +></para> +</informalexample +>--> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-fontsize"/><sgmltag class="attribute" +>FontSize</sgmltag +></term> +<listitem> +<para +>Escolhe o tamanho de letra do texto do texto. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-fontweight"/><sgmltag class="attribute" +>FontWeight</sgmltag +></term> +<listitem> +<para +>Escolhe a espessura da letra do texto do texto. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Espessura da Letra</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>25</sgmltag +></entry> +<entry +>Leve</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>50</sgmltag +></entry> +<entry +>Normal</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>63</sgmltag +></entry> +<entry +>Semi-Negrito</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>75</sgmltag +></entry> +<entry +>Negrito</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>87</sgmltag +></entry> +<entry +>Negro</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-fontitalic"/><sgmltag class="attribute" +>FontItalic</sgmltag +></term> +<listitem> +<para +>Escolhe ou não colocar em itálico o texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Itálico</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>True</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-halignment"/><sgmltag class="attribute" +>HAlignment</sgmltag +></term> +<listitem> +<para +>Mudar o alinhamento horizontal do texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Alinhamento Horizontal</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Esquerda</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Centro</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Direita</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-valignment"/><sgmltag class="attribute" +>VAlignment</sgmltag +></term> +<listitem> +<para +>Muda o alinhamento vertical do texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Alinhamento Vertical</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Topo</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Meio</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Fundo</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-wordwrap"/><sgmltag class="attribute" +>WordWrap</sgmltag +></term> +<listitem> +<para +>Activa ou não a mudança de linha no texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Mudança de Linha</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>True</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-datatype"/><sgmltag class="attribute" +>DataType</sgmltag +></term> +<listitem> +<para +>Escolhe o tipo de dados do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Tipo de Dados</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Cadeia de Caracteres</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Inteiro</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Real</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Data</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Moeda</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-dateformat"/><sgmltag class="attribute" +>DateFormat</sgmltag +></term> +<listitem> +<para +>Escolhe o formato de data do campo. Para isto funcionar, o formato da data no documento de dados deve estar no formato mm/dd/aaaa ou mm-dd-aaaa, em caso contrário o formato original de data é utilizado. Se o tipo de dados não for data, escolha o valor <sgmltag class="attvalue" +>0</sgmltag +>. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Formato da Data</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>m/d/aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>m-d-aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>mm/dd/aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>mm-dd-aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>m/d/aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>m-d-aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>6</sgmltag +></entry> +<entry +>mm/dd/aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>7</sgmltag +></entry> +<entry +>mm-dd-aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>8</sgmltag +></entry> +<entry +>aaaa/m/d</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>9</sgmltag +></entry> +<entry +>aaaa-m-d</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>10</sgmltag +></entry> +<entry +>dd.mm.aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>11</sgmltag +></entry> +<entry +>dd.mm.aaaa</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-precision"/><sgmltag class="attribute" +>Precision</sgmltag +></term> +<listitem> +<para +>Escolhe a precisão numérica do campo. Se o tipo de dados não é numérico, escolha 0. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-currency"/><sgmltag class="attribute" +>Currency</sgmltag +></term> +<listitem> +<para +>Escolhe o símbolo monetário do campo. Se o tipo de dados não é monetário escolha o valor <sgmltag class="attvalue" +>36</sgmltag +> ($). O valor é um número que representa um caracter Unicode. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-negvaluecolor"/><sgmltag class="attribute" +>NegValueColor</sgmltag +></term> +<listitem> +<para +>Escolhe a cor para os valores numéricos negativos. Esta cor é definida como um valor RGB ('Red Green Blue', Vermelho, Verde, Azul) (r, g, b). r, g e b devem estar entre 0 e 255. Se os dados não são numérico, escolha 255,0,0. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-commaseparator"/><sgmltag class="attribute" +>CommaSeparator</sgmltag +></term> +<listitem> +<para +>Utiliza ou não virgulas nos campos numéricos. Se o tipo de dados não foi numérico escolha o valor <sgmltag class="attvalue" +>0</sgmltag +>. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Separador da Vírgula</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>True</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="special-element"> +<title +><sgmltag class="element" +>Special</sgmltag +></title> + +<para +>O elemento <sgmltag class="element" +>Special</sgmltag +> define um objecto utilizado para colocar números de página e a data actual num relatório. </para> + +<synopsis +><!ELEMENT Special EMPTY> +<!ATTLIST Special + Type CDATA #REQUIRED + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED + DateFormat CDATA #REQUIRED> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="s-type"/><sgmltag class="attribute" +>Type</sgmltag +></term> +<listitem> +<para +>Escolhe o tipo do objecto especial. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Tipo</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Data Actual</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Número da Página</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-text"/><sgmltag class="attribute" +>Text</sgmltag +></term> +<listitem> +<para +>Não usado. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-x"/><sgmltag class="attribute" +>X</sgmltag +></term> +<listitem> +<para +>Escolhe a coordenada X inicial (relativa ao campo superior esquerda da secção) para posicionar o campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-y"/><sgmltag class="attribute" +>Y</sgmltag +></term> +<listitem> +<para +>Escolhe a coordenada Y inicial (relativa ao campo superior esquerda da secção) para posicionar o campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-width"/><sgmltag class="attribute" +>Width</sgmltag +></term> +<listitem> +<para +>Escolhe a largura do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Escolhe a altura do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-backgroundcolor"/><sgmltag class="attribute" +>BackgroundColor</sgmltag +></term> +<listitem> +<para +>Escolhe a cor de fundo do campo. Esta cor é definida como um valor RGB ('Red Green Blue', Vermelho, Verde, Azul) (r, g, b). r, g e b devem estar entre 0 e 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-foregroundcolor"/><sgmltag class="attribute" +>ForegroundColor</sgmltag +></term> +<listitem> +<para +>Escolhe a cor principal do campo. Esta cor é definida como um valor RGB ('Red Green Blue', Vermelho, Verde, Azul) (r, g, b). r, g e b devem estar entre 0 e 255. </para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +><anchor id="s-bordercolor"/><sgmltag class="attribute" +>BorderColor</sgmltag +></term> +<listitem> +<para +>Escolhe a cor do contorno do campo. Esta cor é definida como um valor RGB ('Red Green Blue', Vermelho, Verde, Azul) (r, g, b). r, g e b devem estar entre 0 e 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-borderwidth"/><sgmltag class="element" +>BorderWidth</sgmltag +></term> +<listitem> +<para +>Escolhe a largura do contorno do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-borderstyle"/><sgmltag class="element" +>BorderStyle</sgmltag +></term> +<listitem> +<para +>Escolhe o estilo do contorno do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Estilo do Contorno</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Nenhum</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Sólido</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Traço</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Ponto</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Traço Ponto</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>Traço Ponto Ponto</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-fontfamily"/><sgmltag class="attribute" +>FontFamily</sgmltag +></term> +<listitem> +<para +>Escolhe a família de letra do texto do campo. </para> +<!--<informalexample> +<para +><userinput +><sgmltag +class="attribute" +>FontFamily</sgmltag +>="<sgmltag +class="attvalue" +>Helvetica</sgmltag +>"</userinput +></para> +</informalexample +>--> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-fontsize"/><sgmltag class="attribute" +>FontSize</sgmltag +></term> +<listitem> +<para +>Escolhe o tamanho de letra do texto do texto. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-fontweight"/><sgmltag class="attribute" +>FontWeight</sgmltag +></term> +<listitem> +<para +>Escolhe a espessura da letra do texto do texto. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Espessura da Letra</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>25</sgmltag +></entry> +<entry +>Leve</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>50</sgmltag +></entry> +<entry +>Normal</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>63</sgmltag +></entry> +<entry +>Semi-Negrito</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>75</sgmltag +></entry> +<entry +>Negrito</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>87</sgmltag +></entry> +<entry +>Negro</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-fontitalic"/><sgmltag class="attribute" +>FontItalic</sgmltag +></term> +<listitem> +<para +>Escolhe ou não colocar em itálico o texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Itálico</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>True</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-halignment"/><sgmltag class="attribute" +>HAlignment</sgmltag +></term> +<listitem> +<para +>Mudar o alinhamento horizontal do texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Alinhamento Horizontal</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Esquerda</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Centro</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Direita</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-valignment"/><sgmltag class="attribute" +>VAlignment</sgmltag +></term> +<listitem> +<para +>Muda o alinhamento vertical do texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Alinhamento Vertical</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Topo</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Meio</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Fundo</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-wordwrap"/><sgmltag class="attribute" +>WordWrap</sgmltag +></term> +<listitem> +<para +>Activa ou não a mudança de linha no texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Mudança de Linha</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>True</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-dateformat"/><sgmltag class="attribute" +>DateFormat</sgmltag +></term> +<listitem> +<para +>Escolhe o formato de data do campo. Para isto funcionar, o formato da data no documento de dados deve estar no formato mm/dd/aaaa ou mm-dd-aaaa, em caso contrário o formato original de data é utilizado. Se o tipo de dados não for data, escolha o valor <sgmltag class="attvalue" +>0</sgmltag +>. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Formato da Data</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>m/d/aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>m-d-aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>mm/dd/aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>mm-dd-aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>m/d/aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>m-d-aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>6</sgmltag +></entry> +<entry +>mm/dd/aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>7</sgmltag +></entry> +<entry +>mm-dd-aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>8</sgmltag +></entry> +<entry +>aaaa/m/d</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>9</sgmltag +></entry> +<entry +>aaaa-m-d</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>10</sgmltag +></entry> +<entry +>dd.mm.aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>11</sgmltag +></entry> +<entry +>dd.mm.aaaa</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-precision"/><sgmltag class="attribute" +>Precision</sgmltag +></term> +<listitem> +<para +>Escolhe a precisão numérica do campo. Se o tipo de dados não é numérico, escolha 0. </para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +</sect1> + + + diff --git a/koffice-i18n-pt/docs/koffice/kugar/template.docbook b/koffice-i18n-pt/docs/koffice/kugar/template.docbook new file mode 100644 index 00000000..56aede76 --- /dev/null +++ b/koffice-i18n-pt/docs/koffice/kugar/template.docbook @@ -0,0 +1,515 @@ +<!-- If you want to edit or validate this document separately, uncomment +this prolog +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> +--> +<sect1 id="kugartemplate"> +<sect1info> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Pedro</firstname +><surname +>Morais</surname +><affiliation +><address +><email +>[email protected]</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +</sect1info> +<title +>Elemento <sgmltag class="element" +>KugarTemplate</sgmltag +></title> + +<para +>O elemento <sgmltag class="element" +>KugarTemplate</sgmltag +> define atributos do relatório relacionados com tamanho de página, orientação e margens. </para> + +<synopsis +><!ELEMENT KugarTemplate (<link linkend="report-header-and-footer" +>ReportHeader</link +>, <link linkend="page-header-and-footer" +>PageHeader</link +>, <link linkend="detail-header-and-footer" +>DetailHeader</link +>*, <link linkend="detail" +>Detail</link +>*, <link linkend="detail-header-and-footer" +>DetailFooter</link +>*, <link linkend="page-header-and-footer" +>PageFooter</link +>, <link linkend="report-header-and-footer" +>ReportFooter</link +>)> +<!ATTLIST KugarTemplate +PageSize CDATA #REQUIRED +PageOrientation CDATA #REQUIRED +TopMargin CDATA #REQUIRED +BottomMargin CDATA #REQUIRED +LeftMargin CDATA #REQUIRED +RightMargin CDATA #REQUIRED> +</synopsis> + +<variablelist> + +<varlistentry> +<term +>Elementos</term> + +<listitem> + +<para +>O elemento <sgmltag class="element" +>KugarTemplate</sgmltag +> contém os seguintes elementos: </para> + +<variablelist> +<varlistentry> +<term +><link linkend="report-header-and-footer" +><sgmltag class="element" +>ReportHeader</sgmltag +></link +></term> +<listitem> +<para +>O elemento <sgmltag class="element" +>ReportHeader</sgmltag +> define secções do relatórios que são normalmente impressas no início do relatório. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><link linkend="page-header-and-footer" +><sgmltag class="element" +>PageHeader</sgmltag +></link +></term> +<listitem> +<para +>O elemento <sgmltag class="element" +>PageHeader</sgmltag +> define secções do relatório que são normalmente impressas no topo de cada página do relatório. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><link linkend="detail-header-and-footer" +><sgmltag class="element" +>DetailHeader</sgmltag +></link +></term> +<listitem> +<para +>O elemento <sgmltag class="element" +>DetailHeader</sgmltag +> define secções do relatório que são impressas antes dos detalhes de um determinado nível no relatório. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><link linkend="detail" +><sgmltag class="element" +>Detail</sgmltag +></link +></term> +<listitem> +<para +>O elemento <sgmltag class="element" +>Detail</sgmltag +> define a secção do relatório que contém os dados do relatório. O relatório pode ter um número ilimitado de detalhes. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><link linkend="detail-header-and-footer" +><sgmltag class="element" +>DetailFooter</sgmltag +></link +></term> +<listitem> +<para +>O elemento <sgmltag class="element" +>DetailFooter</sgmltag +> define secções do relatório que são impressas depois dos detalhes de um dado nível e em baixo no relatório. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><link linkend="page-header-and-footer" +><sgmltag class="element" +>PageFooter</sgmltag +></link +></term> +<listitem> +<para +>O elemento <sgmltag class="element" +>PageFooter</sgmltag +> define secções do relatório que são normalmente impressas no fundo de cada página do relatório. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><link linkend="report-header-and-footer" +><sgmltag class="element" +>ReportFooter</sgmltag +></link +></term> +<listitem> +<para +>O elemento <sgmltag class="element" +>ReportFooter</sgmltag +> define secções do relatórios que são normalmente impressas no fim do relatório. </para> +</listitem> +</varlistentry> + +</variablelist> + +</listitem> + +</varlistentry> + +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="kut-pagesize"/><sgmltag class="attribute" +>PageSize</sgmltag +></term> +<listitem> +<para +>Escolhe o tamanho da página do relatório. Estão disponíveis os seguintes valores: </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Tamanho da Página</entry> +</row> +</thead> + +<tbody> +<row> +<entry +>0</entry> +<entry +>A4</entry> +</row> +<row> +<entry +>1</entry> +<entry +>B5</entry> +</row> +<row> +<entry +>2</entry> +<entry +>Carta</entry> +</row> +<row> +<entry +>3</entry> +<entry +>Legal</entry> +</row> +<row> +<entry +>4</entry> +<entry +>Executivo</entry> +</row> +<row> +<entry +>5</entry> +<entry +>A0</entry> +</row> +<row> +<entry +>6</entry> +<entry +>A1</entry> +</row> +<row> +<entry +>7</entry> +<entry +>A2</entry> +</row> +<row> +<entry +>8</entry> +<entry +>A3</entry> +</row> +<row> +<entry +>9</entry> +<entry +>A5</entry> +</row> +<row> +<entry +>10</entry> +<entry +>A6</entry> +</row> +<row> +<entry +>11</entry> +<entry +>A7</entry> +</row> +<row> +<entry +>12</entry> +<entry +>A8</entry> +</row> +<row> +<entry +>13</entry> +<entry +>A9</entry> +</row> +<row> +<entry +>14</entry> +<entry +>B0</entry> +</row> +<row> +<entry +>15</entry> +<entry +>B1</entry> +</row> +<row> +<entry +>16</entry> +<entry +>B10</entry> +</row> +<row> +<entry +>17</entry> +<entry +>B2</entry> +</row> +<row> +<entry +>18</entry> +<entry +>B3</entry> +</row> +<row> +<entry +>19</entry> +<entry +>B4</entry> +</row> +<row> +<entry +>20</entry> +<entry +>B6</entry> +</row> +<row> +<entry +>21</entry> +<entry +>B7</entry> +</row> +<row> +<entry +>22</entry> +<entry +>B8</entry> +</row> +<row> +<entry +>23</entry> +<entry +>B9</entry> +</row> +<row> +<entry +>24</entry> +<entry +>C5E</entry> +</row> +<row> +<entry +>25</entry> +<entry +>Comm10E</entry> +</row> +<row> +<entry +>26</entry> +<entry +>DLE</entry> +</row> +<row> +<entry +>27</entry> +<entry +>Folio</entry> +</row> +<row> +<entry +>28</entry> +<entry +>Folheto</entry> +</row> +<row> +<entry +>29</entry> +<entry +>Tablóide</entry> +</row> +<row> +<entry +>30</entry> +<entry +>NPageSize</entry> +</row> + +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="kut-pageorient"/><sgmltag class="attribute" +>PageOrientation</sgmltag +></term> +<listitem> +<para +>Muda a orientação da página do relatório. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Orientação</entry> +</row> +</thead> +<tbody> +<row> +<entry +>0</entry> +<entry +>Retrato</entry> +</row> +<row> +<entry +>1</entry> +<entry +>Paisagem</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="kut-topmargin"/><sgmltag class="attribute" +>TopMargin</sgmltag +></term> +<listitem> +<para +>Escolhe a margem superior da página do relatório. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="kut-botmargin"/><sgmltag class="attribute" +>BottomMargin</sgmltag +></term> +<listitem> +<para +>Escolhe a margem inferior da página do relatório. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="kut-leftmargin"/><sgmltag class="attribute" +>LeftMargin</sgmltag +></term> +<listitem> +<para +>Escolhe a margem esquerda da página do relatório. </para> +</listitem> +</varlistentry +><varlistentry> +<term +><anchor id="kut-rightmargin"/><sgmltag class="attribute" +>RightMargin</sgmltag +></term> +<listitem> +<para +>Escolhe a margem direita da página do relatório. </para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> +</sect1> diff --git a/koffice-i18n-pt/docs/koffice/kugar/templatedtd.docbook b/koffice-i18n-pt/docs/koffice/kugar/templatedtd.docbook new file mode 100644 index 00000000..823e0f14 --- /dev/null +++ b/koffice-i18n-pt/docs/koffice/kugar/templatedtd.docbook @@ -0,0 +1,522 @@ +<!-- If you want to validate or edit this document separately, uncomment +this prolog + +<?xml version="1.0" ?> +<!DOCTYPE appendix PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> + +--> + +<sect1 id="template-dtd"> +<sect1info> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Pedro</firstname +><surname +>Morais</surname +><affiliation +><address +><email +>[email protected]</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +</sect1info> +<title +>DTD (Document Type Definition) do KugarTemplate</title> + +<synopsis +><?xml version="1.0" encoding="UTF-8"?> + +<!DOCTYPE KugarTemplate [ + <!ELEMENT <link linkend="kugartemplate" +>KugarTemplate</link +> (<link linkend="report-header-and-footer" +>ReportHeader</link +>, <link linkend="page-header-and-footer" +>PageHeader</link +>, <link linkend="detail-header-and-footer" +>DetailHeader</link +>*, <link linkend="detail" +>Detail</link +>*, <link linkend="detail-header-and-footer" +>DetailFooter</link +>*, <link linkend="page-header-and-footer" +>PageFooter</link +>, <link linkend="report-header-and-footer" +>ReportFooter</link +>)> + <!ATTLIST KugarTemplate + <link linkend="kut-pagesize" +>PageSize</link +> CDATA #REQUIRED + <link linkend="kut-pageorient" +>PageOrientation</link +> CDATA #REQUIRED + <link linkend="kut-topmargin" +>TopMargin</link +> CDATA #REQUIRED + <link linkend="kut-botmargin" +>BottomMargin</link +> CDATA #REQUIRED + <link linkend="kut-leftmargin" +>LeftMargin</link +> CDATA #REQUIRED + <link linkend="kut-rightmargin" +>RightMargin</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="report-header-and-footer" +>ReportHeader</link +> (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> + <!ATTLIST ReportHeader + <link linkend="rhf-height" +>Height</link +> CDATA #REQUIRED + <link linkend="rhf-printfrequency" +>PrintFrequency</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="page-header-and-footer" +>PageHeader</link +> (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> + <!ATTLIST PageHeader + <link linkend="phf-height" +>Height</link +> CDATA #REQUIRED + <link linkend="phf-printfrequency" +>PrintFrequency</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="detail-header-and-footer" +>DetailHeader</link +> (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> + <!ATTLIST DetailHeader + <link linkend="dhf-height" +>Height</link +> CDATA #REQUIRED + <link linkend="dhf-level" +>Level</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="detail" +>Detail</link +> (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*, <link linkend="field-element" +>Field</link +>*)> + <!ATTLIST Detail + <link linkend="d-height" +>Height</link +> CDATA #REQUIRED + <link linkend="d-level" +>Level</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="detail-header-and-footer" +>DetailFooter</link +> (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> + <!ATTLIST DetailFooter + <link linkend="dhf-height" +>Height</link +> CDATA #REQUIRED + <link linkend="dhf-level" +>Level</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="page-header-and-footer" +>PageFooter</link +> (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> + <!ATTLIST PageFooter + <link linkend="phf-height" +>Height</link +> CDATA #REQUIRED + <link linkend="phf-printfrequency" +>PrintFrequency</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="report-header-and-footer" +>ReportFooter</link +> (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*, <link linkend="calculated-field-element" +>CalculatedField</link +>*)> + <!ATTLIST ReportFooter + <link linkend="rhf-height" +>Height</link +> CDATA #REQUIRED + <link linkend="rhf-printfrequency" +>PrintFrequency</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="line-element" +>Line</link +> EMPTY> + <!ATTLIST Line + <link linkend="l-x1" +>X1</link +> CDATA #REQUIRED + <link linkend="l-y1" +>Y1</link +> CDATA #REQUIRED + <link linkend="l-x2" +>X2</link +> CDATA #REQUIRED + <link linkend="l-y2" +>Y2</link +> CDATA #REQUIRED + <link linkend="l-width" +>Width</link +> CDATA #REQUIRED + <link linkend="l-color" +>Color</link +> CDATA #REQUIRED + <link linkend="l-style" +>Style</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="label-element" +>Label</link +> EMPTY> + <!ATTLIST Label + <link linkend="la-text" +>Text</link +> CDATA #REQUIRED + <link linkend="la-x" +>X</link +> CDATA #REQUIRED + <link linkend="la-y" +>Y</link +> CDATA #REQUIRED + <link linkend="la-width" +>Width</link +> CDATA #REQUIRED + <link linkend="la-height" +>Height</link +> CDATA #REQUIRED + <link linkend="la-backgroundcolor" +>BackgroundColor</link +> CDATA #REQUIRED + <link linkend="la-foregroundcolor" +>ForegroundColor</link +> CDATA #REQUIRED + <link linkend="la-bordercolor" +>BorderColor</link +> CDATA #REQUIRED + <link linkend="la-borderwidth" +>BorderWidth</link +> CDATA #REQUIRED + <link linkend="la-borderstyle" +>BorderStyle</link +> CDATA #REQUIRED + <link linkend="la-fontfamily" +>FontFamily</link +> CDATA #REQUIRED + <link linkend="la-fontsize" +>FontSize</link +> CDATA #REQUIRED + <link linkend="la-fontweight" +>FontWeight</link +> CDATA #REQUIRED + <link linkend="la-fontitalic" +>FontItalic</link +> CDATA #REQUIRED + <link linkend="la-halignment" +>HAlignment</link +> CDATA #REQUIRED + <link linkend="la-valignment" +>VAlignment</link +> CDATA #REQUIRED + <link linkend="la-wordwrap" +>WordWrap</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="field-element" +>Field</link +> EMPTY> + <!ATTLIST Field + <link linkend="f-field" +>Field</link +> CDATA #REQUIRED + <link linkend="f-text" +>Text</link +> CDATA #REQUIRED + <link linkend="f-x" +>X</link +> CDATA #REQUIRED + <link linkend="f-y" +>Y</link +> CDATA #REQUIRED + <link linkend="f-width" +>Width</link +> CDATA #REQUIRED + <link linkend="f-height" +>Height</link +> CDATA #REQUIRED + <link linkend="f-backgroundcolor" +>BackgroundColor</link +> CDATA #REQUIRED + <link linkend="f-foregroundcolor" +>ForegroundColor</link +> CDATA #REQUIRED + <link linkend="f-bordercolor" +>BorderColor</link +> CDATA #REQUIRED + <link linkend="f-borderwidth" +>BorderWidth</link +> CDATA #REQUIRED + <link linkend="f-borderstyle" +>BorderStyle</link +> CDATA #REQUIRED + <link linkend="f-fontfamily" +>FontFamily</link +> CDATA #REQUIRED + <link linkend="f-fontsize" +>FontSize</link +> CDATA #REQUIRED + <link linkend="f-fontweight" +>FontWeight</link +> CDATA #REQUIRED + <link linkend="f-fontitalic" +>FontItalic</link +> CDATA #REQUIRED + <link linkend="f-halignment" +>HAlignment</link +> CDATA #REQUIRED + <link linkend="f-valignment" +>VAlignment</link +> CDATA #REQUIRED + <link linkend="f-wordwrap" +>WordWrap</link +> CDATA #REQUIRED + <link linkend="f-datatype" +>DataType</link +> CDATA #REQUIRED + <link linkend="f-dateformat" +>DateFormat</link +> CDATA #REQUIRED + <link linkend="f-precision" +>Precision</link +> CDATA #REQUIRED + <link linkend="f-currency" +>Currency</link +> CDATA #REQUIRED + <link linkend="f-negvaluecolor" +>NegValueColor</link +> CDATA #REQUIRED + <link linkend="f-commaseparator" +>CommaSeparator</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="calculated-field-element" +>CalculatedField</link +> EMPTY> + <!ATTLIST CalculatedField + <link linkend="c-calculationtype" +>CalculationType</link +> CDATA #REQUIRED + <link linkend="c-field" +>Field</link +> CDATA #REQUIRED + <link linkend="c-text" +>Text</link +> CDATA #REQUIRED + <link linkend="c-x" +>X</link +> CDATA #REQUIRED + <link linkend="c-y" +>Y</link +> CDATA #REQUIRED + <link linkend="c-width" +>Width</link +> CDATA #REQUIRED + <link linkend="c-height" +>Height</link +> CDATA #REQUIRED + <link linkend="c-backgroundcolor" +>BackgroundColor</link +> CDATA #REQUIRED + <link linkend="c-foregroundcolor" +>ForegroundColor</link +> CDATA #REQUIRED + <link linkend="c-bordercolor" +>BorderColor</link +> CDATA #REQUIRED + <link linkend="c-borderwidth" +>BorderWidth</link +> CDATA #REQUIRED + <link linkend="c-borderstyle" +>BorderStyle</link +> CDATA #REQUIRED + <link linkend="c-fontfamily" +>FontFamily</link +> CDATA #REQUIRED + <link linkend="c-fontsize" +>FontSize</link +> CDATA #REQUIRED + <link linkend="c-fontweight" +>FontWeight</link +> CDATA #REQUIRED + <link linkend="c-fontitalic" +>FontItalic</link +> CDATA #REQUIRED + <link linkend="c-halignment" +>HAlignment</link +> CDATA #REQUIRED + <link linkend="c-valignment" +>VAlignment</link +> CDATA #REQUIRED + <link linkend="c-wordwrap" +>WordWrap</link +> CDATA #REQUIRED + <link linkend="c-datatype" +>DataType</link +> CDATA #REQUIRED + <link linkend="c-dateformat" +>DateFormat</link +> CDATA #REQUIRED + <link linkend="c-precision" +>Precision</link +> CDATA #REQUIRED + <link linkend="c-currency" +>Currency</link +> CDATA #REQUIRED + <link linkend="c-negvaluecolor" +>NegValueColor</link +> CDATA #REQUIRED + <link linkend="c-commaseparator" +>CommaSeparator</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="special-element" +>Special</link +> EMPTY> + <!ATTLIST Special + <link linkend="s-type" +>Type</link +> CDATA #REQUIRED + <link linkend="s-text" +>Text</link +> CDATA #REQUIRED + <link linkend="s-x" +>X</link +> CDATA #REQUIRED + <link linkend="s-y" +>Y</link +> CDATA #REQUIRED + <link linkend="s-width" +>Width</link +> CDATA #REQUIRED + <link linkend="s-height" +>Height</link +> CDATA #REQUIRED + <link linkend="s-backgroundcolor" +>BackgroundColor</link +> CDATA #REQUIRED + <link linkend="s-foregroundcolor" +>ForegroundColor</link +> CDATA #REQUIRED + <link linkend="s-bordercolor" +>BorderColor</link +> CDATA #REQUIRED + <link linkend="s-borderwidth" +>BorderWidth</link +> CDATA #REQUIRED + <link linkend="s-borderstyle" +>BorderStyle</link +> CDATA #REQUIRED + <link linkend="s-fontfamily" +>FontFamily</link +> CDATA #REQUIRED + <link linkend="s-fontsize" +>FontSize</link +> CDATA #REQUIRED + <link linkend="s-fontweight" +>FontWeight</link +> CDATA #REQUIRED + <link linkend="s-fontitalic" +>FontItalic</link +> CDATA #REQUIRED + <link linkend="s-halignment" +>HAlignment</link +> CDATA #REQUIRED + <link linkend="s-valignment" +>VAlignment</link +> CDATA #REQUIRED + <link linkend="s-wordwrap" +>WordWrap</link +> CDATA #REQUIRED + <link linkend="s-dateformat" +>DateFormat</link +> CDATA #REQUIRED> + ]> +</synopsis> +</sect1> diff --git a/koffice-i18n-pt/docs/koffice/kugar/tutorial.docbook b/koffice-i18n-pt/docs/koffice/kugar/tutorial.docbook new file mode 100644 index 00000000..132a246c --- /dev/null +++ b/koffice-i18n-pt/docs/koffice/kugar/tutorial.docbook @@ -0,0 +1,380 @@ +<!-- If you want to validate or edit this document separately, uncomment +this prolog + +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> + +--> +<chapter id="tutorial"> +<chapterinfo> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Pedro</firstname +><surname +>Morais</surname +><affiliation +><address +><email +>[email protected]</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Tutorial</title> + +<para +>Este tutorial tenta ser uma breve introdução ao Kugar.</para> + +<para +>Você irá criar um modelo de relatório de exemplo com o &kudesigner;, um ficheiro de dados de exemplo e, finalmente, gerar um relatório completo.</para> + +<para +>O código-fonte para os modelos dos exemplos e os ficheiros de dados poderão ser encontrados no <filename +>sample1.ktf</filename +> e no <filename +>sample1.kdf</filename +> que são distribuídos com o &kugar;.</para> + + +<sect1 id="tut-1"> +<title +>Criar o modelo de relatório com o &kudesigner;</title> + +<para +>Execute o Kugar Designer ao escrever <command +>kudesigner</command +> na linha de comandos. </para> + +<para +>Depois de iniciar o desenhador, escolha a opção <guimenu +>Ficheiro</guimenu +>|<guilabel +>Novo</guilabel +> e configure o tamanho da página para <guilabel +>Carta</guilabel +> e a direcção do papel como <guilabel +>Paisagem</guilabel +>. Configure as margens esquerda e direita iguais a 48 e as margens inferior e superior como 40. Todas as dimensões do &kudesigner; (margens da página, tamanhos, posições, &etc;) são medidas em milímetros. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_file_new.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Janela de <interface +>Novo Relatório</interface +></phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>Está criado agora um novo relatório e todos os botões da <guilabel +>Barra de Itens</guilabel +> e da <guilabel +>Barra de Secções</guilabel +> estão agora activos (os itens de menu correspondentes em <guilabel +>Itens</guilabel +> e <guilabel +>Secções</guilabel +> ficam também activos). <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_empty_report.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Janela de Relatório Vazio</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>Agora é a altura de adicionar algumas secções ao relatório e de determinar os seus tamanhos. Serão adicionados o <link linkend="report-header-and-footer" +>cabeçalho e o rodapé do relatório</link +>, o <link linkend="page-header-and-footer" +>cabeçalho e o rodapé da página</link +> e uma única secção de <link linkend="detail" +>detalhe</link +>. Os cabeçalhos e rodapés do relatório são impressos primeiro, bem como as últimas páginas do relatório ante s e depois de quaisquer dados do relatório. Os rodapés dos relatórios são locais óptimos para os <link linkend="calculated-field-element" +>campos calculados</link +>. Os cabeçalhos e rodapés das páginas são impressos no início e no fim de cada página. O relatório do exemplo irá ter uma secção de detalhe com o nível 0. Isto significa que todas as linhas de dados irão ter uma estrutura idêntica (&ie;, campos). Se a estrutura de dados for mais complexa ou se for organizada com uma relação de mestre-detalhe, poderão ser criados mais níveis de detalhe. Veja o <filename +>sample3.kut</filename +> e o <filename +>sample3.kud</filename +> para ver um exemplo de como isto poderá ser feito. Veja as <link linkend="template-elements" +>descrições dos elementos do modelo</link +> para mais informações. </para> + +<para +>As secções são adicionadas ao usar o menu <guilabel +>Secções</guilabel +> ou uma <guilabel +>Barra de Secções</guilabel +>. A partir de agora, adicione o cabeçalho e o rodapé do relatório e das páginas e, finalmente, o detalhe. Ao adicionar a secção de detalhe, coloque o seu nível a 0 como é mostrado na imagem em baixo. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_set_level.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Modificar o nível de detalhe</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>O relatório deverá agora ficar parecido com o desta imagem. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_rep_look1.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Relatório com secções</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>Todas as secções do exemplo têm uma altura predefinida - 50 mm; esta será agora alterada. Para o fazer, carregue com o &RMB; na secção do Cabeçalho do Relatório ou carregue no botão <guilabel +>Editar as Propriedades</guilabel +> da <guilabel +>Barra de Edição</guilabel +> e, finalmente, escolha uma secção. A janela de propriedades deverá então aparecer. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_edit_height.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Altura da edição da secção</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>Defina agora a altura do Cabeçalho do Relatório como sendo igual a 70. Este procedimento vai ser repetido para todas as outras secções. Configure a altura do Cabeçalho da Página para ser igual a 45 e do Detalhe como sendo igual a 30. Os Rodapés da Página e do Relatório deverão ter 32 mm de altura. </para> + +<para +>Um modelo de relatório com as secções devidamente dimensionadas está pronto a ser preenchido com os itens do relatório. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_rep_look2.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Relatório com secções dimensionadas</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>Poderá agora adicionar itens às secções do relatório. Poderão ser adicionados cinco tipos diferentes de itens. A <link linkend="label-element" +>Legenda</link +> é uma área rectangular que poderá ter um contorno e poderá ser preenchida com qualquer tipo de dados em texto. O texto em si e as cores de fundo, assim como os tipos de letra, poderão ser alterados. Os tipos de contorno e as cores das linhas poderão também ser personalizadas. O <link linkend="field-element" +>Campo</link +> poderá ser colocado numa secção de detalhe. Os campos representam campos de dados e os seus valores serão obtidos a partir de um ficheiro de dados ao gerar um relatório. As quantidades, somas, médias, &etc; dos valores dos campos poderão ser impressas no relatório através dos <link linkend="calculated-field-element" +>Campos Calculados</link +>. Os <link linkend="special-element" +>Especiais</link +> são legendas com algum texto predefinido, como a data actual ou o número de página. A aparência geral do relatório pode ser refinada com as <link linkend="line-element" +>Linhas</link +>. </para> + +<para +>Para adicionar um item do relatório, carregue no botão do item corresponde da <guilabel +>Barra de Itens</guilabel +> e coloque-o na secção. O item seleccionado será posicionado na secção seleccionada com o canto superior esquerdo nas coordenadas indicadas. As outras propriedades ficam configuradas com os valores predefinidos e poderão ser alteradas com a janela das <guilabel +>Opções do Item de Relatório</guilabel +> (da mesma forma como foi alterada a altura da secção). </para> + +<para +>Assim, serão adicionadas legendas ao cabeçalho e ao rodapé do relatório, tal como se demonstra na imagem abaixo. Lembre-se que a legenda <quote +>Mutiny Bay Software</quote +> tem o seu <guilabel +>BorderStyle</guilabel +> e o seu <guilabel +>BorderWidth</guilabel +> iguais a 0 e o <quote +>Software Inventory Report</quote +> - 1mm. Todas as cores estão definidas como uma combinação de três valores (RGB- vermelho, verde e azul) separados por vírgulas. </para> + +<para +>Adicione também elementos de campos na secção do detalhe. Assumindo que existem quatro campos - título, versão, plataforma e cópias. Deste modo, deverão ser colocados quatro elementos <guilabel +>Campo</guilabel +>, assim como deverão ser configuradas as propriedades do <guilabel +>Campo</guilabel +>. Lembre-se que a propriedade do <guilabel +>Texto</guilabel +> é configurada automaticamente como <quote +>[<userinput +>nome_campo</userinput +>]</quote +>. </para> + +<para +>O rodapé da página é um bom sítio onde mostrar a data actual e o número da página, como tal deverão ser adicionados dois campos especiais e configurado o seu <guilabel +>Type</guilabel +> como sendo 0 e 1. O especial com Type=0 irá representar a data e o Type=1 o número da página. Repare que a propriedade <guilabel +>Text</guilabel +> do item especial é alterada automaticamente. </para> + +<para +>O último elemento a ser colocado é o <guilabel +>Campo Calculado</guilabel +> para o campo <quote +>cópias</quote +>. Para adquirir um conjunto de som da cópias, configure a propriedade <guilabel +>Field</guilabel +> do campo calculado como sendo o <quote +>copies</quote +> e o <guilabel +>CalculationType</guilabel +> igual a 1 (a função de soma). </para> + +<para +>Finalmente, o nosso modelo de relatório deve ter este aspecto: <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_rep_complete.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Relatório completo</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +</sect1> + + + +<sect1 id="tut-2"> +<title +>Criar o ficheiro de dados do relatório</title> + +<para +>De um modo geral, os ficheiros de dados poderão ser criados de várias formas. Alguns irão usar tabelas de transformação de XSL para gerar um &XML; válido a partir de outro documento em &XML; (como uma folha de cálculo do &kspread;); os outros irão usar o seu próprio programa para obter os dados de uma base de dados e preencher o ficheiro de dados. Neste tutorial, este será criado à mão. O código-fonte do exemplo, poderá ser encontrado no ficheiro <filename +>sample1.kdf</filename +> ou copiado do exemplo abaixo. </para> + +<programlisting +><?xml version=<quote +>1.0</quote +> encoding=<quote +>UTF-8</quote +>?> + +<!DOCTYPE KugarData [ + <!ELEMENT KugarData (Row* )> + <!ATTLIST KugarData + Template CDATA #REQUIRED> + + <!ELEMENT Row EMPTY> + <!ATTLIST Row + level CDATA #REQUIRED + title CDATA #REQUIRED + version CDATA #REQUIRED + platform CDATA #REQUIRED + copies CDATA #REQUIRED> +]> + +<KugarData Template="sample1.ktf"> + <Row level="0" title=" BRU" version="15.0" platform="x86" copies="1"/> + <Row level="0" title=" Caldera Open Linux" version="2.2" platform="x86" copies="3"/> + <Row level="0" title=" K Desktop" version="1.1.1" platform="x86" copies="1"/> + <Row level="0" title=" Netscape Communicator" version="4.6" platform="x86" copies="10"/> + <Row level="0" title=" Redhat Linux" version="5.0" platform="x86" copies="11"/> + <Row level="0" title=" Redhat Linux" version="5.1" platform="x86" copies="12"/> + <Row level="0" title=" Redhat Linux" version="5.2" platform="x86" copies="14"/> + <Row level="0" title=" Redhat Linux" version="6.0" platform="x86" copies="15"/> + <Row level="0" title=" Star Office" version="5.0" platform="x86" copies="1"/> + <Row level="0" title=" Star Office" version="5.1" platform="x86" copies="3"/> + <Row level="0" title=" Microsoft Windows NT" version="3.1" platform="x86" copies="1"/> + <Row level="0" title=" Microsoft Windows NT" version="3.51" platform="x86" copies="1"/> + <Row level="0" title=" Microsoft Windows NT" version="4.0" platform="x86" copies="1"/> + <Row level="0" title=" Microsoft Windows NT" version="5.0" platform="x86" copies="1"/> + <Row level="0" title=" Sun Solaris" version="2.5" platform="Sparc" copies="1"/> +</KugarData> +</programlisting> + +</sect1> + +<sect1 id="tut-3"> +<title +>Gerar o relatório</title> + +<para +>Neste momento temos um modelo de relatório (<filename +>sample1.ktf</filename +>) e um ficheiro de dados de relatório (<filename +>sample1.kdf</filename +>). </para> +<para +>Para gerar um relatório, escreva o seguinte comando na consola: <command +>kugar <option +>-r <replaceable +>sample1.ktf</replaceable +></option +> <option +>-d <replaceable +>sample1.kdf</replaceable +></option +></command +> </para> + +<para +>Isto faz aparecer uma janela do &kugar; com o relatório gerado. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_rep_generated.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Relatório gerado</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +</sect1> + +</chapter> |