<!--
  <!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd">

 -->

<chapter id="basics">
  <title
>Fundamentos do &kexi; </title>

  <sect1 id="doc-vs-project">
    <title
>Bancos de Dados do &kexi; </title>
    <para
>Muitas aplicações, como o OpenOffice.org ou o Microsoft Excel criam arquivos chamados <firstterm
>documentos</firstterm
>. O &kexi; também cria arquivos, só que normalmente refere-se a eles como sendo <firstterm
>arquivos de bancos de dados do &kexi;</firstterm
> ou simplesmente <firstterm
>arquivos de bancos de dados</firstterm
>. Os arquivos de bancos de dados do &kexi; possuem normalmente a extensão <filename
>.kexi</filename
>. </para>
  
<!-- TODO: Picture of Kexi database icon? -->

    <para
>Além de armazenar os seus bancos de dados nos arquivos, o &kexi; pode também usar os bancos de dados em <firstterm
>servidores dedicados</firstterm
>, razão pela qual se referiu anteriormente aos <emphasis
>arquivos de bancos de dados</emphasis
> e não simplesmente <emphasis
>bancos de dados</emphasis
>. </para>

    <para
>O termo <firstterm
>projeto do &kexi;</firstterm
>, ou simplesmente <firstterm
>projeto</firstterm
>, também é usado para se referir a um banco de dados do &kexi;, independentemente se é gravado num arquivo ou num servidor de banco de dados. </para>
  </sect1>

  <sect1 id="new-database">
    <title
>Criando um Novo Arquivo de Banco de Dados </title>

    <procedure>
      <step>
	<para
>Execute o &kexi; ou, se já estiver rodando, use a opção <menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Arquivo</guimenu
><guimenuitem
>Novo</guimenuitem
> </menuchoice
>. </para>
      </step>
      <step>
	<para
>Clique no botão <guibutton
>OK</guibutton
> para confirmar a criação do projeto. </para>
      </step>
      <step>
	<para
>Insira um nome para o seu projeto e clique em <guibutton
>Próximo</guibutton
>. </para>
      </step>
      <step>
	  <para
>Use o navegador de arquivos para escolher a pasta onde deseja gravar o seu arquivo de banco de dados. Você poderá alterar o nome do arquivo no campo de <guilabel
>Localização:</guilabel
>, se não gostar do que é sugerido. </para>
      </step>
      <step>
	<para
>Clique em <guibutton
>Criar</guibutton
>. </para>
      </step>
    </procedure>
  </sect1>

  <sect1 id="main-window">
    <title
>A Janela Principal do &kexi; </title>
    <para
>O <guilabel
>Navegador do Projeto</guilabel
> e o <guilabel
>Editor de Propriedades</guilabel
> são mostrados em painéis bem definidos de cada lado da janela-filha. Eles podem ser redimensionados ou ocultos de acordo com a necessidade. Um painel poderá ser oculto clicando-se na pequena cruz na parte superior do mesmo (logo abaixo da barra de ferramentas). </para>
    <para
>Os objetos do banco de dados (tabelas, pesquisas, etc.) listados no <guilabel
>Navegador do Projeto</guilabel
> podem ser abertos clicando-se (ou fazendo duplo-clique, dependendo da configuração global do &kde;) nos seus nomes. </para>

<sect2 id="main-application-elements">
<title
>Elementos principais da aplicação </title>
<!--
<br
><img src="img/04_06_00_main_window.png">
<br
>Kexi's main window<br
><br>
-->
<itemizedlist>
<title
>Os elementos principais da janela da aplicação &kexi; são: </title>
<listitem>
<para
><emphasis
>Barra de Menu</emphasis
></para>
<para
>contém os comandos disponíveis para a aplicação. Você irá encontrar uma descrição detalhada dos vários comandos no apêndice. </para>
</listitem>
<listitem>
<para
><emphasis
>Barra de ferramentas</emphasis
></para>
<para
>contém os comandos usados com maior freqüência. </para>
</listitem>

<listitem>
<!-- @todo: link to the various chapters from the listitems -->
<para
><emphasis
>Painel do <guilabel
>Navegador do Projeto</guilabel
></emphasis
></para>
<para
>contém uma lista com os vários objetos (tabelas, pesquisas, formulários, ...) criado dentro do projeto atualmente aberto. O navegador também contém uma pequena barra de ferramentas com os comandos mais usados, relacionados com os objetos do banco de dados. </para>
</listitem>

<listitem>
<para
><emphasis
>Painel dos <guilabel
>Objetos do banco de dados aberto</guilabel
></emphasis
></para>
<para
>uma área central da aplicação que ocupa a maior parte do espaço da tela. No caso do modo de interface IDEAl, contém abas selecionáveis que estão sempre maximizadas. No modo de janelas-filhas, contém janelas flutuantes. </para>
</listitem>

<listitem>
<para
><emphasis
>Painel de <guilabel
>Propriedades</guilabel
></emphasis
></para>
<para
>contém uma lista das propriedades do objeto ativo atualmente no banco de dados. Para alguns objetos (&eg;, ítens gráficos do formulário), poderá consistir em várias abas. </para>
</listitem>

<listitem>
<para
><emphasis
>Barra de tarefas</emphasis
></para>
<para
>contém uma lista das janelas abertas atualmente com objetos do banco de dados. Para o modo de interface IDEAl, está disponível como um conjunto de abas. Para o modo de interface com janelas-filhas, está disponível como um conjunto de botões que se comportam como a barra de tarefas do seu sistema operacional. </para>
</listitem>

</itemizedlist>

<sect3 id="project-navigator-pane">
<title
>Painel do <guilabel
>Navegador do Projeto</guilabel
></title>
<para
>O painel do <guilabel
>Navegador do Projeto</guilabel
> é um dos elementos usados com maior freqüência na janela principal do &kexi;. O painel contém uma lista com todos os objetos criados dentro do projeto de banco de dados do &kexi; aberto atualmente. Os objetos estão divididos em grupos: tabelas, pesquisas, formulários. </para>
<para id="project-navigator-pane-toolbar"
>O painel do <guilabel
>Navegador do Projeto</guilabel
> contém uma <emphasis
>pequena barra de ferramentas para os comandos mais freqüentes</emphasis
> (da esquerda para a direita): <emphasis
>Abrir o objeto selecionado</emphasis
>, <emphasis
>Desenhar o objeto selecionado</emphasis
>, <emphasis
>Criar um novo objeto</emphasis
> e <emphasis
>Apagar o objeto selecionado</emphasis
>. </para>
<para
>Para cada objeto da lista, existe um menu de contexto que está disponível através do &RMB;. Por exemplo, este é o menu de contexto da tabela <emphasis
>pessoas</emphasis
>. </para>

<para
>Realizar um duplo-clique com o &LMB; no nome do objeto na lista, permitirá abrir o objeto na Visão de Dados. Se a janela do objeto já estiver aberta, a ação simplesmente ativa a janela sem mudar o modo de visão. </para>
<para
>Lembre-se que o seu sistema operacional poderá estar configurado para lidar com cliques simples em vez de duplos. Neste caso, é suficiente clicar uma vez no nome do objeto para abrir a sua janela. </para>

</sect3>

<sect3 id="database-object-windows">
<title
>Janelas dos objetos do banco de dados</title>

<orderedlist>
<title
>Abrindo a janela de um objeto</title>
<listitem>
<para
>Selecione o objeto no <link linkend="project-navigator-pane"
>painel do Navegador do Projeto</link
>. </para>
</listitem>
<listitem>
<para
>Clique no botão <guibutton
>Abrir</guibutton
> na <link linkend="project-navigator-pane-toolbar"
>barra de ferramentas do painel do Navegador do Projeto</link
>. </para>
</listitem>
</orderedlist>

<itemizedlist>
<title
>Comandos relacionados com janelas de objetos</title>
<listitem
><para
><emphasis
>Fechar uma janela de objeto</emphasis
></para>
<para
>Quando for usado o modo de interface IDEAl (o padrão), cada janela terá a sua própria aba. Passe o cursor do mouse sobre o ícone na aba. Um botão para <guibutton
>Fechar</guibutton
> ficará visível. Clicando nele, você irá fechar a aba. </para>
<para
>No modo de janelas-filhas, do lado direito de cada janela aberta, existem botões que você poderá usar para controlar a janela. Clique no primeiro do lado direito para fechar a janela. </para>
<para
>Em alternativa, independente do modo de interface que usar, você poderá selecionar a opção <menuchoice
><guimenu
>Janela</guimenu
><guimenuitem
>Fechar</guimenuitem
></menuchoice
> do menu. </para>
</listitem>
<listitem
><para
><emphasis
>Botões da janela para o modo de interface de janelas-filhas</emphasis
></para>
<!--
<para>
<br
><img src="img/04_06_02_window_buttons.png">
<br
>Window's buttons<br
><br>
</para>
-->
<para
>Os outros botões (da direita para a esquerda) podem ser usados para: maximizar, minimizar e desacoplar a janela. </para>
<para
>Existe um ícone pequeno à esquerda da barra de título, que poderá ser clicado para mostrar um menu de contexto com comandos relacionados com a janela. </para>
<!--
<para
>See also Docking and undocking of the windows.</para>
-->
</listitem>
</itemizedlist>

</sect3>

<sect3 id="property-editor-pane">
<title
>Painel do <guilabel
>Editor de Propriedades</guilabel
></title>
<para
>No painel do <guilabel
>Editor de Propriedades</guilabel
> você pode alterar as propriedades do objeto exibido na janela ativa. Dependendo do contexto, o painel consiste em uma ou mais abas. A primeira das Propriedades, que está sempre visível, contém a lista de propriedades disponíveis. </para>
<!--
<para>
<img src="img/04_06_03_prop_panel.png">
<br
>Property Editor<br
><br>
</para>
-->
<itemizedlist>
<title
>Regras para usar o Editor de Propriedades:</title>
<listitem>
<para
>Cada linha corresponde a uma única propriedade.</para>
</listitem>
<listitem>
<para
>Você poderá usar o mouse ou o teclado para mudar os valores das propriedades em particular.</para>
</listitem>
<listitem>
<itemizedlist>
<title
>Os tipos de valores de propriedades usados com maior freqüência são:</title>
<listitem>
<para
><emphasis
>um número;</emphasis
> você poderá inserir o valor diretamente, ou aumentá-lo ou diminuí-lo com o &LMB; nas setas. </para>
</listitem>
<listitem
><para
>texto</para
></listitem>
<listitem
><para
>uma lista de valores</para
></listitem>
<listitem
><para
><emphasis
>valor Sim/Não;</emphasis
> no formato de um botão que poderá comutar; o botão ligado significa um valor <guibutton
>Sim</guibutton
> (<emphasis
>verdadeiro</emphasis
>), enquanto o botão desligado significa um valor <guibutton
>Não</guibutton
> (<emphasis
>falso</emphasis
>). </para>
</listitem>
</itemizedlist>
</listitem>
<listitem
><para
>Não há necessidade de confirmar o valor alterado: as alterações são imediatamente visíveis após mudar para uma linha diferente da lista do Editor de Propriedades ou pressionando-se a tecla <keycombo
><keycap
>Enter</keycap
></keycombo
>. </para
></listitem>
<listitem>
<para
>Os nomes das propriedades alteradas recentemente e que ainda não tenham sido gravadas no banco de dados estão marcadas em negrito. </para>
</listitem>
<listitem>
<para
>Após alterar o valor de uma propriedade, aparece um botão especial para <guibutton
>Desfazer alterações</guibutton
> do lado direito da lista do Editor de Propriedades. Clicando-se nele, você poderá reverter o valor da propriedade ao seu original carregado do banco de dados, quando abriu o objeto do banco de dados. O botão só fica visível quando a propriedade ficar selecionada de fato. </para>
</listitem>
</itemizedlist>

<itemizedlist>
<title
>O painel do Editor de Propriedades fica vazio se:</title>
<listitem
><para
>não estiver aberto qualquer objeto da banco de dados ou</para>
</listitem>
<listitem
><para
>a janela do objeto ativo do banco de dados não oferecer propriedades; é normalmente o caso quando for aberto na Visão de Dados em vez da Visão de Desenho </para>
</listitem>
</itemizedlist>

<!--
<para>
See also the list of keyboard shortcuts available for the Property Editor
pane in appendix Property Editor pane.
</para>
-->

</sect3>

</sect2>

  </sect1>

  <sect1 id="project-opening">
    <title
>Abrindo um arquivo de banco de dados do &kexi; existente </title>
    <itemizedlist>
      <title
>Para abrir um arquivo de banco de dados existente do &kexi;: </title>
      <listitem
><para
>selecione-o na janela <guilabel
>Abrir Projeto Existente</guilabel
>; ou </para
></listitem>
      <listitem
><para
>abra-o, clicando no ícone do arquivo '.kexi'. </para
></listitem>
    </itemizedlist>

    <sect2 id="window-open-existing">
      <title
>Abrindo um arquivo de banco de dados na janela Abrir um Pro<guilabel
>jeto Existente</guilabel
> </title>
      <itemizedlist>
        <listitem
><para
>Execute o &kexi;. Você deverá ver o diálogo inicial <guilabel
>Escolher Projeto</guilabel
>. Escolha a aba <guilabel
>Abrir Projeto Existente</guilabel
>. Você verá o seguinte diálogo: </para
></listitem>
        <listitem
><para
>Na lista <guilabel
>Localização atual</guilabel
>, escolha uma pasta que contenha um arquivo que você procure. </para
></listitem>
        <listitem
><para
>Você poderá tanto escolher um arquivo como indicar o seu nome na caixa <guilabel
>Localização:</guilabel
>. </para
></listitem>
        <listitem
><para
>Clique <guibutton
>OK</guibutton
>. </para
></listitem>
      </itemizedlist>

      <sect3 id="open-existing-notes">
        <title
>Notas </title>
        <itemizedlist>
          <listitem
><para
>Por padrão, a lista <guilabel
>Filtro:</guilabel
> contém a opção <guilabel
>Projeto de Banco de Dados em Arquivo do Kexi</guilabel
> selecionada. No caso do arquivo que estiver procurando tiver outra extensão, você pode mudar a seleção do <guilabel
>Filtro:</guilabel
> para <guilabel
>Todos os Arquivos</guilabel
> para mostrar todos os arquivos disponíveis (independentemente da extensão). </para
></listitem>
          <listitem
><para
>Se você tiver selecionado um arquivo de um tipo externo, como um arquivo MDB do MS Access, o &kexi; fornecerá a opção para importar o arquivo. </para
></listitem>
          <listitem
><para
>Se você tiver selecionado um arquivo de <emphasis
>dados da conexão</emphasis
> (com a extensão .kexic) ou um <emphasis
>atalho para um projeto no servidor de banco de dados</emphasis
> (com a extensão .kexis), o &kexi; exibirá as janelas apropriadas. </para
></listitem>
        </itemizedlist>
      </sect3>
    </sect2>

    <sect2 id="open-icon">
      <title
>Abrindo um arquivo de banco de dados do &kexi; existente, clicando no ícone do arquivo .kexi </title>
      <para
>Clique no ícone do arquivo usando o seu gerenciador de arquivos ou na tela do seu computador. O &kexi; irá abrir este projeto de banco de dados automaticamente. </para>
<!-- <img src="icons/mime-kexiproject_sqlite.png" class="icon"
></img
> -->
      <sect3 id="open-icon-notes">
        <title
>Notas </title>
        <para
><emphasis
>Nota sobre os arquivos de bancos de dados acessados remotamente.</emphasis
> Você poderá querer abrir um arquivo de banco de dados que esteja localizado numa fonte remota (&eg;, um servidor Web ou FTP ou um compartilhamento de MS Windows). O Ambiente de Trabalho K permite-lhe abrir arquivos de fontes remotas diretamente nas aplicações e salvar as alterações de volta na origem, mas este não é o caso dos arquivos de banco de dados. Clicar em um arquivo de banco de dados localizado numa origem remota, fará com que o arquivo seja transferido para uma pasta temporária no seu computador e  todas as suas modificações serão feitas neste arquivo local. O arquivo remoto original irá permanecer sem alteração após fechar o Kexi, por isso recomenda-se que copie (transfira) o arquivo primeiro para o seu computador, abra o arquivo localmente e copie-o de novo para a origem, se quiser atualizá-lo. </para>
      </sect3>
    </sect2>
  </sect1>

  <sect1 id="using-help">
    <title
>Usando a ajuda embutida </title>
    <itemizedlist>
      <title
>As seguintes formas de obter a ajuda interna do &kexi; estão disponíveis: </title>
      <listitem>
        <para
><emphasis
>O Manual, no formato de documento eletrônico.</emphasis
></para>
        <para
>O Manual está disponível pressionando-se a tecla <keycombo
><keycap
>F1</keycap
></keycombo
> ou selecionando-se a opção <menuchoice
><guimenu
>Ajuda</guimenu
><guimenuitem
>Manual do &kexi;</guimenuitem
></menuchoice
> do menu. </para>
      </listitem>
      <listitem>
        <para
><emphasis
>Sugestões O Que É Isto?.</emphasis
></para>
        <para
>Selecione a opção <menuchoice
><guimenu
>Ajuda</guimenu
><guimenuitem
>O Que É Isto?</guimenuitem
></menuchoice
> do menu e clique numa área da aplicação para obter dicas sobre ela. </para>
      </listitem>
    </itemizedlist>
  </sect1>

</chapter>
