Skip to content

system.openPage

since 26.1.0

Open a page.

system.openPage(page)

Parameters

Name Type Required Description
page table yes with elements:

Fields of page:

  • system (integer or nil): system page index or nil for the menu page
  • model (integer or nil): model page index or nil for the menu page
  • home (integer, optional): home page index
  • logicSwitch (integer, optional): logic switch page index
  • timer (integer, optional): timer page index
  • sensor (integer, optional): sensor page index

Returns

Nothing.

Examples

From the official Ethos documentation
system.openPage({system=nil}) -- System menu page
system.openPage({system=0}) -- System / File manager
system.openPage({model=nil}) -- Model menu page
system.openPage({model=0}) -- Model / Model select
system.openPage({home=0}) -- Home page 1
system.openPage({timer=0}) -- Timer 1 configuration
system.openPage({logicSwitch=0}) -- Logic switch 1 configuration
system.openPage({sensor=0}) -- Sensor 1 configuration

Real-world usage

Called 2 times across 2 open-source Ethos Lua projects. A few short excerpts:
local function launchSystemTool(widget)
  if not canOpenSystemTool() then return end
  setToolbarVisible(widget, false)
  requestPaint(widget)
  invalidateWidget(widget)
  system.openPage({system = systemToolHandle})
end

src/rfsuite/widgets/dashboard.lua:1284