Selection Page Element

The selection page element is used to create a page on the hardware’s display that includes one icon and two selection options: “off” or “on.” This element is only available within Rapid IoT projects.

The selection page element is located in the Element Toolbox within Studio’s Embedded tab.

The selection page element is part of a series of embedded elements working in tandem to create Rapid IoT display pages and their navigation and interaction. Unlike other elements, properties of these elements (such as their x- and y-coordinate placements) affect other such elements. To learn more about using NXP display-based embedded elements and how they work together, visit the NXP Display Elements Guide.

Properties

The following properties can be changed for the selection page element:

Name

The name of the element.

Page Visible

The state of the page on the display: hidden or visible.

Page Title Visible

The state of the title on the page: hidden or visible.

Page Title

The title of the page.

Text Color

The color of the text on the page. The text color options include black, red, green, and blue.

Top-left Button Enabled

The state of the top-left button on the page: disabled or enabled.

Top-left Button Label

The text for the button located in the top-left of the page.

Top-right Button Enabled

The state of the top-right button on the page: disabled or enabled.

Top-right Button Label

The text for the button located in the top-right of the page.

Bottom-left Button Enabled

The state of the bottom-left button on the page: disabled or enabled.

Bottom-left Button Label

The text for the button located in the bottom-left of the page.

Bottom-right Button Enabled

The state of the bottom-right button on the page: disabled or enabled.

Bottom-right Button Label

The text for the button located in the bottom-right of the page.

X Coordinate

The placement of the page on the x-axis of the display page coordinate grid.

Y Coordinate

The placement of the page on the y-axis of the display page coordinate grid.

Span X Columns

The number of grid columns the page spans for navigation. Any pages in grid rows above or below the page within the length of the span can directly navigate to this page.

Span Y Rows

The number of grid rows the page spans for navigation. Any pages in grid columns to the left or right of the page within the length of the span can directly navigate to this page.

Icon

The icon displayed on the page. A list of icons is available to choose from.

Initial Selection

The default state of the page’s selection: off (left) or on (right).

Persist On Reboot

The state of the page’s current selection remaining when the device is rebooted.

Different Startup Behavior

If persisting across reboots, set this to true if you want the triggers to behave differently on startup. Use the (startup) variations of the selected triggers to control this.

Triggers

The following triggers are available to execute events from within the selection page element:

Triggered

Execute an event when the source element connected to the selection page triggers.

Displayed

Execute an event when the page is displayed on the hardware.

Top-left Button Pressed

Execute an event when the hardware’s top-left button is pressed.

Top-right Button Pressed

Execute an event when the hardware’s top-right button is pressed.

Bottom-left Button Pressed

Execute an event when the hardware’s bottom-left button is pressed.

Bottom-right Button Pressed

Execute an event when the hardware’s bottom-right button is pressed.

On Selected

Execute an event when the page’s on option is selected.

Off Selected

Execute an event when the page’s off option is selected.

On Selected (Startup)

Execute an event when the page’s on option is selected during startup.

Off Selected (Startup)

Execute an event when the page’s off option is selected during startup.

Abilities

The following abilities are available for the selection page element when its source element triggers:

Trigger

Trigger the element(s) that follow the selection page element.

Display Page

Display the page on the hardware.

Select On

Set the page’s selection to on.

Select Off

Set the page’s selection to off.