IMF Developer's Guide

<GROUP>

IMF Developer's Guide » Map Configuration » <GROUP>

The <GROUP> element is used to organize layers into a virtual layer so they can be controlled as one layer. A layer group is shown like any other ordinary layer in the layers list.

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

Attributes	Description
active-identify	A directive to set the layer group as the active identify layer. Valid values are "true" or "false". Defaults to "false".
can-identify	A directive to specify whether the layer group can be identified. Valid values are "true" or "false". Defaults to true if there are identifiable sub-layers, otherwise false. Note that setting can-identify to "true" when there are no identifiable sub-layers has no effect.
can-set-visibility	Sets whether a layer group can be turned on and off by the user. Valid values are "true" or "false". The default is "true". Layers that have can-set-visibility set to "false" show up in the layers list with the visibility checkbox disabled (grayed out). Optional.
can-set-visibility-beyond-scale	Sets whether a layer group can be turned on and off by the user if it is outside of the visible scale range. Valid values are "true" or "false". The default is "false". Optional.
immediate-refresh	Sets whether the map should immediately refresh when the user changes the visibility of the layer group. Valid values are "true" or "false". The default is "false".
layer-list-legend-visible	Sets whether the layer list legend is visible upon startup. Effective only when the group contains LAYER-LIST_LEGEND elements. Valid values are "true" or "false". Optional, defaults to "false".
metadata-url	Sets the URL for a metadata page that describes the layer group. By default, there is no metadata. Optional.
name	The name of the group. Required.

Frequency	Child Elements
O+	<LAYER-LIST-LEGEND>
R+	<LAYER>

Frequency	Description (in this context)
PO+	A <FOLDER> element may contain zero or more <GROUP> elements.
R+	The <LAYER-LIST-LEGEND> element is optional, and may appear one or more times in a <GROUP> before after any <LAYER> elements.
R+	The <LAYER> element must appear one or more times in a <GROUP> after any <LAYER-LIST-LEGEND> elements, if any.

Examples:

<FOLDER name="Some Layers" open="true">
  <LAYER title="BCGS Grid" /> 
  <LAYER title="NTS Grid" /> 
  <GROUP name="Elevation" visible="false" can-identify="false">
    <LAYER title="Spot Elevation - Points (1:2M)" />
    <LAYER title="Contours - Lines (1:250K)" />
    <LAYER title="Elevation - Lines (1:20K)" />
    <LAYER title="Elevation - Points (1:20K)" />
    <LAYER title="Elevation - Text (1:20K)" /> 
  </GROUP>
</FOLDER>