Documentation / Widgets / Screen

Screen

The root object. It has no position; it is the panel. A screen is styled like any widget (a background colour is the usual thing) and takes the four screen-only events: Screen loaded, Screen unloaded, Screen load start and Screen unload start.

Group: Screen · Default size: the panel · Style parts: Main

The head of the Inspector with the screen selected: its Name, Screen1, its C identifier, and the Temporary and Don't export tick boxes.
With nothing selected the Inspector is the screen's: its name and its two tick boxes.
SettingDefaultWhat it does
TemporaryoffFree the screen from RAM when it is unloaded and rebuild it on the next load. Worth it on a small MCU with many screens.
Don't exportoffSkip the ui_<Name>_screen_init() so you can write that screen by hand.

Example: swipe left for the next screen

  1. In the Screens list press + (Add screen). The new screen is Screen2; click Screen1 to go back to the first.
  2. Click an empty part of the screen, so that nothing is selected and the Inspector shows the screen. Open Style settings, then Background, and set Color to #1E2A38.
  3. Drag a Label onto it. Set its Text to Swipe left and, under Style settings > Text, its Color to #FFFFFF.
  4. Select the screen again, open Events and press Add event. Set the trigger to Swipe left, Action to Change Screen, Screen to load to Screen2 and Fade mode to Move left.
  5. Press Preview and use the left arrow of the swipe pad under the screen: Screen2 slides in. On the board it is a finger drawn across the glass.
A dark blue screen with the words Swipe left in white in the middle.
The screen with a colour of its own.
The Events section of the screen: Swipe left, Change Screen, Screen to load Screen2, Fade mode Move left, Speed 500 ms.
A swipe on the screen loads the next one.