grCrée (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français (générique)

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions de gestion des graphes

Créer et dessiner un graphe par programmation
Tracer plusieurs graphes simultanément
Graphes et threads
Valeurs par défaut d'un graphe créé par programmation

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

grCrée (Fonction)

En anglais : grCreate

Crée un graphe d'un type spécifié.

Remarques :

Il est conseillé de créer directement un champ Graphe plutôt que d'utiliser la fonction grCrée. En effet, le champ Graphe offre beaucoup plus de possibilités.
Cette fonction permet uniquement de créer un graphe par programmation. Cette fonction ne peut pas être utilisée dans l'éditeur de fenêtres, de pages ou d'états.

Exemple

// Création d'un histogramme 
// (avec sauvegarde des paramètres modifiés par l'utilisateur)
grCrée("MonGraphe", grHisto)

Syntaxe

grCrée(<Nom du graphe> , <Type de graphe> [, <Persistance>])

<Nom du graphe> : Chaîne de caractères

Nom du graphe à créer. Ce nom sera utilisé dans toutes les fonctions de gestion des graphes. Attention : ce nom ne doit pas correspondre au nom d'un champ Graphe.

<Type de graphe> : Constante

Indique le type de graphe à créer :
gr3DSAireEmpilé Graphe 3D d'aires empilées.
Cette constante n'est pas disponible.
gr3DSAireProfondeur Graphe 3D d'aires représentées les unes derrières les autres.
Cette constante n'est pas disponible.
gr3DSCourbe Graphe 3D en courbe.
Cette constante n'est pas disponible.
gr3DSHistoCylEmpilé Histogramme empilé en 3D.
Les barres sont représentées par des cylindres.
Cette constante n'est pas disponible.
gr3DSHistoCylGroupé Histogramme groupé en 3D
Les barres sont représentées par des cylindres.
Cette constante n'est pas disponible.
gr3DSHistoCylProfondeur Histogramme en profondeur en 3D : les séries sont représentées les unes derrières les autres.
Les barres sont représentées par des cylindres.
Cette constante n'est pas disponible.
gr3DSHistoEmpilé Histogramme empilé en 3D.
Les barres sont représentées par des parallélépipèdes rectangles. Ce type de graphe ne gère pas les valeurs négatives.
Cette constante n'est pas disponible.
gr3DSHistoGroupé Histogramme groupé en 3D.
Les barres sont représentées par des parallélépipèdes rectangles.
Cette constante n'est pas disponible.
gr3DSHistoProfondeur Histogramme en profondeur en 3D : les séries sont représentées les unes derrières les autres.
Les barres sont représentées par des parallélépipèdes rectangles.
Cette constante n'est pas disponible.
gr3DSMinMax Graphe boursier 3D affichant la différence entre la valeur minimale et la maximale du cours
Cette constante n'est pas disponible.
gr3DSNuage Graphe 3D de type Nuage de points.
Cette constante n'est pas disponible.
gr3DSSecteur Graphe 3D de type Secteur ou "Camembert".
Cette constante n'est pas disponible.
grAire Graphe de type Aire (voir exemple de graphe de type Aire).
grAirePolaire Graphe de type Aire Polaire (voir exemple de graphe de type Aire Polaire).
grBarCharts Graphe de type Boursier (voir exemple de graphe de type Boursier).
grChandelier Graphe boursier de type Chandelier Japonais (voir exemple de graphe de type Boursier).
grCirculaireDeProgrès Graphe de type diagramme circulaire de progrès.
Cette constante n'est pas disponible.
grCourbe Graphe de type Courbe (voir exemple de graphe de type Courbe).
grDonut Graphe de type Beignet (appelé également "Donut"). Voir exemple de graphe de type Beignet.
grEntonnoir Graphe de type Entonnoir. Voir exemple de graphe Entonnoir.
grGrapheBulle Graphe à bulles (voir exemple de graphe à bulles).
grHeatMap Graphe de type Heatmap (voir exemple de graphe Heatmap).
grHémicycle Graphe de type Hémicycle (voir exemple de graphe de type Hémicycle).
grHisto Graphe de type Histogramme (voir exemple de graphe de type Histogramme).
grHistoEmpilé Graphe de type Histogramme empilé. Ce type de graphe ne gère pas les valeurs négatives.
grMinMax Graphe boursier affichant la différence entre la valeur minimale et la maximale du cours (voir exemple de graphe de type Boursier)
grNuage Graphe de type Nuage de points (voir exemple de graphe de type Nuage de points).
grNuage3D Graphe de type Nuage de points 3D (voir exemple de graphe de type Nuage de points 3D).
Nouveauté 2025
grPourcentageImagé
Graphe de type Pourcentage imagé (voir exemple de graphe de type Pourcentage imagé).
grPyramide Graphe de type Pyramide (voir exemple de graphe de type Pyramide).
grRadar Graphe Radar (voir exemple de graphe de type Radar).
grSecteur Graphe de type Secteur ou "camembert" (voir exemple de graphe de type Secteur ou "Camembert").
grSecteurMultiniveau Graphe de type Secteur Multiniveau (également appelé "Sunburst"). Voir exemple de graphe de type Secteur multiniveau.
Cette constante n'est pas disponible.
grSurface Graphe de type Surface (voir exemple de graphe de type Surface).
grWaffle Graphe de type Waffle (voir exemple de graphe de type Waffle).
grWaterfall Graphe de type Waterfall (voir exemple de graphe de type Waterfall).
grZoneIntervalle Graphe de type Zone d'intervalle (voir exemple de graphe de type Zone d'intervalle).

Le type de graphe peut être modifié par la suite grâce à la fonction grType.

<Persistance> : Booléen optionnel

Vrai (valeur par défaut) pour sauvegarder les modifications du graphe réalisées par l'utilisateur grâce au menu contextuel,
Faux pour ne pas sauvegarder ces informations.

Remarques

Créer et dessiner un graphe par programmation

Pour créer et dessiner un graphe :

créez le graphe (fonction grCrée),
ajoutez les données (fonctions grAjouteDonnée, grBourseAjouteDonnée et grNuageAjouteDonnéeXY),
définissez la destination du graphe à l'aide des fonctions suivantes :
dessinez le graphe (fonction grDessine).

Tracer plusieurs graphes simultanément

A un instant donné, il ne peut pas exister plusieurs graphes avec le même nom.

Pour tracer plusieurs graphes en même temps (dans une ou plusieurs fenêtres par exemple), il est nécessaire d'utiliser des noms de graphes différents.

Graphes et threads

Un seul graphe peut être manipulé dans un thread.

Conséquences :

Deux threads ne peuvent pas manipuler le même graphe.
Un graphe créé dans un thread est automatiquement détruit à la fin de ce thread. Le graphe existe dans le thread qui contient l'appel à la fonction grCrée.

Valeurs par défaut d'un graphe créé par programmation

Les valeurs par défaut d'un graphe sont les suivantes :

Menu contextuel activé (paramétrable avec les fonctions grMenu et grOptionMenu).
Graduation automatique des axes (paramétrable avec la fonction grGraduation).
Les couleurs sont sélectionnées selon un ordre prédéfini parmi un éventail de 13 couleurs (paramétrable avec la fonction grCouleurSerie).
Les couleurs sont dégradées (paramétrable avec la fonction grDégradé).
Taille fichier (paramétrable avec la fonction grFenTaille).
Taille fenêtre (paramétrable avec la fonction grFenTaille).
Pas d'étiquette pour les séries (paramétrable avec la fonction grEtiquetteSérie).
Pas de libellé pour les éléments (paramétrable avec les fonctions grEtiquetteCatégorie et grLibellé).
Pas de légende (paramétrable avec la fonction grLégende).
Pas de titre pour le graphe (paramétrable avec la fonction grTitre).
Pas de titre pour les axes (paramétrable avec la fonction grTitreAxe).
Pas de quadrillage de fond (paramétrable avec la fonction grQuadrillage).
Pas de données (ajout d'éléments avec la fonction grAjouteDonnée).
Pas de destination (paramétrable avec les fonctions grDestinationBMP, grDestinationChamp, grDestinationEMF, grDestinationFen et grDestinationWMF).
Pas d'affichage du graphe (pour dessiner le graphe, utilisez la fonction grDessine).
Pas de relief (paramétrable avec la fonction grRelief).
Pour les graphes en secteurs, l'angle de départ est égal à 0 (paramétrable avec la fonction grSecteurAngleDépart).
Pour les histogrammes et les graphes boursiers de type Minimum/Maximum, l'espace entre deux catégories est égal à 10 pixels (paramétrable avec la fonction grHistoEspacement).
Pour les nuages de points, les points sont reliés et de taille égale à 1 (paramétrable avec les fonctions grNuageReliePoint et grNuageTaillePoint).

Classification Métier / UI: Code neutre

Composante: wd300grf.dll

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/03/2025

Signaler une erreur ou faire une suggestion | Aide en ligne locale