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
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 <Graphe>.Paramè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
GRF_Graphe1.Paramètre(grGraduationsOptimiséesX, Faux)
Syntaxe

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

<Résultat> = <Champ Graphe>.Paramètre(<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).
<Champ Graphe> : Nom de champ
Nom du champ Graphe à manipuler (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.
gr3DSPropAutoZoomZoom automatique du graphe
gr3DSPropCouleurPlanXCouleur du plan vertical (axe à droite ou à gauche)
gr3DSPropCouleurPlanYCouleur du plan horizontal (axe au-dessus ou au-dessous)
gr3DSPropCouleurPlanZCouleur du plan du fond
gr3DSPropDistanceZoom du graphe
gr3DSPropElevationAngle de rotation du graphe autour de l'axe des ordonnées (axe Y)
gr3DSPropLégendeSuperposéeSuperposition de la légende et du titre du graphe
gr3DSPropLumièreXAbscisse (X) de la lumière éclairant le graphe
gr3DSPropLumièreYOrdonnée (Y) de la lumière éclairant le graphe
gr3DSPropRotationAngle de rotation du graphe autour de l'axe des abscisses (axe X)
gr3DSPropTransparenceTaux de transparence des barres ou des secteurs du graphe
grAlgoEntonnoirMode de représentation des données dans un graphe de type Entonnoir.
Universal Windows 10 App Cette constante n'est pas disponible.
grAlgoPyramideMode de représentation des données dans un graphe de type Pyramide.
iPhone/iPadWidget IOSMac Catalyst 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.
grProjectionNuage3DMode d'affichage des projections sur un graphe de type Nuage de points 3D.
grSMNInteractifActivation du mode interactif dans un graphe de type Secteur multiniveau.
Universal Windows 10 AppiPhone/iPadWidget IOSMac Catalyst Cette constante n'est pas disponible.
grSMNNiveauMaxDéfinition du nombre maximum de niveaux affichés dans un graphe de type Secteur multiniveau.
Universal Windows 10 AppiPhone/iPadWidget IOSMac Catalyst Cette constante n'est pas disponible.
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%.

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

<Champ Graphe>.Paramètre(<Paramètre> , <Valeur>)
<Champ Graphe> : Nom de champ
Nom du champ Graphe à manipuler (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
gr3DSPropAutoZoomZoom automatique du graphe
gr3DSPropCouleurPlanXCouleur du plan vertical (axe à droite ou à gauche)
gr3DSPropCouleurPlanYCouleur du plan horizontal (axe au-dessus ou au-dessous)
gr3DSPropCouleurPlanZCouleur du plan du fond.
gr3DSPropDistanceZoom du graphe
gr3DSPropElevationAngle de rotation du graphe autour de l'axe des ordonnées (axe Y).
gr3DSPropLégendeSuperposéeSuperposition de la légende et du titre du graphe.
gr3DSPropLumièreXAbscisse (X) de la lumière éclairant le graphe.
gr3DSPropLumièreYOrdonnée (Y) de la lumière éclairant le graphe.
gr3DSPropRotationAngle de rotation du graphe autour de l'axe des abscisses (axe X).
gr3DSPropTransparenceTaux de transparence des barres ou des secteurs du graphe.
grAlgoEntonnoirMode de représentation des données dans un graphe de type Entonnoir.
Universal Windows 10 App Cette constante n'est pas disponible.
grAlgoPyramideMode de représentation des données dans un graphe de type Pyramide.
iPhone/iPadWidget IOSMac Catalyst 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.
grProjectionNuage3DMode d'affichage des projections sur un graphe de type Nuage de points 3D.
grSMNInteractifActivation du mode interactif dans un graphe de type Secteur multiniveau.
Universal Windows 10 AppiPhone/iPadWidget IOSMac Catalyst Cette constante n'est pas disponible.
grSMNNiveauMaxDéfinition du nombre maximum de niveaux affichés dans un graphe de type Secteur multiniveau.
Universal Windows 10 AppiPhone/iPadWidget IOSMac Catalyst Cette constante n'est pas disponible.
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%.
<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 <Graphe>.HMCouleur.
  • 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 <Graphe>.HMCouleur.
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 <Graphe>.Nuage3DProjection.
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.
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 : wd290grf.dll
Version minimum requise
  • Version 23
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