Select Função

Aplica-se a: aplicativos Canvas

Simula uma ação de seleção em um controle, fazendo 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 controle de destino é avaliada.

Use Select para propagar uma ação de seleção 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 da Galeria é definida como Select( Pai ). 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 OnSelect de destino para processamento posterior, o que pode acontecer após a conclusão da avaliação da fórmula atual. Select não faz com que o OnSelect de destino seja avaliado imediatamente, nem Select aguarda que o OnSelect termine de ser avaliado.

Você não pode usar Select entre telas.

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

Você só pode usar Selectfórmulas de comportamento.

Um controle não Select pode ser usado direta 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.
• 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( 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:

   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:

   Notify( "Image Selected", NotificationType.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( Galeria1,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.