Présentation

TeeChart (créer au départ par David Berneda) de la société Steema Software permet l'affichage de graphes en deux ou trois dimensions comme peut faire le logiciel Excel de Microsoft. Grâce au composant TChart, vous pourrez par exemple tracer des courbes ou réaliser le résultat d'un sondage. Teechart possède un module d'impression pour imprimer les graphes.

Exemple d'utilisation

Le but de cet exemple est de vous familiarisé avec le composant TChart.



Créez un nouveau projet sous Delphi.
Puis, placez un composant TChart de l'onglet "Supplément" de la palette de composants de Delphi.

Créer une série pour le graphe en mode concpetion

Cliquez avec le bouton droit de la souris sur se composant. Une menu surgissant apparait alors. Cliquez sur "Modifier le graphe...". Cette fenêtre apparait.



Pour accèder à cette fenêtre, vous pouvez faire un double-clic sur le composant.
Ensuite, cliquez sur le bouton "Ajouter" pour ajouter une nouvelle série.

Une série est en faites, une ou plusieurs courbes qui regroupent un ensemble d'infomrations de même nature.

A noté également, que vous pouvez choisir différents type de séries pour le même graphe.



Par exemple, choisissez "Ligne" comme type de série.
Outre le graphe "Ligne", vous pouvez créer de nombreux type graphes. De plus, toutes les couleurs ainsi que les échelles sont paramètrables.

Cliquez sur le bouton "Fermer" pour fermer cette fenêtre.



Cliquez, de nouveau sur le bouton "Fermer".
TeeChart ajoute des valeurs aléatoires pour que vous puissez visualiser l'apparence du graphe (à l'exécution du programme, aucune valeur ne s'affichera aléatoirement).

Créer une série par programmation

Voici par exemple comment créer une série de type ligne.

var Serie:TLineSeries; //Série de type "Ligne" begin Serie:=TLineSeries.Create(Self); //Crée la série Serie.ParentChart:=Chart1; //Associe la série au graphe Serie.Title:='Series 2'; //Modifie le titre de la série end;

Ajouter des valeurs à une série

Il suffit d'utiliser la méthode "Add" de la série.

var i :integer; begin Series1.Clear; //Efface le contenu de la série for i:=0 to 10 do //Ajoute 10 valeurs dans la série Series1.Add(Random(50)); //Ajoute un nombre entre 0 et 50 à la série end;

On utilise la fonction "Random" pour afficher des points aléatoires.
Vous remarquerez que les valeurs sont affichés à droite du graphe dans une légende. Si vous le souhaitez, vous pouver cacher cette légende. Il suffit de décocher la case "Visible" dans l'onglet "Légende" dans les modification du graphe. Vous pouvez également faire cette opération par programmation.

Chart1.Legend.Visible:=False;

Afficher la moyennne de deux séries

Créez deux séries puis ajoutez des valeurs à ces deux séries comme précèdemment.
Ensuiste, ajoutez une troisième série.

Series3.DataSources.Add(Series1); Series3.DataSources.Add(Series2); Series3.SetFunction(TAverageTeeFunction.Create(Self));

Vous pouvez effectuer les calculs des bases comme par exemple l'addition, la soustraction, la multiplication, la division mais aussi la valeur minimale ou maximale sur l'ensemble des série et la moyenne des séries.

Enregistrer le graphe au format BMP

On utilise la méthode "SaveToBitmapFile" en indiquant l'emplacement du fichier que l'on veut sauvegarder.

Chart1.SaveToBitmapFile('c:\chart.bmp');

Copier le graphe dans le presse-papier

On utilise la méthode "CopyToClipboardBitmap".

Chart1.CopyToClipboardBitmap;

Zoomer sur le graphe

Le composant TChart gère de manière automatique le zoom sur un graphe. Il suffit, pour cela, que la propriété "AllowZoom" du composant soit à "True".
Pour zoomer, il suffit de cliquer sur le graphe et de sélectionner une zône rectangulaire. Pour annuler le zoom, il suffit de sélectionner une zône rectangulaire mais cette fois-ci de bas en haut.

Pour annuler le zoom, vous pouvez également utiliser la méthode "UndoZoom".

Chart1.UndoZoom;

Impression du graphe

On utilise la méthode "Print" du composant TChart.

Chart1.Print;

Le graphe sera alors imprimé au milieu de la page.

TeeChart    [ 20-12-2003 ]  Exemple d'utilisation du composant TChart pour réaliser des graphes. Télécharger :  [6 Ko] [ tchart.zip] Auteur : Yoann Site internet : http://delphipage.free.fr/

Un peu plus loin...

TeeChart possède de nombreuses possibilités. Une démo livré avec Delphi (vous pourrez la trouver dans le répertoire "Demos\TeeChart") vous montrera ses différentes options.
Par exemple, vous pouvez imprimer un graphe à l'aide de QuickReport (un générateur d'état) grâce aux composants TQRChart. Vous pouvez également grâce au composant TDBChart [3 Ko] afficher dans un graphe le contenu d'une base de données.