4D Doc Center : ch_Selection vers graphe

4D Chart v13

ch_Selection vers graphe


ch_Selection vers graphe ( zone ; type ; taille ; groupCatég ; numTable ; champCatég ; champSér/Val ) -> Résultat

Paramètre	Type	Description
zone	Entier long	Zone 4D Chart
type	Entier	Type de graphe (cf. codes ci-dessous)
taille	Entier	Option pour la taille initiale du graphe 1 = Variable, 2 = Relative à la fenêtre, 3 = Relative au document
groupCatég	Entier	Grouper les données de la catégorie ? 0 = Non, 1 = Oui
numTable	Entier	Numéro de la table à représenter
champCatég	Entier	Numéro du champ à représenter sur l’axe des catégories
champSér/Val	Tableau entier	Tableau de numéros de champs
Résultat	Entier long	ID d'objet du graphe

Description

La commande ch_Selection vers graphe crée un graphe de la sélection tirée des champs de numTable. La fonction renvoie l’identifiant d’objet du graphe.

Le tableau suivant fournit la liste des codes du paramètre type :

Code	Type de graphe
1	Aires
2	Colonnes
3	Images
4	Lignes
5	Points
6	Secteurs
7	Diagramme polaire
8	Graphes XY
100	Colonnes 3D
101	Lignes 3D
102	Aires 3D
103	Surfacique 3D
104	Triangulaire 3D
105	Epingles 3

Le paramètre taille détermine la quantité d’espace remplie par le graphe lorsqu’il est généré et comment la taille du graphe change lorsque vous redimensionnez la fenêtre :

Si vous passez 1 (taille Variable), le graphe remplit la zone 4D Chart ou la fenêtre. Il conserve cette taille jusqu’à ce que vous la modifiiez à l’aide des poignées de sélection.
Si vous passez 2 (taille Relative à la fenêtre), le graphe remplit la zone 4D Chart ou la fenêtre externe. Si vous modifiez ensuite la taille de la fenêtre, le graphe s’y adapte automatiquement. Cependant, une fois que vous avez modifié la taille du graphe à l’aide des poignées de sélection, cette adaptation n’a plus lieu.
Si vous passez 3 (taille Relative au document), le graphe s’adapte à la dimension de page que vous avez choisie dans le dialogue Format d’impression. Il conserve cette taille jusqu’à ce que vous modifiiez la taille du graphe à l’aide des poignées de sélection.

groupCatég spécifie si les données sur l’axe des catégories doivent être groupées ou non :

Si groupCatég = 1, chaque élément sera unique, et les valeurs des éventuels éléments en double s’additionneront.
Si groupCatég = 0, les valeurs de chaque élément seront représentées séparément.
Il est inutile de grouper les séries parce que ce sont des noms de champs, forcément uniques.

numTable est le numéro de la table dont les données sont représentées. Vous pouvez obtenir le numéro d’une table en transmettant un pointeur vers la table en tant que paramètre de la fonction Table.

champCatég est le numéro du champ à représenter sur l’axe des éléments. Vous pouvez obtenir le numéro d’un champ en transmettant un pointeur vers le champ en tant que paramètre de la fonction Champ.

champSér/Val est un tableau contenant les numéros des champs dont les séries et les valeurs doivent être représentées. Les noms des champs deviennent les séries ; les valeurs contenues dans les champs sont représentées sur l’axe des valeurs.
Dans un graphe à deux dimensions, les séries s’affichent sur l’axe des éléments. Dans un graphe à trois dimensions, elles s’affichent sur l’axe des séries.