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 Name of the opened module
x X position (-1: Centered in relation to the screen area. -2 is the position at which the module has been opened last. This position will be saved in the user settings (PVSS00ui.ini file) per OS user when the module is closed. The UI notes the position per module name, therefore, the module name may not be empty. If you want to open the module at the last specified position, you have to use the option -2 twice in succession. This means that you must not specify a position first and then use -2 but use -2 the first and the second time).
y Y position (-1: Centered in relation to the screen area). -2 is the position at which the module has been opened last. This position will be saved in the user settings (PVSS00ui.ini file) per OS user when the module is closed. The UI notes the position per module name, therefore, the module name may not be empty. Note that if you want to open the module at the last specified position, you have to use the option -2 twice in succession. This means that you must not specify a position first and then use -2 but use -2 the first and the second time).
w Width
h Height
iconbar

0...Settings from the config file (see config entry nvIconBarOn chapter User interface)

1 Without a icon bar

2 With icon bar

>2 Default (0)

menubar

0...Settings from the config file (see config entry nvMenuBarOn chapter User interface)

1...without a menu bar

2...with menu bar

>2...default (0)

resizeMode

"" ... Settings from the config file (see config entry visionResizeMode chapter User interface)

"None" ... Scaling not possible in the VISION module

"Scale" ... Scaling possible in the VISION module by changing the size of the window

"Zoom" ... Scaling only possible with the Navigator

"FitSmallPanel" ... If the panel in the module is bigger than the module when initializing, scroll bars are shown automatically

otherwise...default ("")

moduleType

0 = Gedi (opens the module GEDI),

1 = Vision (opens the module Vision),

2 = Para (opens the module PARA).

Return value

-

Error

Missing or invalid arguments.

Description

Opens a new module with transferred parameters.

The new module is not opened, when 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 the zoom mode.

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

Assignment

Miscellaneous functions.

Availability

UI

See also

ModuleOnWithPanel()