User guide

DOKuStar Validation Programming Manual Page • 85
Validation now comes up with the last changes you made in the workspace. Play a little around to get a feeling. You
could remove the call to
storeDefault and check that changes of workspace will no longer take effect.
To write it to a file is probably not the best method to save a workspace. Therefore it is also possible to store the
workspace information in the registry. The corresponding commands are
workspaceSink.LoadWorkspaceFromRegistry and
workspaceSink.SaveWorkspaceToRegistry.
The registry path that is used is
HKEY_CURRENT_USER\Software\<base path>\Workspaces\<sub-key> .
The base path is controlled by
RegistryKey. If RegistryKey is an empty string, which is its default value,
Validation uses the standard base path
DOKuStar Validation\<version> as base path. If it is a single
key, Validation appends the standard base path to the specified key. If it contains a hierarchy, Validation uses the
value as it is.
RegistryKey must be specified in the function IAddIn_Initalize, otherwise it will take no effect.
The sub-key has to be specified in the load and save functions.
In our example we use the single key
ValiTour for RegistryKey. Therefore Validation will append its
standard base path. We will have to take that into account when we check the registry key for our workspace later.
To be able to set
RegistryKey we will have to provide the workspace service also in the function
IAddIn_Initalize and to delete the corresponding statement in dsValApp_OnFinalInitialized. In the load
and save functions we will use the sub-key
Default. Therefore Validation will use the following registry path (for
version 3.2):
HKEY_CURRENT_USER\Software\ValiTour\DOKuStar Validation\3.2\Workspaces\Default