DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Nouveauté WINDEV, WEBDEV et WINDEV Mobile 2024 !
Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions Visite guidée
  • Propriétés spécifiques à la description des variables de type VisiteGuidéeEtape
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
VisiteGuidéeEtape (Type de variable)
En anglais : GuidedTourStep
AjaxNon disponible
Le type VisiteGuidéeEtape permet de définir toutes les caractéristiques avancées d'une étape d'une visite guidée. Par défaut, les caractéristiques des étapes ont été définies dans la variable de type VisiteGuidée. Il est possible de les surcharger pour chaque étape grâce aux propriétés de la variable VisiteGuidéeEtape.
Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
Exemple
VisiteNouveauté est un VisiteGuidée
VisiteNouveauté.Identifiant = "Nouveauté de la version"
VisiteNouveauté.Version = 29
SI VisiteGuidéeInfo(VisiteNouveauté, vgInfoVersion) < 29 ALORS
VisiteNouveauté.Étape[1].Cible = SAI_Prénom
VisiteNouveauté.Étape[1].Titre = "Nouveau !"
VisiteNouveauté.Étape[1].Description = "Vous pouvez maintenant saisir votre prénom"
VisiteGuidéeDémarre()
FIN
Propriétés

Propriétés spécifiques à la description des variables de type VisiteGuidéeEtape

Les propriétés suivantes peuvent être utilisées pour manipuler une étape de la visite guidée :
Nom de la propriétéType manipuléEffet
ActionCibleEntierAction effectuée lors d'un clic sur le ou les champ(s) cibles de l'étape en cours. Les actions disponibles sont les suivantes :
  • vgaAucune : Le clic sur le ou les champs cibles est sans effet.
  • vgaDéfaut (défaut) : L'action effectuée dépend du type d'effet choisi :
    • si l'effet choisi correspond au Grisage des Fenêtres Inactives (GFI), l'action effectuée correspondra à la constante vgaAucune.
    • si l'effet choisi correspond au halo, l'action effectuée correspondra à la constante vgaChamp.
    • si aucun effet n'a été choisi, l'action effectuée correspondra à la constante vgaChamp.
  • vgaChamp : Le champ fonctionne normalement. Les événements associés au champ sont exécutés. Le passage à l'étape suivante doit être fait par programmation.
  • vgaChampPuisEtapeSuivante : Le champ fonctionne normalement. A la fin de l'exécution du code du champ, la visite guidée passe automatiquement à l'étape suivante.
    Cette action est opérationnelle uniquement sur les champs suivants : Bouton, Interrupteur, Sélecteur et Option de menu. Pour les autres champs, seul le passage à l'étape suivante sera effectué.
  • vgaEtapeSuivante : Le clic sur le champ permet uniquement de passer à l'étape suivante.
  • vgaFin : Le clic sur le champ termine toute la visite guidée.
Si cette propriété est spécifiée, elle surcharge pour l'étape la propriété définie dans la visite guidée.
ActionHorsCibleEntierAction effectuée lors d'un clic sur des champs différents des champs cibles de l'étape en cours. Les actions disponibles sont les suivantes :
  • vgaAucune : Le clic sur le ou les champs cibles est sans effet.
  • vgaDéfaut (défaut) : L'action effectuée dépend du type d'effet choisi :
    • si l'effet choisi correspond au Grisage des Fenêtres Inactives (GFI), l'action effectuée correspondra à la constante vgaAucune.
    • si l'effet choisi correspond au halo, l'action effectuée correspondra à la constante vgaChamp.
    • si aucun effet n'a été choisi, l'action effectuée correspondra à la constante vgaChamp.
  • vgaChamp : Le champ fonctionne normalement. Les événements associés au champ sont exécutés. Le passage à l'étape suivante doit être fait par programmation.
  • vgaChampPuisEtapeSuivante : Le champ fonctionne normalement. A la fin de l'exécution du code du champ, la visite guidée passe automatiquement à l'étape suivante.
    Cette action est opérationnelle uniquement sur les champs suivants : Bouton, Interrupteur, Sélecteur et Option de menu. Pour les autres champs, seul le passage à l'étape suivante sera effectué.
  • vgaEtapeSuivante : Le clic sur le champ permet uniquement de passer à l'étape suivante.
  • vgaFin : Le clic sur le champ termine toute la visite guidée.
Si cette propriété est spécifiée, elle surcharge pour l'étape la propriété définie dans la visite guidée.
Bulle
Paramètres d'affichage de la bulle d'aide affichée pour l'étape en cours.
Si cette propriété est spécifiée, elle surcharge pour l'étape la propriété définie dans la visite guidée.
Bulle.ActionAutorisée
Actions autorisées dans la bulle d'aide. L'interface de la fenêtre interne par défaut sera adaptée en fonction des options choisies.
Cette propriété et ses sous propriétés sont ignorées si le mode de la bulle d'aide correspond à la constante vgModeTransparent.
Bulle.ActionAutorisée.EtapePrécédenteBooléen
  • Vrai (par défaut) pour autoriser le passage à l'étape précédente,
  • Faux dans le cas contraire.
Bulle.ActionAutorisée.EtapeSuivanteBooléen
  • Vrai (par défaut) pour autoriser le passage à l'étape suivante,
  • Faux dans le cas contraire.
Bulle.ActionAutorisée.FinVisiteBooléen
  • Vrai (par défaut) pour autoriser à terminer la visite,
  • Faux dans le cas contraire.
Bulle.CouleurEntierCouleur des textes de la bulle (titre et description)
Valeur par défaut :
  • si la propriété Bulle.Mode correspond à la constante vgModeOpaque, la couleur sera 0x000000,
  • si la propriété Bulle.Mode correspond à la constante vgModeTransparent, la couleur par défaut sera 0xFFFFFF.
Bulle.CouleurCadreEntierCouleur du cadre de la bulle.
Valeur par défaut : 0xFF3B85FA
Bulle.CouleurFondEntierCouleur de fond de la bulle.
Cette propriété est ignorée si la propriété Bulle.Mode correspond à la constante vgModeTransparent.
Valeur par défaut : 0xFFFFFF
Bulle.FenêtreInterneChaîne de caractèresNom de la fenêtre interne du projet à utiliser pour personnaliser l'affichage dans la bulle.
Si cette propriété correspond à chaîne vide (""), la fenêtre par défaut fournie par le moteur d'exécution WINDEV / WINDEV Mobile est utilisée.
Bulle.MargeEntierMarge en pixels entre les bords de la bulle et son contenu (fenêtre interne).
Valeur par défaut : 15
Bulle.MarkdownBooléen
  • Vrai si les champs de la fenêtre interne utilisés pour afficher le titre et la description de l'étape sont affichés au format Markdown,
  • Faux dans le cas contraire.
Bulle.ModeConstante de type EntierMode d'affichage de la bulle :
  • vgModeOpaque (par défaut) : la bulle est affichée dans une fenêtre popup avec une flèche qui pointe sur le ou les champs cible. Avec la fenêtre interne par défaut, des boutons permettent de passer à l'étape suivante/précédente ou de terminer la visite.
  • vgModeTransparent : la bulle est affichée avec un fond transparent à côté du ou des champs cible. Dans ce mode aucune interaction n'est possible avec les champs de la fenêtre interne. Dans ce mode, il est conseillé d'utiliser l'effet GFI (constante vgtGFI utilisée avec la propriété Effet.Type).
Bulle.PageInterneChaîne de caractèresNom de la page interne du projet à utiliser pour personnaliser l'affichage dans la bulle.
Si cette propriété correspond à chaîne vide (""), la page par défaut fournie par le moteur d'exécution WEBDEV est utilisée.
CibleChaîne de caractèresNom du champ ou nom du groupe de champs à mettre en évidence pour l'étape.
WEBDEV - Code Navigateur Il n'est pas possible d'accéder à un volet d'onglet, une ligne d'un champ Zone répétée, une ligne d'un champ Table, etc. Si des crochets sont utilisés dans le nom du champ ([ ]), une erreur de compilation est affichée.
DescriptionChaîne de caractèresDescription de l'étape, affichée dans la bulle de l'étape.
Valeur par défaut : chaine vide
DuréeValidationAutomatiqueDuréeDélai en secondes avant la validation automatique des étapes de la visite. A la fin de ce délai, la visite passe automatiquement à l'étape suivante.
Si le délai est de 0, aucune validation automatique n'est effectuée.
Par défaut, cette propriété vaut 0.
Effet
Effet d'affichage à utiliser pour mettre en évidence le ou les champ(s) cible(s) pour l'étape.
Chacune des sous propriétés peut être surchargée par étape.
Effet.AgrandissementEntierPourcentage d’agrandissement du halo. Par défaut, cette propriété correspond à 100%.
Cette propriété est ignorée pour les autres effets.
Effet.ArrondiEntierRayon en pixels de l'arrondi à appliquer pour les coins du rectangle lorsque la forme de l'effet est un rectangle (constante vgfRectangle). Par défaut, cette propriété correspond à 5.
Effet.CouleurEntierCouleur de l'effet GFI ou halo. Par défaut :
  • si l'effet correspond au GFI, la couleur correspond à 0x0C0C0C,
  • si l'effet correspond au halo, la couleur correspond à 0xCCBFE9.
Effet.DuréeAnimationEntierDurée de l'animation de l'effet en millisecondes. Par défaut :
  • si l'effet correspond au GFI, la durée de l'animation est 300,
  • si l'effet correspond au halo, la durée de l'animation est 1000.
Effet.FormeEntierForme à utiliser pour le "trou" (effet GFI) ou pour le halo (effet Halo) :
  • vgfCercle : cercle,
  • vgfRectangle : rectangle (avec bord arrondi selon la valeur de la propriété Effet.Arrondi).
Effet.MargeEntierMarge en pixels entre les contours de la forme choisie (propriété Forme) et les bords du ou des champs cibles.
Par défaut, cette marge vaut 10 pixels.
Effet.OpacitéEntierOpacité de la couleur de l'effet (pourcentage).
Par défaut, pour l'effet GFI, cette propriété correspond à 70%, et pour l'effet halo, cette propriété correspond à 100%.
Effet.TypeConstante de type EntierType d'effet :
  • vgtAucun : aucun effet d'affichage
  • vgtGFI : grise le contenu de la fenêtre hôte en laissant apparaitre un trou de la forme choisie par la propriété Forme autour du ou des champ(s) cible(s).
  • vgtHalo (valeur par défaut) : affiche un halo de la forme choisie par la propriété Forme autour du ou des champ(s) cible(s).
IndiceEntier
  • Indice de l'étape dans la visite guidée,
  • 0 si la l'étape n'appartient pas a une visite guidée.
Cette propriété est disponible en lecture seulement.
InitialisationProcédure WLangageProcédure WLangage exécutée avant l'affichage de l'étape. Cette procédure reçoit en paramètre une variable VisiteGuidéeEtape correspondant à l'étape en cours.
Si cette procédure renvoie Faux, l'étape sera ignorée.
TerminaisonProcédure WLangageProcédure WLangage exécutée lors du passage à l'étape suivante/précédente ou à la fin de la visite guidée.
Cette procédure reçoit en paramètre une variable VisiteGuidéeEtape correspondant à l'étape en cours.
TitreChaîne de caractèresTitre de l'étape, affiché dans la bulle de l'étape.
Par défaut, cette propriété correspond à "" (chaîne vide).
Version minimum requise
  • Version 2024
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 19/12/2023

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