The <IDENTIFY-TOOL> element adds a predefined interactive tool to the toolbar above the map that is used to display feature information for the active layer when the user clicks on the map.

Frequency Parent Elements (this element is valid within): PO+ <TOOLSET>

Attributes Description name The name of the tool. All buttons and tools in a toolset must have unique names. Required. url The URL that will be executed when the tool is clicked. 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. Optional, defaults to "$IMF/imfIdentify.jsp". popup An indicator of whether the identify report will be opened in a popup window. Valid values are "true" or "false". If false, the document will be opened in the data frame beside the map. Optional, defaults to "false". hint The pop-up tip that will appear when the user moves the mouse over the tool. Required. status The message that will appear in the browser's status area when the user moves the mouse over the tool. Required. help The URL of the text file containing help text for automatically generated help. If this attribute is present and if the text can be read from the URL, the text in the URL will appear beside the icon in the help document. If this attribute is empty, the text in the status attribute will be used instead. 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 visible Used to set the visibility of a tool to invisible for use in designing user interfaces with active tools set from outside the toolbar. Optional, the default is "true". graphic The URL of the image for the tool. 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. active-graphic The URL of the image shown when the tool is active. In the IMF application, this is usually the same graphic with a red outline. 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. width The width of the tool image, in pixels. Required. height The height of the tool image, in pixels. Required.

Frequency Description (in this context) PO+ The <IDENTIFY-TOOL> element is optional, and may only appear once within the <TOOLSET> element.

Example:

<IDENTIFY-TOOL
 name="Identify"
 popup="false"
 hint="Identify"
 status="Display information about the feature that you click on the map."
 help="$IMF/help/en/identify.txt"
 graphic="$IMF/tools/identify_1.gif"
 active-graphic="$IMF/tools/identify_2.gif"
 width="16"
 height="16" />