4D Doc Center : GRAPHE

4D v13.4

GRAPHE


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

Paramètre	Type	Description
zoneGraphe	Variable image, Variable graphe	Variable image ou Zone de graphe
graphNum	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 v13, le plug-in 4D Chart n'est plus intégré à 4D et doit être installé spécifiquement si vous souhaitez l'utiliser. Par compatibilité, la commande GRAPHE peut toujours générer des graphes à l'aide de ce plug-in lorsqu'il est présent, mais il est désormais fortement conseillé de privilégier l'utilisation du moteur de rendu SVG intégré.

La commande GRAPHE crée un graphe dans une variable image placée dans un formulaire, à partir de valeurs provenant de tableaux. La commande GRAPHE 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.

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 à l'adresse http://www.w3.org.Graphics/SVG /. La commande SVG EXPORTER VERS IMAGE vous permet également de tirer parti du moteur SVG intégré.

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

Note : Par compatibilité, la commande accepte également une zone de graphe ou une référence de zone 4D Chart dans le paramètre zoneGraphe, mais cette syntaxe est désormais déconseillée.

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 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 désormais 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_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_IMAGE(vGraph) //Variable du graphe

 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 second tableau pour l'axe des Z

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

 B{2}:=80

 vType:=1 //Initialisation du type de graphe

 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 :

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