# O Manual do &kchart;

## Introdução

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

Mas a incorporação de objetos gráficos 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 com o usuário do &kchart; e como ele poderá ser usado como uma aplicação independente. Quando estiver familiarizado com o &kchart;, você irá descobrir os recursos para geração de gráficos que ele oferece, trabalhando junto com o &kspread;.

## A Interface do Usuário

### Interface Principal da Aplicação

Vejamos um exemplo simples para conhecer o &kchart;. Ao longo do caminho, discutiremos também a interface do usuário, de modo que você aprenda sobre muitos detalhes do componente.

Quando você iniciar o &kchart; como uma aplicação independente, irá obter o usual diálogo de inicialização, onde poderá escolher entre vários modelos ou carregar documentos de gráficos já existentes.

Janela Inicial do &kchart;

Você pode iniciar o &kchart; de várias maneiras. À esquerda, você pode ver três opções. Documentos Recentes, modelos de Gráficos e Abrir Documento Existente.... A primeira opção lhe permite escolher entre um dos gráficos recentemente abertos, a segunda é para criação de um novo gráfico a partir de diversos modelos e a terceira é para abrir um gráfico existente usando a janela de arquivos padrão do &kde;.

Por enquanto, iremos começar com o modelo padrão. Selecione Gráficos na área da esquerda e, finalmente, selecione o Gráfico de Barras na área principal do modelo. Normalmente, este modelo já deverá estar selecionado após escolher Gráficos.

Se você optar por iniciar o &kchart; com um modelo selecionado por padrão, você poderá também selecionar a opção Usar sempre este modelo.

Clique no botão Usar Este Modelo à direita, abaixo da pré-visualização do modelo.

Interface do Usuário do &kchart;

Como você poder ver, já existem alguns dados de exemplo presentes. O &kchart; oferece a barra de ferramentas padrão para criar um novo gráfico, salvar, 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. Você poderá também alternar os tipos de gráficos com os ícones restantes. Repare que alguns destes tipos possuem sub-tipos.

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

Observe que a edição de dados não estará disponível se você usar o &kchart; dentro do &kspread;, uma vez que todos os dados são fornecidos pela planilha. Como uma aplicação independente, o editor de dados é uma componente importante da aplicação.

### Assistente de Gráfico

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

Você poderá executar o assistente a qualquer momento; ele irá sempre preservar os seus dados e as outras opções. Você também poderá alterar cada uma das configurações que fizer, posteriormente, com o assistente, sem que perca nada. De fato, o assistente é apenas uma forma de definir algumas opções básicas e importantes de uma só vez.

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

#### Passo 0 - Escolher a Fonte de Dados

Passo 0 do Assistente - Fonte de Dados

O primeiro passo do assistente é escolher a fonte de dados. Se a área de dados selecionada não corresponder aos dados que deseja, selecione-os agora.

Inclua as células que desejar usar como legendas para as linhas e colunas, se você desejá-las no gráfico.

Vá então para o passo seguinte com o botão Próximo >. Você poderá também optar por Terminar, a qualquer momento, se já se sentir satisfeito com a configuração feita até então.

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

Passo 1 do Assistente - Tipo de Gráfico

O próximo passo do assistente é escolher, de fato, o tipo primário do gráfico. Esta seleção tem o impacto mais importante na forma como os seus dados serão apresentados. Como tal, deverá ser bem escolhida. Você poderá alterar o tipo do gráfico com os ícones na barra de ferramentas, sem perder quaisquer dados ou configurações a seguir. De fato, até é considerado normal testar todos os vários tipos de gráficos para descobrir a melhor opção.

Neste exemplo, nós escolhemos o tipo de Linhas. Dependendo do tipo de gráfico escolhido, ficarão disponíveis diferentes opções nos passos seguintes.

Depois de ter escolhido o tipo, você poderá passar ao próximo passo com o botão Próximo >.

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

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

No caso do tipo de gráfico escolhido ter vários sub-tipos, você poderá escolher o desejado no segundo passo. Se o tipo de gráfico não tiver sub-tipos, este passo será pulado automaticamente.

Se você decidir alterar o sub-tipo mais tarde, poderá fazê-lo no diálogo de configuração apropriado, que será mostrada mais tarde.

Você poderá simplesmente deixar a seleção padrão e passar para o próximo passo. Obviamente, você poderá escolher outro sub-tipo que desejar.

#### Passo 3 - Rótulos e Legenda, Fontes

Passo 3 do Assistente - Rótulos e Legenda

No terceiro passo, você poderá definir o texto do título do gráfico, os eixos e a legenda. Poderá também configurar o tipo de fonte 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.

Você poderá tanto optar por Terminar, para aceitar as opções do seu gráfico, < Voltar e mudar várias opções ou, simplesmente, descartar todas as opções do assistente, clicando em Cancelar.

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

Lembre-se que o diálogo 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 acessado selecionando a opção Editar Editar Dados... do menu ou clicando no ícone da barra de ferramentas.

O &dataeditor; em modo independente

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

Dependendo do tipo de gráfico, as linhas e colunas possuem 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 determinada localização.

O nome de um conjunto de dados poderá ser alterado clicando-se no cabeçalho da linha (à esquerda da primeira coluna com valores). O nome de uma coluna poderá ser alterado clicando-se 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 para a configuração do gráfico. Elas estão disponíveis tanto no modo independente e como quando está embutido no &kspread;

Dependendo do tipo de gráfico que tiver selecionado, as opções disponíveis serão ligeiramente diferentes. Vamos escolher o tipo de gráfico de linhas, clicando para isso no ícone da barra de ferramentas.

Para acessar a janela de configuração do gráfico, selecione Formatar Gráfico... no menu ou clique no ícone na barra de ferramentas. Você poderá precisar clicar na seta para a esquerda ou direita no topo da janela para acessar todas as páginas se a largura da janela for muito pequena.

#### 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 padrão, uma linha é considerada como sendo um conjunto de dados e cada coluna contém os valores individuais da série de dados. Aqui você 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 selecionar 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. Você poderá também obter uma previsã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.

#### Cabeçalho e Rodapé

Passo 3 da configuração - Cabeçalho e Rodapé

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

#### Legenda

Página 4 da configuração - Legenda

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

A caixa 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 ocultar a legenda.

A caixa de Fonte poderá ser usada para definir tipos de letra diferentes para o título da legenda e para os ítens individuais. Adicionalmente, você poderá definir cores diferentes na caixa 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 principalmente do tipo de gráfico escolhido. Para o gráfico de linhas, você poderá definir escalas logarítmicas ou lineares e ativar ou desativar a grade.

#### Cores

Página 6 da configuração - Cores

Na página Cores, você poderá escolher as cores para os conjuntos de dados individuais. Você poderá também definir as cores para algumas partes de gráficos, como a Cor da linha dos eixos e a Cor da grade.

#### Fonte

Página 7 da configuração - Fonte

A página Fonte 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 em outras páginas, mas somente na página de fonte você terá todas as configurações em somente um lugar.

#### Fundo

Página 8 da configuração - Fundo

Na página Fundo, você poderá encontrar várias opções para ajustar a configuração do fundo do gráfico. Poderá tanto escolher entre várias cores diferentes, bem como uma imagem, para o fundo.

#### Mais...

Esta visão geral das opções de configuração forneceu-lhe uma breve introdução sobre as possibilidades de configuração do seu gráfico, sem no entanto ser de forma alguma completa. Os diferentes tipos de gráficos como Barra, Linha e Torta, possuem 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 clicar no ponto de interrogação na decoração da janela e depois clicar na área da página de configuração onde deseja obter mais informações.

## O &kchart; como uma aplicação independente

O capítulo anterior descreveu a interface do usuário, várias opções de configuração, a edição de dados e o assistente em detalhe.

Este capítulo fornece exemplos da vida real para explicar como usar o &kchart; em várias situações como uma aplicação independente. O intuito é dar-lhe algumas idéias sobre a forma como o &kchart; funciona e como as várias partes se relacionam entre si.

### Apresentar Imagens de Vendas

#### Aquecimento

Este primeiro exemplo, que poderá ser encontrado com freqüência na vida real, serve para apresentar imagens das vendas ou, neste caso em particular, o lucro.

Imagine que você possui uma companhia que tem três categorias principais de negócio: vendas, suporte e treinamento, e que gostaria de apresentar os lucros destas categorias ao longo de alguns anos. Fazer uma estatística gráfica é, certamente, uma boa idéia. O &kchart; pode ajudá-lo aqui.

#### Iniciando

Execute o &kchart; e selecione a Folha de Trabalho em Branco.

Iniciando com um gráfico em branco

Clique no botão Usar Este Modelo para começar. O &kchart; apresentará um documento completamente vazio. Isso é bom, uma vez que apenas é necessário inserir alguns dados e fazer algumas configurações básicas para obter um belo gráfico.

Um gráfico em branco

#### Inserindo os números

O primeiro passo e, provavelmente, o mais importante, é inserir os dados verdadeiros no gráfico. Isto poderá ser feito facilmente com o &dataeditor;. Como de costume, você poderá acessar ao editor de dados clicando no ícone da barra de ferramentas.

Você irá notar que não existem quaisquer dados presentes. Repare também que o número de linhas e colunas de dados é igual ao mínimo, que é 1.

Agora, basta introduzir os dados que vê na imagem a seguir. Note que você poderá aumentar o número de linhas e colunas com as caixas de incremento no canto inferior esquerdo. Os nomes das linhas e colunas poderão ser alterados, clicando neles.

Os Dados

Basta clicar no botão OK quando tiver terminado. Isso fará com que seja apresentado um gráfico de barras simples.

Gráfico simples, sem ajustes

Continue a ler para fazer alguns ajustes!

#### Ajustes Finos

Agora, nós iremos fazer alguns pequenos ajustes e será atribuído um título ao gráfico. Será também adicionado um bonito efeito 3D às barras.

Inicie a janela de configuração, clicando para isso no ícone da barra de ferramentas.

##### Título

Opções - Título

Vamos começar com as legendas. Vá para a página de Cabeçalho/Rodapé e insira o texto, tal como aparece na imagem acima.

##### Configurações da Fonte do Eixo dos X

O próximo passo é tornar o tipo de fonte do eixo dos X um pouco maior. Você pode fazer isso com a página Fonte.

Opções - Fontes

Selecione o ítem Eixo dos X e clique no botão Fonte.... Selecione um tipo de fonte um pouco maior, tal como aparece na imagem a seguir.

Opções - Fonte do Eixo dos X

Note que o tamanho da fonte está configurado como Relativo. Isto significa que a fonte é dimensionada automaticamente, de acordo com o tamanho global do gráfico. Isso é bastante útil e, na maior parte dos casos, é o que o usuário médio espera.

##### Dando um aspecto 3D

Alguns tipos de gráfico, como o de Barras e o Torta, possuem uma página de configuração adicional.

Opções - Parâmetros 3D

Para obter um efeito 3D para este tipo de gráfico, vá para a página Barra e ative a opção Barra 3D.

Isto é tudo o que é necessário para um gráfico com aspecto razoável. Repare que muita desta configuração poderá também ter sido obtida com o assistente. É apenas uma questão de preferência pessoal. Os usuários mais experientes poderão desejar usar a janela de opções completa, como nós usamos neste exemplo.

Basta aceitar as opções, clicando no botão OK.

#### Resultado final

O gráfico final irá ficar como a imagem a seguir.

Gráfico Final

Você poderá querer aumentar a janela da aplicação para ver o gráfico com o tamanho completo. Repare como os tipos de letra ficam maiores, em relação ao tamanho do gráfico.

Existem certamente alguns aspectos a melhorar ainda mais, de acordo com o seu gosto pessoal. Por exemplo, tente tornar o tipo de fonte do título ainda maior. Continue a experimentar; dessa forma, passará a conhecer bem a aplicação &kchart;.

Finalmente, você poderá salvar o gráfico no menu Arquivo e sair do &kchart; com a opção Arquivo Sair

#### Exportação para os Formatos Gráficos: SVG, PNG, JPG, &chalk;, &karbon14;, Gimp, entre outros

Para um processamento posterior, o gráfico também poderá ser exportado como um arquivo gráfico. Estão disponíveis vários formatos. A utilização de um dos formatos PNG, SVG, JPG ou do &chalk; poderá produzir o melhor resultado.

Para exportar o seu gráfico atual, basta escolher a opção Arquivo Exportar... do menu e selecionar o formato de arquivo desejado, a partir da lista.

## Usando o &kchart; no &kspread;

Além da operação independente, o &kchart; está desenhado para ser usado com o &kspread;. Este capítulo descreve como criar e manipular os gráficos dentro do &kspread;.

Lembre-se que a incorporação do &kchart; no &kspread; é uma forma muito comum e bem implementada de utilização. Os exemplos neste capítulo deverão permitir que você inicie seu uso sem problemas.

Assim que tenha criado um gráfico no &kspread;, você poderá tirar um partido completo de todas as funcionalidades do &kchart;, fazendo um duplo-clique na área do gráfico. Isto é necessário para obter todas as opções de configuração avançadas. Tenha em mente que o editor de dados não está disponível quando o &kchart; está embutido dentro do &kspread;. Isto é óbvio, uma vez que o &kspread; serve, do ponto de vista do &kchart;, como um fornecedor de dados poderoso.

A troca do X e do Y é de particular interesse, ao trabalhar com o &kspread;. Você poderá trocar a interpretação do eixo dos X e dos Y no &kchart;, na configuração do Formato dos Dados, que poderá ser acessada através do menu Editar ou no menu de contexto, quando clicar com o botão direito no gráfico em si. Como foi visto acima, é necessário estar dentro do componente do &kchart; para acessar a estas opções, o que poderá ser acontecer se fizer duplo-clique no gráfico embutido na sua planilha.

### Traçando com o &kchart;

Para traçar com o &kchart; quando ele estiver embutido no &kspread;, faça o seguinte:

Imagem de diálogo de barra de ferramentas

- Selecione a segunda linha de números.

- Em seguida, clique no botão Gráfico para criar o diagrama.

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

Os dados completos também podem ser variados usando-se duas colunas, em vez de duas linhas. Se utilizar as colunas, você poderá também querer trocar o eixo dos X e Y na configuração do &kchart;, como descrito acima.

Para fazer um diagrama de barras para itens individuais, coloque os números em uma coluna, como mostrado abaixo.

Imagem de diálogo de barra de ferramentas

A orientação dos números determina como os pontos serão feitos.

- Um linha de números define as ordenadas para um ponto simples.

- Uma coluna de números define a altura para cada barra, no gráfico de barras. Ela também determina o tamanho das fatias em um diagrama em pizza.

## Referência de Comando

### A Janela Principal do &kchart;

#### O Menu Arquivo

&Ctrl;N Arquivo Novo

- Cria um novo documento

&Ctrl;O Arquivo Abrir...

- Abre um documento

Arquivo Abrir Recente

- Mostra uma lista com os documentos abertos recentemente

&Ctrl;S Arquivo Salvar

- Salva o gráfico no arquivo atual. Se o gráfico ainda não tiver sido gravado, é mostrada o diálogo de arquivos.

Arquivo Salvar Como...

- Salva o documento, sendo usada o diálogo de seleção de arquivos.

Arquivo Recarregar

- Recarrega o documento.

Arquivo Importar...

- Abre um documento em qualquer formato suportado. O documento original não será modificado.

Arquivo Exportar...

- Salva um documento em qualquer formato suportado. O documento não se torna o arquivo exportado. Você poderá também escolher entre vários formatos de imagem, como o PNG, o SVG, o do &chalk;, o do Gimp ou o JPG.

Arquivo Enviar por E-Mail...

- Envia o gráfico como um anexo de e-mail.

Arquivo Importar Dados...

- Importa os valores em CSV (Comma Separated Values - Valores Separados por Vírgulas) de um arquivo, tal como acontece na importação em CSV do &kspread;. Note que você poderá indicar várias opções e separadores diferentes (não apenas as vírgulas).

Arquivo Criar Modelo a Partir do Documento...

- Cria um modelo do &kchart;, baseado neste documento.

&Ctrl;P Arquivo Imprimir...

- Imprime o documento

  Certifique-se de ter selecionado o sistema de impressão correto na seção Sistema de impressão em uso:. Esta opção pode ser vista depois de clicar no botão Opções >>.

Arquivo Previsão da Impressão...

- Mostra uma previsão do aspecto do documento, depois de impresso.

Arquivo Informação do Documento

- Abre uma caixa de diálogo onde você pode inserir informações sobre seu gráfico.

  Estas informações do documento serão mostradas no gerenciador de arquivos &konqueror; como uma dica útil. As dicas úteis são janelas instantâneas que mostram o conteúdo de um arquivo quando você move seu mouse sobre o ícone do arquivo.

&Ctrl;F Arquivo Fechar

- Fecha o gráfico atual.

&Ctrl;I Arquivo Sair

- Sai do &kchart;

#### O Menu Editar

Editar Editar Dados...

- Abre o &dataeditor;.

#### O Menu Formatar

Formatar Gráfico...

- Abre a janela de Configuração do &kchart;.

##### O Guia Configurar

Formato dos Dados...

- Trocar as linhas e colunas (inversão X/Y).

Sub-Tipo do Gráfico...

- Mude o arranjo do gráfico de barras.

Cabeçalho & Rodapé...

- Insira os títulos que você deseja para seu gráfico aqui.

Cores...

- Selecione aqui as cores do gráfico, cores da linha, da grade, do título e dos rótulos dos eixos.

Fonte...

- Selecione aqui o estilo e tamanho da fonte. Também podem ser aqui selecionadas as cores das séries. As séries referem-se ao gráficos individuais; cada conjunto de dados no gráfico é uma série.

Fundo...

- Selecione uma cor ou papel de parede como fundo para o seu gráfico.

Legenda...

- Muda o título, a fonte e a localização das legendas. A cor da caixa das legendas também pode ser alterada aqui.

Disposição da Página...

- Configure as Margens da página aqui.

#### O Menu Configurações

Configurações Barras de Ferramentas

- Mostra/Oculta as várias barras de ferramentas (Arquivo, Ações e Tipos).

Configurações Configurar Atalhos...

- Configura os atalhos de teclado do &kchart;.

Configurações Configurar Barras de Ferramentas...

- Configura as barras de ferramentas do &kchart;.

#### O Menu Ajuda

&help.menu.documentation;

#### Configurar Atalhos

O Configurações Configurar Atalhos... lhe permite especificar atalhos de teclado.

Abaixo está um exemplo de como configurar um atalho para abrir o assistente de gráfico.

Imagem de diálogo de atalho

- Clique em Personalizado.

- Em seguida clique em Atalho primário:.

- Tecle `&Alt;&Ctrl;W` e o diálogo deve desaparecer. O atalho é agora inserido.

Agora, ao clicar nas teclas `&Alt;&Ctrl;W` será aberto o assistente.

#### Configurar Barra de Ferramentas

O Configurações Configurar Barra de Ferramentas... é usado para adicionar botões às barras de ferramentas.

Imagem de diálogo de barra de ferramentas

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

  Imagem de diálogo de barra de ferramentas

  certifique-se de que Arquivo <&koffice;> é exibido no topo da caixa combinada.

- Clique em um dos ítens do painel do lado esquerdo. Este ítem passa a ficar realçado, mostrando que foi selecionado.

- Em seguida, clique no botão Seta para direitapara colocá-lo no painel à direita.

- Clique em `Aplicar` e então clique em `OK`

O novo item deverá estar na barra de ferramentas.

## Créditos e Licença

&kchart;

Copyright do Programa 1998-2005 do &kchart;

Autores Originais:

- &Matthias.Kalle.Dalheimer; &Matthias.Kalle.Dalheimer.mail;

- Torben Weis weis@kde.org

Contribuidores:

- Laurent Montel lmontel@mandrakesoft.com

- Karl-Heinz Zimmer khz@kde.org

- Inge Wallin inge@lysator.liu.se

Copyright da Documentação 2002 de &Jonathan.Drews; &Jonathan.Drews.mail;

Copyright da Documentação 2005 de Raphael Langerhorst raphael.langerhorst@kdemail.net

Tradução de Marcus Gamamarcus.gama@gmail.com

&underFDL; &underGPL;
&documentation.index;