<Groups>

The Groups element specifies the group tree, which represents the hierarchical set of group names used to help organize the document elements in the list.

Full element example

    <Groups>
      <Group name="Personal" checked="yes"/>
      <Groups name="Animals" checked="yes" expanded="yes">
        <Group name="Frogs//Toads"/>
        <Group name="Cows" checked="yes"/>
        <Group name="Dogs and cats"/>
      </Groups>
      <Group name="Work"/>
    </Groups>

Sub-element summary

TagTypeDefaultDescription
<Group> string n/a A group with no sub-groups.
<Groups> string n/a A group with sub-groups.

Sub-element descriptions

<Group>

Description
The <Group> element specifies a group, whose name is given using the name attribute. If the name contains a slash, it must be represented with two forward slashes because a single forward slash serves as a path-separator in a group path. The <Group> tag may optionally have a checked attribute that can take one of the values yes and no. This attribute is used within user interfaces to indicate whether or not document elements belonging to the checked group are shown.

Examples
This example specifies a group whose name is Work:
  <Group name="Work"/>
This example specifies a group whose name is Personal and is checked:
  <Group name="Personal" checked="yes"/>
The next example specifies a group whose name is Frogs/Toads. Note the use of two forward slashes to represent the single forward slash in the group name:
  <Group name="Frogs//Toads"/>

<Groups>

Description
The Groups element specifies a group that has sub-groups. Specify the name of the group using the name attribute. If the name contains a slash, it must be represented with two forward slashes because a single forward slash serves as a path-separator in a group path. The <Groups> tag may optionally have a checked attribute that can take one of the values yes and no. This attribute is used within user interfaces to indicate whether or not document elements belonging to the checked group are shown. Additionally, the <Groups> tag may optionally have an expanded attribute that can take one of the values yes and no. This attribute is used within user interfaces to indicate whether or not the sub-groups within the group are shown or not in the user interface component representing the group tree.

Within the <Groups> start tag and the </Groups> end tag, specify one or more Group or Groups elements to represent the sub-groups.

Examples
This example specifies a group named Animals that has three sub-groups named Frogs/Toads, Cows, and Dogs and cats.

  <Groups name="Animals" checked="yes" expanded="yes">
    <Group name="Frogs//Toads"/>
    <Group name="Cows" checked="yes"/>
    <Group name="Dogs and cats"/>
  </Groups>

©1999-2017 DC & Co. All rights reserved.