| | |
| Nombre de la propiedad | Tipo utilizado | Efecto |
|---|
| ActionOutsideTarget | Integer | Acción realizada cuando el usuario hace clic en un control distinto al control destacado de la etapa actual. Las acciones disponibles son las siguientes: - gtaNone: Hacer clic en los controles no tiene ningún efecto.
- gtaDefault (valor predeterminado): La acción depende del tipo de efecto:
- si se utiliza el efecto de Oscurecimiento de Ventanas Inactivas (OVI), la acción corresponderá a la constante gtaNone.
- si se utiliza el efecto de halo, la acción corresponderá a la constante gtaControl.
- si no se utiliza ningún efecto, la acción corresponderá a la constante gtaControl.
- gtaControl: El control tiene un comportamiento estándar. Los eventos asociados al control se ejecutan. La transición a la etapa siguiente debe realizarse mediante programación.
- gtaControlThenNextStep: El control tiene un comportamiento estándar. Una vez ejecutado el código del control, la visita guiada pasa automáticamente a la etapa siguiente.
Esta acción solo está disponible para los siguientes controles: Botón, Casilla de verificación, Botón de opción y Opción de menú. Para los otros controles, solo se ejecutará la transición a la etapa siguiente. - gtaNextStep: Al hacer clic en el control, el usuario pasa a la etapa siguiente.
- gtaEnd: Al hacer clic en el control, finaliza la visita guiada.
Esta propiedad puede sobrescribirse en cada etapa. |
| ActionTarget | Integer | Acción realizada cuando el usuario hace clic en el o los controles destacados de la etapa actual. Las acciones disponibles son las siguientes: - gtaNone: Hacer clic en los controles no tiene ningún efecto.
- gtaDefault (valor predeterminado): La acción depende del tipo de efecto:
- si se utiliza el efecto de Oscurecimiento de Ventanas Inactivas (OVI), la acción corresponderá a la constante gtaNone.
- si se utiliza el efecto de halo, la acción corresponderá a la constante gtaControl.
- si no se utiliza ningún efecto, la acción corresponderá a la constante gtaControl.
- gtaControl: El control tiene un comportamiento estándar. Los eventos asociados al control se ejecutan. La transición a la etapa siguiente debe realizarse mediante programación.
- gtaControlThenNextStep: El control tiene un comportamiento estándar. Una vez ejecutado el código del control, la visita guiada pasa automáticamente a la etapa siguiente.
Esta acción solo está disponible para los siguientes controles: Botón, Casilla de verificación, Botón de opción y Opción de menú. Para los otros controles, solo se ejecutará la transición a la etapa siguiente. - gtaNextStep: Al hacer clic en el control, el usuario pasa a la etapa siguiente.
- gtaEnd: Al hacer clic en el control, finaliza la visita guiada.
Esta propiedad puede sobrescribirse en cada etapa. |
| AutomaticValidationTimeout | Duration | Tiempo (expresado en segundos) antes de que se valide automáticamente la etapa de la visita guiada. Una vez transcurrido este tiempo, el usuario pasa automáticamente a la etapa siguiente.
Si el tiempo de espera es 0, no habrá validación automática.
De forma predeterminada, esta propiedad se establece en 0. |
| Effect | | Efecto utilizado para destacar el o los controles de todas las etapas de la visita guiada. Todas las subpropiedades pueden sobrescribirse en cada etapa. |
| Effect.AnimationDuration | Integer | Duració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.Color | Integer | Color 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.Grow | Integer | Porcentaje de crecimiento del halo. De forma predeterminada, esta propiedad se establece en 100%. Esta propiedad se ignora para los otros efectos. |
| Effect.Margin | Integer | Margen en pixeles entre la forma (propiedad Shape) y los bordes del control destacado. De forma predeterminada, este margen se establece en 10 pixeles. |
| Effect.Opacity | Integer | Opacidad 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.Round | Integer | Radio 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.Shape | Integer | Forma 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.Type | Constante de tipo Integer | Tipo 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.
|
| Identifier | Character string | Identificador de la visita guiada utilizado para la persistencia.
Esta propiedad debe especificarse y su contenido debe ser único para el proyecto/aplicación actual. Este identificador se utiliza en particular con la función GuidedTourInfo. Por ejemplo, puede definir que no se vuelva a abrir una visita guiada si el usuario ya la ha visto. Ejemplo: IF GuidedTourInfo(GuidedTourGetStarted.Identifier, ...
gtInfoCount) = 0 THEN
GuidedTourStart(GuidedTourGetStarted)
END
|
| Initialization | Procedimiento WLanguage | Procedimiento WLanguage ejecutado al iniciar la visita guiada. Si este procedimiento devuelve False, la visita guiada se detiene. |
| Step | Array de GuidedTourStep | |
| Termination | Procedimiento WLanguage | Procedimiento WLanguage ejecutado al final de la visita guiada. |
| Tooltip | | Define las opciones de visualización del tooltip que se muestra en la etapa actual. Todas las subpropiedades pueden sobrescribirse en cada etapa. |
| Tooltip.ActionAllowed | | Acciones 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.EndTour | Boolean | - True (predeterminado) para permitir a los usuarios finalizar la visita,
- False en caso contrario.
|
| Tooltip.ActionAllowed.NextStep | Boolean | - True (predeterminado) para permitir a los usuarios ir a la etapa siguiente,
- False en caso contrario.
|
| Tooltip.ActionAllowed.PreviousStep | Boolean | - True (predeterminado) para permitir a los usuarios volver a la etapa anterior,
- False en caso contrario.
|
| Tooltip.BackgroundColor | Integer | Color de fondo del tooltip. Esta propiedad se ignora si la propiedad Tooltip.Mode corresponde a gtModeTransparent. Valor predeterminado: 0xFFFFFF |
| Tooltip.BorderColor | Integer | Color del borde del tooltip. Valor predeterminado: 0xFF3B85FA |
| Tooltip.Color | Integer | Color 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.InternalPage | Character string | Nombre 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.InternalWindow | Character string | Nombre 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.Margin | Integer | Margen en pixeles entre los bordes del tooltip y su contenido (ventana interna). Valor predeterminado: 15 |
| Tooltip.Markdown | Boolean | - True si los controles de la ventana interna se muestran con formato Markdown,
- False en caso contrario.
|
| Tooltip.Mode | Constante de tipo Integer | Modo 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).
|
| Version | Integer | Número de versión de la visita guiada. De forma predeterminada, esta propiedad se establece en 1.
Esta propiedad debe ser incrementada por el desarrollador en función de las novedades que se van a mostrar en la visita guiada.Este número de versión puede utilizarse con la función GuidedTourInfo. Por ejemplo, es posible abrir la visita guiada si hay nuevas funcionalidades disponibles. Ejemplo:
WhatsNewTour is GuidedTour
WhatsNewTour.Identifier = "What's new in this version"
WhatsNewTour.Version = 29
IF GuidedTourInfo(WhatsNewTour, gtInfoVersion) < 29 THEN
WhatsNewTour.Step[1].Target = EDT_FirstName
WhatsNewTour.Step[1].Title = "New!"
WhatsNewTour.Step[1].Description = ...
"Now, you can enter your first name"
GuidedTourStart(WhatsNewTour)
END
|