diff options
Diffstat (limited to 'koffice-i18n-pt_BR/docs/koffice/kugar')
| -rw-r--r-- | koffice-i18n-pt_BR/docs/koffice/kugar/Makefile.am | 4 | ||||
| -rw-r--r-- | koffice-i18n-pt_BR/docs/koffice/kugar/datadtd.docbook | 90 | ||||
| -rw-r--r-- | koffice-i18n-pt_BR/docs/koffice/kugar/dataref.docbook | 162 | ||||
| -rw-r--r-- | koffice-i18n-pt_BR/docs/koffice/kugar/designer.docbook | 679 | ||||
| -rw-r--r-- | koffice-i18n-pt_BR/docs/koffice/kugar/index.docbook | 207 | ||||
| -rw-r--r-- | koffice-i18n-pt_BR/docs/koffice/kugar/progguide.docbook | 671 | ||||
| -rw-r--r-- | koffice-i18n-pt_BR/docs/koffice/kugar/starting.docbook | 100 | ||||
| -rw-r--r-- | koffice-i18n-pt_BR/docs/koffice/kugar/template-elements.docbook | 3577 | ||||
| -rw-r--r-- | koffice-i18n-pt_BR/docs/koffice/kugar/template.docbook | 515 | ||||
| -rw-r--r-- | koffice-i18n-pt_BR/docs/koffice/kugar/templatedtd.docbook | 522 | ||||
| -rw-r--r-- | koffice-i18n-pt_BR/docs/koffice/kugar/tutorial.docbook | 380 |
11 files changed, 6907 insertions, 0 deletions
diff --git a/koffice-i18n-pt_BR/docs/koffice/kugar/Makefile.am b/koffice-i18n-pt_BR/docs/koffice/kugar/Makefile.am new file mode 100644 index 00000000..babf802f --- /dev/null +++ b/koffice-i18n-pt_BR/docs/koffice/kugar/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = pt_BR +SUBDIRS = $(AUTODIRS) +KDE_DOCS = AUTO +KDE_MANS = AUTO diff --git a/koffice-i18n-pt_BR/docs/koffice/kugar/datadtd.docbook b/koffice-i18n-pt_BR/docs/koffice/kugar/datadtd.docbook new file mode 100644 index 00000000..cf4d7b97 --- /dev/null +++ b/koffice-i18n-pt_BR/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 +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Marcus</firstname +><surname +>Gama</surname +><affiliation +><address +><email +>marcus.gama@gmail.com</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +</sect1info> +<title +><sgmltag class="element" +>KugarData</sgmltag +> Definição de Tipo do Documento</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" +>Modelo</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="row-element" +>Linha</link +> EMPTY> + <!ATTLIST Row + <link linkend="level-att" +>nível</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_BR/docs/koffice/kugar/dataref.docbook b/koffice-i18n-pt_BR/docs/koffice/kugar/dataref.docbook new file mode 100644 index 00000000..4071b6df --- /dev/null +++ b/koffice-i18n-pt_BR/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 +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Marcus</firstname +><surname +>Gama</surname +><affiliation +><address +><email +>marcus.gama@gmail.com</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 coleção de linhas e colunas. Este documento não define tipos de dados e seus atributos. O modelo de relatório define informações de tipo de dados de coluna. </para> + +<para +>O criador do documento pode aplicar um estilo &XSL; de folha para um documento existente para convertê-lo para este formato. Se o &XSL; for usado, o criador pode aplicar macros customizados usando o &XSL; para cálculos de coluna, 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 de dados Kugar</title> +<para +>O elemento <sgmltag class="element" +>KugarData</sgmltag +> contém zero ou mais elementos <sgmltag class="element" +>Linha</sgmltag +>. Uma <sgmltag class="element" +>Linha</sgmltag +> deve contar um atributo <sgmltag class="attribute" +>nível</sgmltag +> com o valor correspondente ao nível de detalhe no modelo. Outros atributos representam colunas de dados. </para> +<para +><anchor id="template-att"/>O valor do atributo <sgmltag class="attribute" +>Modelo</sgmltag +> é a &URL; do modelo de relatório usada 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</title> + +<variablelist> + +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> + +<varlistentry> +<term +><anchor id="level-att"/><sgmltag class="attribute" +>nível</sgmltag +></term> +<listitem> +<para +>O valor do atributo indica qual detalhe no modelo de relatório é usado para exibir dados. Linhas podem conter vários conjuntos de colunas para vários níveis, de modo que nenhum atributo exceto o <sgmltag class="attribute" +>level</sgmltag +> pode ser determinado como #IMPLIED. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="column-att"/><sgmltag class="attribute" +>coluna</sgmltag +></term> +<listitem> +<para +>O nome do atributo é o nome da coluna, e usa o formato como fornecido na definição <sgmltag class="element" +>KugarData</sgmltag +>. O nome do atributo é usado no modelo de relatório para conectar os dados aos campos do relatório. </para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +</sect1> + diff --git a/koffice-i18n-pt_BR/docs/koffice/kugar/designer.docbook b/koffice-i18n-pt_BR/docs/koffice/kugar/designer.docbook new file mode 100644 index 00000000..f714fc66 --- /dev/null +++ b/koffice-i18n-pt_BR/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 +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Marcus</firstname +><surname +>Gama</surname +><affiliation +><address +><email +>marcus.gama@gmail.com</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Manual de Designer de Modelo de Relatório</title> + +<para +>O &kudesigner; permite a criação e modificação interativa das modificações nos modelos de relatórios, assim como a colocação das seções e dos itens dos relatórios em um 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 na tela. No momento presente, a escala é igual a 100% automaticamente e não poderá ser alterada.</para> + +<itemizedlist> +<title +>Cada modelo de relatório pode conter as seguintes seções de relatório:</title> +<listitem +><para +>Cabeçalho do Relatório</para +></listitem> +<listitem +><para +>Cabeçalho da Página</para +></listitem> +<listitem +><para +>Cabeçalho de Detalhes</para +></listitem> +<listitem +><para +>Detalhes</para +></listitem> +<listitem +><para +>Rodapé de Detalhes</para +></listitem> +<listitem +><para +>Rodapé da Página</para +></listitem> +<listitem +><para +>Rodapé do Relatório</para +></listitem> +</itemizedlist> + +<itemizedlist> +<title +>Seções do relatório podem conter os seguintes itens de relatório:</title> +<listitem +><para +>Rótulo</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 +>Seções e itens de relatório podem ser colocados no modelo de relatório usando menus ou barras de ferramentas.</para> + +<para +>Todos os elementos, como o modelo do relatório, a seção do relatório ou um ítem, possuem as suas próprias propriedades. Estas propriedades definem os parâmetros geométricos, textuais ou outros diversos. Cada vez que o elemento é colocado, é aplicado um conjunto de propriedades padrão. Por exemplo, quando é colocado o elemento <guilabel +>Legenda</guilabel +>, o valor da sua propriedade Text é configurado como <quote +>Text</quote +>.</para> + +<para +>Para mudas as propriedades, use o diálogo <guilabel +>Opções do Item do Relatório</guilabel +>. Este diálogo pode ser chamdo por um clique do &RMB; num item ou com o botão <guilabel +>Editar Propriedades</guilabel +> na <guilabel +>Barra de Ferramentas Editar</guilabel +>. Veja a captura de tela abaixo (propriedades para um item Campo): </para> + +<para +>Para excluir um item, clique com o &MMB; nele ou use o botão <guilabel +>Excluir</guilabel +> na <guilabel +>Barra de Ferramentas Editar</guilabel +>. </para> + +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="props.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Diálogo <guilabel +>Novo Relatório</guilabel +></phrase> +</textobject> +</mediaobject> +</screenshot> + +<variablelist> +<title +>A referência de menu do &kudesigner;</title> +<varlistentry> +<term +><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl; <keycap +>N</keycap +></keycombo +> </shortcut +> <guimenu +>Arquivo</guimenu +> <guimenuitem +>Novo</guimenuitem +> </menuchoice +></term> +<listitem> +<para +><action +>Traz</action +> o diálogo <guilabel +>Novo Relatório</guilabel +> para criar um novo modelo de relatório.</para> +<para +>Como foi visto na imagem, o tamanho da página do relatório, a orientação e as margens precisam ser configurados antes do relatório poder ser criado. </para> +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="file_new.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Diálogo <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 +>Arquivo</guimenu +> <guimenuitem +>Abrir...</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Abre</action +> um modelo de relatório anteriormente salvo.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Arquivo</guimenu +> <guimenuitem +>Abrir Recente</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Mostra</action +> uma lista com os modelos abertos recentemente. Selecione um arquivo para abrí-lo.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>S</keycap +> </keycombo +></shortcut +> <guimenu +>Arquivo</guimenu +> <guimenuitem +>Salvar</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Salva</action +> o modelo de relatório atual num arquivo texto no formato &XML;.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Arquivo</guimenu +> <guimenuitem +>Salvar Como...</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Salva</action +> o modelo de relatório atual num arquivo e fornece-lhe outro nome.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>W</keycap +> </keycombo +></shortcut +> <guimenu +>Arquivo</guimenu +> <guimenuitem +>Fechar</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Fecha</action +> o modelo de relatório atual.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>P</keycap +> </keycombo +></shortcut +> <guimenu +>Arquivo</guimenu +> <guimenuitem +>Imprimir</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Imprime...</action +> o modelo de relatório atual como texto no formato &XML;.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>Q</keycap +> </keycombo +></shortcut +> <guimenu +>Arquivo</guimenu +> <guimenuitem +>Sair</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Sai</action +> do programa.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Editar</guimenu +> <guimenuitem +>Limpar Seleção</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Cancela</action +> qualquer ação de edição, de modo que nenhum propriedade será editada ou itens excluídos.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Editar</guimenu +> <guimenuitem +>Editar Propriedades</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Edita</action +> propriedades do item selecionado.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Editar</guimenu +> <guimenuitem +>Excluir</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Exclui</action +> o item selecionado.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Seções</guimenu +> <guimenuitem +>Cabeçalho do Relatório</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca a seção Cabeçalho do Relatório</action +> no modelo do relatório.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Seções</guimenu +> <guimenuitem +>Cabeçalho da Página</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca a seção Cabeçalho da Página</action +> no modelo do relatório.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Seções</guimenu +> <guimenuitem +>Cabeçalho de Detalhes</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca a seção Cabeçalho de Detalhes</action +> no modelo do relatório.</para> +<para +>Antes de colocar a seção, a janela para <guilabel +>Adicionar Cabeçalho do Detalhe</guilabel +> será mostrada para indicar o nível de detalhe. O cabeçalho de Detalhe será adicionado à seção de detalhe no nível indicado.</para> +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="add_detail_header.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Diálogo <guilabel +>Adicionar Cabeçalho de Detalhe</guilabel +></phrase> +</textobject> +</mediaobject> +</screenshot> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Seções</guimenu +> <guimenuitem +>Detalhe</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca a seção Detalhe</action +> no modelo do relatório.</para> +<para +>Antes de colocar a seção, o diálogo <guilabel +>Adicionar Detalhe</guilabel +> será exibido para especificar o nível de detalhe.</para> +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="add_detail.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Diálogo <interface +>Adicionar Detalhe</interface +></phrase> +</textobject> +</mediaobject> +</screenshot> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Seções</guimenu +> <guimenuitem +>Rodapé de Detalhe</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca a seção Rodapé de Detalhe</action +> no modelo do relatório.</para> +<para +>Antes de colocar a seçã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 à seção de detalhe do nível indicado.</para> +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="add_detail_footer.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Diálogo <guilabel +>Adicionar Rodapé de Detalhe</guilabel +></phrase> +</textobject> +</mediaobject> +</screenshot> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Seções</guimenu +> <guimenuitem +>Rodapé de Página</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca a seção Rodapé de Página</action +> no modelo do relatório.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Seções</guimenu +> <guimenuitem +>Rodapé de Relatório</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca a seção Rodapé de Relatório</action +> no modelo do relatório.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Itens</guimenu +> <guimenuitem +>Limpar Seleção</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Limpa</action +> a seleção de item, de modo que nenhum item de relatório será adicionado à seção.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Itens</guimenu +> <guimenuitem +>Rótulo</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca o elemento Rótulo</action +> na seção.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Itens</guimenu +> <guimenuitem +>Campo</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca o elemento Campo</action +> na seçã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 seçã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 seção.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Itens</guimenu +> <guimenuitem +>Linha</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Coloca o elemento Linha</action +> na seção.</para +></listitem> +</varlistentry> + +</variablelist> +</chapter> diff --git a/koffice-i18n-pt_BR/docs/koffice/kugar/index.docbook b/koffice-i18n-pt_BR/docs/koffice/kugar/index.docbook new file mode 100644 index 00000000..389caa35 --- /dev/null +++ b/koffice-i18n-pt_BR/docs/koffice/kugar/index.docbook @@ -0,0 +1,207 @@ +<?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 % Brazilian-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 +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Marcus</firstname +><surname +>Gama</surname +><affiliation +><address +><email +>marcus.gama@gmail.com</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 gerador de relatórios &XML; baseado em modelos. O &kudesigner; é uma &GUI; flexível de desenho de modelos de relatório para o motor de relatórios do &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 +>designer</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;. Ele 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 usa um arquivo de modelo de relatório baseado em &XML; (que pode ser criado manualmente ou usando o &kudesigner;) e um arquivo de dados (também em formato &XML;) para criar relatórios. Para obter mais informações sobre o &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 uma visão geral do <acronym +>DTD</acronym +> (formato de arquivo) 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 sobre como criar relatórios. </para> + +<para +>Programadores devem também consultar o <link linkend="prog-guide" +>Guia do porgramador</link +> para encontrar informações sobre o uso do &kugar; nos seus próprios aplicativos.</para> +</chapter> + +&tutorial; + +&starting; + +&designermanual; + +&progguide; + +<chapter> +<title +>Créditos e Licença</title> + +<para +>&kugar; </para> + +<para +><trademark class="copyright" +>Copyright</trademark +> 2000 de Mutiny Bay Software </para> +<para +><trademark class="copyright" +>Copyright</trademark +> 2000-2001 de Phil Thompson </para> +<para +><trademark class="copyright" +>Copyright</trademark +> 2002 de Alexander Dymo </para> + +<para +>Partes da documentação com <trademark class="copyright" +>Copyright</trademark +> 2000-2001 de Phil Thompson e <trademark class="copyright" +>Copyright</trademark +> 2002 de Alexander Dymo</para> + +<para +>Tradução de Marcus Gama<email +>marcus.gama@gmail.com</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_BR/docs/koffice/kugar/progguide.docbook b/koffice-i18n-pt_BR/docs/koffice/kugar/progguide.docbook new file mode 100644 index 00000000..3c9a992b --- /dev/null +++ b/koffice-i18n-pt_BR/docs/koffice/kugar/progguide.docbook @@ -0,0 +1,671 @@ +<!-- 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 +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Marcus</firstname +><surname +>Gama</surname +><affiliation +><address +><email +>marcus.gama@gmail.com</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 em seus próprios programas</title> + +<itemizedlist> +<title +>Existem muitas maneiras de usar o &kugar;</title> +<listitem> +<para +>Crie um arquivo temporário e preencha-o com dados, organizados de acordo com a <link linkend="kugardata-dtd" +>Definição do Tipo de Documento KugarData</link +>. Em seguida, invoque o comando <command +>kugar</command +> ( <cmdsynopsis +> <command +>kugar</command +> <group +> <option +>-d <replaceable +>arquivo de dados do Kugar</replaceable +></option +> </group +> <group +> <option +>-r <replaceable +>arquivo de modelo do Kugar</replaceable +></option +> </group +> </cmdsynopsis +> ) para pré-visualizar e imprimir o relatório. Veja a seção <link linkend="prog-using-for-preview" +>Usando o &kugar; para pré-visualizar os relatórios</link +> para uma descrição detalhada. </para> +</listitem> +<listitem> +<para +>Use o &kugar; diretamente no código da aplicação. Veja a seção <link linkend="prog-using-widget" +>Usando 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 seção <link linkend="prog-designer-plugin" +>Criando 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 arquivos de dados. Assim, qualquer programa consegue produzir resultados no formato do arquivo de dados do &kugar; tal como está descrito na <link linkend="kugardata-dtd" +><acronym +>DTD</acronym +> do KugarData</link +> ou mesmo no formato de arquivo 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 pré-visualizar e imprimir os resultados gerados. </para> + +</sect1> + +<sect1 id="prog-using-for-preview"> +<title +>Usar o shell &kugar; para visualizar relatórios</title> + +<orderedlist> +<title +>A maneira de criar e pré-visualizar (impressão) um relatório é:</title> +<listitem> +<para +>Criar um arquivo de modelo de relatório com o &kudesigner; </para> +</listitem> +<listitem> +<para +>Criar uma arquivo de dados com valores de coluna para as bandas de detalhe do relatório. Use <link linkend="kugardata-dtd" +>KugarData <acronym +>DTD</acronym +></link +> para produzir arquivos de dados corretos. </para> +</listitem> +<listitem> +<para +>Executar o shell &kugar; para visualizar e imprimir um relatório. Por exemplo, para fazer isto, nas linguagens c ou c++ chame:</para> + +<programlisting +><function +>system(<option +>"kugar -r <replaceable +>arquivo_modelo.ktf</replaceable +>-d <replaceable +>arquivo_dados.kdf</replaceable +>"</option +>)</function +>. +</programlisting> + +<para +>Não esqueça de incluir <filename class="headerfile" +>stdlib.h</filename +>. </para> +</listitem> +</orderedlist> +</sect1> + +<sect1 id="prog-using-widget"> +<title +>Usar uma classe &kugar; para relatório</title> +<para +>A biblioteca &kugar; contém dois elementos para uso. </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 conseguir construir programas que usam a biblioteca do &kugar;, ele deve ser ligado com a biblioteca compartilhada <filename +>libkugar.so</filename +>, que é fornecida com a distribuição do &kugar; em todas as plataformas &UNIX;. </para> +<para +>Os arquivos de inclusão são o <filename +>kugarqt.h</filename +> e <filename +>kugar.h</filename +> para os programas &Qt; e &kde; respectivamente. </para> +<para +>Para um exemplo detalhado de como as classe do &kugar; podem ser usadas, veja a pasta <filename class="directory" +>/shell</filename +> nas fontes 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 +>Renderiza o relatório para um tela.</funcsynopsisinfo> +</funcsynopsis> + +<funcsynopsis> +<funcprototype> +<funcdef +>void <function +>printReport</function +></funcdef> +<void/> +</funcprototype> +<funcsynopsisinfo +>Chama o diálogo 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 na tela e libera os dados do relatório. Chame isto antes de abrir um novo relatório.</funcsynopsisinfo> +</funcsynopsis> + +<funcsynopsis> +<funcprototype +><funcdef +>bool <function +>setReportData</function +></funcdef +> <paramdef +>const QString &<parameter +>nome_arquivo_dados</parameter +></paramdef +> </funcprototype> +<funcsynopsisinfo +>Configura os dados do relatório a partir do arquivo <replaceable +>nome_arquivo_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 diretamente de um baco de dados, crie uma filha da classe <classname +>QIODevice</classname +> e redefina toda a funcionalidade necessária. </funcsynopsisinfo> +</funcsynopsis> + +<funcsynopsis> +<funcprototype +><funcdef +>bool <function +>setReportTemplate</function +></funcdef +> <paramdef +>const QString &<parameter +>nome_arquivo_modelo</parameter +></paramdef +> </funcprototype> +<funcsynopsisinfo +>Configura o modelo de relatório a partir do arquivo <replaceable +>nome_arquivo_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 um banco 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 um plugin de designer &Qt;</title> + +<para +>Este é o exemplo de código de como o plugin de designer é criado. O código abaixo cria um plugin para um widget &kde; <classname +>KReportViewer</classname +>. </para> + +<para +>Se um widget &Qt; é desejado, substitua <classname +>KReportViewer</classname +> com <classname +>MReportViewer</classname +> e <filename +>kugar.h</filename +> com <filename +>kugarqt.h</filename +> no código do plugin. </para> + +<sect2 id="plugin-usage"> +<title +>Uso do plugin</title> +<para +>O plugin do desenhador permitirá o uso do &Qt; Designer para colocar um elemento <classname +>KReportViewer</classname +> em uma janela e pré-visualizá-lo corretamente. </para> + +<para +>Programas que façam uso deste plugin devem ser linkados dinamicamente com ele. A biblioteca correspondente chama-se <filename +>libkugar_plugin.so</filename +>. Widgets ou diálogos que incluem o widget <classname +>KReportViewer</classname +> devem incluir <kugar.h> em implementação e ter uma declaração de repasse da <classname +>class KReportViewer</classname +>. Inclusões podem ser feitas com o Explorador de Objeto do Designer do &Qt; (Página Fonte). </para> + +<para +>Para construir 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 arquivos:</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 a classe <classname +>KugarWidgetPlugin</classname +>, filha de <classname +>QWidgetPlugin</classname +>;</seg> +<seg +>Um arquivo de código para a classe <classname +>KugarWidgetPlugin</classname +>, filha de <classname +>QWidgetPlugin</classname +>;</seg> +<seg +>Arquivo de projeto 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_BR/docs/koffice/kugar/starting.docbook b/koffice-i18n-pt_BR/docs/koffice/kugar/starting.docbook new file mode 100644 index 00000000..9835ed5b --- /dev/null +++ b/koffice-i18n-pt_BR/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 +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Marcus</firstname +><surname +>Gama</surname +><affiliation +><address +><email +>marcus.gama@gmail.com</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Iniciar o &kugar; e o &kudesigner;</title> +<para +>O programa &kugar; recebe dois argumentos de linha de comando: </para> + +<cmdsynopsis +><command +>kugar</command +> <group +> <option +>-d <replaceable +>arquivo de dados Kugar</replaceable +></option +> </group +> <group +> <option +>-r <replaceable +>arquivo 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 nome de arquivo 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_BR/docs/koffice/kugar/template-elements.docbook b/koffice-i18n-pt_BR/docs/koffice/kugar/template-elements.docbook new file mode 100644 index 00000000..1a1b407c --- /dev/null +++ b/koffice-i18n-pt_BR/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 +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Marcus</firstname +><surname +>Gama</surname +><affiliation +><address +><email +>marcus.gama@gmail.com</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +</sect1info> +<title +>Elementos de modelo <sgmltag class="element" +>KugarTemplate</sgmltag +></title> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Bandas de seção</entry> +<entry +>Elementos de seção</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 +>Seçõ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 seções do relatório que são comumente impressas no início e 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 #NECESSÁRIO + PrintFrequency CDATA #NECESSÁRIO> +</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 #NECESSÁRIO + PrintFrequency CDATA #NECESSÁRIO> +</synopsis> + +<variablelist> + +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="rhf-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Configura a altura da seção do relatório. Se você não deseja esta seção, configure o valor <sgmltag class="attvalue" +>0</sgmltag +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="rhf-printfrequency"/><sgmltag class="attribute" +>PrintFrequency</sgmltag +></term> +<listitem> +<para +>Configura a frequência de impressão da seçã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 +>Cada Página</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 +>Seçõ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 seções do relatório que são comumente usadas impressas em cada página 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 #NECESSÁRIO + PrintFrequency CDATA #NECESSÁRIO> +</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 #NECESSÁRIO + PrintFrequency CDATA #NECESSÁRIO> +</synopsis> + +<variablelist> + +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="phf-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Configura a altura da seção do relatório. Se você não deseja esta seção, configure o valor <sgmltag class="attvalue" +>0</sgmltag +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="phf-printfrequency"/><sgmltag class="attribute" +>PrintFrequency</sgmltag +></term> +<listitem> +<para +>Configura a frequência de impressão da seçã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 +>Cada Página</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 +>Seçõ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 seções do relatório que são impressas antes e após os detalhes do nível fornecido e abaixo do 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 #NECESSÁRIO + Level CDATA #NECESSÁRIO> +</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 #NECESSÁRIO + Level CDATA #NECESSÁRIO> +</synopsis> + +<variablelist> + +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="dhf-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Configura a altura da seção do relatório. Se você não deseja esta seção, configure o valor <sgmltag class="attvalue" +>0</sgmltag +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="dhf-level"/><sgmltag class="attribute" +>Level</sgmltag +></term> +<listitem> +<para +>Configura o nível na hierarquia da seção. Seções com níveis superiores serão impressas antes de seçõ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 +>Seção <sgmltag class="element" +>Detail</sgmltag +></title> + +<para +>O elemento <sgmltag class="element" +>Detail</sgmltag +> define a seção do relatório que contém os dados do relatório. O relatório pode possuir múltiplos detalhes, que são acessados pelo seu atributo nível de detalhe. </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 #NECESSÁRIO + Level CDATA #NECESSÁRIO> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="d-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Configura a altura da seção do relatório. Se você não deseja esta seção, configure o valor <sgmltag class="attvalue" +>0</sgmltag +>. </para> +</listitem> +</varlistentry> +<varlistentry> +<term +><anchor id="d-level"/><sgmltag class="attribute" +>Level</sgmltag +></term> +<listitem> +<para +>Configura o nível hierárquico da seção. As seções com níveis superior serão impressas antes das seçõ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 arquivo 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 objeto de relatório usado para desenhar linhas no relatório. </para> + +<synopsis +><!ELEMENT Line EMPTY> +<!ATTLIST Line + X1 CDATA #NECESSÁRIO + Y1 CDATA #NECESSÁRIO + X2 CDATA #NECESSÁRIO + Y2 CDATA #NECESSÁRIO + Width CDATA #NECESSÁRIO + Color CDATA #NECESSÁRIO + Style CDATA #NECESSÁRIO> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributos</term> +<listitem> +<variablelist> + +<varlistentry> +<term +><anchor id="l-x1"/><sgmltag class="attribute" +>X1</sgmltag +></term> +<listitem> +<para +>Configura a coordenada x de início (relativa ao canto superior esquerdo da seção) para a linha. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-y1"/><sgmltag class="attribute" +>Y1</sgmltag +></term> +<listitem> +<para +>Configura a coordenada y de início (relativa ao canto superior esquerdo da seção) para a linha. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-x2"/><sgmltag class="attribute" +>X2</sgmltag +></term> +<listitem> +<para +>Configura a coordenada x final (relativa ao canto superior esquerdo da seção) para a linha. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-y2"/><sgmltag class="attribute" +>Y2</sgmltag +></term> +<listitem> +<para +>Configura a coordenada y final (relativa ao canto superior esquerdo da seção) para a linha. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-width"/><sgmltag class="attribute" +>Width</sgmltag +></term> +<listitem> +<para +>Configura a largura da linha. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-color"/><sgmltag class="attribute" +>Color</sgmltag +></term> +<listitem> +<para +>Configura a cor da linha. A cor é definida como um valor RGB (Red Green Blue - Vermelho Verde Azul) (r,g,b). r, g e b devem estar no intervalo 0..255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-style"/><sgmltag class="attribute" +>Style</sgmltag +></term> +<listitem> +<para +>Configura o estilo de desenho para a 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ólida</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Tracejada</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Pontilhada</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 objeto do relatório usado para desenhar texto fixo de um relatório. </para> + +<synopsis +><!ELEMENT Label EMPTY> + <!ATTLIST Label + Text CDATA #NECESSÁRIO + X CDATA #NECESSÁRIO + Y CDATA #NECESSÁRIO + Width CDATA #NECESSÁRIO + Height CDATA #NECESSÁRIO + BackgroundColor CDATA #NECESSÁRIO + ForegroundColor CDATA #NECESSÁRIO + BorderColor CDATA #NECESSÁRIO + BorderWidth CDATA #NECESSÁRIO + BorderStyle CDATA #NECESSÁRIO + FontFamily CDATA #NECESSÁRIO + FontSize CDATA #NECESSÁRIO + FontWeight CDATA #NECESSÁRIO + FontItalic CDATA #NECESSÁRIO + HAlignment CDATA #NECESSÁRIO + VAlignment CDATA #NECESSÁRIO + WordWrap CDATA #NECESSÁRIO> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="la-text"/><sgmltag class="attribute" +>Text</sgmltag +></term> +<listitem> +<para +>Configura o texto do rótulo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-x"/><sgmltag class="attribute" +>X</sgmltag +></term> +<listitem> +<para +>Configura a coordenada x (relativa ao canto superior esquerdo da seção) para posicionar o rótulo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-y"/><sgmltag class="attribute" +>Y</sgmltag +></term> +<listitem> +<para +>Configura a coordenada y (relativa ao canto superior esquerdo da seção) para posicionar o rótulo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-width"/><sgmltag class="attribute" +>Width</sgmltag +></term> +<listitem> +<para +>Configura a largura do rótulo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Configura a altura do rótulo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-backgroundcolor"/><sgmltag class="attribute" +>BackgroundColor</sgmltag +></term> +<listitem> +<para +>Configura a cor do fundo do rótulo. A cor é definida como um valor RGB (Red Green Blue - Vermelho Verde Azul) (r,g,b). r, g e b devem estar no intervalo 0..255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-foregroundcolor"/><sgmltag class="attribute" +>ForegroundColor</sgmltag +></term> +<listitem> +<para +>Configura a cor do texto do rótulo. A cor é definida como um valor RGB (Red Green Blue - Vermelho Verde Azul) (r,g,b). r, g e b devem estar no intervalo 0..255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-bordercolor"/><sgmltag class="element" +>BorderColor</sgmltag +></term> +<listitem> +<para +>Configura a cor da borda do rótulo. A cor é definida como um valor RGB (Red Green Blue - Vermelho Verde Azul) (r,g,b). r, g e b devem estar no intervalo 0..255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-borderwidth"/><sgmltag class="element" +>BorderWidth</sgmltag +></term> +<listitem> +<para +>Configura a espessura da borda do rótulo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-borderstyle"/><sgmltag class="element" +>BorderStyle</sgmltag +></term> +<listitem> +<para +>Configura o estilo da borda para o rótulo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Estilo de Borda</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ólida</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Tracejada</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Pontilhada</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 +>Configura o tipo de fonte para o texto do rótulo. </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 +>Configura o tamanho da fonte para o texto do rótulo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-fontweight"/><sgmltag class="attribute" +>FontWeight</sgmltag +></term> +<listitem> +<para +>Configura o peso da fonte para o texto do rótulo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Peso da Fonte</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 +>Configura o sinalizador de itálico para o texto do rótulo. </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 +>Falso</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Verdadeiro</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-halignment"/><sgmltag class="attribute" +>HAlignment</sgmltag +></term> +<listitem> +<para +>Configura o alinhamento horizontal do texto do rótulo. </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 +>Esquerdo</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Centralizado</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Direito</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-valignment"/><sgmltag class="attribute" +>VAlignment</sgmltag +></term> +<listitem> +<para +>Configura o alinhamento vertical do texto do rótulo. </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 +>Inferior</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-wordwrap"/><sgmltag class="attribute" +>WordWrap</sgmltag +></term> +<listitem> +<para +>Configura o sinalizador de quebra de linha para o texto do rótulo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Quebra de Linha</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Falso</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Verdadeiro</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" +>Field</sgmltag +> define um objeto de relatório usado para desenhar dados no relatório. </para> + +<synopsis +><!ELEMENT Field EMPTY> +<!ATTLIST Field + Field CDATA #NECESSÁRIO + Text CDATA #NECESSÁRIO + X CDATA #NECESSÁRIO + Y CDATA #NECESSÁRIO + Width CDATA #NECESSÁRIO + Height CDATA #NECESSÁRIO + BackgroundColor CDATA #NECESSÁRIO + ForegroundColor CDATA #NECESSÁRIO + BorderColor CDATA #NECESSÁRIO + BorderWidth CDATA #NECESSÁRIO + BorderStyle CDATA #NECESSÁRIO + FontFamily CDATA #NECESSÁRIO + FontSize CDATA #NECESSÁRIO + FontWeight CDATA #NECESSÁRIO + FontItalic CDATA #NECESSÁRIO + HAlignment CDATA #NECESSÁRIO + VAlignment CDATA #NECESSÁRIO + WordWrap CDATA #NECESSÁRIO + DataType CDATA #NECESSÁRIO + DateFormat CDATA #NECESSÁRIO + Precision CDATA #NECESSÁRIO + Currency CDATA #NECESSÁRIO + NegValueColor CDATA #NECESSÁRIO + CommaSeparator CDATA #NECESSÁRIO> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="f-field"/><sgmltag class="attribute" +>Field</sgmltag +></term> +<listitem> +<para +>Configura o campo de dados do objeto. Isto é um atributo do elemento <sgmltag class="attribute" +>row</sgmltag +> no arquivo 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 +>Configura a coordenada x (relativa ao canto superior esquerdo da seção) para posicionar o campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-y"/><sgmltag class="attribute" +>Y</sgmltag +></term> +<listitem> +<para +>Configura a coordenada y (relativa ao canto superior esquerdo da seção) para posicionar o campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-width"/><sgmltag class="attribute" +>Width</sgmltag +></term> +<listitem> +<para +>Configura a largura do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Configura a altura do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-backgroundcolor"/><sgmltag class="attribute" +>BackgroundColor</sgmltag +></term> +<listitem> +<para +>Configura a cor de fundo do campo. A cor é definida como um valor RGB (Red Green Blue - Vermelho Verde Azul) (r,g,b). r, g e b devem estar no intervalo 0..255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-foregroundcolor"/><sgmltag class="attribute" +>ForegroundColor</sgmltag +></term> +<listitem> +<para +>Configura a cor do texto do campo. A cor é definida como um valor RGB (Red Green Blue - Vermelho Verde Azul) (r,g,b). r, g e b devem estar no intervalo 0..255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-bordercolor"/><sgmltag class="attribute" +>BorderColor</sgmltag +></term> +<listitem> +<para +>Configura a cor da borda do campo. A cor é definida como um valor RGB (Red Green Blue - Vermelho Verde Azul) (r,g,b). r, g e b devem estar no intervalo 0..255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-borderwidth"/><sgmltag class="element" +>BorderWidth</sgmltag +></term> +<listitem> +<para +>Configura a espessura da borda para o campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-borderstyle"/><sgmltag class="element" +>BorderStyle</sgmltag +></term> +<listitem> +<para +>Configura o estilo da borda para o campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Estilo de Borda</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ólida</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Tracejada</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Pontilhada</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 +>Configura o tipo de fonte para o 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 +>Configura o tamanho da fonte para o texto do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-fontweight"/><sgmltag class="attribute" +>FontWeight</sgmltag +></term> +<listitem> +<para +>Configura o peso da fonte para o texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Peso da Fonte</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 +>Configura o sinalizador de itálico para 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 +>Falso</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Verdadeiro</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-halignment"/><sgmltag class="attribute" +>HAlignment</sgmltag +></term> +<listitem> +<para +>Configura 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 +>Esquerdo</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Centralizado</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Direito</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-valignment"/><sgmltag class="attribute" +>VAlignment</sgmltag +></term> +<listitem> +<para +>Configura 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 +>Inferior</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-wordwrap"/><sgmltag class="attribute" +>WordWrap</sgmltag +></term> +<listitem> +<para +>Configura a quebra de linha para o texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Quebra de Linha</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Falso</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Verdadeiro</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> +<!--</variablelist> +</listitem> +</varlistentry +>--> + +<varlistentry> +<term +><anchor id="f-datatype"/><sgmltag class="attribute" +>DataType</sgmltag +></term> +<listitem> +<para +>Configura o tipo de dados do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Tipos de Dados</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>String</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Inteiro</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Flutuante</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Data</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Monetário</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-dateformat"/><sgmltag class="attribute" +>DateFormat</sgmltag +></term> +<listitem> +<para +>Configura 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; caso contrário o formato original de data é utilizado. Se o tipo de dados não for data, defina esta opção como <sgmltag class="attvalue" +>0</sgmltag +>. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Formato de 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 +>Configura a precisão numérica do campo. Se o tipo de dados não é numérico, configure como 0. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-currency"/><sgmltag class="attribute" +>Monetário</sgmltag +></term> +<listitem> +<para +>Configura o símbolo monetário do campo. Se o tipo de dados não é monetário configure com 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 +>Configura a cor para valores negativos. A cor é definida como um valor RGB (Red Green Blue - Vermelho Verde Azul) (r,g,b). r, g e b devem estar no intervalo 0..255. Se o dado não for do tipo numérico, configure para 255,0,0. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-commaseparator"/><sgmltag class="attribute" +>CommaSeparator</sgmltag +></term> +<listitem> +<para +>Configura se as virgulas serão usadas ou não nos campos numéricos. Se o tipo de dados não for numérico configure o valor <sgmltag class="attvalue" +>0</sgmltag +>. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Vírgula Separadora</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Falso</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Verdadeiro</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 objeto do relatório usado para desenhar valores calculados no relatório. </para> + +<synopsis +><!ELEMENT CalculatedField EMPTY> +<!ATTLIST CalculatedField + CalculationType CDATA #NECESSÁRIO + Field CDATA #NECESSÁRIO + Text CDATA #NECESSÁRIO + X CDATA #NECESSÁRIO + Y CDATA #NECESSÁRIO + Width CDATA #NECESSÁRIO + Height CDATA #NECESSÁRIO + BackgroundColor CDATA #NECESSÁRIO + ForegroundColor CDATA #NECESSÁRIO + BorderColor CDATA #NECESSÁRIO + BorderWidth CDATA #NECESSÁRIO + BorderStyle CDATA #NECESSÁRIO + FontFamily CDATA #NECESSÁRIO + FontSize CDATA #NECESSÁRIO + FontWeight CDATA #NECESSÁRIO + FontItalic CDATA #NECESSÁRIO + HAlignment CDATA #NECESSÁRIO + VAlignment CDATA #NECESSÁRIO + WordWrap CDATA #NECESSÁRIO + DataType CDATA #NECESSÁRIO + DateFormat CDATA #NECESSÁRIO + Precision CDATA #NECESSÁRIO + Currency CDATA #NECESSÁRIO + NegValueColor CDATA #NECESSÁRIO + CommaSeparator CDATA #NECESSÁRIO> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="c-calculationtype"/><sgmltag class="attribute" +>CalculationType</sgmltag +></term> +<listitem> +<para +>Configura 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 +>Contar</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Somatório</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Média</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Variação</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 +>Configura o campo de dados do objeto. Isto é um atributo do elemento <sgmltag class="attribute" +>row</sgmltag +> no arquivo 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 +>Configura a coordenada x (relativa ao canto superior esquerdo da seção) para posicionar o campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-y"/><sgmltag class="attribute" +>Y</sgmltag +></term> +<listitem> +<para +>Configura a coordenada y (relativa ao canto superior esquerdo da seção) para posicionar o campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-width"/><sgmltag class="attribute" +>Width</sgmltag +></term> +<listitem> +<para +>Configura a largura do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Configura a altura do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-backgroundcolor"/><sgmltag class="attribute" +>BackgroundColor</sgmltag +></term> +<listitem> +<para +>Configura a cor de fundo do campo. A cor é definida como um valor RGB (Red Green Blue - Vermelho Verde Azul) (r,g,b). r, g e b devem estar no intervalo 0..255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-foregroundcolor"/><sgmltag class="attribute" +>ForegroundColor</sgmltag +></term> +<listitem> +<para +>Configura a cor do texto do campo. A cor é definida como um valor RGB (Red Green Blue - Vermelho Verde Azul) (r,g,b). r, g e b devem estar no intervalo 0..255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-bordercolor"/><sgmltag class="attribute" +>BorderColor</sgmltag +></term> +<listitem> +<para +>Configura a cor da borda do campo. A cor é definida como um valor RGB (Red Green Blue - Vermelho Verde Azul) (r,g,b). r, g e b devem estar no intervalo 0..255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-borderwidth"/><sgmltag class="element" +>BorderWidth</sgmltag +></term> +<listitem> +<para +>Configura a espessura da borda para o campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-borderstyle"/><sgmltag class="element" +>BorderStyle</sgmltag +></term> +<listitem> +<para +>Configura o estilo da borda para o campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Estilo de Borda</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ólida</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Tracejada</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Pontilhada</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 +>Configura o tipo de fonte para o 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 +>Configura o tamanho da fonte para o texto do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-fontweight"/><sgmltag class="attribute" +>FontWeight</sgmltag +></term> +<listitem> +<para +>Configura o peso da fonte para o texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Peso da Fonte</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 +>Configura o sinalizador de itálico para 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 +>Falso</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Verdadeiro</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-halignment"/><sgmltag class="attribute" +>HAlignment</sgmltag +></term> +<listitem> +<para +>Configura 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 +>Esquerdo</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Centralizado</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Direito</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-valignment"/><sgmltag class="attribute" +>VAlignment</sgmltag +></term> +<listitem> +<para +>Configura 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 +>Inferior</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-wordwrap"/><sgmltag class="attribute" +>WordWrap</sgmltag +></term> +<listitem> +<para +>Configura a quebra de linha para o texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Quebra de Linha</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Falso</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Verdadeiro</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-datatype"/><sgmltag class="attribute" +>DataType</sgmltag +></term> +<listitem> +<para +>Configura o tipo de dados do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Tipos de Dados</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>String</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Inteiro</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Flutuante</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Data</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Monetário</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-dateformat"/><sgmltag class="attribute" +>DateFormat</sgmltag +></term> +<listitem> +<para +>Configura 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; caso contrário o formato original de data é utilizado. Se o tipo de dados não for data, defina esta opção como <sgmltag class="attvalue" +>0</sgmltag +>. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Formato de 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 +>Configura a precisão numérica do campo. Se o tipo de dados não é numérico, configure como 0. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-currency"/><sgmltag class="attribute" +>Monetário</sgmltag +></term> +<listitem> +<para +>Configura o símbolo monetário do campo. Se o tipo de dados não é monetário configure 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 +>Configura a cor para valores negativos. A cor é definida como um valor RGB (Red Green Blue - Vermelho Verde Azul) (r,g,b). r, g e b devem estar no intervalo 0..255. Se o dado não for do tipo numérico, configure para 255,0,0. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-commaseparator"/><sgmltag class="attribute" +>CommaSeparator</sgmltag +></term> +<listitem> +<para +>Configura se as virgulas serão usadas ou não nos campos numéricos. Se o tipo de dados não for numérico configure o valor <sgmltag class="attvalue" +>0</sgmltag +>. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Vírgula Separadora</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Falso</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Verdadeiro</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 objeto do relatório usado para desenhar números de página e a data atual no relatório. </para> + +<synopsis +><!ELEMENT Special EMPTY> +<!ATTLIST Special + Type CDATA #NECESSÁRIO + Text CDATA #NECESSÁRIO + X CDATA #NECESSÁRIO + Y CDATA #NECESSÁRIO + Width CDATA #NECESSÁRIO + Height CDATA #NECESSÁRIO + BackgroundColor CDATA #NECESSÁRIO + ForegroundColor CDATA #NECESSÁRIO + BorderColor CDATA #NECESSÁRIO + BorderWidth CDATA #NECESSÁRIO + BorderStyle CDATA #NECESSÁRIO + FontFamily CDATA #NECESSÁRIO + FontSize CDATA #NECESSÁRIO + FontWeight CDATA #NECESSÁRIO + FontItalic CDATA #NECESSÁRIO + HAlignment CDATA #NECESSÁRIO + VAlignment CDATA #NECESSÁRIO + WordWrap CDATA #NECESSÁRIO + DateFormat CDATA #NECESSÁRIO> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributos</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="s-type"/><sgmltag class="attribute" +>Tipo</sgmltag +></term> +<listitem> +<para +>Configura o tipo do objeto especial. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Tipe</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Data Atual</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 +>Configura a coordenada x (relativa ao canto superior esquerdo da seção) para posicionar o campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-y"/><sgmltag class="attribute" +>Y</sgmltag +></term> +<listitem> +<para +>Configura a coordenada y (relativa ao canto superior esquerdo da seção) para posicionar o campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-width"/><sgmltag class="attribute" +>Width</sgmltag +></term> +<listitem> +<para +>Configura a largura do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-height"/><sgmltag class="attribute" +>Height</sgmltag +></term> +<listitem> +<para +>Configura a altura do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-backgroundcolor"/><sgmltag class="attribute" +>BackgroundColor</sgmltag +></term> +<listitem> +<para +>Configura a cor de fundo do campo. A cor é definida como um valor RGB (Red Green Blue - Vermelho Verde Azul) (r,g,b). r, g e b devem estar no intervalo 0..255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-foregroundcolor"/><sgmltag class="attribute" +>ForegroundColor</sgmltag +></term> +<listitem> +<para +>Configura a cor do texto do campo. A cor é definida como um valor RGB (Red Green Blue - Vermelho Verde Azul) (r,g,b). r, g e b devem estar no intervalo 0..255. </para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +><anchor id="s-bordercolor"/><sgmltag class="attribute" +>BorderColor</sgmltag +></term> +<listitem> +<para +>Configura a cor da borda do campo. A cor é definida como um valor RGB (Red Green Blue - Vermelho Verde Azul) (r,g,b). r, g e b devem estar no intervalo 0..255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-borderwidth"/><sgmltag class="element" +>BorderWidth</sgmltag +></term> +<listitem> +<para +>Configura a espessura da borda para o campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-borderstyle"/><sgmltag class="element" +>BorderStyle</sgmltag +></term> +<listitem> +<para +>Configura o estilo da borda para o campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Estilo de Borda</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ólida</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Tracejada</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Pontilhada</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 +>Configura o tipo de fonte para o 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 +>Configura o tamanho da fonte para o texto do campo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-fontweight"/><sgmltag class="attribute" +>FontWeight</sgmltag +></term> +<listitem> +<para +>Configura o peso da fonte para o texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Peso da Fonte</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 +>Configura o sinalizador de itálico para 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 +>Falso</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Verdadeiro</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-halignment"/><sgmltag class="attribute" +>HAlignment</sgmltag +></term> +<listitem> +<para +>Configura 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 +>Esquerdo</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Centralizado</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Direito</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-valignment"/><sgmltag class="attribute" +>VAlignment</sgmltag +></term> +<listitem> +<para +>Configura 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 +>Inferior</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-wordwrap"/><sgmltag class="attribute" +>WordWrap</sgmltag +></term> +<listitem> +<para +>Configura a quebra de linha para o texto do campo. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Quebra de Linha</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Falso</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Verdadeiro</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-dateformat"/><sgmltag class="attribute" +>DateFormat</sgmltag +></term> +<listitem> +<para +>Configura 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; caso contrário o formato original de data é utilizado. Se o tipo de dados não for data, defina esta opção como <sgmltag class="attvalue" +>0</sgmltag +>. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Formato de 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 +>Configura a precisão numérica do campo. Se o tipo de dados não é numérico, configure como 0. </para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +</sect1> + + + diff --git a/koffice-i18n-pt_BR/docs/koffice/kugar/template.docbook b/koffice-i18n-pt_BR/docs/koffice/kugar/template.docbook new file mode 100644 index 00000000..0473ba93 --- /dev/null +++ b/koffice-i18n-pt_BR/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 +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Marcus</firstname +><surname +>Gama</surname +><affiliation +><address +><email +>marcus.gama@gmail.com</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 de relatório relacionados ao tamanho da 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 #NECESSÁRIO +PageOrientation CDATA #NECESSÁRIO +TopMargin CDATA #NECESSÁRIO +BottomMargin CDATA #NECESSÁRIO +LeftMargin CDATA #NECESSÁRIO +RightMargin CDATA #NECESSÁRIO> +</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 seções do relatório que são comumente 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 seções do relatório que são comumente impressar na parte superior 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 seçõ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 seçã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 seções do relatório que são impressas após os detalhes de um nível fornecido e na parte inferior do 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 seções do relatório que são comumente impressas no fim 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 seções do relatório que são comumente impressas no final 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 +>Configura o tamanho da página do relatório. Os seguintes valores estão disponíveis: </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 +>Fólio</entry> +</row> +<row> +<entry +>28</entry> +<entry +>Livro</entry> +</row> +<row> +<entry +>29</entry> +<entry +>Tablóide</entry> +</row> +<row> +<entry +>30</entry> +<entry +>TamanhoPáginaN</entry> +</row> + +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="kut-pageorient"/><sgmltag class="attribute" +>PageOrientation</sgmltag +></term> +<listitem> +<para +>Configura a orientação da página. </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 +>Configura 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 +>Configura 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 +>Configura 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 +>Configura a margem direita da página do relatório. </para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> +</sect1> diff --git a/koffice-i18n-pt_BR/docs/koffice/kugar/templatedtd.docbook b/koffice-i18n-pt_BR/docs/koffice/kugar/templatedtd.docbook new file mode 100644 index 00000000..aed95bda --- /dev/null +++ b/koffice-i18n-pt_BR/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 +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Marcus</firstname +><surname +>Gama</surname +><affiliation +><address +><email +>marcus.gama@gmail.com</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +</sect1info> +<title +>O Definição de Tipo de Documento 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 #NECESSÁRIO + <link linkend="kut-pageorient" +>PageOrientation</link +> CDATA #NECESSÁRIO + <link linkend="kut-topmargin" +>TopMargin</link +> CDATA #NECESSÁRIO + <link linkend="kut-botmargin" +>BottomMargin</link +> CDATA #NECESSÁRIO + <link linkend="kut-leftmargin" +>LeftMargin</link +> CDATA #NECESSÁRIO + <link linkend="kut-rightmargin" +>RightMargin</link +> CDATA #NECESSÁRIO> + + <!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 #NECESSÁRIO + <link linkend="rhf-printfrequency" +>PrintFrequency</link +> CDATA #NECESSÁRIO> + + <!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 #NECESSÁRIO + <link linkend="phf-printfrequency" +>PrintFrequency</link +> CDATA #NECESSÁRIO> + + <!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 #NECESSÁRIO + <link linkend="dhf-level" +>Level</link +> CDATA #NECESSÁRIO> + + <!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 #NECESSÁRIO + <link linkend="d-level" +>Level</link +> CDATA #NECESSÁRIO> + + <!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 #NECESSÁRIO + <link linkend="dhf-level" +>Level</link +> CDATA #NECESSÁRIO> + + <!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 #NECESSÁRIO + <link linkend="phf-printfrequency" +>PrintFrequency</link +> CDATA #NECESSÁRIO> + + <!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 #NECESSÁRIO + <link linkend="rhf-printfrequency" +>PrintFrequency</link +> CDATA #NECESSÁRIO> + + <!ELEMENT <link linkend="line-element" +>Line</link +> EMPTY> + <!ATTLIST Line + <link linkend="l-x1" +>X1</link +> CDATA #NECESSÁRIO + <link linkend="l-y1" +>Y1</link +> CDATA #NECESSÁRIO + <link linkend="l-x2" +>X2</link +> CDATA #NECESSÁRIO + <link linkend="l-y2" +>Y2</link +> CDATA #NECESSÁRIO + <link linkend="l-width" +>Width</link +> CDATA #NECESSÁRIO + <link linkend="l-color" +>Color</link +> CDATA #NECESSÁRIO + <link linkend="l-style" +>Style</link +> CDATA #NECESSÁRIO> + + <!ELEMENT <link linkend="label-element" +>Label</link +> EMPTY> + <!ATTLIST Label + <link linkend="la-text" +>Text</link +> CDATA #NECESSÁRIO + <link linkend="la-x" +>X</link +> CDATA #NECESSÁRIO + <link linkend="la-y" +>Y</link +> CDATA #NECESSÁRIO + <link linkend="la-width" +>Width</link +> CDATA #NECESSÁRIO + <link linkend="la-height" +>Height</link +> CDATA #NECESSÁRIO + <link linkend="la-backgroundcolor" +>BackgroundColor</link +> CDATA #NECESSÁRIO + <link linkend="la-foregroundcolor" +>ForegroundColor</link +> CDATA #NECESSÁRIO + <link linkend="la-bordercolor" +>BorderColor</link +> CDATA #NECESSÁRIO + <link linkend="la-borderwidth" +>BorderWidth</link +> CDATA #NECESSÁRIO + <link linkend="la-borderstyle" +>BorderStyle</link +> CDATA #NECESSÁRIO + <link linkend="la-fontfamily" +>FontFamily</link +> CDATA #NECESSÁRIO + <link linkend="la-fontsize" +>FontSize</link +> CDATA #NECESSÁRIO + <link linkend="la-fontweight" +>FontWeight</link +> CDATA #NECESSÁRIO + <link linkend="la-fontitalic" +>FontItalic</link +> CDATA #NECESSÁRIO + <link linkend="la-halignment" +>HAlignment</link +> CDATA #NECESSÁRIO + <link linkend="la-valignment" +>VAlignment</link +> CDATA #NECESSÁRIO + <link linkend="la-wordwrap" +>WordWrap</link +> CDATA #NECESSÁRIO> + + <!ELEMENT <link linkend="field-element" +>Field</link +> EMPTY> + <!ATTLIST Field + <link linkend="f-field" +>Field</link +> CDATA #NECESSÁRIO + <link linkend="f-text" +>Text</link +> CDATA #NECESSÁRIO + <link linkend="f-x" +>X</link +> CDATA #NECESSÁRIO + <link linkend="f-y" +>Y</link +> CDATA #NECESSÁRIO + <link linkend="f-width" +>Width</link +> CDATA #NECESSÁRIO + <link linkend="f-height" +>Height</link +> CDATA #NECESSÁRIO + <link linkend="f-backgroundcolor" +>BackgroundColor</link +> CDATA #NECESSÁRIO + <link linkend="f-foregroundcolor" +>ForegroundColor</link +> CDATA #NECESSÁRIO + <link linkend="f-bordercolor" +>BorderColor</link +> CDATA #NECESSÁRIO + <link linkend="f-borderwidth" +>BorderWidth</link +> CDATA #NECESSÁRIO + <link linkend="f-borderstyle" +>BorderStyle</link +> CDATA #NECESSÁRIO + <link linkend="f-fontfamily" +>FontFamily</link +> CDATA #NECESSÁRIO + <link linkend="f-fontsize" +>FontSize</link +> CDATA #NECESSÁRIO + <link linkend="f-fontweight" +>FontWeight</link +> CDATA #NECESSÁRIO + <link linkend="f-fontitalic" +>FontItalic</link +> CDATA #NECESSÁRIO + <link linkend="f-halignment" +>HAlignment</link +> CDATA #NECESSÁRIO + <link linkend="f-valignment" +>VAlignment</link +> CDATA #NECESSÁRIO + <link linkend="f-wordwrap" +>WordWrap</link +> CDATA #NECESSÁRIO + <link linkend="f-datatype" +>DataType</link +> CDATA #NECESSÁRIO + <link linkend="f-dateformat" +>DateFormat</link +> CDATA #NECESSÁRIO + <link linkend="f-precision" +>Precision</link +> CDATA #NECESSÁRIO + <link linkend="f-currency" +>Currency</link +> CDATA #NECESSÁRIO + <link linkend="f-negvaluecolor" +>NegValueColor</link +> CDATA #NECESSÁRIO + <link linkend="f-commaseparator" +>CommaSeparator</link +> CDATA #NECESSÁRIO> + + <!ELEMENT <link linkend="calculated-field-element" +>CalculatedField</link +> EMPTY> + <!ATTLIST CalculatedField + <link linkend="c-calculationtype" +>CalculationType</link +> CDATA #NECESSÁRIO + <link linkend="c-field" +>Field</link +> CDATA #NECESSÁRIO + <link linkend="c-text" +>Text</link +> CDATA #NECESSÁRIO + <link linkend="c-x" +>X</link +> CDATA #NECESSÁRIO + <link linkend="c-y" +>Y</link +> CDATA #NECESSÁRIO + <link linkend="c-width" +>Width</link +> CDATA #NECESSÁRIO + <link linkend="c-height" +>Height</link +> CDATA #NECESSÁRIO + <link linkend="c-backgroundcolor" +>BackgroundColor</link +> CDATA #NECESSÁRIO + <link linkend="c-foregroundcolor" +>ForegroundColor</link +> CDATA #NECESSÁRIO + <link linkend="c-bordercolor" +>BorderColor</link +> CDATA #NECESSÁRIO + <link linkend="c-borderwidth" +>BorderWidth</link +> CDATA #NECESSÁRIO + <link linkend="c-borderstyle" +>BorderStyle</link +> CDATA #NECESSÁRIO + <link linkend="c-fontfamily" +>FontFamily</link +> CDATA #NECESSÁRIO + <link linkend="c-fontsize" +>FontSize</link +> CDATA #NECESSÁRIO + <link linkend="c-fontweight" +>FontWeight</link +> CDATA #NECESSÁRIO + <link linkend="c-fontitalic" +>FontItalic</link +> CDATA #NECESSÁRIO + <link linkend="c-halignment" +>HAlignment</link +> CDATA #NECESSÁRIO + <link linkend="c-valignment" +>VAlignment</link +> CDATA #NECESSÁRIO + <link linkend="c-wordwrap" +>WordWrap</link +> CDATA #NECESSÁRIO + <link linkend="c-datatype" +>DataType</link +> CDATA #NECESSÁRIO + <link linkend="c-dateformat" +>DateFormat</link +> CDATA #NECESSÁRIO + <link linkend="c-precision" +>Precision</link +> CDATA #NECESSÁRIO + <link linkend="c-currency" +>Currency</link +> CDATA #NECESSÁRIO + <link linkend="c-negvaluecolor" +>NegValueColor</link +> CDATA #NECESSÁRIO + <link linkend="c-commaseparator" +>CommaSeparator</link +> CDATA #NECESSÁRIO> + + <!ELEMENT <link linkend="special-element" +>Special</link +> EMPTY> + <!ATTLIST Special + <link linkend="s-type" +>Type</link +> CDATA #NECESSÁRIO + <link linkend="s-text" +>Text</link +> CDATA #NECESSÁRIO + <link linkend="s-x" +>X</link +> CDATA #NECESSÁRIO + <link linkend="s-y" +>Y</link +> CDATA #NECESSÁRIO + <link linkend="s-width" +>Width</link +> CDATA #NECESSÁRIO + <link linkend="s-height" +>Height</link +> CDATA #NECESSÁRIO + <link linkend="s-backgroundcolor" +>BackgroundColor</link +> CDATA #NECESSÁRIO + <link linkend="s-foregroundcolor" +>ForegroundColor</link +> CDATA #NECESSÁRIO + <link linkend="s-bordercolor" +>BorderColor</link +> CDATA #NECESSÁRIO + <link linkend="s-borderwidth" +>BorderWidth</link +> CDATA #NECESSÁRIO + <link linkend="s-borderstyle" +>BorderStyle</link +> CDATA #NECESSÁRIO + <link linkend="s-fontfamily" +>FontFamily</link +> CDATA #NECESSÁRIO + <link linkend="s-fontsize" +>FontSize</link +> CDATA #NECESSÁRIO + <link linkend="s-fontweight" +>FontWeight</link +> CDATA #NECESSÁRIO + <link linkend="s-fontitalic" +>FontItalic</link +> CDATA #NECESSÁRIO + <link linkend="s-halignment" +>HAlignment</link +> CDATA #NECESSÁRIO + <link linkend="s-valignment" +>VAlignment</link +> CDATA #NECESSÁRIO + <link linkend="s-wordwrap" +>WordWrap</link +> CDATA #NECESSÁRIO + <link linkend="s-dateformat" +>DateFormat</link +> CDATA #NECESSÁRIO> + ]> +</synopsis> +</sect1> diff --git a/koffice-i18n-pt_BR/docs/koffice/kugar/tutorial.docbook b/koffice-i18n-pt_BR/docs/koffice/kugar/tutorial.docbook new file mode 100644 index 00000000..61e7d90b --- /dev/null +++ b/koffice-i18n-pt_BR/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 +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Marcus</firstname +><surname +>Gama</surname +><affiliation +><address +><email +>marcus.gama@gmail.com</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Tutorial</title> + +<para +>Este tutorial tenta ser uma rápida introdução ao Kugar.</para> + +<para +>Você criará um modelo de relatório exemplo com o &kudesigner;, um arquivo de dados exemplo e finalmente irá gerar um relatório completo.</para> + +<para +>O código-fonte para os modelos dos exemplos e os arquivos 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 +>Criando um modelo de relatório com o &kudesigner;</title> + +<para +>Execute o Kugar Designer digitando <command +>kudesigner</command +> no shell. </para> + +<para +>Após você iniciar o designer, escolha <guimenu +>Arquivo</guimenu +>|<guilabel +>Novo</guilabel +> e configure o tamanho da página para <guilabel +>Carta</guilabel +> e a orientação do papel para <guilabel +>Paisagem</guilabel +>. Configure as margens esquerda e direita para 48, e as margens superior e inferior para 40. Todas as dimensões no &kudesigner; (margens de página, tamanhos, posições, &etc;) são mensuradas em milímetros. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_file_new.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Diálogo <interface +>Novo Relatório</interface +></phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>Um novo relatório é agora criado e todos os botões na <guilabel +>Barra de Ferramentas Items</guilabel +> e <guilabel +>Barra de Ferramentas Seções</guilabel +> são agora habilitados (os ítens correspondentes de menu no <guilabel +>Ítems</guilabel +> e <guilabel +>Seções</guilabel +> são também habilitados). <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 é hora de adicionar algumas seções ao relatório e determinar os seus tamanhos. Nós adicionaremos 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 seção de <link linkend="detail" +>detalhe</link +>. Os cabeçalhos e rodapés do relatório são impressos na primeira página e na última página do relatório antes 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 seçã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 seções são adicionadas usando o menu <guilabel +>Seções</guilabel +> ou uma <guilabel +>Barra de Seçõ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 seção de detalhe, coloque o seu nível a 0 como é mostrado na imagem abaixo. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_set_level.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Configurando o nível de detalhe</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>Nosso relatório deverá parecer agora como este na captura de tela. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_rep_look1.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Relatório com seções</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>Todas as seções do exemplo possuem uma altura pré-definida - 50 mm. Vamos mudá-la. Para fazer isso, clique com o &RMB; na seção do Cabeçalho do Relatório ou clique no botão <guilabel +>Editar Propriedades</guilabel +> da <guilabel +>Barra de Edição</guilabel +> e, finalmente, escolha uma seção. A janela de propriedades deverá então aparecer. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_edit_height.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Edição da altura da seção</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>Defina agora a altura do Cabeçalho do Relatório como sendo igual a 70. Vamos executar este procedimento para todas as outras seçõ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 seções dimensionadas corretamente está pronto para ser preenchido com itens de relatório. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_rep_look2.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Relatório com as seções dimensionadas</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>Você poderá agora adicionar itens às seções do relatório. Poderão ser adicionados cinco tipos diferentes de itens. A <link linkend="label-element" +>Legenda</link +> é uma área retangular que poderá ter uma borda 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 fonte, poderão ser alterados. Os tipos de borda e as cores das linhas poderão também ser personalizadas. O <link linkend="field-element" +>Campo</link +> poderá ser colocado numa seção de detalhe. Os campos representam campos de dados e os seus valores serão obtidos a partir de um arquivo 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 pré-definido, como a data atual 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 de relatório clique o botão do item correspondente na <guilabel +>Barra de Ferramentas Items</guilabel +> e coloque-o (clique) na seção. O item escolhido será colocado na seção selecionada com o canto superior esquerdo nas coordenadas fornecidas. Outras propriedades são configuradas com os valores padrão e podem ser mudadas com o diálogo <guilabel +>Opções de Item de Relatório</guilabel +> (da mesma maneira que nós fizemos para mudar a altura da seção). </para> + +<para +>Assim, vamos adicionar legendas ao cabeçalho e ao rodapé do relatório, tal como mostrado na imagem abaixo. Note 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 +>Nós adicionamos também elementos de campos na seção do detalhe. Assumindo que existem quatro campos - título, versão, plataforma e cópias. Assim, deverão ser colocados quatro elementos <guilabel +>Campo</guilabel +>, assim como deverão ser configuradas as propriedades do <guilabel +>Campo</guilabel +>. Note 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 local para mostrar a data atual e o número da página, assim deverão ser adicionados dois campos especiais e configurados 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. Note que a propriedade <guilabel +>Text</guilabel +> do ítem 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 soma 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, nosso modelo de relatório deve parecer-se com isto: <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 +>Criando um arquivo de dados de relatório</title> + +<para +>De um modo geral, os arquivos 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 planilha do &kspread;); outros irão usar o seu próprio programa para obter os dados de um banco de dados e preencher o arquivo de dados. Neste tutorial, nós simplesmente criaremos este arquivo de maneira manual. O código-fonte do exemplo, poderá ser encontrado no arquivo <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 +>Gerando o relatório</title> + +<para +>Neste momento nós temos um modelo de relatório (<filename +>sample1.ktf</filename +>) e um arquivo de dados de relatório (<filename +>sample1.kdf</filename +>). </para> +<para +>Para gerar um relatório, digite o seguinte comando no console: <command +>kugar <option +>-r <replaceable +>sample1.ktf</replaceable +></option +> <option +>-d <replaceable +>sample1.kdf</replaceable +></option +></command +> </para> + +<para +>Isto trará uma janela de shell 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> |