ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Chart functions
  • Paramètres d'un graphe
  • Divers
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
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.
Linux Attention : L'utilisation de cette fonction sous Linux nécessite une configuration spécifique. Pour plus de détails, consultez Les graphes.
Nouveauté 2025
Android Cette fonction est désormais disponible pour les applications Android.
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).
PHP Seuls les champs Graphe interactif sont disponibles.
<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.
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropAutoZoomZoom automatique du graphe
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropCouleurPlanXCouleur du plan vertical (axe à droite ou à gauche)
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropCouleurPlanYCouleur du plan horizontal (axe au-dessus ou au-dessous)
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropCouleurPlanZCouleur du plan du fond
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropDistanceZoom du graphe
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropElevationAngle de rotation du graphe autour de l'axe des ordonnées (axe Y)
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropLégendeSuperposéeSuperposition de la légende et du titre du graphe
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropLumièreXAbscisse (X) de la lumière éclairant le graphe
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropLumièreYOrdonnée (Y) de la lumière éclairant le graphe
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropRotationAngle de rotation du graphe autour de l'axe des abscisses (axe X)
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropTransparenceTaux de transparence des barres ou des secteurs du graphe
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
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.
WEBDEV - Code ServeurAndroidPHP Cette constante n'est pas disponible
grAscenseurZoomToujoursVisibleGestion des ascenseurs lors d'un zoom sur le graphe.
AndroidPHP Cette constante n'est pas disponible.
grEchantillonnageActifGestion de l'échantillonnage (sub sampling).
Android Cette constante n'est pas disponible.
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.
AndroidPHP Cette constante n'est pas disponible.
grGraduationsOptimiséesXActivation de l'optimisation des graduations sur l'axe des abscisses (axe X).
AndroidPHP Cette constante n'est pas disponible.
grGraduationsOptimiséesYActivation de l'optimisation des graduations sur l'axe des ordonnées (axe Y).
AndroidPHP Cette constante n'est pas disponible.
grHMAffichageCouleurMode d'affichage des couleurs dans un graphe de type Heatmap.
Android Cette constante n'est pas disponible.
grLibelléSMNPerpendiculairePortionMode d'affichage du libellé de la portion dans un graphe de type Secteur multiniveau.
WINDEVWindows 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.
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
grSMNInteractifActivation du mode interactif dans un graphe de type Secteur multiniveau.
AndroidiPhone/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.
AndroidiPhone/iPadWidget IOSMac Catalyst Cette constante n'est pas disponible.
Nouveauté 2025
grVignetteAvecAgrandissement
Gestion de l'agrandissement de l'image définie avec grVignetteCatégorie.
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%.
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible

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).
PHP Seuls les champs Graphe interactif sont disponibles.
<Paramètre> : Constante de type entier
Paramètre du graphe à modifier :
gr3DSPropAnimationType d'animation jouée lors de l'affichage du graphe.
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropAutoZoomZoom automatique du graphe
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropCouleurPlanXCouleur du plan vertical (axe à droite ou à gauche)
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropCouleurPlanYCouleur du plan horizontal (axe au-dessus ou au-dessous)
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropCouleurPlanZCouleur du plan du fond
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropDistanceZoom du graphe
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropElevationAngle de rotation du graphe autour de l'axe des ordonnées (axe Y)
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropLégendeSuperposéeSuperposition de la légende et du titre du graphe
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropLumièreXAbscisse (X) de la lumière éclairant le graphe
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropLumièreYOrdonnée (Y) de la lumière éclairant le graphe
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropRotationAngle de rotation du graphe autour de l'axe des abscisses (axe X)
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
gr3DSPropTransparenceTaux de transparence des barres ou des secteurs du graphe
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
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.
WEBDEV - Code ServeurAndroidPHP Cette constante n'est pas disponible
grAscenseurZoomToujoursVisibleGestion des ascenseurs lors d'un zoom sur le graphe.
AndroidPHP Cette constante n'est pas disponible.
grEchantillonnageActifGestion de l'échantillonnage (sub sampling).
Android Cette constante n'est pas disponible.
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.
AndroidPHP Cette constante n'est pas disponible.
grGraduationsOptimiséesXActivation de l'optimisation des graduations sur l'axe des abscisses (axe X).
AndroidPHP Cette constante n'est pas disponible.
grGraduationsOptimiséesYActivation de l'optimisation des graduations sur l'axe des ordonnées (axe Y).
AndroidPHP Cette constante n'est pas disponible.
grHMAffichageCouleurMode d'affichage des couleurs dans un graphe de type Heatmap.
Android Cette constante n'est pas disponible.
grLibelléSMNPerpendiculairePortionMode d'affichage du libellé de la portion dans un graphe de type Secteur multiniveau.
WINDEVWindows 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.
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
grSMNInteractifActivation du mode interactif dans un graphe de type Secteur multiniveau.
AndroidiPhone/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.
AndroidiPhone/iPadWidget IOSMac Catalyst Cette constante n'est pas disponible.
Nouveauté 2025
grVignetteAvecAgrandissement
Gestion de l'agrandissement de l'image définie avec grVignetteCatégorie.
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%.
WEBDEV - Code ServeurAndroidiPhone/iPadWidget IOSMac CatalystPHP Cette constante n'est pas disponible
<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.
WEBDEV - Code ServeurPHP Le libellé est toujours 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).
Nouveauté 2025
grVignetteAvecAgrandissement
Booléen. Gestion de l'agrandissement de l'image définie avec grVignetteCatégorie :
  • Vrai : la vignette suivra le redimensionnement du graphe (si le graphe s'agrandit, la vignette visible dans la part sera agrandie).
  • Faux (valeur par défaut) : la vignette ne change jamais de taille.
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.
WINDEVEtats et RequêtesCode Utilisateur (MCU)

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
Minimum version required
  • Version 14
Comments
Click [Add] to post a comment

Last update: 12/04/2024

Send a report | Local help