Reference property
A reference to the form group.
Referencing a form group is useful when writing formulas for the
IncludedFields property of open report
buttons, email report
buttons, server relay
buttons and reset buttons. When a
form group is included in the IncludedFields array, it causes
all fields of the form group to be included.
This property is a read-only property, meaning that no formula can be assigned to it.
Referencing form groups from formulas
When referencing a form group from a formula, there is no need to write .Reference,Reference after the form group name if a reference is sought. These formulas are equivalent when associated with the IncludedFields property of email report buttons:
Above, the IncludedFields property is looking for an array of references. FormGroup1 and FormGroup2 can return references through their Reference properties. As such, .Reference,Reference is implied.
Examples
This formula is associated with the IncludedFields property of an open report button and causes all fields of the form group to be included in the report.
This formula is associated with the IncludedFields property of an open report button and causes all fields of the form group to be included in the report. Writing out the Reference property in formulas (by writing FormGroup1.ReferenceFormGroup1,Reference) is rarely necessary.
This formula is associated with the IncludedFields property of a reset button. If the ResetAllFields switch field is toggled to its "on" position, all fields of the form group are reset (courtesy of FormGroup1FormGroup1 being part of the first array). Otherwise, only Field1, Field10 and all fields that appear between them are reset.