Selecionar função

Aplica-se a: Aplicativos de tela Aplicativos baseados em modelo

Simula uma ação de seleção em um controle, fazendo com que a fórmula OnSelect seja avaliada.

Descrição

A função Select 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 controle de destino é avaliada.

Use Select para propagar uma ação de selecionar para um controle pai. Esse tipo de propagação é o comportamento padrão em, por exemplo, galerias. Por padrão, a propriedade OnSelect de qualquer controle em um controle Gallery é definida como Select( Parent ). Dessa forma você pode definir o valor da propriedade OnSelect do controle Gallery em si, e essa fórmula será avaliada independentemente de onde na galeria o usuário clicar ou tocar.

Se você quiser um ou mais controles na galeria para executar ações diferentes da própria galeria, defina a propriedade OnSelect para esses controles para algo diferente do valor padrão. Você pode deixar os valores padrão para a propriedade OnSelect da maioria dos controles na galeria, se você desejar que eles executem a mesma ação que a própria galeria.

Select coloca em filas o OnSelect alvo para processamento posterior, que pode ocorrer após a fórmula atual terminar de ser avaliada. Select não causa a avaliação imediata do OnSelect alvo, nem o Select aguarda que o OnSelect termine de ser avaliado.

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

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

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

Um controle não pode usar Select nele mesmo diretamente ou indiretamente por meio de outros controles.

A função Select também pode ser usada com uma galeria. Por exemplo, ela pode ser usada para especificar a linha ou a coluna a ser selecionada em uma galeria e o controle a ser selecionado dentro dessa linha ou dessa coluna da galeria. Quando você seleciona uma linha ou uma coluna, a seleção da galeria é alterada e a fórmula OnSelect no controle Gallery é avaliado. Se um controle dentro da linha ou da coluna for fornecido, a fórmula OnSelect do controle filho será avaliada.

Sintaxe

Select( Controle )

• Controle - obrigatório. O controle para selecionar em nome do usuário.

Select( Controle, Linha ou Coluna, Controle filho )

• Controle - obrigatório. O controle para selecionar em nome do usuário.
• Linha ou coluna - não obrigatório. O número de linhas ou colunas (começando com 1) em um controle Gallery a ser selecionado em nome do usuário.
• Controle filho - não obrigatório. O controle filho do controle identificado no parâmetro "control" a ser selecionado.

Exemplos

• Botão

  Select(button1)

• Galeria

  Select(Gallery1, 1)

  Simula um usuário ao selecionar a linha 1 ou a coluna 1 em Gallery1.

• Galeria

  Select(Gallery1, 1, ChildControl1)

  Simula um usuário ao selecionar ChildConttrol1 na linha 1 ou na coluna 1 de Gallery1.

Uso básico

1. Adicione um controle Button e renomeie-o para Button1 se ele tiver um nome diferente.

2. Defina a propriedade OnSelect do Button1 para esta fórmula:

   Notify( "Olá, Mundo" )

3. Na mesma tela, adicione um segundo controle Button e configure a propriedade OnSelect para esta fórmula:

   Select( Button1 )

4. Mantendo a tecla Alt pressionada, selecione o segundo botão.

   Uma notificação será exibida na parte superior do seu aplicativo. A propriedade OnSelect do Button1 gerou esta notificação.

   

Controle Gallery

1. Adicione um controle Gallery vertical que contém outros controles.

   

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

   Notify( "Gallery Selected" )

3. Mantendo a tecla Alt pressionada, clique ou toque no plano de fundo ou em qualquer controle da galeria.

   Todas as ações mostrarão a notificação Galeria selecionada na parte superior do aplicativo.

   Use a propriedade OnSelect da galeria para especificar a ação padrão a ser tomada quando o usuário clicar ou tocar em um item da galeria.

4. Defina a propriedade OnSelect de controle Image como esta fórmula:

   Notify( "Image Selected", Success )

5. Mantendo a tecla Alt pressionada, clique ou toque em vários elementos da galeria.

   Ao clicar ou tocar em qualquer controle na galeria, exceto a imagem, é exibido Galeria selecionada, como antes. Ao clicar ou tocar na imagem, é exibido Imagem selecionada.

   Use os controles individuais na galeria para realizar ações diferentes da ação padrão da galeria.

   

6. Na mesma tela, adicione um controle Button e defina sua propriedade OnSelect como esta fórmula:

   Select( Gallery1,2,Image1 )

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

   A notificação Imagem Selecionada é exibida na parte superior do seu aplicativo. O clique no botão simulado selecionando a imagem na linha 2 da galeria.