Seleccionar función

Aplícase a: Aplicacións de lenzo Aplicacións baseadas en modelos

Simula unha acción selecta nun control, causando que a fórmula OnSelect se avalíe.

Descripción

A función Select simula unha acción selecta nun control coma se o usuario fixese clic ou tocase o control. Como resultado, a fórmula OnSelect avalíase no control de destino.

Use Select para propagar unha acción selecta a un control primario. Este tipo de propagación é o comportamento predeterminado en galerías, por exemplo. Por defecto, a propiedade OnSelect de calquera control nun control de Galería está configurado en Select( Parent ). Deste xeito, pode definir o valor da propiedade OnSelect do control da galería e esta fórmula valorarase independentemente de onde estea un usuario pode facer clic ou tocar na galería.

Se desexa que un ou varios controis na galería realicen diferentes accións desde a propia galería, configure a propiedade OnSelect destes controis a outra cousa que o valor por defecto. Pode deixar os valores por defecto para as propiedades OnSelect da maioría dos controis da galería se desexa que realicen a mesma acción que a propia galería.

Select crea filas para o OnSelect de destino para o seu posterior procesamento, que pode suceder despois de que a fórmula actual rematou de ser avaliada. Select non causa que OnSelect de destino avalíe inmediatamente, nin Select agarda por OnSelect para acabar de ser avaliado.

Non pode usar Select nas pantallas.

Pode usar Select só con controis que teñan unha propiedade OnSelect.

Só pode usar Select en fórmulas de comportamento.

Un control non pode Seleccionarse a si mesmo directa ou indirectamente a través doutros controis.

A función Select tamén se pode usar cunha galería. Por exemplo, pódese usar para especificar a fila ou columna que seleccionar nunha galería e o control que seleccionar dentro desa fila ou columna da galería. Se selecciona unha fila ou columna, a selección da galería cambia e a fórmula OnSelect avalíase no control da galería. Se se dispón dun control dentro da fila ou columna, a fórmula OnSelectavaliarase para o control secundario.

Sintaxe

Select( Control )

• Control – Obrigatorio. O control que se vai seleccionar en nome do usuario.

Select( Control, Row or column, Child Control )

• Control – Obrigatorio. O control que se vai seleccionar en nome do usuario.
• Fila ou columna – Non requirido. O número de fila ou columna (a partir de 1) nun control de galería para seleccionar en nome do usuario.
• Control secundario: Non requirido. O control secundario do control identificado no parámetro "control" que se vai seleccionar.

Exemplos

• Botón

  Select(button1)

• Galería

  Select(Gallery1, 1)

  Simula un usuario seleccionando a fila 1 ou a columna 1 en Gallery1.

• Galería

  Select(Gallery1, 1, ChildControl1)

  Simula un usuario seleccionando ChildConttrol1 na fila 1 ou a columna 1 de Gallery1.

Uso básico

1. Engada un control de Botón e renoméeo Button1 se ten un nome diferente.

2. Axuste a propiedade OnSelect de Button1 nesta fórmula:

   Notify( "Hello World" )

3. Na mesma pantalla, engada un segunco control de Botón e axuste a súa propiedade OnSelect nesta fórmula:

   Select( Button1 )

4. Seleccione o segundo botón mantendo premida a tecla Alt.

   Unha notificación aparece na parte superior da aplicación. A propiedade OnSelect de Button1 xerou esta notificación.

   

Control de galería

1. Engada un control vertical de Galería que conteña outros controis.

   

2. Axuste a propiedade OnSelect da galería nesta fórmula:

   Notify( "Gallery Selected" )

3. Mentres mantén premida a tecla Alt, faga clic ou toque o fondo da galería ou calquera control na galería.

   Todas as accións mostrarán a notificación Galería seleccionada na parte superior da aplicación.

   Use a propiedade OnSelect da galería para especificar a acción predeterminada que debe realizarse cando o usuario fai clic ou toca un elemento na galería.

4. Axuste a propiedade OnSelect do control de imaxe nesta fórmula:

   Notify( "Image Selected", Success )

5. Mentres mantén premida a tecla Alt, faga clic ou toque os distintos elementos da galería.

   Cando fai clic ou toca calquera control na galería, excepto a imaxe, Galería seleccionada aparece como antes. Cando fai clic ou toca a imaxe, Imaxe seleccionada aparece.

   Use controis individuais na galería para realizar accións que difiren da acción predeterminada da galería.

   

6. Na mesma pantalla, engada un control de Botón e axuste a súa propiedade OnSelect nesta fórmula:

   Select( Gallery1,2,Image1 )

7. Seleccione o botón mantendo premida a tecla Alt.

   Unha notificación de imaxe seleccionada aparece na parte superior da aplicación. O clic do botón simulou seleccionar a imaxe na fila 2 da galería.