Settings Panel Technical Reference

Summary

  • The Settings Panel API allows the Settings Panel to be opened programatically
  • This includes opening Custom Settings Panels

Settings Panel Options

The Settings Panel Options section contains many useful configuration properties:

PropertyDescriptionDefault
alwaysShowInDashboardWhether a Settings Panel button should always be displayed in ModuleButtons area of Dashboardfalse
alwaysShowInToolPanelWhether a Settings Panel button should always be displayed in ModuleButtons area of ToolPanelfalse
customSettingsPanelsCustom Settings Panels provided by developers at design-time
iconIcon shown in top left of Settings Panel: Can be ConfigurationIcon, ApplicationIcon or custom IconConfigurationIcon
navigationOrdered items to display at side of Settings Panelall available AdapTable modules
popupTypeWhether Settings Panel is 'window' (i.e. movable, resizable, no backdrop) or 'modal' (centre of screen with backdrop)'window'
positionInitial position of Settings Panel windowMiddle of Screen
showModuleIconsWhether to show Icons for each Module in the Setting Paneltrue
sizeInitial size of Settings PanelComputed based on size of screen
titleTitle for the Settings Panel'Settings Panel'

Settings Panel API

The Settings Panel API section provides a couple of functions to show the Settings Panel:

MethodDescription
closeSettingsPanel()Closes Settings Panel
openCustomSettingsPanel(name)Opens Settings Panel with the Custom Settings Panel, provided by name, displayed
openSettingsPanel(moduleName)Opens Settings Panel and displays specified Module (if provided) or first available one