A UI element that contains one or more other controls in an app.

Description

Most apps have multiple Screen controls that contain Label controls, Button controls, and other controls that show data and support navigation.

Key properties

BackgroundImage – The name of an image file that appears in the background of a screen.

Fill – The background color of a control.

Additional properties

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 – How an app responds when the user navigates away from a screen.

OnVisible – How an app responds when the user navigates to a screen.

Related functions

Distinct( DataSource, ColumnName )

Example

  1. Add a Radio control, name it ScreenFills, and set its Items property to this value:
    ["Red", "Green"]

    Don't know how to add, name, and configure a control?

  2. Name the default Screen control Source, add another Screen control, and name it Target.

  3. On Source, add a Shape control (such as an arrow), and set its OnSelect property to this formula:
    Navigate(Target, ScreenTransition.Fade)

    Want more information about the Navigate function or other functions?

  4. In Target, add a Shape control (such as an arrow), and set its OnSelect property to this formula:
    Navigate(Source, ScreenTransition.Fade)

  5. 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))

  6. From Source, press F5, click or tap either option in the Radio control, and then click or tap the Shape control.

    Target appears in the color that you chose.

  7. On Target, click or tap the Shape control to return to Source.

  8. (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. To return to the default workspace, press Esc.