# 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.

Quando você iniciar o &kchart; como uma aplicação autónoma, irá obter a janela normal de arranque, onde poderá escolher entre vários modelos ou carregar os documentos de gráficos existentes.

Janela Inicial do &kchart;

Poderá escolher entre várias maneiras de iniciar o &kchart;. No cimo da janela, poderá ver três páginas de opções: os Documentos Recentes, os modelos de Gráficos e o Abrir um Documento Existente.... A primeira serve para criar um novo gráfico a partir de vários modelos, a segunda para abrir um gráfico existente com uma janela de ficheiros e a última permite-lhe escolher entre os gráficos abertos recentemente.

Por agora, iremos começar com o modelo predefinido. Seleccione os Gráficos na área da esquerda e, finalmente, seleccione o Gráfico de Barras na área principal do modelo. Normalmente, este modelo já deverá estar seleccionado após escolher os Gráficos.

Se optar por iniciar o &kchart; com um modelo seleccionado por omissão, poderá também seleccionar esta opção no fundo da janela.

Carregue no botão Usar Este Modelo à direita, sob a antevisão do modelo.

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 0 - Escolher a Fonte de Dados

Passo 0 do Assistente - Fonte de dados

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

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

Poderá então 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 1 - Escolher o Tipo de Gráfico

Passo 1 do Assistente - Tipo de Gráfico

O próximo passo do assistente é escolher, de facto, o tipo primário do gráfico. Esta selecção tem o impacto mais importante 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 Linhas. Dependendo do tipo de gráfico escolhido, ficarão disponíveis diferentes opções nos passos seguintes.

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

#### 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 Formato Gráfico... do menu ou carregue no ícone da barra de ferramentas. Poderá ter de carregar na seta esquerda ou direita no cimo da janela, para obter todas as páginas desta, no caso de a largura da janela ser demasiado estreita.

#### 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.

#### Cabeçalho 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 e activar ou desactivar a grelha.

#### 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 e a Cor da grelha dos eixos.

#### 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, como os de Barras, Linhas e Circulares 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

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

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

### Apresentar Imagens de Vendas

#### Aquecimento

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

Imagine que possui uma companhia que tem três categorias principais de negócio: vendas, suporte e formação, e que gostaria de apresentar os lucros destas categorias ao longo de alguns anos. Fazer uma estatística gráfica é, certamente, uma boa ideia. O &kchart; podê-lo-á ajudar aqui.

#### Introdução

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

Iniciar com um gráfico em branco

Carregue no botão Usar Este Modelo para começar. O &kchart; apresentar-lhe-á um documento completamente vazio. Isso é bom, dado que apenas é necessário introduzir alguns dados e fazer algumas configurações básicas para obter um gráfico bonito.

Um gráfico em branco

#### Introduzir os números

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

Irá notar que não estão 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 seguinte. Repare que poderá aumentar o número de linhas e colunas no canto inferior esquerdo. Os nomes das linhas e colunas poderão ser alterados, quando carregar neles.

Os Dados

Basta carregar no botão OK quando tiver terminado. Isso apresentar-lhe-á um gráfico de barras simples.

Gráfico simples, sem ajustes

Continue a ler para fazer alguns ajustes!

#### Ajustes de Pormenor

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

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

##### Título

Opções - Título

Comecemos com a legendagem. Vá à página de Cabeçalho/Rodapé e introduza o texto, tal como aparece na imagem acima.

##### Configuração do Tipo de Letra do Eixo dos X

O próximo passo é tornar o tipo de letra do eixo dos X um pouco maior. Podê-lo-á fazer com a página Tipo de Letra.

Opções - Tipos de Letra

Escolha o item Eixo dos X e carregue no botão Tipo de Letra.... Escolha um tipo de letra um pouco maior, tal como aparece na imagem seguinte.

Opções - Tipo de Letra do Eixo dos X

Repare como o tipo de letra está configurado como Relativo. Isto significa que o tipo de letra é dimensionado automaticamente, de acordo com o tamanho global do gráfico. Isso é bastante útil e, na maior parte dos casos, é o que o utilizador médio pretende.

##### Dar-lhe um aspecto 3D

Muitos dos tipos de gráfico, como o de Barras e o Circular, têm uma página de configuração adicional.

Opções - Parâmetros 3D

Para obter um efeito 3D no gráfico, basta ir à página Barra e activar a opção barras 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 gosto o que pretender usar. Os utilizadores mais experientes poderão querer usar a janela de opções completa, tal como aconteceu neste exemplo.

Basta aceitar as opções, carregando para tal no botão OK.

#### Resultado final

O gráfico final irá ficar como a imagem seguinte demonstra.

Gráfico Final

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 letra do título ainda maior. Continue a experimentar; dessa forma, irá passar a conhecer muito a aplicação &kchart;.

Finalmente, poderá gravar a aplicação no menu Ficheiro e sair do &kchart; com a opção Ficheiro 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 ficheiro 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 actual, basta escolher a opção Ficheiro Exportar... do menu e seleccionar o formato de ficheiro desejado, a partir da lista.

## 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;.

Lembre-se que a incorporação do &kchart; no &kspread; é uma forma muito comum e bem implementada de utilização, pelo que os exemplos deste capítulo deverão pô-lo a par sem problemas.

Assim que tenha criado um gráfico no &kspread;, poderá tirar um partido completo de todas as funcionalidades do &kchart;, fazendo um duplo-click 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á incorporado dentro do &kspread;. Isto é óbvio, dado 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;. Poderá trocar a interpretação do eixo dos X e dos Y no &kchart;, na configuração do Formato dos Dados, o que poderá ser acedido através do menu Editar ou no menu de contexto, quando carregar com o botão direito no gráfico em si. Como foi visto acima, é necessário estar dentro do componente do &kchart; para aceder a estas opções, o que poderá ser acontecer se fizer duplo-click no gráfico incorporado na sua folha de cálculo.

### 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.

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

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

- Mostra uma lista com os documentos abertos recentemente

&Ctrl;S Ficheiro Gravar

- Grava o documento no ficheiro actual. Se o gráfico ainda não tiver sido gravado, é mostrada a janela de ficheiros.

Ficheiro Gravar Como...

- Grava o documento, sendo usada a janela de selecção de ficheiros.

Ficheiro Recarregar

- Volta a carregar o documento.

Ficheiro Importar...

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

Ficheiro Exportar...

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

Ficheiro Enviar por E-Mail...

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

Ficheiro Importar Dados...

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

Ficheiro Criar um Modelo a Partir do Documento...

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

&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 Opções >>.

Ficheiro Antevisão da Impressão...

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

Ficheiro Informação do 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.

&Ctrl;W Ficheiro Fechar

- Fecha o gráfico actual.

&Ctrl;Q Ficheiro Sair

- Sai do &kchart;

#### O Menu Editar

Editar Editar Dados...

- Abre o &dataeditor;.

#### O Menu Formato

Formato Gráfico...

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

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

Formato dos Dados...

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

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.

Cores...

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

Tipo de Letra...

- Seleccione aqui 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 é uma série.

Fundo...

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

Legenda...

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

Disposição da Página...

- Configure as Margens da página aqui.

#### O Menu Configuração

Configuração Barras de Ferramentas

- Mostra/esconde as várias barras de ferramentas (Ficheiro, Acções e Tipos).

Configuração Configurar os Atalhos...

- Configura os atalhos de teclado do &kchart;.

Configuração Configurar as Barras de Ferramentas...

- Configura as barras de ferramentas do &kchart;.

#### O Menu Ajuda

&help.menu.documentation;

#### 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 em Personalizado.

- De seguida, carregue no botão Atalho 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 ficar realçado, o 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.

## Créditos e Licença

&kchart;

Programa copyright 1998-2005 a Equipa do &kchart;

Autores Originais:

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

- Torben Weis weis@kde.org

Contribuições:

- Laurent Montel lmontel@mandrakesoft.com

- Karl-Heinz Zimmer khz@kde.org

- Inge Wallin inge@lysator.liu.se

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

Documentação copyright 2005 Raphael Langerhorst raphael.langerhorst@kdemail.net

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

&underFDL; &underGPL;
&documentation.index;