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 enfila o destino OnSelect para un procesamento posterior, que pode ocorrer despois de que a fórmula actual remate de avaliarse. Select non fai que o destino OnSelect se avalie inmediatamente, nin Select agarda a que OnSelect remate a avaliación.

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

Seleccione( Control )

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

Seleccione( Control, Fila ou columna, Control secundario )

• Control – Obrigatorio. O control que se vai seleccionar en nome do usuario.
• Fila ou columna – Non é necesario. O número de fila ou columna (a partir de 1) nun control de galería para seleccionar en nome do usuario.
• Control infantil - Non é necesario. 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:

   Notificar("Ola mundo")

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

   Seleccionar (Botón 1)

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:

   Notificar("Galería seleccionada")

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:

   Notificar( "Imaxe seleccionada", Éxito)

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:

   Seleccionar (Galería1,2,Imaxe1)

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.