Função Select no Power Apps

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 Galeria está definida como Select( Parent ). Dessa forma, pode definir o valor da propriedade OnSelect do próprio controlo de galeria. 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 de galeria é avaliada. Se for fornecido um controlo na linha ou coluna, a fórmula OnSelect do controlo subordinado será avaliada.

Sintaxe

Select( Control )

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

Select( Control, Row or column, Child Control )

  • Controlo – 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 de galeria 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

  • 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 Botão 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 Botão 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.

    Uma animação que mostra as definições da propriedade OnSelect para os dois botões e a notificação quando o segundo botão é clicado

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

    Selecione uma galeria vertical com 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.

    Uma animação que mostra o valor predefinido da propriedade OnSelect para um controlo de galeria, bem como um controlo que executa uma ação diferente

  6. No mesmo ecrã, adicione um controlo Botão 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.

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).