# Manuel de &kchart;

## Introduction

&kchart; est un outil pour visualiser les données numériques. Il peut être utilisé comme une application indépendante avec un simple éditeur de données. Mais, en tant que composant de &koffice;, il offre une intégration très flexible. &kspread; utilise le composant &kchart; pour les diagrammes. &kspread; peut être considéré comme un outil d'alimentation en données très puissant comme entrée pour &kchart;.

Mais l'intégration n'est pas limitée à &kspread;. Un diagramme &kchart; peut être intégré dans beaucoup des composants de &koffice;, comme &kword;, &kpresenter; ou &kivio;.

Pour commencer, nous allons observer l'interface de &kchart; et comment on peut l'utiliser comme application indépendante. Quand nous serons familiers avec &kchart;, nous étudierons les capacités de graphe qu'il offre en partenariat avec &kspread;.

## L'interface utilisateur

### L'interface principale de l'application

Nous allons examiner un simple exemple pour apprendre à connaître &kchart;. Au cours du chemin, nous discuterons aussi de l'interface utilisateur, et, ainsi, vous apprendrez beaucoup de détails du composant.

Quand vous démarrez &kchart; comme une application indépendante, vous obtenez l'habituel dialogue de démarrage où vous pouvez choisir entre différents modèles ou charger des documents de diagrammes existants.

Dialogue de démarrage de KChart

Vous pouvez choisir entre diverses manières de démarrer &kchart;. En haut de la boîte de dialogue, vous voyez trois pages d'options. La première est pour créer un nouveau diagramme à partir de divers modèles, la deuxième pour ouvrir un diagramme existant avec un dialogue de fichiers, et la dernière vous permet de choisir parmi des diagrammes récemment ouverts.

Pour l'instant, nous commencerons avec le modèle par défaut. Sélectionnez la page Créer un document, puis choisissez Diagrammes dans la zone de gauche, et sélectionnez finalement Diagramme en barres dans le modèle principal.

Si vous décidez de démarrer &kchart; avec un modèle sélectionné comme modèle par défaut, vous pouvez aussi sélectionner cette option en bas de la boîte de dialogue.

Maintenant, cliquez sur le bouton OK pour commencer avec un diagramme en barres.

Interface utilisateur de KChart

Comme vous pouvez le voir, il y a déjà des données exemples. &kchart; offre la barre d'outils par défaut pour créer un nouveau diagramme, l'enregistrer, en charger un et en imprimer un. La deuxième barre d'outils offre des icônes pour modifier les données, configurer le diagramme ou utiliser un assistant de configuration. Vous pouvez aussi passer d'un mode à l'autre avec les autres icônes. Notez que certains de ces types de diagrammes ont des sous-types.

Le menu offre toutes les entrées standard, y compris la configuration des raccourcis et la page de mise en page pour l'impression.

Notez que l'édition des données n'est pas disponible si vous utilisez &kchart; à partir de &kspread;, car toutes les données sont fournies pas le tableur. En tant qu'application indépendante, l'éditeur de données est une partie importante de l'application.

### Assistant de diagramme

L'assistant est, en fait, une partie très utile de &kchart; pour déterminer rapidement certaines options de base, comme le type de diagramme ou les libellés en quelques étapes simples.

Vous pouvez lancer l'assistant n'importe quand. Il préservera toujours les données. De plus, vous pouvez changer chaque configuration que vous faites avec l'assistant ultérieurement, sans perdre quoi que ce soit. en fait, l'assistant est simplement une manière de déterminer des options de base et importantes d'un seul coup.

Pour démarrer l'assistant cliquez sur l'icône dans la barre d'outils.

#### Étape 1 - Choisir un type de diagramme

Étape 1 de l'assistant - Type de diagramme

La première étape dans l'assistant est de choisir le type primaire du diagramme. Cette sélection a le plus grand impact sur la manière dont vos données seront présentées. Ainsi, il faut bien le choisir. Vous pouvez changer le type de diagramme avec les icônes dans la barre d'outils sans perdre de données ni la configuration plus tard. En fait, il est même considéré comme normal pour tester tous les types de diagrammes pour trouver celui qui convient le mieux.

Dans cet exemple, nous choisissons le type Ligne. En fonction du type de diagramme choisi, différentes options sont disponibles dans les étapes suivantes.

Après avoir choisi le type, vous pouvez passer à l'étape suivante avec le bouton Suivant. Vous pouvez aussi choisir Terminer à n'importe quel moment si vous êtes déjà satisfait du réglage à ce moment.

#### Étape 2 - Choisir le sous-type

Étape 1 de l'assistant - Sous-type de diagramme

Au cas où le type de diagramme a différents sous-types, vous pouvez en choisir un dans la deuxième étape. Si le type de diagramme n'a pas de sous-type, cette étape sera sautée automatiquement.

Si vous désirez changer le sous-type plus tard, vous pouvez le faire dans la boîte de dialogue appropriée, qui sera montrée plus tard.

Vous pouvez simplement laisser la sélection par défaut et aller à l'étape suivante. Bien sûr, vous pouvez choisir n'importe quel type désiré.

#### Étape 3 - Libellés et légendes, Polices

Étape 3 de l'assistant - Libellés et légendes

Lors de la troisième étape, vous pouvez déterminer le texte pour le titre du diagramme, les axes et la légende. Vous pouvez aussi configurer la police désirée en détail pour chacun d'entre eux.

#### Étape 4 - Axes

Étape 4 de l'assistant - Axes

La dernière étape de l'assistant vous permet de déterminer différentes options pour les axes et les autres options, en fonction du type de diagramme.

You can either choose Finish to accept the options for your chart, go Back and change various things or simply dismiss all options from the wizard by choosing Cancel.

Si vous choisissez Terminer, tous vos choix dans l'assistant seront intégrés dans le diagramme et vous pouvez continuer à saisir des données et faire des réglages fins d'options variées.

Souvenez-vous que le dialogue de configuration du diagramme a beaucoup plus d'options disponibles. Nous en discuterons plus tard.

### L'éditeur de données

L'&dataeditor; s'atteint en sélectionnant Édition Éditer les données... à partir du menu, ou en cliquant sur l'icône dans la barre d'outils.

&dataeditor; en mode indépendant

L'&dataeditor; peut être utilisé pour déterminer toutes les valeurs. Vous pouvez aussi définir le nombre de lignes et de colonnes.

En fonction du type de diagramme, les lignes et colonnes ont différente représentations. Chaque ligne peut généralement être considérée comme une série de données et chaque colonne représente les valeurs de toutes les séries de données à un certain emplacement.

Le nom d'un lot de données peut être changé en cliquant sur l'en-tête de ligne (à gauche de la première colonne contenant des valeurs). Le nom d'une colonne peut être changé en cliquant sur l'en-tête de colonne (au-dessus de la première ligne).

Le nombre de lignes et de colonnes peut être ajusté pour s'adapter aux besoins. Depuis la version 1.4, la restriction de 16 lignes et de 16 colonnes a été éliminée.

### Configuration du diagramme

&kchart; offre beaucoup d'options de configuration pour le diagramme. Elles sont disponibles en mode indépendant et en mode intégré à &kspread;.

En fonction du type de diagramme que vous avez choisi, les options disponibles sont quelque peu différentes. Choisissons le type de diagramme Ligne en cliquant sur l'icône de la barre d'outils.

Pour obtenir le dialogue de configuration du diagramme, sélectionnez Édition Diagramme Configurer le diagramme... dans le menu ou cliquez sur l'icône dans la barre d'outils.

#### Permutation de Ligne et Colonne

Configuration page 1 - Inversion de ligne et colonne

La première page de configuration peut servir à inverser l'interprétation des lignes et colonnes. Par défaut, une ligne est supposée être un ensemble de données et chaque colonne contenir les valeurs individuelles pour les séries de données. Ici, vous pouvez choisir que chaque colonne gère un ensemble de données. Notez que les valeurs ne sont pas vraiment inversées, mais seulement leur interprétation.

#### Sous-type de diagramme

Configuration page 2 - Sous-type de diagramme

La deuxième page peut servir à sélectionner le sous-type de diagramme désiré. Les sous-types disponibles dépendent du type de diagramme, dans ce cas, le diagramme en ligne. Certains diagrammes n'ont pas de sous-type du tout, et, dans ce cas, cette page de configuration n'est pas affichée. Vous obtenez aussi un aperçu pour chaque sous-type.

Souvenez-vous que le type de diagramme peut être choisi dans la barre d'outils, alors que le sous-type peut-être choisi par cette boîte de dialogue de configuration.

#### Titre et Pied de page

Configuration page 3 - Titre et Pied de page

Sur la troisième page, vous pouvez déterminer le titre, les sous-titres et le pied du diagramme, chacun disposant d'un réglage individuel de police.

#### Légende

Configuration page 4 - Légende

La page de configuration de légende vous permet de déterminer tous les aspects de la légende. La légende contient les noms pour tous les ensembles de données, avec les couleurs respectives. Ceci est important pour identifier les données sur un diagramme.

La boîte Général gère le titre de la légende, qui est affiché en haut de la boîte de légende. La boîte Position peut être utilisée pour placer la légende à différents emplacements sur le diagramme. Utilisez le bouton central pour cacher la légende.

La boîte Police sert à déterminer différentes polices pour le titre de légende et les entrées individuelles. De plus, vous pouvez déterminer différentes couleurs dans la boîte Couleurs.

#### Axes

Configuration page 5 - Axes

La page Axes gère la configuration pour les axes du diagramme. Cette page dépend hautement du type de diagramme choisi. Pour les diagrammes en lignes, vous pouvez déterminer les échelles linéaire ou logarithmique, afficher ou non le quadrillage, et le marqueur de ligne met un carré à chaque valeur de donnée.

#### Couleurs

Configuration page 6 - Couleurs

Sur la page des couleurs, vous pouvez choisir les couleurs pour les ensembles individuels de données. Vous pouvez aussi déterminer les couleurs pour certaines parties générales de diagramme, comme la couleur des lignes d'axes et de quadrillage.

#### Police

Configuration page 7 - Police

La page des polices sert à configurer diverses polices, comme celles des axes, titres, libellés et ainsi de suite. Certaines de ces polices peuvent aussi être déterminées sur d'autres pages, mais, sur la page des polices, vous les avez toutes en un seul endroit.

#### Fond

Configuration page 8 - Fond

Sur la page du fond, vous trouverez diverses options pour affiner les réglages du fond du diagramme. Vous pouvez soit choisir différentes couleurs de fond, soit une image.

#### Davantage...

Ce court survol des options de configuration vous a donné une introduction aux possibilités de configuration de votre diagramme, mais n'est en aucune manière complet. Différents types de diagrammes p,t des ages de configuration supplémentaires spécialisées et vous êtes invité à y jeter un oeil, essayer différents aspects de diagrammes et tester les possibilités de configuration. Utilisez les infobulles et lisez l'aide Qu'est-ce que c'est ? Pour utiliser l'aide Qu'est-ce que c'est ?, cliquez simplement sur le point d'interrogation sur la décoration de la fenêtre, puis cliquez sur sur la zone de la page de configuration sur laquelle vous voulez davantage d'informations.

## &kchart; en tant qu'application indépendante

Le chapitre précédent décrivait l'interface utilisateur, diverses options de configuration, l'édition de données et l'assistant en détails.

Ce chapitre donne des exemples de la vie réelle sur la manière d'utiliser &kchart; dans diverses situations comme une application indépendante. L'objet est de vous donner une compréhension sur la manière dont &kchart; fonctionne, et comment les diverses parties sont liées ensemble.

### Présentation de résultats de ventes

#### Échauffement

Le premier exemple qui peut être rencontré dans la vraie vie est la présentation de courbes de ventes, ou, dans ce cas particulier, des bénéfices.

Imaginez que vous possédiez une société qui a trois branches principales d'activité : les ventes, le support et la formation. Et vous voudriez présenter les bénéfices de ces catégories sur les dernières années. Faire un graphique statistique est certainement une bonne idée. &kchart; peut vous aider ici.

#### Commencer

Lancez &kchart; et sélectionnez un modèle vide.

Commencer avec un diagramme vide

Actionnez le bouton OK pour commencer. &kchart; vous présentera un document complètement vide. Ça tombe bien, puisque nous voulons saisir des données et faire une configuration de base pour obtenir un joli graphique.

Un diagramme vide

#### Introduire les nombres

La première étape, et probablement la plus importante, est d'introduire les données dans le graphique. Ceci se fait facilement avec le &dataeditor;. Comme d'habitude, vous pouvez aller dans l'éditeur de données en cliquant sur l'icône dans la barre d'outils.

Vous noterez qu'aucune donnée n'est présente. Aussi, notez que le nombre de lignes et de colonnes de données est réglé au minimum, qui est 1.

Maintenant, saisissez les données que vous voyez dans la capture d'écran suivante. Notez que vous pouvez augmenter le nombre de lignes et de colonnes avec les compteurs dans le coin inférieur gauche. On peut changer les noms des lignes et des colonnes elles-mêmes en cliquant dessus.

Les données

Cliquez simplement sur le bouton OK quand c'est fini. Ceci vous montrera un simple diagramme en barre.

Graphique simple sans réglage fin.

Continuez à lire pour faire des réglages fins !

#### Réglages fins

Nous allons maintenant faire des réglages fins et mettre un titre sur le graphique. Et nous allons ajouter un joli effet 3D.

Commencez le dialogue de configuration en cliquant sur l'icône dans la barre d'outils.

##### Titre

Options - Titre

Commençons avec les libellés. Allez sur la page En-tête / Pied de page, et écrivez le texte comme dans la capture d'écran ci-dessus.

##### Réglages de police de l'axe des X

L'étape suivante est d'agrandir un peu les polices de l'axe des X. Vous pouvez faire ceci sur la page Police.

Options - Polices

Choisissez l'élément Axe des X et cliquez sur le bouton Police.... Choisissez une police un peu plus grande, comme dans la capture d'écran suivante.

Options - Police de l'axe des X

Notez que la police est réglée sur Relative. Ceci signifie que la police est automatiquement étirée selon la taille du graphique. C'est très utile, et la plupart du temps ce que les utilisateurs moyens attendent.

##### Donner un aspect 3D

La page de configuration finale est Paramètres 3D. Vous pouvez avoir besoin de cliquer sur la flèche droite en haut pour l'obtenir si la largeur de la boîte de dialogue est trop petite.

Options - Paramètres 3D

Pour obtenir un effet 3D pour le graphique, activez simplement Histogramme 3D.

C'est tout ce dont nous avons besoin pour un graphique à bonne allure. Notez que le plus gros de cette configuration peut aussi se faire avec l'assistant. C'est essentiellement une question de goût. Les utilisateurs avancés utiliseront probablement le dialogue avec toutes les options que nous avons utilisées dans cet exemple.

Acceptez simplement les options en cliquant sur le bouton OK.

#### Sortie finale

Le diagramme final ressemblera à la capture d'écran suivante.

Diagramme final

Vous pouvez vouloir agrandir la fenêtre de l'application pour voir le graphique en pleine taille. Notez comment les polices deviennent plus grandes en fonction de la taille du diagramme.

Il y a certainement des aspects à améliorer pour votre goût personnel. Par exemple, essayez de rendre la police de titre encore plus grande. Expérimentez plus loin, de cette manière, vous obtiendrez du savoir-faire sur l'application &kchart;.

Finally you can save the application from the File menu and quit with File Quit

#### Exportation de graphes en formats : SVG, PNG, JPG, Krita, Karbon14, Gimp et autres

Pour un traitement ultérieur, le diagramme peut aussi être exporté comme fichier graphique. Beaucoup de formats sont disponibles. L'utilisation de PNG, SVG, JPG ou Krita produiront probablement le meilleur résultat.

Pour exporter le diagramme actuel, effectuez simplement Fichier Exporter... dans le menu et sélectionnez le format de fichier désiré dans la boîte de filtre.

## Utilisation de &kchart; dans &kspread;

En plus des opérations indépendantes, &kchart; est conçu pour être utilisé conjointement avec &kspread;. Ce chapitre décrit comment créer et manipuler des graphiques depuis &kspread;.

Souvenez-vous que l'intégration de &kchart; dans &kspread; est une fonctionnalité souvent utilisée et efficace. Les exemples de ce chapitre devraient juste vous permettre de démarrer.

Aussitôt que vous avez créé un diagramme dans &kspread;, vous pouvez avoir les avantages de toutes les fonctionnalités de &kchart; en double-cliquant sur la zone de diagramme. C'est nécessaire pour obtenir les options de configuration avancées. Gardez en tête que l'éditeur de données n'est pas disponible quand &kchart; est intégré dans &kspread;. C'est évident, car &kspread; sert, du point de vue de &kchart;, de fournisseur de données puissant.

L'inversion des x et des y est particulièrement intéressante en cas de travail avec &kspread;. Vous pouvez permuter l'interprétatin des axes x et y dans les réglages de format de données, qui peuvent être atteints par le menu Édition ou par le menu contextuel obtenu en cliquant du &BDS; sur le diagramme lui-même. Comme noté plus haut, vous avez besoin d'être dans le composant &kchart; pour accéder à ces réglages, ce qui peut se faire en double-cliquant sur le graphique enchâssé dans votre tableur.

### Tracer des diagrammes avec &kchart;

Pour tracer des diagrammes avec &kchart; lorsqu'il est intégré à &kspread;, faites ce qui suit :

Image de la boîte de dialogue des barres d'outils

- Surlignez la seconde rangée de nombres.

- Cliquez ensuite sur le bouton Graphique pour créer le graphique.

- Sélectionnez les options désirées dans l'assistant de graphiques. L'assistant de graphiques surgira lorsque vous aurez inséré le graphique.

La totalité des données peut aussi être créée en utilisant deux colonnes au lieu de deux lignes. En cas d'utilisation de colonnes, vous pouvez inverser les axes des X et des Y dans la configuration de &kchart;, comme décrit plus haut.

Pour faire un diagramme pour des éléments individuels, mettez le nombre dans une colonne comme vous pouvez le voir ci-dessous.

Image de la boîte de dialogue des barres d'outils

L'orientation des nombres détermine comment le diagramme sera fait.

- Une rangée de nombres définit l'ordonnée d'un point unique.

- Une colonne de nombres définit la hauteur de chaque barre dans un histogramme. Elle détermine aussi la taille des tranches dans un camembert.

## Référence des commandes

### La fenêtre principale de &kchart;

#### Le menu Fichier

&Ctrl;N Fichier Nouveau

- Crée un nouveau document

&Ctrl;O Fichier Ouvrir...

- Ouvre un document

Fichier Récemment ouvert(s)

- Ouvre un document récemment enregistré

&Ctrl;S Fichier Enregistrer

- Saves the document to the current file. If the chart has not yet been saved the file dialog is shown.

Fichier Enregistrer sous...

- Enregistre le document, le dialogue des fichiers sera utilisé.

Fichier Recharger

- Recharge le document.

Fichier Importer...

- Ouvre un document avec n'importe quel format géré. Le document ne devient pas le fichier importé.

Fichier Exporter...

- Enregistre un document vers n'importe quel format géré. Le document ne devient pas le fichier exporté. Vous pouvez aussi choisir parmi plusieurs formats d'images, comme PNG, SVG, Krita, Gimp ou JPG.

Fichier Importer les données...

- Importe des valeurs CSV à partir d'un fichier, comme l'importation CSV de KSpread. Notez que vous pouvez spécifier diverses options et différents séparateurs (pas juste des virgules).

Fichier Créer un modèle à partir du document...

- Créer un modèle de graphique &kchart; basé sur ce document.

&Ctrl;P Fichier Imprimer...

- Imprime le document

  Assurez-vous que l'imprimante adéquate est sélectionnée dans la section Système d'impression actuellement utilisé. Cette option est visible en cliquant sur le bouton Développer.

Fichier Aperçu avant impression

- Affiche une image du document tel qu'il apparaîtra lorsqu'il sera imprimé.

Fichier Informations sur le document

- Ouvre une boîte de dialogue où vous pouvez saisir des informations concernant votre graphique

  Ces informations sur le document seront affichées dans le gestionnaire de fichiers de &konqueror; comme une astuce. Les astuces sont des fenêtres surgissante qui affichent le contenu d'un fichier quand vous déplacer la souris sur l'icône de celui-ci.

Fichier Envoyer par message électronique...

- Envoie le diagramme comme pièce jointe.

&Ctrl;W Fichier Fermer

- Ferme le diagramme actuel.

&Ctrl;Q Fichier Quitter

- Quitte&kchart;

#### Le menu Édition

Édition Éditer les données...

- Tableau pour saisir les données.

Édition Configurer...

- Boîte de dialogue pour configurer le diagramme

##### Les onglets de configuration

Format des données

- Inverser les lignes et les colonnes.

Couleurs

- Sélectionnez la couleur du diagramme, du quadrillage et des titres ici.

Police

- Sélectionnez la taille et le style de la police ici. Les couleurs des séries peuvent aussi être sélectionnées ici. Les séries se réfèrent aux diagrammes individuels. Chaque ensemble de donnés dessinées est une série.

Fond

- Sélectionnez la couleur du fond pour votre diagramme.

  Les fonds avec image ne fonctionnent pas actuellement.

Légende

- Changer l'emplacement de la boîte de légende. La couleur de la boîte de légende peut aussi être changée. Le boîte de légende contient la couleur des séries de diagramme.

Axes

- Les axes peuvent être activés ou désactivés ici.

  Ici, toutes les fonctionnalités ne marchent pas encore.

Paramètres 3D

- La perspective pour les histogrammes 3D peut être configurée ici.

Sous-type de diagramme

- Modifie l'arrangement des histogrammes.

En-tête/Pied de page

- Saisissez le titre souhaité pour votre diagramme ici.

#### Le menu Configuration

Configuration Barre d'outils

- Afficher/Cacher diverses barres d'outils.

Édition Configurer les raccourcis clavier...

- Configurer les raccourcis clavier de &kchart;.

Configuration Configurer les barres d'outils...

- Configurer les barres d'outils de &kchart;.

#### Configurer les raccourcis clavier...

Le Configuration Configurer les raccourcis clavier... vous permet de spécifier les raccourcis clavier

Vous trouverez ci-dessous un exemple de la manière de configurer un raccourci clavier ouvrant l'assistant de diagramme.

Image de la boîte de dialogue de raccourcis clavier

- Cliquez sur le bouton Personnalisée.

- Cliquez ensuite sur le bouton Raccourci principal.

- Faites `&Alt;&Ctrl;W` et la boîte de dialogue disparaîtra. Le raccourci clavier est maintenant saisi.

Maintenant, en appuyant sur les touches `&Alt;&Ctrl;W`, vous ouvrez l'assistant.

#### Configurer les barres d'outils

Configuration Barre d'outils... est utilisé pour ajouter des boutons supplémentaires à la barre d'outils.

Image de la boîte de dialogue des barres d'outils

- Pour ajouter un bouton à la barre d'outils Fichier,

  Image de la boîte de dialogue des barres d'outils

  assurez vous que Fichier <KOfficeShell> est affiché en haut de la boîte combinée.

- Cliquez sur un des éléments dans le panneau de gauche. Cet élément aura maintenant un fond bleu montrant qu'il a été sélectionné.

- Cliquez ensuite sur le bouton représenté par une flèche vers la droite pour le mettre dans le panneau de droite.

- Cliquez sur `Appliquer` et cliquez ensuite sur `OK`

Le nouvel élément sera dans la barre d'outils.

#### Le menu Aide

&help.menu.documentation;

## Remerciements et licence

&kchart;

Program copyright 1998-2005 the KChart Team

Auteurs originaux :

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

- Torben Weis weis@kde.org

Contributeurs :

- Laurent Montel lmontel@mandrakesoft.com

- Karl-Heinz Zimmer khz@kde.org

- Inge Wallin inge@lysator.liu.se

Copyright de documentation 2002 &Jonathan.Drews; &Jonathan.Drews.mail;

Documentation copyright 2005 Raphael Langerhorst raphael.langerhorst@kdemail.net

Traduction française par &LaurentRathle; et &GerardDelafond;

&underFDL; &underGPL;
&documentation.index;