With this component, it is possible for the user to customize the Desktop by dragging an icon (or button) associated with a task to a shortcut area, which will be saved between logons. This allows the user to save his configuration on exiting. To makes this option available, two classes are available to the Desktop: BookmarkArea and Bookmark.
The information about the BookmarkArea is kept in the BookmarkArea configuration file (named BMA.xml by default). The Desktop tag of the Desktop configuration file contains a BookmarkID attribute that specifies the name of the BookmarkArea definition file. For example, if the value of this attribute is set to BookmarkID, then the BookmarkArea configuration will be read from the BMABookmarkID.xml file. This file is found in the location specified in the client configuration file (dse.ini). The BookmarkArea itself is initialized in much the same way that the Desktop is.
The following is an example of the steps required to define a user configuration:
When the Desktop is initialized, the application will read the desktop.xml file and then the BMAXXX.xml file. In both cases, the same mechanism is used to instantiate the components. Note that if the components of the BookmarkArea are changed at runtime (either added or removed), then the BMAXXX.xml file will change when you exit normally (using the Exit button) from the Desktop. You also can define an empty bookmarkArea (without a BMA file) by omitting the bookmarkID attribute, and the BMA.xml file will be automatically created at runtime when adding components to the bookmark area.