Controle Screen no PowerAppsScreen control in PowerApps

Um elemento da interface do usuário que contém um ou mais controles em um aplicativo.A UI element that contains one or more other controls in an app.

DescriçãoDescription

A maioria dos aplicativos tem vários controles Tela que contêm controles Rótulo, controles Botão e outros controles que mostram os dados e dão suporte à navegação.Most apps have multiple Screen controls that contain Label controls, Button controls, and other controls that show data and support navigation.

Propriedades-chaveKey properties

BackgroundImage – o nome de um arquivo de imagem exibido na tela de fundo.BackgroundImage – The name of an image file that appears in the background of a screen.

Fill – a cor da tela de fundo de um controle.Fill – The background color of a control.

Propriedades adicionaisAdditional properties

ImagePosition – a posição (Preencher, Ajustar, Ampliar, Organizar lado a lado ou Centralizar) de uma imagem em uma tela ou em um controle se ela não tiver o mesmo tamanho da imagem.ImagePosition – The position (Fill, Fit, Stretch, Tile, or Center) of an image in a screen or a control if it isn't the same size as the image.

OnHidden – o comportamento de um aplicativo quando o usuário sai de uma tela.OnHidden – The behavior of an app when the user navigates away from a screen.

OnVisible – o comportamento de um aplicativo quando o usuário navega para uma tela.OnVisible – The behavior of an app when the user navigates to a screen.

OnStart – o comportamento do aplicativo quando aberto pelo usuário.OnStart – The behavior of the app when the user opens the app.

  • A fórmula para a qual essa propriedade está definida é executada antes que a primeira tela do aplicativo seja exibida.The formula to which this property is set runs before the first screen of the app appears. Chame a função Navegar para alterar a tela que aparece primeiro quando o aplicativo é iniciado.Call the Navigate function to change which screen appears first when the app starts.
  • Não é possível definir variáveis de contexto com a função UpdateContext, porque nenhuma tela apareceu ainda.You can't set context variables with the UpdateContext function because no screen has appeared yet. No entanto, é possível passar variáveis de contexto na função Navegar, bem como criar e preencher uma coleção usando a função Coletar.However, you can pass context variables in the Navigate function and create and fill a collection by using the Collect function.
  • Ao atualizar um aplicativo, a fórmula para a qual essa propriedade está definida é executada quando o aplicativo é carregado no PowerApps Studio.When you update an app, the formula to which this property is set runs when the app is loaded into PowerApps Studio. Para ver o impacto da alteração dessa propriedade, será necessário salvar, fechar e recarregar o aplicativo.To see the impact of changing this property, you'll need to save, close, and reload your app.
  • A propriedade OnStart é, na verdade, uma propriedade do aplicativo, e não da tela.The OnStart property is actually a property of the app, not the screen. Para facilitar a edição, exiba e modifique-a como uma propriedade na primeira tela do aplicativo.For editing convenience, you view and modify it as a property on the first screen of your app. Se a primeira tela for removida ou se as telas forem reorganizadas, poderá ser difícil localizar essa propriedade.If you remove the first screen or reorder screens, this property may become hard to find. Nesse caso, salve, feche e recarregue o aplicativo; assim, a propriedade reaparecerá como uma propriedade da primeira tela.In this case, save, close, and reload your app, and the property will reappear as a property of the first screen.

Distinct( DataSource, ColumnName )Distinct( DataSource, ColumnName )

ExemploExample

  1. Adicione um controle Radio, chame-o de ScreenFills e defina sua propriedade Items como este valor:Add a Radio control, name it ScreenFills, and set its Items property to this value:
    ["Red", "Green"]["Red", "Green"]

    Não sabe como adicionar, nomear e configurar um controle?Don't know how to add, name, and configure a control?

  2. Nomeie o controle Screen padrão como Source, adicione outro controle Screen e chame-o de Target.Name the default Screen control Source, add another Screen control, and name it Target.
  3. Em Source, adicione um controle Shape e defina sua propriedade OnSelect como esta fórmula:On Source, add a Shape control (such as an arrow), and set its OnSelect property to this formula:
    Navigate(Target, ScreenTransition.Fade)Navigate(Target, ScreenTransition.Fade)

    Deseja saber mais sobre a função Navigate ou outras funções?Want more information about the Navigate function or other functions?

  4. Em Target, adicione um controle Shape e defina sua propriedade OnSelect como esta fórmula:In Target, add a Shape control (such as an arrow), and set its OnSelect property to this formula:
    Navegar(Source, ScreenTransition.Fade)Navigate(Source, ScreenTransition.Fade)
  5. Defina a propriedade Fill de Target como esta fórmula:Set the Fill property of Target to this formula:
    If("Red" in ScreenFills.Selected.Value, RGBA(255, 0, 0, 1), RGBA(54, 176, 75, 1))If("Red" in ScreenFills.Selected.Value, RGBA(255, 0, 0, 1), RGBA(54, 176, 75, 1))
  6. Em Source, pressione F5, clique ou toque em uma das opções no controle Radio e então clique ou toque no controle Shape.From Source, press F5, click or tap either option in the Radio control, and then click or tap the Shape control.

    Target aparece na cor que você escolheu.Target appears in the color that you chose.

  7. Em Target, clique ou toque no controle Shape para retornar a Source.On Target, click or tap the Shape control to return to Source.
  8. (opcional) Clique ou toque em outra opção no controle Radio e clique ou toque no controle Shape para confirmar que Target aparece na outra cor.(optional) Click or tap the other option in the Radio control, and then click or tap the Shape control to confirm that Target appears in the other color.
  9. Para retornar ao espaço de trabalho padrão, pressione Esc.To return to the default workspace, press Esc.