# O Manual do &kchart;

## Introdução

O &kchart; é uma ferramenta para visualizar dados numéricos. Pode ser usado como uma aplicação autónoma com um &dataeditor; simples. Porém, como um componente do &koffice;, oferece uma integração muito flexível. O &kspread; usa o componente do &kchart; para os gráficos e diagramas. O &kspread; pode ser visto como um fornecedor de dados muito poderoso para o &kchart;.

Mas a incorporação não está limitada ao &kspread;. Um gráfico do &kchart; pode ser incorporado em vários componentes do &koffice;, como o &kword;, o &kpresenter; ou o &kivio;.

Para começar, vejamos a interface de utilizador do &kchart; e como é que poderá ser usado como uma aplicação autónoma. Quando estiver familiarizado com o &kchart;, irá investigar as capacidades de geração de gráficos que ele oferece, em conjunto com o &kspread;.

## A Interface de Utilizador

### A Interface Principal da Aplicação

Vejamos um exemplo simples para conhecer o &kchart;. Ao longo do percurso, discutir-se-á também a interface do utilizador, de modo a que o utilizador aprenda muitos detalhes do componente.

Start &kchart; with the default settings and you will see the main user interface of &kchart;

Interface de Utilizador do KChart

Como poderá ver, já existem alguns dados de exemplo presentes. O &kchart; oferece a barra de ferramentas predefinida para criar um novo gráfico, gravar, carregar e imprimir o gráfico. A segunda barra de ferramentas oferece ícones para editar os dados, configurar o gráfico ou usar um assistente de configuração. Poderá também mudar de tipos de gráficos com os restantes ícones. Repare que alguns destes tipos têm sub-tipos.

O menu oferece todos os itens normais, incluindo a configuração de atalhos e da barra de ferramentas, assim como da formatação da página para a impressão.

Lembre-se que a edição de dados não está disponível, se você usar o &kchart; dentro do &kspread;, dado que todos os dados são fornecidos pela folha de cálculo. Como uma aplicação autónoma, o &dataeditor; é uma componente importante da aplicação.

### Assistente do Gráfico

O assistente é, de momento, uma parte bastante útil do &kchart; para configurar rapidamente algumas opções básicas, como o tipo de gráfico e a legendagem do mesmo, em alguns passos simples.

Poderá correr o assistente em qualquer altura; este irá sempre preservar os seus dados e as outras opções. Também poderá alterar cada uma das configurações que fizer, posteriormente, com o assistente, sem que perca nada. De facto, o assistente é apenas uma forma de definir algumas opções básicas e importantes de uma vez.

Para iniciar o assistente, basta carregar no ícone da barra de ferramentas.

#### Passo 1 - Escolher o Tipo de Gráfico

Passo 1 do Assistente - Tipo de Gráfico

O primeiro passo do assistente é escolher, de facto, o tipo primário do gráfico. Esta selecção tem o impacto mais impotrante na forma como os seus dados serão apresentados. Como tal, deverá ser bem escolhida. Poderá alterar o tipo do gráfico com os ícones na barra de ferramentas, sem que perca quaisquer dados ou configurações a seguir. De facto, até é considerado normal testar todos os vários tipos de gráficos para descobrir a melhor opção.

Neste exemplo, será escolhido o tipo de linha. Dependendo do tipo de gráfico escolhido, ficarão disponíveis diferentes opções nos passos seguintes.

Depois de escolher o tipo, poderá ir para o passo seguinte com o botão Seguinte. Poderá também optar por Terminar, em qualquer altura, se já se identificar com a configuração feita até então.

#### Passo 2 - Escolher o Sub-Tipo

Passo 2 do Assistente - Sub-Tipo do Gráfico

No caso de o tipo de gráfico escolhido ter vários sub-tipos, poderá escolher o pretendido no segundo passo. Se o tipo de gráfico não tiver sub-tipos, este passo será avançado automaticamente.

Se decidir alterar o sub-tipo mais tarde, podê-lo-á fazer na janela de configuração apropriada, que será mostrada posteriormente.

Poderá simplesmente deixar a selecção predefinida e passar ao próximo passo. Obviamente, poderá escolher outro sub-tipo que desejar.

#### Passo 3 - Legenda, Tipos de Letra

Passo 3 do Assistente - Legenda

No terceiro passo, poderá definir o texto do título do gráfico, os eixos e a legenda. Poderá também configurar o tipo de letra desejado, em detalhe, para cada um deles.

#### Passo 4 - Eixos

Passo 4 do Assistente - Eixos

O último passo do assistente permite-lhe definir várias opções para os eixos e outras opções, dependendo do tipo de gráfico.

Poderá tanto optar por Terminar, para aceitar as opções do seu gráfico, recuar e mudar várias opções ou, simplesmente, esquecer todas as opções do assistente, carregando para tal em Cancelar.

Se escolher Terminar, todas as suas opções do assistente serão integradas no gráfico e poderá continuar a introduzir alguns dados, assim como fazer algum ajuste pormenorizado das várias opções.

Lembre-se que a janela de configuração do gráfico tem muitas mais opções disponíveis, as quais serão discutidas posteriormente.

### O &dataeditor;

O &dataeditor; poderá ser acedido se seleccionar a opção Editar Editar os Dados... do menu ou se carregar no ícone da barra de ferramentas.

O &dataeditor; em modo independente

O &dataeditor; pode ser usado para definir todos os valores. Poderá também definir o número de linhas e colunas.

Dependendo do tipo de gráfico, as linhas e colunas têm representações diferentes. Cada linha poderá ser considerada, de um modo geral, como uma série ou conjunto de dados, enquanto cada coluna representa os valores de todos os conjuntos de dados numa dada localização.

O nome de um conjunto de dados poderá ser alterado se carregar no cabeçalho da linha (à esquerda da primeira coluna com valores). O nome de uma coluna poderá ser alterado se carregar no cabeçalho da coluna (acima da primeira linha).

O número de linhas e colunas poderá ser ajustado de acordo com as necessidades. Desde a versão 1.4, a restrição de 16 linhas e 16 colunas foi eliminada.

### Configuração do Gráfico

O &kchart; oferece várias opções de configuração do gráfico. Estas estão disponíveis no modo autónomo e quando está incorporado no &kspread;

Dependendo do tipo de gráfico que tiver seleccionado, as opções disponíveis serão ligeiramente diferentes. Tentemos o tipo de gráfico de linhas, carregando para tal no ícone da barra de ferramentas.

Para ir para a janela de configuração do gráfico, seleccione a opção Editar Gráfico Configurar o Gráfico... do menu ou carregue no ícone da barra de ferramentas.

#### Troca de Linhas e Colunas

Passo 1 da configuração - troca das linhas/colunas

A primeira página de configuração poderá ser usada para trocar a interpretação das linhas e colunas. Por omissão, uma linha é considerada como sendo um conjunto de dados e cada coluna contém os valores individuais da série de dados. Aqui poderá optar por ter cada coluna com um conjunto de dados. Repare que os valores não estão realmente trocados, somente a sua interpretação é que está.

#### Sub-tipo de Gráfico

Página 2 da configuração - Sub-Tipo do Gráfico

A segunda página pode ser usada para seleccionar o sub-tipo de gráfico desejado. Os sub-tipos disponíveis dependem do tipo de gráfico, sendo neste caso o gráfico de linhas. Alguns tipos de gráficos não têm qualquer sub-tipo de todo onde, nesse caso, esta página de configuração não é mostrada. Poderá também obter uma antevisão de cada tipo.

Lembre-se que o tipo de gráfico poderá ser escolhido na barra de ferramentas, enquanto o sub-tipo poderá ser definido com esta janela de configuração.

#### Título e Rodapé

Passo 3 da configuração - Título e Rodapé

Na terceira página, poderá definir o título, o sub-título e o rodapé do gráfico, tendo cada um deles configurações de tipo de letra diferentes.

#### Legenda

Página 4 da configuração - Legenda

A página de configuração da legenda permite-lhe definir todos os aspectos da legenda. Esta contém os nomes de todos os conjuntos de dados, com as respectivas cores; isto é importante para identificar os dados no gráfico.

A área Geral contém o título da legenda, que é mostrado no topo da área da legenda. A área de Posição pode ser usada para colocar a legenda em vários pontos do gráfico. Use o botão central para esconder a legenda.

A área do Tipo de Letra poderá ser usada para definir tipos de letra diferentes para o título da legenda e para os itens individuais. Adicionalmente, poderá definir cores diferentes na área de Cor.

#### Eixos

Página 5 da configuração - Eixos

A página de Eixos contém a configuração dos eixos do gráfico. Esta página depende em grande medida do tipo de gráfico escolhido. Para o gráfico de linhas, poderá definir escalas logarítmicas e lineares, activar ou desactivar a grelha, assim como o marcador de linhas poderá colocar um quadrado em todos os valores de dados.

#### Cores

Página 6 da configuração - Cores

Na página de cores, poderá escolher as cores para os conjuntos de dados individuais. Poderá também definir as cores para algumas partes de gráficos, como a cor da linha dos eixos e da grelha.

#### Tipo de Letra

Página 7 da configuração - Tipo de Letra

A página do tipo de letra pode ser usada para configurar vários tipos de letra, como os dos títulos, das legendas dos eixos, e assim por diante. Alguns destes tipos de letra poderão ser definidos noutras páginas, só que na página do tipo de letra, tê-los-á a todos num único sítio.

#### Fundo

Página 8 da configuração - Fundo

Na página do fundo, poderá encontrar várias opções para afinar a configuração do fundo do gráfico. Poderá tanto escolher várias cores diferentes, assim como uma imagem, para o fundo.

#### Mais...

Esta introdução geral às opções de configuração deu-lhe uma introdução às possibilidades de configuração do seu gráfico, o que não quer dizer que esteja de forma alguma completa. Os diferentes tipos de gráficos têm páginas de configuração especializadas e você está convidado a experimentá-las; tente os vários tipos de gráficos e veja as possibilidades de configuração. Use as dicas e leia a ajuda O Que É Isto?. Para usar esse tipo de ajuda, basta carregar no ponto de interrogação na decoração da janela e depois carregar na área da página de configuração onde deseja obter mais informações.

## O &kchart; como uma aplicação autónoma

In this chapter we will take a look at &kchart; as a standalone application.

## Utilizar o &kchart; no &kspread;

Para além de uma operação autónoma, o &kchart; está desenhado para ser usado com o &kspread;. Este capítulo descreve como criar e manipular os gráficos dentro do &kspread;.

### Criar gráficos com o &kchart;

Para criar um gráfico com o &kchart;, quando embebido no &kspread;, faça o seguinte:

Imagem da janela de barras de ferramentas

- Seleccione a segunda fila de números.

- Em seguida carregue no botão Gráfico para criar o gráfico.

- Seleccione as opções que desejar do assistente de gráficos. O assistente de gráficos aparece depois de inserir o gráfico.

Para criar um gráfico de barras para itens individuais, coloque os número numa coluna, como se mostra em baixo.

Imagem da janela de barras de ferramentas

A orientação dos números determina a forma como o gráfico será feito.

- Uma fila de número define as ordenadas de um gráfico.

- Uma coluna de números define as alturas de cada barra, num gráfico de barras. Também determina o tamanho das fatias num gráfico circular.

## Referência de Comandos

### A janela principal do &kchart;

#### O Menu Ficheiro

&Ctrl;N Ficheiro Novo

- Cria um novo documento

&Ctrl;O Ficheiro Abrir...

- Abre um documento

Ficheiro Abrir um Recente

- Abrir um documento gravado recentemente

&Ctrl;S Ficheiro Gravar

- Grava o documento

Ficheiro Gravar Como

- Grava o documento no formato indicado

&Ctrl;P Ficheiro Imprimir

- Imprime o documento

  Verifique que seleccionou o sistema de impressão correcto na secção Sistema de impressão em uso:. Esta opção pode ser vista depois de carregar no botão Expandir.

Ficheiro Antevisão da Impressão

- Mostra qual será o aspecto do documento depois de impresso.

Ficheiro Informação Sobre o Documento...

- Abre uma janela pode pode inserir informações acerca do se gráfico.

  Este dados do documento serão mostrados no gestor de ficheiros &konqueror; como uma dica. As dicas são pequenas janela que mostram o conteúdo de um ficheiro para passa o rato por cima do ícone do ficheiro.

Ficheiro Enviar Ficheiro...

- Esta funcionalidade não funciona correctamente. Não a utilize.

&Ctrl;W Ficheiro Fechar

- Fecha o gráfico actual.

&Ctrl;Q Ficheiro Sair

- Sai do &kchart;

#### O Menu Editar

Editar Configurar com o Assistente...

- Permite-lhe indicar o tipo de gráfico.Pode também inserir títulos e mudar os tipos de letra com o Assistente.

Editar Editar Dados...

- Tabela onde inserir dados.

Editar Configurar...

- Janela para configurar o gráfico.

##### As Páginas de Configuração

Cores

- Seleccione aqui as cores do gráfico, cores da grelha e cores do título.

Tipo de Letra

- Seleccione o estilo e tamanho do tipo de letra. Também podem ser aqui seleccionadas as cores das séries. As séries referem-se ao gráficos individuais; cada conjunto de dados no gráfico é um série.

Fundo

- Seleccione a cor de fundo do seu gráfico.

  O fundo da imagem não funciona neste momento

Legenda

- Muda a localização das legendas. A cor da caixa das legendas também pode ser aqui alterada. A caixa de legenda contém o índice de cores para as séries do gráfico.

Eixos

- Os eixos podem ser activados ou desactivados aqui.

  Nem tudo funciona aqui.

Parâmetros 3D

- Aqui pode ser configurada a perspectiva em gráficos de barras 3d.

Sub-Tipo do Gráfico

- Muda a disposição de gráficos de barras.

Cabeçalho/Rodapé

- Indique aqui os títulos que deseja para o seu gráfico.

#### O Menu Configuração

Configuração Ler a Configuração

- Carrega uma configuração anteriormente gravada.

Configuração Gravar a Configuração

- Grava a configuração que efectuou em Editar, Configurar.

Configuração Configuração por Omissão

- Carrega a configuração por omissão.

Configuração Mostrar a Barra de Ferramentas Ficheiro

- Mostra a barra de ferramentas de ficheiros para acesso rápido.

Configuração Mostrar a Barra de Ferramentas Gráfico

- Mostra a barra de ferramentas com os vários tipos de gráficos (Gráfico Circular, Gráfico de Barras, Gráfico de Área e assim por diante).

#### Configurar os Atalhos

A opção Configuração Configurar os Atalhos... permite-lhe alterar as atribuições de teclas.

Segue-se um exemplo de como configurar um atalho para abrir o assistente de gráficos.

Imagem da janela de atalhos

- Carregue no botão Personalizada.

- Em seguida carregue no botão Primário.

- Carregue em `&Alt;&Ctrl;W` e a janela deve desaparecer. A associação de tecla está realizada.

Agora ao carregar nas teclas `&Alt;&Ctrl;W` abre o assistente.

#### Configurar as Barras de Ferramentas

A opção de menu Configuração Configurar as Barras de Ferramentas... é utilizada para adicionar botões às barras de ferramentas.

Imagem da janela de barras de ferramentas

- Para adicionar um botão à barra de ferramentas dos Ficheiros,

  Imagem da janela de barras de ferramentas

  verifique que aparece na caixa de selecção no topo Ficheiro <KOfficeShell>.

- Carregue em um dos itens do painel do lado esquerdo. Este item passa a ter um fundo azul que mostra que foi seleccionado.

- Em seguida carregue no botão Seta direita para o colocar no painel da direita.

- Carregue em `Aplicar` e depois carregue em `OK`.

O novo item deverá aparecer na barra de ferramentas.

#### O Menu Ajuda

&help.menu.documentation;

## Perguntas e Respostas

&reporting.bugs; &updating.documentation;

O &kchart; aceita ficheiros de texto com dados, por exemplo colunas de números, para fazer gráficos?

Não. Neste momento o &kchart; só consegue fazer gráficos de dentro do &kspread;.

Porque é que algumas comandos do menu Editar Configurar não funcionam?

O &kchart; ainda está a ser desenvolvido e algumas funcionalidades não está completas.

## Créditos e Licença

&kchart;

Programa copyright 1998-2002 &Matthias.Kalle.Dalheimer; &Matthias.Kalle.Dalheimer.mail;

Contribuições:

- Laurent Montel lmontel@mandrakesoft.com

- Karl-Heinz Zimmer khz@kde.org

Documentação copyright 2002 &Jonathan.Drews; &Jonathan.Drews.mail;

Tradução de Pedro Morais morais@kde.org

&underFDL; &underGPL;

## Instalação

### Como obter o &kchart;

&install.intro.documentation;

### Requisitos

Para utilizar esta versão do &kchart; necessita do &koffice; 1.3 e do &Qt; 3.2

Todas as bibliotecas necessárias, bem com o próprio &kchart; podem ser encontrados na Página do &koffice;.

Pode encontrar uma lista de alterações em http://www.koffice.org/kchart/.

### Compilação e Instalação

&install.compile.documentation;
&documentation.index;