HaveGroup

Use this function to determine if a given group is part of a document.

Syntax

HaveGroup (Group)

Parameter

Description

Group

Enter the name of a group to locate. The default is the current group.

The system returns one (1) if the group is located and zero (0) if it cannot be found.

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.

Several DAL functions can return values that indicate a group is or is not a part of the document. However, those functions also intend to perform some other procedure other than searching for the group. The HaveGroup function simply identifies whether a given group is present in the document.

The function does not require any parameters. However, calling it in this manner will typically return 1, since it will locate the current group.

Example

Here is an example:

Function

Result

Explanation

HaveGroup ( "GRP")

1 or 0

Returns one (1) if the identified group is a part of the document.

See also