IMF Developer's Guide

IMF Developer's Guide » Layer Configuration » <folder>

The <folder> element is used to organize layers into folders for display in the layers list in the IMF application. The <folder> element is used to create and name a new folder. Within a <folder> element, there can be many layers, groups, or other folders (up to 3 deep) to specify the contents of the folder.

Frequency	Parent Elements (the <folder> element is valid within):
PO+	<folder>
PO+	<layer-config>

Frequency	Child Elements (the <folder> element may contain):
O+	<dynamic-feature-layer>
O+	<dynamic-image-layer>
O+	<folder>
O+	<group>
O+	<layer>
O+	<wms-layer>

Frequency	Description (in this context)
PO+	The <folder> element may appear one or more times within the parent element in any order.
O+	The child element may appear one or more times within the <folder> element in any order.

Attributes	Description
apply-visibility-to-subfolders	Specifies whether setting the visibility of a folder also applies to sub-folders. Valid values are "true" or "false". Defaults to "true".
can-set-visibility-on	Specifies whether the ON option appears beside a folder for the user to control the visibility of the folder's contents. Valid values are "true" or "false". Defaults to "false".
can-set-visibility-off	Specifies whether the OFF option appears beside a folder for the user to control the visibility of the folder's contents. Valid values are "true" or "false". Defaults to "true".
name	The name of the folder. Required.
open	Specifies whether the folder is open the first time that the user sees it. Valid values are "true" or "false". Defaults to "false".
radio	Specifies whether the visibility controls of the layers in the folder work like radio buttons, where only one of them can be visible at a time. Valid values are "true" or "false". Defaults to "false".

Example:

<folder name="Grid layers"
        open="true"
        radio="false"
        apply-visibility-to-subfolders="false"
        can-set-visibility-on="false"
        can-set-visibility-off="true">
  <layer name="1:20K Map Grid"/>  
  <layer name="1:50K Map Grid"/>
  <layer name="1:250K Map Grid"/>
</folder>