"loadPanel"

The function allows to preload panels that are positioned around the current panel. This allows to implement a matrix navigation.

Synopsis

loadPanel(int pos, string fileName, string panelName, dyn_string parameter);

Parameter

Parameter Description
pos

Position to load the panel to, relative to the current panel.

  • 0 - Left
  • 1 - Right
  • 2 - Above
  • 3 - Below
fileName Name of the panel file
panelName Name of the panel
parameter (optional) Parameters which are passed to the preloaded panel

Description

The function allows to preload multiple panels located around the current panel before they are even displayed. This allows to implement a smooth matrix navigation.

To load a single panel in the module, RootPanelOnModule should be used.

By using the function "scrollToPanel" the current panel can be switched with one of the preloaded panels. You can also use a two finger swipe gesture. It must be considered that the gesture must be triggered within 200ms after touching the display. Otherwise the common touch gestures are triggered.

Calling the function loadPanel() implicitly activates the panel grid mode which can also be manually activated or deactivated using the panelGridMode() function.

By calling the function panelLoad() multiple times additional panels can be stored within the system memory cache. This allows to load the panels faster.

It is recommended that the panels are using the same dimensions.

ScrollToPanel

main(string type, mapping data)
{
  if ( type == "scrollToPanel" && data["targetPos"] == 0 )  // 0 - moved left
  {
    centerPanelNum -= 1;
    if (centerPanelNum == 0)  // no more panels on the left, loop around
      centerPanelNum = allPanels.count();
  }
  else if ( type == "scrollToPanel" && data["targetPos"] == 1 )  // 1 - moved right
  {
    centerPanelNum += 1;
    if (centerPanelNum > allPanels.count())  // no more panels on the right, loop around
      centerPanelNum = 1;
  }

  this.loadPanel(0, (centerPanelNum > 1 ? allPanels[centerPanelNum - 1] : allPanels[allPanels.count()]), "left", makeDynString());  // 0 - left
  this.loadPanel(1, (centerPanelNum < allPanels.count() ? allPanels[centerPanelNum + 1] : allPanels[1]), "right", makeDynString());  // 1 - right
}

Assignment

Embedded Module