Selecionar função

Aplica-se a: Aplicativos Canvas Aplicativos baseados em modelos

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 enfileira o alvo 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 alvo OnSelect seja avaliado imediatamente, nem Select espera que 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, filho Controle )

• 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.
• filho Controle - 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:

   Notificar( "Olá Mundo")

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

   Select( Botão1 )

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:

   Notificar( "Galeria Selecionada")

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:

   Notificar( "Imagem Selecionada", Sucesso )

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( Galeria1,2, Imagem1 )

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.