Selecionar função

Aplica-se a: Aplicações de tela Aplicações condicionadas por modelo

Simula uma ação de seleção num controlo e faz com que a fórmula OnSelect seja avaliada.

Descrição

A função Select simula uma ação de seleção num controlo como se o utilizador tivesse clicado ou tocado no controlo. Como resultado, a fórmula OnSelect no controlo de destino é avaliada.

Utilize a função Select para propagar uma ação de seleção para um controlo principal. Este tipo de propagação é o comportamento predefinido, por exemplo, em galerias. Por predefinição, a propriedade OnSelect de qualquer controlo num controlo Gallery está definida como Select( Parent ). Dessa forma, pode definir o valor da propriedade OnSelect do próprio controlo gallery. Essa fórmula será avaliada independentemente do local onde o utilizador clique ou toque na galeria.

Se quiser que um ou mais controlos na galeria efetuem ações diferentes das da própria galeria, defina a propriedade OnSelect para esses controlos como algo diferente do valor predefinido. Poderá deixar os valores predefinidos para as propriedades OnSelect da maioria dos controlos na galeria se quiser que aqueles efetuem a mesma ação que a própria galeria.

Select coloca em fila o alvo OnSelect para processamento posterior, o que pode ocorrer depois da avaliação da atual fórmula ter terminado. Select não faz com que o alvo OnSelect seja avaliado imediatamente, nem a função Select espera que OnSelect termine de ser avaliado.

Não pode utilizar Select nos ecrãs.

Pode utilizar Select apenas com controlos que tenham uma propriedade OnSelect.

Só pode utilizar Select em fórmulas de comportamento.

Um controlo não pode utilizar a função Select direta ou indiretamente através de outros controlos.

A função Select também pode ser utilizada com uma galeria. Por exemplo, pode ser utilizada para especificar a linha ou coluna a selecionar numa galeria, assim como o controlo a selecionar nessa linha ou coluna da galeria. Quando seleciona uma linha ou coluna, a seleção de galeria é alterada e a fórmula OnSelect no controlo gallery é avaliada. Se for fornecido um controlo na linha ou coluna, a fórmula OnSelect do controlo subordinado será avaliada.

Sintaxe

Select( Control )

• Control – Obrigatório. O controlo a selecionar em nome do utilizador.

Select( Control, Row or column, Child Control )

• Control – Obrigatório. O controlo a selecionar em nome do utilizador.
• Row or column – Não é obrigatório. O número da linha ou coluna (a começar no 1) num controlo gallery a ser selecionado em nome do utilizador.
• Child Control – Não é obrigatório. O controlo subordinado do controlo identificado no parâmetro "control" a selecionar.

Exemplos

• Button

  Select(button1)

• Galeria

  Select(Gallery1, 1)

  Simula um utilizador a selecionar a linha 1 ou a coluna 1 da Galeria1.

• Galeria

  Select(Gallery1, 1, ChildControl1)

  Simula um utilizador a selecionar o ControloSubordinado1 na linha 1 ou coluna 1 da Galeria1.

Utilização básica

1. Adicione um controlo de Button e mude o nome para Botão1 (se tiver um nome diferente).

2. Defina a propriedade OnSelect de Botão1 como esta fórmula:

   Notify( "Hello World" )

3. No mesmo ecrã, adicione um segundo controlo Button e defina a propriedade OnSelect para esta fórmula:

   Select( Button1 )

4. Mantenha a tecla Alt premida e selecione o segundo botão.

   É apresentada uma notificação na parte superior da aplicação. A propriedade OnSelect do Botão1 gerou esta notificação.

   

Controlo gallery

1. Adicione um controlo Gallery vertical que contém outros controlos.

   

2. Defina a propriedade OnSelect da galeria para esta fórmula:

   Notify( "Gallery Selected" )

3. Mantenha a tecla Alt premida e clique ou toque no fundo da galeria ou em qualquer controlo na galeria.

   Todas as ações irão mostrar a notificação Galeria Selecionada na parte superior da aplicação.

   Utilize a propriedade OnSelect da galeria para especificar a ação predefinida a tomar quando o utilizador clica ou toca num item na galeria.

4. Defina a propriedade OnSelect do controlo de item para esta fórmula:

   Notify( "Image Selected", Success )

5. Mantenha a tecla Alt premida e clique ou toque nos vários elementos da galeria.

   Quando clica ou toca em qualquer controlo na galeria, exceto na imagem, aparece Galeria Selecionada, como anteriormente. Quando clica ou toca na imagem, aparece Imagem Selecionada.

   Utilize os controlos individuais na galeria para executar ações diferentes da ação predefinida para a galeria.

   

6. No mesmo ecrã, adicione um controlo Button e defina a propriedade OnSelect para esta fórmula:

   Select( Gallery1,2,Image1 )

7. Mantendo premida a tecla Alt, selecione o botão.

   É apresentada uma notificação Imagem Selecionada na parte superior da sua aplicação. O clique do botão simulado a selecionar a imagem na linha 2 da galeria.