GroupName

Use this function to get the name from a group of forms.

Syntax

GroupName (Count, StartGroup)

Parameter

Description

Count

An index reference to locate a group before or after the specified group. Enter a negative number to move backwards. The default is zero (0).

StartGroup

Enter the name of a group from which to start the search. The default is the current group.

The system returns the name of the group it located.

Keep in mind you can use an asterisk (*) as the object name to match parent objects. This lets you find objects without explicitly knowing the parent names.

Note For optimal performance, avoid using wildcards (*) when searching for field, section, or form names.

The system returns the name of a group of forms relative to another group. If you omit the parameters, the system returns the name of the current group.

The count parameter tells the system to move forward or backwards from a located group before returning the group name.

If it cannot find the starting group cannot or the count parameter causes it to move beyond the number of groups contained in the document set, the system returns an empty string.

Groups are unique within a document set.

Example

Here are some examples:

(Assume the current group is GROUPONE.)

Function

Result

Explanation

GroupName( )

GROUPONE

No parameters will result in returning the current group name.

GroupName( -1)

 

Returns the name of the group before the current group.

See also