<!-- 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&percnt; 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>
