GRAPH

4D v15.4

GRAPH


GRAPH ( graphImage ; graphNum \| graphParams ; xCatégories {; zValeurs} {; zValeurs2 ; ... ; zValeursN} )

Paramètre	Type	Description
graphImage	Variable image	Variable image
graphNum \| graphParams	Entier long	Numéro de type de graphe
xCatégories	Tableau	Catégories sur l'axe des x
zValeurs	Tableau	Valeurs à représenter graphiquement (jusqu'à 8 valeurs)

Description

Note de compatibilité : A compter de 4D v14, la commande GRAPH fonctionne uniquement avec une variable image en premier paramètre. La syntaxe obsolète utilisant une zone de graphe (4D Chart) n’est plus prise en charge.

La commande GRAPH crée un graphe dans une variable image à partir de valeurs provenant de tableaux.

Les graphes générés par cette commande sont dessinés via le moteur de rendu SVG intégré. Ils bénéficient des fonctions d'interface associées aux variables images : menu contextuel en mode Application (permettant notamment le choix du format d'affichage), barres de défilement, etc. Des IDs spécifiques sont automatiquement attribués aux éléments présents dans le graphe généré, ce qui permet de les manipuler (cf. paragraphe suivant).

Note : SVG (Scalable Vector Graphics) est un format de fichier graphique vectoriel (extension .svg). Basé sur le XML, ce format est largement répandu et peut être notamment affiché par les navigateurs Web. Pour plus d'informations, reportez-vous à http://www.w3.org.Graphics/SVG /. La commande SVG EXPORT TO PICTURE vous permet également de tirer parti du moteur SVG intégré.

Passez dans le paramètre graphImage le nom de la variable image devant afficher le graphe dans le formulaire.

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

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 chaîne, Heure, Date, ou un type numérique. Il doit y avoir le même nombre 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.

IDs automatiques

Des IDs spécifiques sont automatiquement attribués aux éléments présents dans le graphe SVG :

IDs	Description
ID_graph_1 à ID_graph_8	Colonnes, lignes, aires...
ID_graph_shadow_1 à ID_graph_shadow_8	Ombre des colonnes, lignes, aires...
ID_bullet_1 à ID_bullet_8	Points (graphes en Lignes et en Points uniquement)
ID_pie_label_1 à ID_pie_label_8	Libellés des secteurs (graphes en Secteurs uniquement)
ID_legend	Légende
ID_legend_1 à ID_legend_8	Titres des légendes
ID_legend_border	Encadrement des légendes
ID_legend_border_shadow	Ombre des encadrements des légendes
ID_x_values	Valeurs axe des X
ID_y_values	Valeurs axe des Y
ID_y0_axis	Valeurs axe des Z
ID_background	Arrière plan
ID_background_shadow	Ombre de l’arrière plan
ID_x_grid	Grille sur l’axe des X
ID_x_grid_shadow	Ombre de la grille sur l’axe des X
ID_y_grid	Grille sur l’axe des Y
ID_y_grid_shadow	Ombre de la grille sur l’axe des Y

Exemple

L'exemple suivant illustre les différents types de graphes que vous pouvez obtenir. Ce code doit être placé dans la méthode formulaire (ou une méthode objet) du formulaire contenant la variable image. A noter que, dans notre exemple, les données représentées sont constantes, ce qui n'est généralement pas le cas :

 C_PICTURE(vGraph) //Variable du graphe

 ARRAY TEXT(X;2) //Création d'un tableau pour l'axe des X

 X{1}:="1995" //Libellé X #1

 X{2}:="1996" //Libellé X #2

 ARRAY REAL(A;2) //Création d'un tableau pour l'axe des Z

 A{1}:=30 // Insertion des données

 A{2}:=40

 ARRAY REAL(B;2) //Création d'un second tableau pour l'axe des Z

 B{1}:=50 // Insertion des données

 B{2}:=80

 vType:=1 //Initialisation du type de graphe

 GRAPH(vGraph;vType;X;A;B) //Dessiner le graphe

 GRAPH SETTINGS(vGraph;0;0;0;0;False;False;True;"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 :

Note : Par défaut, les graphes en secteurs n'affichent pas la légende. Pour la faire apparaître, il suffit de rendre visible l'attribut SVG 'ID_legend' via l'instruction suivante :
SVG SET ATTRIBUTE(vGraph;"ID_legend";"visibility";"visible";*)

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

Note : Les images sont des rectangles simples par défaut.

Voir aussi

_o_GRAPH TABLE
GRAPH SETTINGS
SVG EXPORT TO PICTURE