GUIBuilder: gb.ini File Parameters (Superseded)
GUIBuilder has been superseded by the AppBuilder module in the BASIS IDE for BBj. Includes support for both the READRECORD Event Queue and PROCESS_EVENTS/CALLBACK paradigm. Integrates tightly with FormBuilder, the BBj replacement for ResBuilder.
The following identifies the parameters of the gb.ini file. The initial values and comments in this table apply to Visual PRO/5; the parameters that differ in BBj are described under BBj-Specific Information.
|
Parameter |
Initial Value |
Comments |
|---|---|---|
|
about_box_win |
-1,-1 |
X,Y location of the "About GUIBuilder" dialog box. |
|
bitmap_dir |
Tells GUIBuilder where to find the .BMP files used in the toolbar. |
|
|
check_syntax |
No |
If set, GUIBuilder will syntax-check each code block before saving it to the .gbf structure. The user can also check syntax at any time with the menu selection Program > Check for Errors. |
|
config_bbx |
..\..\config.min |
Location of the user's config.bbx file (used by Tools > VPRO/5 and by Program > Run). |
|
copyright |
If set, this will be copied to the Copyright= line in .gbf files, which will cause a REM to be put at the beginning of generated programs. |
|
|
current_dir |
The location of the most recently opened .gbf project file. |
|
|
ddbuilder |
..\..\vpro5\ddbuild.exe |
DDBuilder program (should be ddbuild.exe). |
|
editor |
If set, GUIBuilder will call this external editor rather than using the built-in editor. |
|
|
error_list_win |
-1,-1 |
X,Y location of the error list window used to report syntax errors to the user. |
|
event_list_win |
-1,-1 |
X,Y location of the event list window used to prompt the user to pick an event for a selected control. |
|
find_win |
-1,-1 |
X,Y location of the "find text" window. |
|
help_file |
guibuild.hlp |
Name of the Windows Help file used by GUIBuilder. |
|
include_comments |
Yes |
If set, this will be copied to the Remarks= line in .gbf files, which determines if the program will be tokenized with the -r flag (omit comments). |
|
interpreter |
..\..\vpro5\vpro5.exe |
Fully qualified name of the Visual PRO/5 interpreter. |
|
Intro_video_file |
Name of the file, if any, that displays an introductory video tutorial of GUIBuilder. |
|
|
lister |
..\..\vpro5\pro5lst.exe |
Fully qualified name of the Visual PRO/5 stand-alone lister program. |
|
main_win |
-1,-1 |
X,Y[,W,H] location of the GUIBuilder main window. |
|
memory_check_pages |
If set, this will be copied to the Pages= line in .gbf files, which will cause a test for minimum required memory to be put at the beginning of generated programs. |
|
|
new_program_win |
-1,-1 |
X,Y location of the help screen that describes how to create a new program using GUIBuilder. |
|
options_win |
-1,-1 |
X,Y location of the program options window (Program > Options). |
|
other_code_win |
-1,-1 |
X,Y location of the Other Code window. |
|
pick_event_help_win |
-1,-1 |
X,Y location of the "Pick Events" help window. |
|
precision |
If set, this will be copied to the Precision= line in .gbf files, which will generate a PRECISION line at the beginning of generated programs. (Range 1..16) |
|
|
prefix |
If set, this will be copied to the Prefix= line in .gbf files, which will generate a PREFIX line at the beginning of generated programs. |
|
|
program_extension |
bbx |
The extension for generated programs. A null setting (program_extension=) is legal, and will cause tokenized programs to be created with no extension. Source files have a hard-coded extension of .src. |
|
recent_files |
4 |
Number of .gbf files to keep in the Most Recently Used list on the Files menu (range 0..9). |
|
recent_file1.. recent_file9 |
The most recently used .gbf files (updated when each .gbf file is opened and when it is saved). |
|
|
release |
Yes |
If set GUIBuilder will release Visual PRO/5, returning to Windows when you exit. |
|
resbuilder |
..\..\vpro5\resbuild.exe |
Name of the resource editor program (Usually RESBUILD.EXE, but could be RESEDIT.EXE). |
|
select_control_win |
-1,-1 |
X,Y location of the "Select Control" window, for selecting among controls that overlap at the same screen location. |
|
select_popup_win |
-1,-1 |
X,Y location of the "Select Popup" window. |
|
show_all_events |
Yes |
If set, the Event drop-down box will display all events, even if they will not be visible in the event loop of the generated program. |
|
select_form_win |
-1,-1 |
X,Y location of the "Select Form" window. |
|
show_forms |
All |
This will be copied to the 'Show Forms=' line in .gbf files, which determines how to initialize windows in generated programs. Legal values are None (or 0): initially hide all windows; First (or 1): initially hide all windows except for the first one found in the resource file; and All (or 2), the default: initially show all windows. |
|
show_pick_event_help |
Yes |
Determines whether the user will see a dialog explaining that he/she is about to attach code to a given event. |
|
show_welcome_window |
Yes |
Determines whether the user will see the initial welcome window when starting GUIBuilder. The user can click a checkbox on the welcome window to suppress it in the future. |
|
splash_screen_win |
-1,-1 |
X,Y location of the initial copyright screen that comes up when starting GUIBuilder. |
|
subroutine_win |
-1,-1 |
X,Y location of the window for typing in the name of a new subroutine or function. |
|
tokenizer |
..\..\vpro5\pro5cpl.exe |
Fully qualified name of the Visual PRO/5 stand-alone tokenizer program. |
|
use_carriage_returns |
No |
If set, GUIBuilder will create certain output files using CRLF line terminators default is LF only). |
|
welcome_win |
-1,-1 |
X,Y location of the GUIBuilder welcome window. |
BBj-Specific Information
In BBj, the current_dir and select_popup_win parameters are not used, and the following parameters have the initial values and comments shown here. All other parameters are the same as in the table above.
|
Parameter |
Initial Value |
Comments |
|---|---|---|
|
config_bbx |
../cfg/config.min |
Location of the user's config.bbx file (used by Tools > Interpreter and by Program > Run). |
|
ddbuilder |
../ddbuilder/ddbuild.exe |
DDBuilder program (should be ddbuild.exe). |
|
help_file |
guibuild.hs |
Name of the Java Help file used by GUIBuilder. |
|
interpreter |
bbj |
Fully qualified name of the BBj interpreter. |
|
lister |
bbjlst |
Fully qualified name of the BBj stand-alone lister program. |
|
program_extension |
bbj |
The extension for generated programs. A null setting (program_extension=) is legal, and will cause tokenized programs to be created with no extension. Source files have a hard-coded extension of .src. |
|
release |
Yes |
If set GUIBuilder will release BBj, returning to Windows when you exit. |
|
resbuilder |
../resbuilder/resbuild.exe |
Name of the resource editor program (Usually RESBUILD.EXE, but could be RESEDIT.EXE). |
|
tokenizer |
bbjcpl |
Fully qualified name of the BBj stand-alone tokenizer program. |