The <TOOLSET> element is used to define a set of tools and buttons for the toolbar over the map.

You may define multiple toolsets with different names. Each toolset can contain a different set of tools and a separate help document to describe the tools. To open a toolset other than default when the site is started, follow the following example:

<TOOL-FRAME url="$IMF/imfTools.jsp?toolset=mytools" />

To use the default toolset, the toolset argument above can be omitted, or called with the toolset named "default". To switch toolsets from a tool in the toolset, define a button as follows:

<BUTTON name="Standard Tools"
        url="$IMF/imfTools.jsp?toolset=default"
        target="toolFrame"
        hint="Standard Tools"
        status="Shows the standard tool set."
        graphic="$IMF/tools/tools_close.gif"
        width="16" height="16" />

Frequency Parent Elements (this element is valid within): PRS+ <SITE-CONFIG>

Attributes Description active The name of the tool that is active when the site opens. Required. toolset The name of the toolset, made up by the designer. Required. help The URL of the help document that describes this toolset. The URL can contain the special variable $IMF to specify that the document is relative to the IMF installation directory. Absolute URLs may also be used. URLs that don't start with http: or $IMF are resolved relative to the location of the XML file. Required.

Frequency Child Elements: O+ <BUTTON> O+ <SPACE> O+ <TOOL> O1 <IDENTIFY-TOOL> O1 <PAN-TOOL> O1 <ZOOM-IN-TOOL> O1 <ZOOM-OUT-TOOL>

Frequency Description (in this context) PRS+ The <TOOLSET> element is required one or more times within the <SITE-CONFIG> element in the site configuration file in the sequence specified. O+ This optional element may appear multiple times within the <TOOLSET> element. O1 This optional element may appear only once within the <TOOLSET> element.

Example:

<TOOLSET name="default" active="Zoom In" help="$IMF/imfHelp.jsp" />