ImgControl_SetupWithConfig

Setup a ImgControl form object with a named configuration.
ImgControl_SetupWithConfig(controlName{; configName}) ➔ success
controlName Text The name of the ImgControl form object.
configName Text The configuration name.
success Longint Completion status: 1 on success, 0 otherwise.

Setup the ImgControl form object named controlName with a named configuration.

Typically called during the On Load event of the host form right after a successful call to ImgControl_Initialize. Can also be called while the form is running in order to change the configuration “on the fly”.

The method looks for Q2Pix/Q2ImgControl/Configs/<configName>.json in the host database’s Resources folder. If the file exists the ImgControl configuration is loaded from that file.

If no file exists at that location or <configName> is empty (or omitted), configuration is delegated to ImgControl_Setup.

Note

The format of the JSON configuration object will be finalized and documented in a subsequent beta.