GRAPHE

version 6.0 (Modifiée)

Notes version 6 : Depuis la version 6 de 4e Dimension, les graphes sont réalisés à l'aide du plug-in 4D Chart, intégré à 4e Dimension. Les commandes du thème Graphe de la version précédente de 4D sont désormais redirigées de manière transparente vers 4D Chart.

• Si vous souhaitez personnaliser une Zone de graphe placée dans un formulaire avec les commandes de 4D Chart, utilisez le paramètre graphZone décrit dans cette commande comme référence de zone externe pour les commandes de 4D Chart. Pour plus d'informations sur les commandes de 4D Chart, reportez-vous au manuel Langage de 4D Chart.

• La commande GRAPHE fonctionne avec une Zone de graphe créée dans un formulaire 4D. Elle doit impérativement être placée dans la méthode formulaire ou dans une méthode objet appartenant au formulaire, ou encore dans une méthode projet appelée par l'une des deux précédentes.

GRAPHE (graphZone; graphNum; xCatégories; zValeurs{; zValeurs2; ...; zValeursN})

La commande GRAPHE crée un graphe dans une zone de graphe placée dans un formulaire. Les valeurs à représenter peuvent provenir soit de tableaux soit de sous-champs.

Le paramètre graphZone est le nom de la zone de graphe qui affiche le graphe. Les zones de graphe sont créées en mode Structure, dans l'éditeur de formulaires. Le nom du graphe est celui de la variable de type Zone de graphe. Pour plus d'informations sur la création de zones de graphe dans les formulaires, reportez-vous au manuel Mode Structure de 4e Dimension.

Le paramètre graphNum définit le type de graphe à utiliser. Vous devez passer un nombre entre 1 et 8. Les différents types de graphes disponibles sont listés dans l'exemple présenté plus bas. Une fois le graphe créé, vous pouvez modifier son type en modifiant la valeur de graphNum et en exécutant de nouveau la commande GRAPHE.

Le paramètre xCatégories définit les valeurs qui seront utilisées pour l'axe des X. Vous pouvez passer un champ de type Alpha, Heure, Date, ou un type numérique. Il doit y avoir le même nombre de sous-enregistrements ou d'éléments de tableau dans xCatégories qu'il y en a dans chaque zValeurs.

Le paramètre zValeurs définit les valeurs à représenter graphiquement. Elles doivent être de type numérique. Vous pouvez passer jusqu'à huit ensembles de données. Les graphes en secteurs ne représentent que le premier zValeurs.

(1) L'exemple suivant illustre l'utilisation des tableaux pour générer un graphe. Ce code doit être placé dans la méthode formulaire (ou une méthode objet) du formulaire contenant la zone de graphe. A noter que, dans notre exemple, les données représentées sont constantes, ce qui n'est généralement pas le cas :

   TABLEAU ALPHA (4; X; 2)  ` Création d'un tableau pour l'axe des X
   X{1} := "1995"  ` libellé X #1 
   X{2} := "1996"  ` Libellé X #2 
   TABLEAU REEL (A; 2)  ` Création d'un tableau pour l'axe des Z 
   A{1} := 30  ` Insertion des données 
   A{2} := 40 
   TABLEAU REEL (B; 2) ` Création d'un tableau pour l'axe des Z 
   B{1} := 50  ` Insertion des données 
   B{2} := 80 
   GRAPHE (vGraph; vType; X; A; B) ` Dessiner le graphe  
   PARAMETRES DU GRAPHE (vGraph; 0; 0; 0; 0; Faux; Faux; Vrai; "France"; "USA") 
      ` Définition des légendes du graphe

Les images suivantes représentent les graphes résultants :

• Lorsque vType est égal à 1, vous obtenez un graphe en Colonnes :

• Lorsque vType est égal à 2, vous obtenez un graphe en Colonnes proportionnelles :

• Lorsque vType est égal à 3, vous obtenez un graphe en Colonnes empilées :

• Lorsque vType est égal à 4, vous obtenez un graphe en Lignes :

• Lorsque vType est égal à 5, vous obtenez un graphe en Aires :

• Lorsque vType est égal à 6, vous obtenez un graphe en Points :

• Lorsque vType est égal à 7, vous obtenez un graphe en Secteurs :

• Lorsque vType est égal à 8, vous obtenez un graphe en Images :

(2) L'exemple suivant effectue la représentation graphique des ventes des commerciaux. La sous-table comporte trois champs : Nom, TotalAnnéePrécédente, et TotalCetteAnnée. Le graphe affichera les ventes de chaque commercial pour les deux dernières années :

   GRAPHE (GrapheVentes; 1; Commerciaux'Nom; Commerciaux'TotalAnnéePrécédente; 
                                    Commerciaux'TotalCetteAnnée)

ch_Donnees vers graphe, ch_Selection vers graphe, ch_Tableaux vers graphe, GRAPHE SUR SELECTION, PARAMETRES DU GRAPHE.