DXLab Launcher Online Help Contents
In conformance with Windows programming standards, DXLab applications store their settings in the Windows Registry - with one exception: DXKeeper stores some settings in the current Log file. Windows Registry settings persist between operating sessions, and also survive the installation of both full releases and development releases.
There are several reasons to save a DXLab's Windows Registry settings to a file, and to later load the Windows Registry with settings from that file:
for archival storage, to be restored after a hardware or operating system failure
to copy settings from one PC to another
to establish multiple "operating configurations" and rapidly switch between them
The Launcher enables you to save the Windows Registry settings of all specified DXLab applications into a Workspace - a folder in a specified location. Each application's settings are stored within the workspace folder in an appropriately named file. Clicking the Configuration window's Workspaces button or depressing the CTRL key while clicking the Main window's Config button displays the Launcher's Workspaces window; if WS: WorkspaceName is displayed on the Main window, clicking it will also display the Workspace window.
The Workspaces (in Current Workspace Folder) panel displays a list of the Workspaces that are present in the folder whose pathname is specified in the Current Workspace Folder box; by default, this is set to the Launcher's Workspaces folder. You can choose a different folder by clicking the Select Folder button to the right of the Workspaces window's Current Workspace Folder box. Letting the mouse cursor hover over a Workspace in the Workspaces (in Current Workspace Folder) panel will display a popup window showing the name of each DXLab application for which settings are stored in that Workspace.
To select a Workspace, click its entry in the Workspaces (in Current Workspace Folder) panel.
The Launcher's Workspaces window provides four primary functions: Create Empty Workspace, Save Settings to Workspace, Load Settings from Workspace, and Delete Workspace; the latter three functions are disabled if no Workspace is selected in the Workspaces (in Current Workspace Folder) panel:
Create Empty Workspace | prompts you
to specify a Workspace name, and then creates the Workspace
|
Save Settings to Workspace | saves
the Windows Registry settings of all specified DXLab applications into files in the selected Workspace, over-writing any existing files
of the same name in that
Workspace
|
Load Settings from Workspace |
loads the
Windows Registry with settings from each file contained in the selected
Workspace
The name of the Workspace from which Windows Registry settings were
most recently loaded is shown between
square brackets in the Configuration window's title bar; if no
application or database updates
are available, the name of the Workspace from which Windows
Registry settings were most recently loaded
is also displayed on the Launcher's Main window as WS:
WorkspaceName . |
Delete Workspace | deletes the selected Workspace |
To facilitate recovery should your PC subsequently suffer hardware or software problems,
specify pathnames for all of your DXLab applications on the Configuration window's DXLab Applications panel
terminate all running DXLab applications except the Launcher
in the Launcher's Workspaces window, click the Create Empty Workspace button and specify the name of the Workspace to be created
in the Workspaces window's Workspaces panel, click the name of the newly-created Workspace to select it
in the Workspaces window, click the All DXLab Applications panel's Save Settings to Workspace button
configure your Backup and Recovery
application to include the Launcher's Workspaces
folder (and its sub-folders)
After repairing the root cause of a hardware or software failure that caused the loss of settings stored in the Windows Registry,
direct your Backup and Recovery application to restore the Launcher's Workspaces folder (and its sub-folders) and any other folders containing DXLab data (e.g. your log file)
install the Launcher and the other DXLab applications you use
start the Launcher; do not start any other DXLab applications
in the Workspaces window's Workspaces panel, select the Workspace whose settings are to be loaded into the Windows Registry by clicking its name
in the Workspaces window, click the
All DXLab Applications panel's Load Settings from Workspace
button
If you've intentionally changed one DXLab application's settings, you can back up that application's settings to a Workspace, replacing any previously backed-up settings in that Workspace for that application:
terminate the DXLab application whose settings you wish to back up
in the Workspaces window
in the Workspaces panel, click on the name of the Workspace that will receive the backed up settings
in the Selected DXLab Application panel,
set the Application Settings to Save selector to the name of the DXLab application whose settings will be backed up
click the Save Settings to
Workspace button
After inadvertently modifying the settings of one DXLab application, you can restore that application's settings to the Windows Registry from a Workspace:
terminate the DXLab application whose settings you wish to recover
in the Workspaces window
in the Workspaces panel, click on the name of the Workspace from which settings will be recovered
in the Selected DXLab Application panel,
set the Application Settings to Load selector to the name of the DXLab application whose settings will be recovered
click the
Load Settings from
Workspace button
If you start the Launcher via a batch file or a desktop icon,
appending the name of a Workspace to the command line will cause the Launcher to
load Windows Registry settings from that Workspace in the
Current Registry Folder on startup. If the name of the workspace includes
spaces, enclose the Workspace name with double-quote characters, e.g.
"contest settings".
To establish multiple operating configurations,
setup your DXLab applications for the first configuration
terminate all DXLab applications except the Launcher; the Launcher's Terminate button is a convenient way to do this
in the Launcher's Workspaces window, click the Create Empty Workspace button and specify the name of the Workspace to be created; choose a name associated with the configuration whose settings it will save
in the Workspaces window's Workspaces panel, click the name of the newly-created Workspace to select it
in the Workspaces window, click the All DXLab Applications panel's Save Settings to Workspace button
if more configurations remain, setup your DXLab applications for the next configuration, and proceed to step 2
To switch from one operating configuration to another
terminate all running DXLab applications except the Launcher; the Launcher's Terminate button is a convenient way to do this
in the Workspaces window's Workspaces panel, select the Workspace for those configuration whose settings are to be loaded into the Windows Registry by clicking its name
in the Workspaces window, click the
All DXLab Applications panel's Load Settings from Workspace
button
The Registry panel on the DXLab Apps tab of the Launcher's Configuration window provides buttons that enable you to save a DXLab application's registry settings to a file of your choice, or load an application's registry settings from a file of your choice; the Windows standard .reg extension is used in both cases. Clicking an application's Sv button saves that application's registry settings to a file; clicking an application's Ld button loads that application's settings from a file. When invoking an application's registry save or registry load functions, the application should not be running. The Launcher will immediately update the applications settings from the registry after completing the Ld operation.
Important note: If you save a DXLab application's registry settings to a file and later wish to visually examine the contents of that file, do not invoke the Windows Explorer and double-click on the file. Rather than display the file's contents in Notepad, as happens when you double-click on a .txt file, double-clicking on a .reg file updates the Windows registry with the contents of the file -- just as if you'd clicked the Launcher's Ld button. To view the contents of a .reg file, start Notepad (or the editor of your choice) manually, and then File:Open the .reg file.
The Registry panel also enables you to delete all of a DXLab application's Windows Registry settings; to do so, depress the CTRL key while clicking the associated Ld button. Before invoking this function, saving the application's registry settings to a file by clicking the Sv button is recommended.