Select Função

Aplica-se a: Aplicativos de tela

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

Descrição

A Select função simula uma ação de seleção em um controle como se o usuário tivesse clicado ou tocado no controle. Como resultado, a fórmula OnSelect no controlo de destino é avaliada.

Use Select para propagar uma ação de seleção para um controle pai. Este tipo de propagação é o comportamento predefinido, por exemplo, em galerias. Por padrão, a propriedade OnSelect de qualquer controle em um controle Gallery é 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 enfileira o destino OnSelect para processamento posterior, o que pode acontecer depois que a fórmula atual terminar de ser avaliada. Select não faz com que o OnSelect de destino seja avaliado imediatamente, nem espera Select que o OnSelect termine de ser avaliado.

Não é possível usar Select entre telas.

Você pode usar Select somente com controles que tenham uma propriedade OnSelect .

Você pode usar Select somente em fórmulas de comportamento.

Um controle não Select pode ser ele mesmo direta ou indiretamente através de outros controles.

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( Controlo )

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

Select( Controlo, Linha ou coluna, Controlo filho )

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

Exemplos

• Botão

  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:

   Notificar( "Olá Mundo" )

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

   Select( Botão1 )

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:

   Notificar( "Galeria selecionada" )

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:

   Notifique( "Imagem selecionada", NotificationType.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( Galeria1,2,Imagem1 )

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.