Componente de secuencia de comandos desplegable

Una lista desplegable permite al agente elegir una opción de una lista. Una lista desplegable inactiva muestra el último valor seleccionado o el valor por defecto de la variable a la que está vinculada.

Haga clic en el Desplegable en la barra de herramientas del componente.
Ampliar la Avanzado grupo de propiedad.
En la configuración de Value, elija una variable de cadena.
Nota: En tiempo de ejecución, esta variable almacena la selección del agente.
Para definir selecciones para que el agente seleccione, en Opciones haga clic en Editar lista. Aparece Editing List, que proporciona herramientas para añadir, editar, reordenar o eliminar elementos de una lista desplegable.
Hacer clic Agregar ítem nuevo.
Debajo Valor, escriba un valor único para almacenar en la variable cuando se seleccione este elemento.
Propina: Los valores y etiquetas de los elementos desplegables pueden incluir variables interpoladas o texto normal. Para más información, consulte Uso de llaves para mostrar valores de variables y Variables incorporadas.
En Display, escriba el texto que el agente verá como selección a elegir.
Hacer clic Agregar.
Repita los pasos 4 a 8 para añadir otros elementos a la lista.
Para reposicionar elementos en la lista, use las flechas hacia arriba y hacia abajo.
Cuando termine, cierre la lista. En tiempo de ejecución, la lista desplegable muestra estas opciones al agente. Si se ha seleccionado previamente un valor, éste se indica mediante una casilla de verificación.
Para definir una lista desplegable dinámica que el agente pueda seleccionar, en Opciones haga clic en el menú y seleccione Variable.
En la lista desplegable Valores Lista , seleccione una variable o cree una nueva.
(Opcional) Seleccione una acción para invocar cuando se elija un elemento de este desplegable.
Hacer clic No se seleccionó ninguna acción debajo Cambiar acción en las propiedades del componente.

Establezca cualquier otra propiedad de este componente.

Común

Valor

El valor une un componente a la variable seleccionada. Por ejemplo, si vincula un componente de entrada de texto a una variable, el cuadro de entrada siempre mostrará el valor de esa variable, ignorando cualquier texto de marcador de posición especificado. La variable se actualiza automáticamente con el texto escrito por el usuario, sujeto a un proceso de validación.

Otros controles, botones de opción, por ejemplo, usan Valor con una configuración de Texto de valor seleccionado. Cuando se selecciona el botón de radio en tiempo de ejecución, su "Texto de valor seleccionado" se convierte en el nuevo valor de la variable. De esta forma, cada botón de opción puede asignar un valor diferente a la misma variable.

Cuando un control de calendario está vinculado a la variable, su valor se establece en la fecha seleccionada por el control. Dado que las variables pueden preestablecer el valor de los controles visuales y también ser configuradas por ellos, la vinculación es una técnica poderosa y de uso frecuente.

Marcador de posición

El texto del marcador de posición muestra una sugerencia para el usuario.

Para una entrada de texto, el texto de marcador de posición se muestra hasta que el usuario escribe la entrada. Si el usuario borra el contenido de un cuadro de entrada, se vuelve a mostrar el texto del marcador de posición.

Para un menú desplegable, el texto del marcador de posición solicita al usuario que realice una selección.

El marcador de posición se reemplaza después de que el usuario selecciona un elemento.

Propina: El texto de marcador de posición escrito manualmente se ignora si el componente está vinculado a una variable. Si se selecciona una variable, siempre se muestra su valor.

Opciones

Esta propiedad se aplica solo a los componentes desplegables. Agrega o elimina elementos de la lista de un menú desplegable.

De forma predeterminada, un menú desplegable no tiene elementos. Para agregar opciones para que los usuarios seleccionen, expanda el Avanzado grupo de propiedad.
Hacer clic Lista de edición en Opciones.
Hacer clic Agregar ítem nuevo.
Para cada elemento, configure el texto para mostrar y un valor de retorno:
- Colocar Valor a una cadena o número único. Cuando se elige el elemento, el valor indica qué elemento seleccionó el usuario. Opcionalmente, el valor puede asignarse mediante una variable.
- Colocar Monitor para enviar un mensaje de texto que un usuario puede elegir en la lista desplegable. El texto de la pantalla se puede asignar opcionalmente mediante una variable.
Hacer clic Agregar para guardar el artículo.
los Lista de edición popover resume los elementos agregados. Puede reordenar elementos haciendo clic en las flechas hacia arriba / abajo, eliminar elementos haciendo clic en el icono de la papelera o agregar elementos de lista adicionales al menú desplegable.
Hacer clic Agregar ítem nuevo para agregar elementos adicionales.
Cuando termine, descarte la ventana emergente haciendo clic en su cuadro de cierre.

Requiere valor

Determina si el usuario debe escribir o seleccionar un valor. El valor predeterminado es False, lo que significa que la interacción del usuario es opcional.

La interfaz de usuario indica visualmente si la entrada del usuario es opcional.

La entrada opcional se indica mediante una etiqueta debajo del componente:

Diseño

Ancho

Configura el ancho a un tamaño fijo, para que crezca según sea necesario para mostrar contenido o para consumir tanto espacio como sea posible en relación con otros componentes, utilizando la ponderación para influir en los ajustes de tamaño.

Configuración	Descripción
	El tamaño automático configura el componente para que se reduzca o crezca de acuerdo con su contenido. Por ejemplo, el ancho de una etiqueta puede crecer dependiendo de la cantidad de texto que contenga.
	El estiramiento permite que un componente consuma tanto espacio como sea posible en relación con otros componentes, utilizando la ponderación para influir en los ajustes de tamaño. Si dos componentes están configurados para estirarse, a ambos se les asigna el 50% del espacio restante de forma predeterminada. Esta proporción se puede ajustar cambiando el valor de peso. Por ejemplo, si configura un componente con un peso de 200 y el otro con un peso de 100, el primer componente ocupará dos tercios del espacio restante, mientras que el otro solo ocupará un tercio. El primer componente aparece dos veces el tamaño del otro componente, ya que su peso era dos veces el peso del segundo componente.
	Establece un tamaño fijo en píxeles. Puede escribir un valor entero en el cuadro o usar flechas hacia arriba o hacia abajo para incrementar o disminuir el tamaño. Estas flechas son visibles cuando el componente tiene el foco.

Altura

Configura la altura a un tamaño fijo, para que crezca según sea necesario para mostrar contenido o para consumir tanto espacio como sea posible en relación con otros componentes, utilizando la ponderación para influir en los ajustes de tamaño.

Configuración	Descripción
	El tamaño automático configura el componente para que se reduzca o crezca de acuerdo con su contenido.
	Establece un tamaño fijo en píxeles. Puede escribir un valor entero en el cuadro o usar flechas hacia arriba o hacia abajo para incrementar o disminuir el tamaño. Estas flechas son visibles cuando el componente tiene el foco.
	El estiramiento permite que un componente consuma tanto espacio como sea posible en relación con otros componentes, utilizando la ponderación para influir en los ajustes de tamaño. Si dos componentes están configurados para estirarse, a ambos se les asigna el 50% del espacio restante de forma predeterminada. Esta proporción se puede ajustar cambiando el valor de peso. Por ejemplo, si configura un componente con un peso de 200 y el otro con un peso de 100, el primer componente ocupará dos tercios del espacio restante, mientras que el otro solo ocupará un tercio. El primer componente aparece dos veces el tamaño del otro componente, ya que su peso era dos veces el peso del segundo componente.

Alinear

Alinea un componente a la izquierda, a la derecha o al centro, en relación con su contenedor principal.

Consejo: Un componente no puede alinearse verticalmente al centro si el ajuste Altura de su contenedor padre es Auto Sizing. Para corregir esto, establezca la altura del contenedor padre en Stretch o en una altura fija en Pixels.

Configuración	Ejemplo

Margen

Los márgenes establecen el espaciado izquierdo, derecho, superior e inferior alrededor de un borde.

Para actualizar opcionalmente todos los valores de los márgenes a la vez, presione el Establecer todos botón de Margen en el panel de propiedades.
Haga clic en el campo de valor para obtener un margen. Aparece un control de giro en ese campo.
Utilice el control de giro para aumentar o disminuir el margen. Si Establecer todos se seleccionó, el cambio se aplica a todos los márgenes.

El componente se reposiciona inmediatamente utilizando su nueva configuración de margen.

Visible

Establece la visibilidad de un componente según el valor de una variable booleana (verdadera o falsa).

Haga clic en el Diseño grupo de propiedad. Debajo de Visible, haga clic en Seleccionar variable.
Seleccione una variable u, opcionalmente, cree una nueva variable Sí / No y luego asigne esa nueva variable a la Visible propiedad.
En tiempo de ejecución, el componente es visible cuando el valor de la variable es Verdadero. Por el contrario, está oculto cuando el valor de la variable es Falso.

Avanzado

Valor

Opciones

Esta propiedad se aplica solo a los componentes desplegables. Agrega o elimina elementos de la lista de un menú desplegable.

De forma predeterminada, un menú desplegable no tiene elementos. Para agregar opciones para que los usuarios seleccionen, expanda el Avanzado grupo de propiedad.
Hacer clic Lista de edición en Opciones.
Hacer clic Agregar ítem nuevo.
Para cada elemento, configure el texto para mostrar y un valor de retorno:
- Colocar Valor a una cadena o número único. Cuando se elige el elemento, el valor indica qué elemento seleccionó el usuario. Opcionalmente, el valor puede asignarse mediante una variable.
- Colocar Monitor para enviar un mensaje de texto que un usuario puede elegir en la lista desplegable. El texto de la pantalla se puede asignar opcionalmente mediante una variable.
Hacer clic Agregar para guardar el artículo.
los Lista de edición popover resume los elementos agregados. Puede reordenar elementos haciendo clic en las flechas hacia arriba / abajo, eliminar elementos haciendo clic en el icono de la papelera o agregar elementos de lista adicionales al menú desplegable.
Hacer clic Agregar ítem nuevo para agregar elementos adicionales.
Cuando termine, descarte la ventana emergente haciendo clic en su cuadro de cierre.

Requiere valor

Determina si el usuario debe escribir o seleccionar un valor. El valor predeterminado es False, lo que significa que la interacción del usuario es opcional.

La interfaz de usuario indica visualmente si la entrada del usuario es opcional.

La entrada opcional se indica mediante una etiqueta debajo del componente:

Discapacitado

Todos los componentes están habilitados de forma predeterminada. La propiedad Disabled vincula una variable Verdadero / Falso a un componente, para deshabilitarlo o habilitarlo en función del valor de tiempo de ejecución de la variable.

1. Para crear una variable Verdadero / Falso, haga clic en el Variables pestaña.
2. Haga clic en Añadir para añadir una variable.
3. Seleccione Verdadero Falso como el tipo de datos.
4. En la casilla Name, escriba un nombre descriptivo.
5. Establecer valor predeterminado en Cierto o Falso.
  - Si la variable es True, el componente está desactivado.
  - Si la variable es False, el componente está activado.
6. Para guardar la variable, haga clic en Aplicar.
7. Asigne la variable a la propiedad Disabled. Debajo Discapacitado, haga clic en Seleccionar variable.
8. Seleccione la variable Verdadero / Falso.

Para probar su trabajo, haga clic en Avance.

Cambiar acción

los Cambiar acción La propiedad le permite establecer una acción que se ejecuta cuando se cambia el estado o el valor de este componente.

Puede seleccionar una acción de Scripter, una Acción de salida o una acción personalizada. Las acciones salientes no están disponibles a menos que la propiedad Saliente esté habilitada.