DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions de gestion des graphes
  • Paramètres d'un graphe
  • Divers
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
Récupère ou modifie un paramètre d'un graphe.
Remarques :
  • Cette fonction propose toutes les options de la fonction grParamètre3DS.
  • Cette fonction ne doit pas être utilisée sur des champs Graphe présents dans l'éditeur d'états.
Exemple
// Désactive l'optimisation des graduations sur l'axe X de GRF_Graphe1
grParamètre(GRF_Graphe1, grGraduationsOptimiséesX, Faux)
Syntaxe

Récupérer la valeur d'un paramètre d'un graphe Masquer les détails

<Résultat> = grParamètre(<Nom du graphe> , <Paramètre>)
<Résultat> : Entier, réel ou booléen
Valeur du paramètre. Le type dépend du paramètre spécifié (voir les notes).
<Nom du graphe> : Nom de champ ou chaîne de caractères
Nom du graphe à manipuler. Ce nom correspond :
  • soit au nom du graphe défini par programmation avec la fonction grCrée.
  • soit au nom du champ Graphe (présent dans l'éditeur de fenêtres ou de pages).
<Paramètre> : Constante de type entier
Paramètre du graphe dont la valeur est recherchée :
gr3DSPropAnimationType d'animation jouée lors de l'affichage du graphe.
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropAutoZoomZoom automatique du graphe
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropCouleurPlanXCouleur du plan vertical (axe à droite ou à gauche)
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropCouleurPlanYCouleur du plan horizontal (axe au-dessus ou au-dessous)
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropCouleurPlanZCouleur du plan du fond
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropDistanceZoom du graphe
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropElevationAngle de rotation du graphe autour de l'axe des ordonnées (axe Y)
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropLégendeSuperposéeSuperposition de la légende et du titre du graphe
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropLumièreXAbscisse (X) de la lumière éclairant le graphe
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropLumièreYOrdonnée (Y) de la lumière éclairant le graphe
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropRotationAngle de rotation du graphe autour de l'axe des abscisses (axe X)
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropTransparenceTaux de transparence des barres ou des secteurs du graphe
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
grAlgoEntonnoirMode de représentation des données dans un graphe de type Entonnoir.
grAlgoPyramideMode de représentation des données dans un graphe de type Pyramide.
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux et dans les applications pour iPhone ou iPad.
grAscenseurZoomToujoursVisibleGestion des ascenseurs lors d'un zoom sur le graphe.
grEchantillonnageActifGestion de l'échantillonnage (sub sampling).
grEmplacementOptimiséActivation de l'optimisation du remplissage de l'espace disponible pour les graphes de type Secteur, Hémicycle et Donut affichés dans un champ ou une fenêtre.
grGraduationsOptimiséesXActivation de l'optimisation des graduations sur l'axe des abscisses (axe X).
grGraduationsOptimiséesYActivation de l'optimisation des graduations sur l'axe des ordonnées (axe Y).
grHMAffichageCouleurMode d'affichage des couleurs dans un graphe de type Heatmap.
grLibelléSMNPerpendiculairePortionMode d'affichage du libellé de la portion dans un graphe de type Secteur multiniveau.
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows. Cette constante n'est pas prise en compte pour un champ Graphe présent dans un état.
grProjectionNuage3DMode d'affichage des projections sur un graphe de type Nuage de points 3D.
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows.
grSMNInteractifActivation du mode interactif dans un graphe de type Secteur multiniveau.
grSMNNiveauMaxDéfinition du nombre maximum de niveaux affichés dans un graphe de type Secteur multiniveau.
grZoomArrièreInfiniActivation du mode zoom arrière infini. Si le zoom arrière infini est activé, il est possible de dé-zoomer un graphe même si celui-ci est affiché à 100%.
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows.

Modifier la valeur d'un paramètre d'un graphe Masquer les détails

grParamètre(<Nom du graphe> , <Paramètre> , <Valeur>)
<Nom du graphe> : Nom de champ ou chaîne de caractères
Nom du graphe à manipuler. Ce nom correspond :
  • soit au nom du graphe défini par programmation avec la fonction grCrée.
  • soit au nom du champ Graphe (présent dans l'éditeur de fenêtres ou de pages).
<Paramètre> : Constante de type entier
Paramètre du graphe à modifier :
gr3DSPropAnimationType d'animation jouée lors de l'affichage du graphe
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropAutoZoomZoom automatique du graphe
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropCouleurPlanXCouleur du plan vertical (axe à droite ou à gauche)
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropCouleurPlanYCouleur du plan horizontal (axe au-dessus ou au-dessous)
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropCouleurPlanZCouleur du plan du fond.
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropDistanceZoom du graphe
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropElevationAngle de rotation du graphe autour de l'axe des ordonnées (axe Y).
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropLégendeSuperposéeSuperposition de la légende et du titre du graphe.
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropLumièreXAbscisse (X) de la lumière éclairant le graphe.
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropLumièreYOrdonnée (Y) de la lumière éclairant le graphe.
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropRotationAngle de rotation du graphe autour de l'axe des abscisses (axe X).
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
gr3DSPropTransparenceTaux de transparence des barres ou des secteurs du graphe.
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux.
grAlgoEntonnoirMode de représentation des données dans un graphe de type Entonnoir.
grAlgoPyramideMode de représentation des données dans un graphe de type Pyramide.
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows et Linux et dans les applications pour iPhone ou iPad.
grAscenseurZoomToujoursVisibleGestion des ascenseurs lors d'un zoom sur le graphe.
grEchantillonnageActifGestion de l'échantillonnage (downsampling).
grEmplacementOptimiséActivation de l'optimisation du remplissage de l'espace disponible pour les graphes de type Secteur, Hémicycle et Donut affichés dans un champ ou une fenêtre.
grGraduationsOptimiséesXActivation de l'optimisation des graduations sur l'axe des abscisses (axe X).
grGraduationsOptimiséesYActivation de l'optimisation des graduations sur l'axe des ordonnées (axe Y).
grHMAffichageCouleurMode d'affichage des couleurs dans un graphe de type Heatmap.
grLibelléSMNPerpendiculairePortionMode d'affichage du libellé de la portion dans un graphe de type Secteur multiniveau.
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows.
grProjectionNuage3DMode d'affichage des projections sur un graphe de type Nuage de points 3D.
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows.
grSMNInteractifActivation du mode interactif dans un graphe de type Secteur multiniveau.
grSMNNiveauMaxDéfinition du nombre maximum de niveaux affichés dans un graphe de type Secteur multiniveau.
grZoomArrièreInfiniActivation du mode zoom arrière infini. Si le zoom arrière infini est activé, il est possible de dé-zoomer un graphe même si celui-ci est affiché à 100%.
Windows Cette constante est disponible uniquement dans les applications WINDEV pour Windows.
<Valeur> : Entier, réel ou booléen
Valeur du paramètre. Le type dépend du paramètre spécifié (voir les notes).
Remarques

Paramètres d'un graphe

Les différents paramètres d'un graphe sont les suivants :
ConstanteEffetValeur du paramètre
gr3DSPropAnimationType d'animation jouée lors de l'affichage du grapheEntier
Les valeurs possibles sont :
  • 0 : aucune animation
  • 1 : zoom avant
  • 2 : effet de rotation
  • 4 : construction progressive des barres / secteurs
  • 8 : affichage progressif des couleurs
Ces valeurs peuvent être additionnées.
La valeur par défaut est 15.
gr3DSPropAutoZoomZoom automatique du grapheBooléen
  • Vrai (par défaut) si le zoom doit être automatiquement calculé,
  • Faux dans le cas contraire.
Si le zoom est automatiquement calculé, la valeur du paramètre gr3DSPropDistance n'est pas prise en compte.
gr3DSPropCouleurPlanXCouleur du plan vertical (axe à droite ou à gauche)Entier
Pour ne pas dessiner cet axe, utilisez la constante Transparent.
Cette constante est prise en compte uniquement sur les graphes de type histogramme ou courbe.
La valeur par défaut est GrisClair.
gr3DSPropCouleurPlanYCouleur du plan horizontal (axe au-dessus ou au-dessous)Entier
Pour ne pas dessiner cet axe, utilisez la constante Transparent.
Cette constante est prise en compte uniquement sur les graphes de type histogramme ou courbe.
La valeur par défaut est GrisClair.
gr3DSPropCouleurPlanZCouleur du plan du fondEntier
Pour ne pas dessiner cet axe, utilisez la constante Transparent.
Cette constante est prise en compte uniquement sur les graphes de type histogramme ou courbe.
La valeur par défaut est GrisClair.
gr3DSPropDistanceZoom du grapheRéel
Les valeurs possibles sont comprises entre 0 et l'infini.
Cette constante est prise en compte uniquement si la constante gr3DSPropAutoZoom est à Faux.
La valeur par défaut est 189.
gr3DSPropElevationAngle de rotation (en degrés) du graphe autour de l'axe des ordonnées (axe Y)Réel
Les valeurs possibles sont comprises entre 0 et 360.
La valeur 0 permet de voir le graphe de face.
La valeur 90 permet de voir le graphe du dessus.
Par défaut, l'angle de rotation optimal est automatiquement calculé.
gr3DSPropLégendeSuperposéeSuperposition de la légende et du titre du grapheBooléen.
  • Vrai si la légende et le titre sont superposés au graphe,
  • Faux (par défaut) dans le cas contraire.
gr3DSPropLumièreXAbscisse (X) de la lumière éclairant le graphe.Réel
Les valeurs possibles sont comprises entre 0 et l'infini.
La valeur par défaut est 78.
gr3DSPropLumièreYOrdonnée (Y) de la lumière éclairant le graphe.Réel
Les valeurs possibles sont comprises entre 0 et l'infini.
La valeur par défaut est 80.
gr3DSPropRotationAngle de rotation (en degrés) du graphe autour de l'axe des abscisses (axe X).Réel
Les valeurs possibles sont comprises entre 0 et 360.
La valeur 0 permet de voir le graphe de face.
La valeur 90 permet de voir le graphe de droite.
Par défaut, l'angle de rotation optimal est automatiquement calculé.
gr3DSPropTransparenceTaux de transparence (en pourcentage) des barres ou des secteurs du grapheEntier
Les valeurs possibles sont comprises entre 0 (opaque) et 100 (transparent/invisible).
La valeur par défaut est 27%.
grAlgoEntonnoirMode de représentation des données d'un graphe de type Entonnoir.Constante de type Entier :
  • grEntonnoirAire : La valeur est symbolisée par l'aire de la portion de l'entonnoir.
  • grEntonnoirHauteur : La valeur est symbolisée par la hauteur de la portion de l'entonnoir.
grAlgoPyramideMode de représentation des données d'un graphe de type Pyramide.Constante de type Entier :
  • grPyramideHauteur : La valeur est symbolisée par la hauteur de la portion de la pyramide.
  • grPyramideVolume : La valeur est symbolisée par le volume de la portion de la pyramide.
grAscenseurZoomToujoursVisibleGestion des ascenseurs lors du zoom. Booléen.
  • Vrai (par défaut) si les ascenseurs du zoom doivent être toujours visibles, même lorsque le graphe est affiché à 100%.
  • Faux si les ascenseurs de zoom doivent devenir invisibles lorsque le graphe est affiché à 100%.
grEchantillonnageActifGestion de l'échantillonnage des données. Booléen.
  • Vrai (par défaut) si l'échantillonnage des données est activé.
  • Faux si l'échantillonnage des données est désactivé.
grEmplacementOptimiséActivation de l'optimisation du remplissage de l'espace disponible pour les graphes de type Secteur, Hémicycle et Donut affichés dans un champ ou une fenêtre.Booléen.
Si l'optimisation du remplissage est activée, les graphes de type Secteur, Hémicycle et Donut occuperont toute la place disponible lors de leur affichage dans un champ ou une fenêtre.
Par défaut, l'optimisation du remplissage est activée.
grGraduationsOptimiséesXActivation de l'optimisation des graduations sur l'axe des abscisses (axe X).Booléen.
Si l'optimisation des graduations est activée, seules certaines graduations sont affichées pour éviter les superpositions.
Par défaut, l'optimisation des graduations est activée (option "Graduation" à "Défaut" dans la description du champ Graphe).
grGraduationsOptimiséesYActivation de l'optimisation des graduations sur l'axe des ordonnées (axe Y).Booléen.
Si l'optimisation des graduations est activée, seules certaines graduations sont affichées pour éviter les superpositions.
Par défaut, l'optimisation des graduations est activée (option "Graduation" à "Défaut" dans la description du champ Graphe).
grHMAffichageCouleurMode d'affichage des couleurs entre deux valeurs dans un graphe de type Heatmap. Les valeurs possibles sont :
  • grDégradéCouleur (par défaut) : Un dégradé linéaire est appliqué pour les valeurs intermédiaires.
  • grPalierInférieur : L'affichage des couleurs se fait par palier. Toutes les valeurs inférieures ou égales au palier prendront la couleur fournie par la fonction grHMCouleur.
  • grPalierSupérieur : L'affichage des couleurs se fait par palier. Toutes les valeurs supérieures ou égales au palier prendront la couleur fournie par la fonction grHMCouleur.
grLibelléSMNPerpendiculairePortionActivation de l'affichage des libellés perpendiculaires aux portions.Booléen.
Par défaut, les libellés sont affichés dans la largeur de la portion. Si cette option est activée (Vrai), le libellé sera affiché dans la hauteur de la portion.
grProjectionNuage3DMode d'affichage des projections sur un graphe de type Nuage de points 3D.Les projections ont été définies avec la fonction grNuage3DProjection.
Les valeurs possibles sont :
  • grProjectionAucune : Aucune projection n'est effectuée.
  • grProjectionClic : Les projections sont visibles uniquement lors du clic sur le point.
  • grProjectionToujoursVisible (par défaut) : Les projections sont toujours visibles.
grSMNInteractifMode de gestion de l'interactivité du graphe de type Secteur multiniveau. Booléen.
  • Vrai (option par défaut) : le graphe de type Secteur multiniveau est interactif : un clic sur une portion permet d'afficher les portions des sous-niveaux.
  • Faux : le graphe de type Secteur multiniveau n'est pas interactif.
grSMNNiveauMaxNombre maximum de niveaux affichés dans un graphe de type Secteur multiniveau. Entier.
Valeur par défaut : 0 (correspond à aucune limite).
grZoomArrièreInfiniGestion du zoom arrière (dézoomage)Booléen.
  • Vrai pour autoriser le zoom arrière d'un graphe (c'est-à-dire utiliser un zoom négatif sur un graphe affiché à 100%)
  • Faux (par défaut) pour interdire le zoom arrière.
Etats et Requêtes

Divers

Si la fonction grParamètre est utilisée sur un type de graphe autre que 3D Spatiale, aucune erreur n'est renvoyée. Si les options de dessin en 3 dimensions ne sont pas disponibles, l'information est stockée et sera utilisée lorsque le type du graphe sera modifié (avec la fonction grType ou avec le menu contextuel du graphe).
Liste des exemples associés :
WD Graphe Exemples didactiques (WINDEV) : WD Graphe
[ + ] Cet exemple didactique présente diverses utilisations du champ graphe.
Différents types de graphe sont présentés :
- Secteur (ou camembert)
- Secteur multiniveau (ou sunburst)
- Courbe
- Nuage de points
- Histogramme
- Aire
- ...

Les fonctionnalités mises en avant sont la personnalisation des graphes par programmation ainsi que le remplissage du graphe à partir d'un fichier de données HFSQL ou dans l'éditeur.
Composante : wd300grf.dll
Version minimum requise
  • Version 14
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/06/2023

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