ModuleOn()

Opens a new module.

Synopsis

void ModuleOn(stringmoduleName, unsignedx, unsigned y,unsigned w,unsigned h,unsignediconbar,unsignedmenubar,stringresizeMode, int ModuleType);

Parameters

Parameter Description
moduleName The name of the module to be opened.
x X position:
  • -1: Centered on the screen.
  • -2: Opens the module at the last position it was opened. This position is saved in the user settings (PVSS00ui.ini file) for each OS user when the module is closed. The position is saved based on the module name, so the module name cannot be empty. To open the module at the last position, use -2 twice in a row. Do not specify a position first and then use -2; instead, use -2 both times.
y Y position:
  • -1: Centered on the screen.
  • -2: Opens the module at the last position it was opened. This position is saved in the user settings (PVSS00ui.ini file) for each OS user when the module is closed. The position is saved based on the module name, so the module name cannot be empty. To open the module at the last position, use -2 twice in a row. Do not specify a position first and then use -2; instead, use -2 both times.
w The width of the module.
h The height of the module.
iconbar
  • 0: Use settings from the config file (see the config entry [ui] nvIconBarOn).
  • 1: No icon bar.
  • 2: With an icon bar.
  • >2: Default (0).
menubar
  • 0: Use settings from the config file (see the config entry [ui] nvMenuBarOn).
  • 1: No menu bar.
  • 2: With a menu bar.
  • >2: Default (0).
resizeMode
  • "" : Use settings from the config file (see config entry [ui] visionResizeMode).
  • "None": Scaling is not allowed in the VISION module.
  • "Scale": Scaling is allowed in the VISION module by resizing the window.
  • "Zoom": Scaling is only possible with the Navigator.
  • "FitSmallPanel": If the panel in the module is larger than the module at startup, scroll bars are automatically displayed.

Otherwise: Default ("").
moduleType
  • 0: Opens the GEDI module.
  • 1: Opens the VISION module.
  • 2: Opens the PARA module.

Return value

-

Error

Occurs when arguments are missing or invalid.

Details

This function opens a new module using the provided parameters.

The module will not open if another module with the same name is already open.

Example

main()
{
  ModuleOn("M1",0,0,70,70,2,2,"None",2);
}

The following example opens a VISION module in zoom mode:

main()
{
  ModuleOn("M1",0,0,70,70,2,2,"Zoom",1);
}

Assignment

Miscellaneous functions.

Availability

UI