Compartir vía

Seleccionar función

  • Artículo

Se aplica a: Aplicaciones de lienzo Aplicaciones basadas en modelos

Simula una acción de selección en un control, lo que provoca la evaluación de la fórmula OnSelect.

Descripción

La función Select simula una acción de selección en un control como si el usuario hubiera hecho clic en el control o lo hubiera pulsado. Como resultado, la fórmula OnSelect se evalúa en el control de destino.

Use Select para propagar una acción seleccionada a un control primario. Este tipo de propagación es el comportamiento predeterminado en, por ejemplo, las galerías. De forma predeterminada, la propiedad OnSelect de cualquier control en un control Gallery se establece en Select (primario). De este modo, puede establecer el valor de la propiedad OnSelect del propio control de la galería y que la fórmula se evaluará independientemente de dónde un usuario podría haga clic o pulsar en la galería.

Si desea que uno o varios controles de la galería realicen diferentes acciones de la propia galería, establezca la propiedad OnSelect para esos controles en un valor distinto del valor predeterminado. Puede dejar los valores predeterminados para las propiedades OnSelect de la mayoría de los controles de la galería si desea que realicen la misma acción que la propia galería.

Select pone en cola la propiedad OnSelect de destino para su posterior procesamiento, que puede ocurrir una vez finalizada la evaluación de la fórmula actual. Select no provoca que la propiedad OnSelect de destino se evalúe inmediatamente; Select tampoco espera a que OnSelect termine de evaluarse.

No se puede utilizar Select entre pantallas.

Solo puede usar Select con controles que tienen una propiedad OnSelect.

Se pueden usar Select en fórmulas de comportamiento.

Un control no puede usar Select directa o indirectamente a través de otros controles.

La función Select también se puede usar con una galería. Por ejemplo, se puede usar para especificar la fila o columna que se va a seleccionar en una galería y el control que se va a seleccionar dentro de esa fila o columna de la galería. Al seleccionar una fila o una columna, la selección de la galería cambia y se evalúa la fórmula OnSelect del control de la galería. Si se proporciona un control dentro de la fila o columna, se evaluará la fórmula OnSelect del control secundario.

Sintaxis

Select( Control )

  • Control (obligatorio). El control para seleccionar en nombre del usuario.

Select( Control, fila o columna, control secundario )

  • Control (obligatorio). El control para seleccionar en nombre del usuario.
  • Fila o columna (no es obligatorio). Número de fila o columna (empezando por 1) en un control de galería que se quiere seleccionar en nombre del usuario.
  • Control secundario: opcional. Control secundario del control identificado en el parámetro "Control" que se quiere seleccionar.

Ejemplos

  • Botón

    Select(button1)

  • Galería

    Select(Gallery1, 1)

    Simula un usuario que selecciona la fila 1 o la columna 1 en Gallery1.

  • Galería

    Select(Gallery1, 1, ChildControl1)

    Simula un usuario que selecciona ChildConttrol1 en la fila 1 o la columna 1 de Gallery1.

Uso básico

  1. Agregue un control Button y, si tiene otro nombre, cámbielo a Botón1.

  2. Establezca la propiedad OnSelect de Botón1 en esta fórmula:

    Notify( "Hola mundo" )

  3. En la misma pestaña, agregue un segundo control Button y establezca su propiedad OnSelect en esta fórmula:

    Select( Botón1 )

  4. Mientras mantiene presionada la tecla Alt, seleccione el segundo botón.

    Aparecerá una notificación en la parte superior de la aplicación. La propiedad OnSelect de Button1 generó esta notificación.

    Animación que muestra la configuración de la propiedad OnSelect para los dos botones y la notificación cuando se hace clic en el segundo botón.

  1. Agregue un control Gallery vertical que contiene otros controles.

    Seleccione una galería vertical que contiene controles.

  2. Seleccione la propiedad OnSelect de la galería en esta fórmula:

    Notify( "Galería seleccionada" )

  3. Mientras mantiene presionada la tecla Alt, haga clic en el fondo de la galería o en cualquier control en la galería; también puede pulsar dichos elementos.

    Todas las acciones mostrarán la notificación Galería seleccionada en la parte superior de la aplicación.

    Use propiedad OnSelect de la galería para especificar la acción predeterminada que se realizará cuando el usuario haga clic en un elemento de dicha galería o pulse ese elemento.

  4. Establezca la propiedad OnSelect del control de imagen en esta fórmula:

    Notify( "Imagen seleccionada", operación correcta)

  5. Mientras mantiene presionada la tecla Alt, haga clic en los distintos elementos de la galería o púlselos.

    Al hacer clic o pulsar en cualquier control en la galería, excepto en la imagen, Galería seleccionada aparecerá como antes. Al hacer clic en la imagen o pulsarla, aparecerá Imagen seleccionada.

    Use controles individuales en la galería para realizar acciones que difieren de la acción predeterminada de la galería.

    Animación que muestra el valor predeterminado de la propiedad OnSelect para un control de la galería, así como un control que realiza una acción diferente.

  6. En la misma pestaña, agregue un control Button y establezca su propiedad OnSelect en esta fórmula:

    Select( Gallery1,2,Image1 )

  7. Mientras mantiene presionada la tecla Alt, seleccione el botón.

    Aparecerá una notificación Imagen seleccionada en la parte superior de la aplicación. Simulación de un clic en un botón para seleccionar la imagen en la fila 2 de la galería.