ControlGroup
Object List Next Object
Definition:
A collection of all the controls and embedded forms contained within its
corresponding form.
Specialized Features:
The following table lists and describes the properties added by ControlGroup. There are no added methods or events.
Properties Use to...
Count Determine the number of controls in a group. (Read only)
EvalRequires Regulate the error behavior of implicit iteration.
Form Identify the form whose controls the group contains (Read only).
Copied Features:
None
this is a top-level object.
Usage:
[object.]ControlGroup(index)[.property] [=value]
[object.]ControlGroup(index)[.method [arglist]]
[object.]ControlGroup[.method [arglist]]
Details:
ControlGroup is a collection that enumerates the controls on a form. Each form
has a Controls property, which is a reference to its ControlGroup. The
collection can be used to iterate through each control, using the index to identify
each member of the collection. The index is valid between 0 and Count-1. For
valid values of the index, ControlGroup(index) returns an object reference to one
of the controls on Form, which can be used anywhere a control reference is
valid. For example, as part of a longer identifier or as an argument to a group
member.
ControlGroup can also be used to implicitly iterate its elements.
ControlGroup.method(arglist) attempts to evaluate methods, either function or sub, on each
element in the collection. The evaluation is controlled by the enumerated
property EvalRequires. EvalRequires can take on three values: MatchNone, MatchOne,
MatchAll. If EvalRequires is set to MatchNone, the evaluation will proceed
without throwing, even if none of the elements of the collection can successfully
evaluate the given method. If EvalRequires is set to MatchAll, the evaluation
will throw an exception if any member is unsuccessful in evaluating the given
method. If EvalRequires is set to MatchOne, the evaluation will throw an exception
unless at least one of the elements successfully evaluates the given method.