HTBasic/BuilderPlus CONFIG File
The
CONFIG file is initially located in the latest install directory (i.e. C:\Program Files (x86)\HTBasic 2021). When installing an update, SETUP will rename any existing CONFIG file(s) (to CONFIG.001, CONFIG.002, ...) to avoid overwriting a custom one. On startup (or SCRATCH A), HTBasic searches for the CONFIG file in: 1) the current MSI, 2) the $HOME environment CONFIG variable setting, or 3) the installation directory.
The CONFIG file is a text file that can be edited to customize a number of settings. But exercise care when making changes as they can render HTBasic almost unusable and require re-installation.
Custom BuilderPlus Settings
System MSI specifies an alternate location for HTBasic to search for BuilderPlus ancillary files.
System font (width)X(height) format (e.g., 8X16).
SLIDER widget click delays: (by default initial_delay is 500 ms, and repeat_delay is 100 ms)
CONFIG Settings for Widget Context Help
|
Parameter
|
Setting
|
Function
|
|
provide_defaults
|
true
|
Default widget's HELP TOPIC is widget's name
|
|
f1_is_help
|
true
|
F1 key provides help for widget with focus |
|
rht_ms_btn_is_help
|
true
|
Right mouse button provides widget help
|
Widget HELP TOPIC and HELP FILE Attributes
Each widget has HELP TOPIC and HELP FILE attributes. If provide_defaults is set to true (the default setting), the widget's HELP TOPIC attribute defaults to the widget's name and the HELP FILE attribute defaults to the NULL string, which indicates to use HTBasic's help file which shows how to program the widget, whereas a specific Help File might show how to use your programmed widget.
If provide_defaults is not set (or set to "false"), an INFORMATION dialog appears stating help is not available for that widget .
Invoking Widget Context Help
Context help is invoked by right-clicking the widget when rht_ms_btn_is_help is set to true, or pressing F1 when the widget has focus and f1_is_help is set to true. If both are set to false, no context help will be provided regardless of HELP TOPIC and HELP FILE settings.
ScreenBuilder Widget Order
