Edit.INI Checkbox
The Edit.INI Checkbox tool is used to draw a checkbox that can linked to a Config.INI variable. The purpose is to allow an operator to enable or disable the action of the variable. Only those variables whose value can be a 1 (enabled) or 0 (disabled) should be linked to this checkbox.
Note: Information on Config.ini variables is provided in the VTS Programmer's Guide: Introduction to Config.ini.
The result of the above configuration is a checkbox labeled, "Scale Objects On Page" that can be checked to set the ScaleDisplayContent Config.ini [SYSTEM] section variable to 1 (i.e. stretch graphics to fit the screen), or can be unchecked to set ScaleDisplayContent to 0 (i.e. do not stretch graphics to fit the screen).
Because the Update RAM Copy checkbox has been selected, operators can use the checkbox object to stretch and un-stretch the graphics while the application is running.
Note: Some Config.ini variables (like DispMgrFullScreen) require that your application be restarted before their value can be read. Others allow you to modify your application's behavior without requiring a restart if you select the Update RAM Copy checkbox.
For each Config.ini variable whose value you wish to modify, you must create a new Edit .INI Checkbox object. If you wish to set a Config.ini variable that accepts values other than 0 or 1 (e.g. a text or color-associated variable), use the Edit.INI Var Field tool in the Standard Tools library (see: Edit.INI Var Field).
Note: You may not wish operators to have access to the configuration file settings for your applications. It is therefore recommended that you configure an application page, place all your Edit .INI Checkbox objects on it, and then protect it from operator access using an application privilege (see: Protect a Page with an Application Privilege.
(Click title to expand text)
The Section field enables you to enter the name of the Config.ini section under which the variable you wish this checkbox to modify appears. For example, if the variable appears under the [LABELS] section heading in Config.ini, enter "Labels" in the Section field. If the variable appears under the [SYSTEM] section in Config.ini, enter "System" in the Section field.
The Variable field enables you to enter the name of the Config.ini variable that this checkbox will enable users to edit.
The Label field enables you to enter the text label that you wish to be displayed for the completed checkbox.
The Box on Left checkbox enables you to set the position of the checkbox in relation to its label.
If the Box on Left checkbox is selected the checkbox will appear to the left of the accompanying label.
If the Box on Left checkbox is not selected, the checkbox will appear to the right of the accompanying label.
The Update RAM Copy checkbox enables you to indicate whether or not you wish the value entered for the Config.ini variable associated with this edit field to be instantly updated in your PC's RAM.
If the Update RAM Copy checkbox is selected, the associated Config.ini variable's value will be automatically updated whenever a value is entered into this edit field.
If this checkbox is not selected, you must stop and restart the application each time you have entered a new value into this edit field before the new value will take effect.
The Alignment drop-down list enables you to configure the alignment of the completed checkbox object and its accompanying label within its drawing area.
The Focus ID spin box enables you to select a number representing the order of the completed object in the overall tab order.