DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

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
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
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.
gr3DSAireProfondeurGraphe 3D d'aires représentées les unes derrières les autres.
gr3DSCourbeGraphe 3D en courbe.
gr3DSHistoCylEmpiléHistogramme empilé en 3D.
Les barres sont représentées par des cylindres.
gr3DSHistoCylGroupéHistogramme groupé en 3D
Les barres sont représentées par des cylindres.
gr3DSHistoCylProfondeurHistogramme 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.
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.
gr3DSHistoGroupéHistogramme groupé en 3D.
Les barres sont représentées par des parallélépipèdes rectangles.
gr3DSHistoProfondeurHistogramme 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.
gr3DSMinMaxGraphe boursier 3D affichant la différence entre la valeur minimale et la maximale du cours
gr3DSNuageGraphe 3D de type Nuage de points.
gr3DSSecteurGraphe 3D de type Secteur ou "Camembert".
grAireGraphe de type Aire (voir exemple de graphe de type Aire).
grAirePolaireGraphe de type Aire Polaire (voir exemple de graphe de type Aire Polaire).
grBarChartsGraphe de type Boursier (voir exemple de graphe de type Boursier).
grChandelierGraphe boursier de type Chandelier Japonais (voir exemple de graphe de type Boursier).
grCirculaireDeProgrèsGraphe de type diagramme circulaire de progrès.
grCourbeGraphe de type Courbe (voir exemple de graphe de type Courbe).
grDonutGraphe de type Beignet (appelé également "Donut"). Voir exemple de graphe de type Beignet.
grEntonnoirGraphe de type Entonnoir. Voir exemple de graphe Entonnoir.
grGrapheBulleGraphe à bulles (voir exemple de graphe à bulles).
grHeatMapGraphe de type Heatmap (voir exemple de graphe Heatmap).
grHémicycleGraphe de type Hémicycle (voir exemple de graphe de type Hémicycle).
grHistoGraphe 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.
grMinMaxGraphe boursier affichant la différence entre la valeur minimale et la maximale du cours (voir exemple de graphe de type Boursier)
grNuageGraphe de type Nuage de points (voir exemple de graphe de type Nuage de points).
grNuage3DGraphe de type Nuage de points 3D (voir exemple de graphe de type Nuage de points 3D).
grPyramideGraphe de type Pyramide (voir exemple de graphe de type Pyramide).
grRadarGraphe Radar (voir exemple de graphe de type Radar).
grSecteurGraphe de type Secteur ou "camembert" (voir exemple de graphe de type Secteur ou "Camembert").
grSecteurMultiniveauGraphe de type Secteur Multiniveau (également appelé "Sunburst"). Voir exemple de graphe de type Secteur multiniveau.
grSurfaceGraphe de type Surface (voir exemple de graphe de type Surface).
grWaffleGraphe de type Waffle (voir exemple de graphe de type Waffle).
grWaterfallGraphe de type Waterfall (voir exemple de graphe de type Waterfall).
grZoneIntervalleGraphe 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 :

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).
Liste des exemples associés :
Les fonctions Graphe Exemples unitaires (WINDEV) : Les fonctions Graphe
[ + ] Utilisation des principales fonctionnalités du grapheur de WINDEV :
- Réaliser un graphique de type Secteur, Histogramme ou Courbe
- Définir la zone d'affichage d'un graphique
- Définir les options du graphique (légende, pourcentage,...)
- Réaliser un tracé de courbe sur un graphe
Les fonctions Graphe Exemples unitaires (WEBDEV) : Les fonctions Graphe
[ + ] Utilisation des principales fonctionnalités du grapheur de WEBDEV pour :
- Réaliser un graphique de type : Secteur, Histogramme ou Courbe
- Définir la zone d'affichage d'un graphique
- Définir les options du graphique (légende, pourcentage,...)
Les fonctions Graphe Exemples unitaires (WINDEV Mobile) : Les fonctions Graphe
[ + ] Utilisation des fonctions Graphe :
- réaliser par programmation un graphique de type Secteur, Histogramme ou Courbe
- définir les options du graphique (légende, pourcentage,...)
Classification Métier / UI : Code neutre
Composante : wd300grf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 06/10/2023

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