<Graphe>.Bulle (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide

WLangage

Fonctions WLangage

Champs, pages et fenêtres

Fonctions de gestion des graphes

Options de la bulle à paramétrer

Activation / Désactivation de la bulle d'aide

Mise en forme des éléments affichés dans la bulle d'aide

Voir aussi

AjouteDonnée

AjouteDonnéeTemporelle

MAJAutomatiqueEtiquetteCatégorie

Nuage3DCouleurAltitude

Nuage3DLibelléGraduation

Nuage3DProjection

Nuage3DQuadrillage

Nuage3DReliePoint

Nuage3DSupprimeCouleurAltitude

Nuage3DSupprimeLibelléGraduation

NuageRécupèreDonnéeXY

SourceEtiquetteCatégorie

SurfaceCouleurAltitude

SurfaceLibelléGraduation

SurfaceMaillage

SurfaceQuadrillage

SurfaceRécupèreDonnée

SurfaceSupprimeCouleurAltitude

SurfaceSupprimeLibelléGraduation

WaterfallTypeCatégorie

Zoom

Options de la bulle à paramétrer
Activation / Désactivation de la bulle d'aide
Mise en forme des éléments affichés dans la bulle d'aide

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

<Graphe>.Bulle (Fonction)

En anglais : <Chart>.Tooltip

Affiche et met en forme :

la bulle d'aide associée à chaque portion d'un graphe (secteur pour un graphe de type Secteur, barre pour un graphe de type Histogramme, ...). Permet également de connaître les caractéristiques de la bulle d'aide associée à chaque portion d'un graphe.
Versions 23 et supérieures
une bulle d'aide personnalisée, associée à un point.
Nouveauté 23
une bulle d'aide personnalisée, associée à un point.
une bulle d'aide personnalisée, associée à un point.

Par défaut, une bulle d'aide est automatiquement affichée (option grBulleActive à Vrai) lors du survol d'un graphe.

Dans une page d'un site WEBDEV, le graphe doit être interactif pour permettre l'affichage de la bulle. Pour rendre le graphe interactif, cochez l'option "Graphe interactif" dans l'onglet "Détail" de la description du champ.

Versions 19 et supérieures

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Nouveauté 19

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Versions 20 et supérieures

Cette fonction est désormais disponible pour les sites WEBDEV sous Windows et Linux.

Nouveauté 20

Cette fonction est désormais disponible pour les sites WEBDEV sous Windows et Linux.

Versions 23 et supérieures

Cette fonction est désormais disponible pour les sites PHP.

Cette fonction est désormais disponible pour les applications Android.

Nouveauté 23

Cette fonction est désormais disponible pour les sites PHP.

Cette fonction est désormais disponible pour les applications Android.

Cette fonction est désormais disponible pour les sites PHP.

Cette fonction est désormais disponible pour les applications Android.

Versions 25 et supérieures

Cette fonction est désormais disponible en code navigateur.

Nouveauté 25

Cette fonction est désormais disponible en code navigateur.

Exemple

// Champ Graphe
// Affichage des pourcentages sur un histogramme
GRF_MonGraphe.Libellé(grAffichePourcentage, Vrai)
GRF_MonGraphe.Bulle(grFormatBulle, -%"[%SERIE%]" + RC + -%"[%CATEGORIE%]" + RC + -%"[%VALEUR%]")
GRF_MonGraphe.Bulle(grBulleActive, Vrai)
// Dessin du graphe
GRF_MonGraphe.Dessine()

Versions 23 et supérieures

// Champ Graphe
// Affichage d'une bulle spécifique pour un point
GRF_MonGraphe.Bulle(1, 2, "Le contenu de ma bulle d'aide")
// Dessin du graphe
GRF_MonGraphe.Dessine()

Nouveauté 23

// Champ Graphe
// Affichage d'une bulle spécifique pour un point
GRF_MonGraphe.Bulle(1, 2, "Le contenu de ma bulle d'aide")
// Dessin du graphe
GRF_MonGraphe.Dessine()

Syntaxe

Afficher et mettre en forme la bulle d'aide associée à un champ Graphe Masquer les détails

<Champ Graphe>.Bulle(<Option de la bulle à paramétrer> , <Valeur de l'option de la bulle>)

<Champ Graphe> : Nom de champ

Nom du champ Graphe à manipuler (présent dans l'éditeur de fenêtres).
Seuls les champs Graphe interactif sont disponibles.

<Option de la bulle à paramétrer> : Constante de type Entier

Active ou non la bulle d'aide et configure ses caractéristiques.
grBulleActive Active ou non la bulle d'aide.
grFormatBulle Décrit le format de la bulle d'aide.
grFormatBulleBoursier Décrit le format de la bulle d'aide pour un graphe de type Boursier.
Cette constante n'est pas disponible.
Versions 20 et supérieures
grFormatBulleEntêteMire
Nouveauté 20
grFormatBulleEntêteMire
grFormatBulleEntêteMire Décrit le format de l'entête de la mire des graphes.
Versions 16 et supérieures
grFormatBulleGrapheBulle
Nouveauté 16
grFormatBulleGrapheBulle
grFormatBulleGrapheBulle Décrit le format de la bulle d'aide pour un graphe de type Graphe à bulles.
Cette constante n'est pas disponible.
Versions 21 et supérieures
grFormatBulleHeatMap
Nouveauté 21
grFormatBulleHeatMap
grFormatBulleHeatMap Décrit le format de la bulle d'aide pour un graphe de type Heatmap.
Cette constante n'est pas disponible.
grFormatBulleNuage Décrit le format de la bulle d'aide pour un graphe de type Nuage de points.
Cette constante n'est pas disponible.
grFormatBulleSecteur Décrit le format de la bulle d'aide pour un graphe de type Secteur.

<Valeur de l'option de la bulle> : Chaîne de caractères ou booléen

Valeur de l'option de la bulle choisie. Cette valeur dépend de l'option choisie (voir tableau ci-dessus).

Connaître les caractéristiques de la bulle d'aide associée à un champ Graphe Masquer les détails

<Résultat> = <Champ Graphe>.Bulle(<Option de la bulle>)

<Résultat> : Type correspondant à l'option (booléen ou chaîne de caractères)

Valeur de l'option recherchée.

<Champ Graphe> : Nom de champ

Nom du champ Graphe à manipuler (présent dans l'éditeur de fenêtres).
Seuls les champs Graphe interactif sont disponibles.

<Option de la bulle> : Constante de type Entier

Option de la bulle d'aide dont la valeur est recherchée.
grBulleActive Active ou non la bulle d'aide.
grFormatBulle Décrit le format de la bulle d'aide.
grFormatBulleBoursier Décrit le format de la bulle d'aide pour un graphe de type Boursier.
Cette constante n'est pas disponible.
Versions 20 et supérieures
grFormatBulleEntêteMire
Nouveauté 20
grFormatBulleEntêteMire
grFormatBulleEntêteMire Décrit le format de l'entête de la mire des graphes.
Versions 16 et supérieures
grFormatBulleGrapheBulle
Nouveauté 16
grFormatBulleGrapheBulle
grFormatBulleGrapheBulle Décrit le format de la bulle d'aide pour un graphe de type Graphe à bulle.
Cette constante n'est pas disponible.
Versions 21 et supérieures
grFormatBulleHeatMap
Nouveauté 21
grFormatBulleHeatMap
grFormatBulleHeatMap Décrit le format de la bulle d'aide pour un graphe de type Heatmap.
Cette constante n'est pas disponible.
grFormatBulleNuage Décrit le format de la bulle d'aide pour un graphe de type Nuage de points.
Cette constante n'est pas disponible.
grFormatBulleSecteur Décrit le format de la bulle d'aide pour un graphe de type Secteur.

Afficher et personnaliser la bulle d'aide associée à un point Masquer les détails

<Champ Graphe>.grBulle(<Numéro de série> , <Numéro de catégorie> , <Valeur de la bulle>)

<Champ Graphe> : Nom de champ

Nom du champ Graphe à manipuler (présent dans l'éditeur de fenêtres ou de pages).
Seuls les champs Graphe interactif sont disponibles.

<Numéro de série> : Entier

Numéro de la série à manipuler.

<Numéro de catégorie> : Entier

Numéro de la catégorie à manipuler.

<Valeur de la bulle> : Chaîne de caractères (avec guillemets)

Texte personnalisé de la bulle associée au point.

Remarques

Options de la bulle à paramétrer

Constante	Effet	Valeur de l'option

grBulleActive	Active ou non la bulle d'aide.	Booléen Vrai (par défaut) pour activer la bulle d'aide, Faux pour ne pas l'afficher. Attention : les paramètres définis pour la bulle d'aide ne sont pas ré-initialisés lors de l'affichage.
grFormatBulle	Décrit le format de la bulle d'aide.	Chaîne de caractères Chaîne vide pour utiliser le format par défaut. Combinaison des chaînes suivantes : [%SERIE%] : Affiche le libellé de la série (défini avec la fonction <Graphe>.EtiquetteSérie). [%CATEGORIE%] : Affiche le libellé de la catégorie (défini avec la fonction <Graphe>.EtiquetteCatégorie). [%VALEUR%] : Affiche la valeur Exemple : "[%VALEUR%]"+RC+"[%CATEGORIE%]" Par défaut, le format est le suivant : "[%CATEGORIE%]"+RC+"[%SERIE%]"+"="+"[%VALEUR%]"
grFormatBulleBoursier	Décrit le format de la bulle d'aide pour un graphe de type Boursier.	Chaîne de caractères Chaîne vide pour utiliser le format par défaut. Combinaison des chaînes suivantes : [%SERIE%] : Affiche le libellé de la série (défini avec la fonction <Graphe>.EtiquetteSérie). [%CATEGORIE%] : Affiche le libellé de la catégorie (défini avec la fonction <Graphe>.EtiquetteCatégorie). [%MAX%] : Affiche la valeur maximale de la séance. [%MIN%] : Affiche la valeur minimale de la séance. [%DEBUT%] : Affiche la première valeur de la séance. [%FIN%] : Affiche la valeur de fin de la séance. Par défaut, le format est le suivant : "[%CATEGORIE%]"+RC+"Min.=[%MIN%]"+RC+"Max.=[%MAX%]"+RC+"Début=[%DEBUT%]"+RC+"Fin=[%FIN%]"
Versions 20 et supérieures grFormatBulleEntêteMire Nouveauté 20 grFormatBulleEntêteMire grFormatBulleEntêteMire	Décrit le format de l'entête de la mire des graphes.	Chaîne de caractères Chaîne vide pour utiliser le format par défaut. Chaîne de caractères contenant la chaîne suivante : [%CATEGORIE%] : Affiche le libellé de la catégorie (défini avec la fonction <Graphe>.EtiquetteCatégorie). Par défaut, le format est le suivant : "[%CATEGORIE%]" Versions 22 et supérieures Graphe de type Histogramme empilé : Il est possible d'ajouter le total de la pile dans la bulle d'aide d'un histogramme empilé en utilisant la syntaxe suivante : GRF_MonGraphe.grBulle(grFormatBulleEntêteMire, ... "[%CATEGORIE%], Somme = [%VALEUR%]") Nouveauté 22 Graphe de type Histogramme empilé : Il est possible d'ajouter le total de la pile dans la bulle d'aide d'un histogramme empilé en utilisant la syntaxe suivante : GRF_MonGraphe.grBulle(grFormatBulleEntêteMire, ... "[%CATEGORIE%], Somme = [%VALEUR%]") Graphe de type Histogramme empilé : Il est possible d'ajouter le total de la pile dans la bulle d'aide d'un histogramme empilé en utilisant la syntaxe suivante : GRF_MonGraphe.grBulle(grFormatBulleEntêteMire, ... "[%CATEGORIE%], Somme = [%VALEUR%]")
Versions 16 et supérieures grFormatBulleGrapheBulle Nouveauté 16 grFormatBulleGrapheBulle grFormatBulleGrapheBulle	Décrit le format de la bulle d'aide pour un graphe à bulles.	Chaîne de caractères Chaîne vide pour utiliser le format par défaut. Combinaison des chaînes suivantes : [%SERIE%] : Affiche le libellé de la série (défini avec la fonction <Graphe>.EtiquetteSérie). [%CATEGORIE%] : Affiche le libellé de la catégorie (défini avec la fonction <Graphe>.EtiquetteCatégorie). [%X%] : Affiche l'abscisse (première série) [%Y%] : Affiche l'ordonnée (seconde série) [%Z%] : Affiche la valeur de la troisième série. Par défaut, le format est le suivant : "([%X%];[%Y%]): [%Z%]"+RC+"[%CATEGORIE%]"
grFormatBulleNuage	Décrit le format de la bulle d'aide pour un graphe de type Nuage de points.	Chaîne de caractères Chaîne vide pour utiliser le format par défaut. Combinaison des chaînes suivantes : [%SERIE%] : Affiche le libellé de la série (défini avec la fonction <Graphe>.EtiquetteSérie). [%CATEGORIE%] : Affiche le libellé de la catégorie (défini avec la fonction <Graphe>.EtiquetteCatégorie). [%X%] : Affiche l'abscisse. Par défaut, le format est le suivant : "[%X%]"+RC+"[%Y%]"+RC+"[%SERIE%]"+RC+"[%CATEGORIE%]"
Versions 21 et supérieures grFormatBulleHeatMap Nouveauté 21 grFormatBulleHeatMap grFormatBulleHeatMap	Décrit le format de la bulle d'aide pour un graphe de type Heatmap.	Chaîne de caractères Chaîne vide pour utiliser le format par défaut. Combinaison des chaînes suivantes : [%SERIE%] : Affiche le libellé de la série (défini avec la fonction <Graphe>.EtiquetteSérie). [%CATEGORIE%] : Affiche le libellé de la catégorie (défini avec la fonction <Graphe>.EtiquetteCatégorie). [%X%] : Affiche l'abscisse (première série) [%Y%] : Affiche l'ordonnée (seconde série) [%Z%] : Affiche la valeur de la troisième série. Par défaut, le format est le suivant : "([%X%];[%Y%]): [%Z%]"+RC+"[%CATEGORIE%]"
grFormatBulleSecteur	Décrit le format de la bulle d'aide pour un graphe de type Secteur.	Chaîne de caractères Chaîne vide pour utiliser le format par défaut. Combinaison des chaînes suivantes : [%SERIE%] : Affiche le libellé de la série (défini avec la fonction <Graphe>.EtiquetteSérie). [%CATEGORIE%] : Affiche le libellé de la catégorie (défini avec la fonction <Graphe>.EtiquetteCatégorie). [%VALEUR%] : Affiche la valeur [%%%] : Affiche le pourcentage Exemple : "[%VALEUR%]"+RC+"[%CATEGORIE%]"+RC+"[%%%]" Par défaut, le format est le suivant : "[%CATEGORIE%]"+RC+"[%VALEUR%]"+RC+"[%%%]"

Si le format par défaut est utilisé :

la chaîne "[%CATEGORIE%]" est ignorée si aucun libellé de catégorie n'a été spécifié avec la fonction <Graphe>.EtiquetteCatégorie.
la chaîne "[%SERIE%]" est ignorée si aucun libellé de série n'a été spécifié avec la fonction <Graphe>.EtiquetteSérie.

Versions 22 et supérieures
Attention : Si vous utilisez la construction dynamique des chaînes (option "Autoriser "[% %]" dans les chaînes" dans l'onglet "Compilation" de la description du projet), une erreur de compilation apparaît (identificateur inconnu). Dans ce cas, il est nécessaire de faire précéder chaque chaîne par '-%'. Exemple :

GRF_Echéance.Bulle(grFormatBulle, "[%CATEGORIE%]" + RC + RC+ "[%VALEUR%]" + " H")

devient

GRF_Echéance.Bulle(grFormatBulle, -%"[%CATEGORIE%]" + RC + RC + -%"[%VALEUR%]" + " H")

Nouveauté 22
Attention : Si vous utilisez la construction dynamique des chaînes (option "Autoriser "[% %]" dans les chaînes" dans l'onglet "Compilation" de la description du projet), une erreur de compilation apparaît (identificateur inconnu). Dans ce cas, il est nécessaire de faire précéder chaque chaîne par '-%'. Exemple :

GRF_Echéance.Bulle(grFormatBulle, "[%CATEGORIE%]" + RC + RC+ "[%VALEUR%]" + " H")

devient

GRF_Echéance.Bulle(grFormatBulle, -%"[%CATEGORIE%]" + RC + RC + -%"[%VALEUR%]" + " H")

Attention : Si vous utilisez la construction dynamique des chaînes (option "Autoriser "[% %]" dans les chaînes" dans l'onglet "Compilation" de la description du projet), une erreur de compilation apparaît (identificateur inconnu). Dans ce cas, il est nécessaire de faire précéder chaque chaîne par '-%'. Exemple :

GRF_Echéance.Bulle(grFormatBulle, "[%CATEGORIE%]" + RC + RC+ "[%VALEUR%]" + " H")

devient

GRF_Echéance.Bulle(grFormatBulle, -%"[%CATEGORIE%]" + RC + RC + -%"[%VALEUR%]" + " H")

Activation / Désactivation de la bulle d'aide

L'activation / la désactivation de la bulle d'aide (constante grBulleActive) est prise en compte uniquement lors de l'exécution de la fonction <Graphe>.Dessine.

L'activation / la désactivation de la bulle d'aide (constante grBulleActive) est prise en compte immédiatement.

Mise en forme des éléments affichés dans la bulle d'aide

Pour mettre en forme les valeurs affichées dans la bulle d'aide (valeur et pourcentage), utilisez la fonction <Graphe>.Masque.

Composante : wd260grf.dll

Voir Aussi

Version minimum requise

Version 24

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 21/10/2020

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