AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Ayuda / WLanguage / Funciones WLanguage / Funciones estándar / Funciones de visitas guiadas
  • Propriétés spécifiques à la description des variables de type VisiteGuidée
  • Fonctions manipulant des variables de type VisiteGuidée
WINDEV
WindowsLinuxJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac Catalyst
Otros
Procedimientos almacenados
Le type VisiteGuidée permet de définir toutes les caractéristiques avancées d'une visite guidée et de ses étapes. Les caractéristiques de cette visite guidée peuvent être définies et modifiées à l'aide de différentes propriétés WLangage.
Les caractéristiques des étapes peuvent être personnalisées grâce à la variable de type VisiteGuidéeEtape. Pour toutes les caractéristiques d'étapes non personnalisées, les caractéristiques définies dans la variable VisiteGuidée seront utilisées.
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.
Ejemplo
vg is GuidedTour
vg.Step[1].Titre = "Etape 1"
vg.Step[2].Titre = "Etape 2"
vg.Step[3].Titre = "Etape 3"
vg.Effet.Couleur = LightGreen   
vg.Step[2].Effet.Couleur = LightOrange
// les étapes 1 et 3 ont un fond vert, l'étape 2 a un fond orange
Propiedades

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

Les propriétés suivantes peuvent être utilisées pour manipuler une variable de type VisiteGuidé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.
Cette propriété peut être surchargée par étape.
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.
Cette propriété peut être surchargée par étape.
Bulle
Paramètres d'affichage de la bulle d'aide affichée pour l'étape en cours. Chacune des sous propriétés peut être surchargée par étape.
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, aucun validation automatique n'est effectuée.
Par défaut, cette propriété vaut 0.
Effect.AnimationDurationIntegerDuración de la animación del efecto en milisegundos. De forma predeterminada:
  • si se utiliza el efecto OVI, la duración de la animación se establece en 300,
  • si se utiliza el efecto de halo, la duración de la animación se establece en 1000.
Effect.ColorIntegerColor del efecto OVI o del halo. De forma predeterminada:
  • si se utiliza el efecto OVI, el color se establece en 0x0C0C0C,
  • si se utiliza el efecto de halo, el color se establece en 0xCCBFE9.
Effect.GrowIntegerPorcentaje de crecimiento del halo. De forma predeterminada, esta propiedad se establece en 100%.
Esta propiedad se ignora para los otros efectos.
Effect.MarginIntegerMargen en pixeles entre la forma (propiedad Shape) y los bordes del control destacado.
De forma predeterminada, este margen se establece en 10 pixeles.
Effect.OpacityIntegerOpacidad del color del efecto (porcentaje).
De forma predeterminada, esta propiedad se establece en 70 % para el efecto OVI, y en 100 % para el efecto de halo.
Effect.RoundIntegerRadio en pixeles que se aplicará para redondear las esquinas del rectángulo cuando se utilice la constante gtsRectangle. De forma predeterminada, esta propiedad se establece en 5.
Effect.ShapeIntegerForma que se utilizará para el resaltar el control (efecto OVI) o para el halo (efecto Halo):
  • gtsCircle: círculo,
  • gtsRectangle: rectángulo (con esquinas redondeadas según el valor de la propiedad Effect.Round).
Effect.TypeConstante de tipo IntegerTipo de efecto:
  • gttNone: ningún efecto
  • gttDDW: oscurece el contenido de la ventana principal y deja un espacio con la forma definida por la propiedad Shape alrededor del o de los controles destacados.
  • gttHalo (predeterminado): muestra un halo de la forma definida por la propiedad Shape alrededor del o de los controles destacados.
Effet
Effet d'affichage à utiliser pour mettre en évidence le ou les champ(s) cible(s) pour toutes les étapes de la visite.
Chacune des sous propriétés peut être surchargée par étape.
ÉtapeTableau de VisiteGuidéeEtape
IdentifiantChaîne de caractèresIdentifiant de la visite utilisé pour la persistance.
Cette propriété doit être spécifiée et son contenu doit être unique pour le projet/l'application en cours.
Cet identifiant est notamment utilisé avec la fonction VisiteGuidéeInfo. Il est par exemple possible de ne plus afficher la visite guidée si l'utilisateur l'a déjà vue.
Exemple :
IF GuidedTourInfo(VisiteDécouverte.Identifier, ...
		gtInfoCount) = 0 THEN
	GuidedTourStart(VisiteDécouverte)
END
InitialisationProcédure WLangageProcédure WLangage exécutée au lancement de la visite guidée. Si cette procédure renvoie Faux, la visite guidée est arrêtée.
TerminaisonProcédure WLangageProcédure WLangage exécutée à la fin de la visite guidée.
Tooltip.ActionAllowedAcciones permitidas en el tooltip. La interfaz de la ventana interna predeterminada se adaptará en función de las opciones seleccionadas.
Esta propiedad y sus subpropiedades se ignoran si el modo del tooltip corresponde a la constante gtModeTransparent.
Tooltip.ActionAllowed.EndTourBoolean
  • True (predeterminado) para permitir a los usuarios finalizar la visita,
  • False en caso contrario.
Tooltip.ActionAllowed.NextStepBoolean
  • True (predeterminado) para permitir a los usuarios ir a la etapa siguiente,
  • False en caso contrario.
Tooltip.ActionAllowed.PreviousStepBoolean
  • True (predeterminado) para permitir a los usuarios volver a la etapa anterior,
  • False en caso contrario.
Tooltip.BackgroundColorIntegerColor de fondo del tooltip.
Esta propiedad se ignora si la propiedad Tooltip.Mode corresponde a gtModeTransparent.
Valor predeterminado: 0xFFFFFF
Tooltip.BorderColorIntegerColor del borde del tooltip.
Valor predeterminado: 0xFF3B85FA
Tooltip.ColorIntegerColor del texto del tooltip (título y descripción)
Valor predeterminado:
  • si la propiedad Tooltip.Mode corresponde a la constante gtModeOpaque, el color será 0x000000,
  • si la propiedad Tooltip.Mode corresponde a la constante gtModeTransparent, el color predeterminado será 0xFFFFFF,.
Tooltip.InternalPageCharacter stringNombre de la página interna que se utilizará para personalizar las opciones de visualización del tooltip.
Si esta propiedad corresponde a una cadena vacía (""), se utilizará la página predeterminada proporcionada por WEBDEV.
Tooltip.InternalWindowCharacter stringNombre de la ventana interna que se utilizará para personalizar las opciones de visualización del tooltip.
Si esta propiedad corresponde a una cadena vacía (""), se utilizará la ventana predeterminada proporcionada por WINDEV o WINDEV Mobile.
Tooltip.MarginIntegerMargen en pixeles entre los bordes del tooltip y su contenido (ventana interna).
Valor predeterminado: 15
Tooltip.MarkdownBoolean
  • True si los controles de la ventana interna se muestran con formato Markdown,
  • False en caso contrario.
Tooltip.ModeConstante de tipo IntegerModo de visualización del tooltip:
  • gtModeOpaque (predeterminado): el tooltip se muestra en una ventana emergente con una flecha que apunta a los controles destacados. La ventana interna predeterminada incluye dos botones para ir a la etapa siguiente/anterior o para finalizar la vista.
  • gtModeTransparent: el tooltip se muestra con un fondo transparente junto a los controles destacados. En este modo, el usuario no puede interactuar con los controles de la ventana interna. En este modo, se recomienda utilizar el efecto de Oscurecimiento de Ventanas Inactivas (constante gttDDW con la propiedad Effect.Type).
VersionEntierNuméro de version de la visite guidée. Par défaut, cette propriété vaut 1.
Cette propriété doit être incrémentée par le développeur selon les nouveautés à montrer dans la visite guidée.
Ce numéro de version peut notamment être utilisé avec la fonction VisiteGuidéeInfo. Il est par exemple possible d'afficher la visite guidée si des nouveautés sont disponibles.
Exemple :
// Affiche les nouveautés d'une version 
VisiteNouveauté is GuidedTour
VisiteNouveauté.Identifier = "Nouveauté de la version"
VisiteNouveauté.Version = 29
IF GuidedTourInfo(VisiteNouveauté, gtInfoVersion) < 29 THEN
VisiteNouveauté.Step[1].Cible = SAI_Prénom
VisiteNouveauté.Step[1].Titre = "Nouveau !"
VisiteNouveauté.Step[1].Description = ...
	"Vous pouvez maintenant saisir votre prénom"
GuidedTourStart(VisiteNouveauté)
END
Observaciones

Fonctions manipulant des variables de type VisiteGuidée

GuidedTourChangeStepCambia a otra etapa de la visita guiada.
GuidedTourInfoDevuelve información sobre una visita guiada.
GuidedTourStartInicia la visita guiada y muestra la primera etapa.
GuidedTourStopDetiene la visita guiada actual u otra visita guiada especificada.
Versión mínima requerida
  • Versión 2024
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 18/09/2024

Señalar un error o enviar una sugerencia | Ayuda local