SET AUTOMATIC RELATIONS
SET AUTOMATIC RELATIONS ( one {; many} )
Parameter | Type | Description | |
---|---|---|---|
one | Boolean | → | Status of all Many-to-One relations |
many | Boolean | → | Status of all One-to-Many relations |
Description
SET AUTOMATIC RELATIONS temporarily changes all the manual relations into automatic relations for the entire database in the current process. The relations stay automatic unless a subsequent call to SET AUTOMATIC RELATIONS is made.
- If one is true, then all manual Many-to-One relations will become automatic. If one is false, all previously changed Many-to-One relations will revert to manual relations.
- The same is true for the many parameter, except that manual One-to-Many relations are affected.
This command changes relations set as manual in the Design environment to automatic, just before executing operations that require them to be automatic (such as relational queries and sorts). After the operation is finished, relations can be changed back to manual by calling SET AUTOMATIC RELATIONS again. Any relations set as automatic in the Design environment are not affected by this command.
Notes:
- When you pass True to the SET AUTOMATIC RELATIONS command, the automatic mode is "locked" for all the manual relations during the session. In this case, any calls to the SET FIELD RELATION command during the same session are ignored, regardless of whether they are placed before or after SET AUTOMATIC RELATIONS. To "unlock" the automatic mode and take the calls to SET FIELD RELATION into account, pass False to SET AUTOMATIC RELATIONS.
- Automatic features are disabled when related tables are being viewed in a list form displayed using DISPLAY SELECTION, MODIFY SELECTION, or a subform. See Automatic and manual relations.
Example
The following example makes all manual Many-to-One relations automatic and reverts any previously changed One-to-Many relations:
SET AUTOMATIC RELATIONS(True;False)
See also
About Relations
GET AUTOMATIC RELATIONS
GET RELATION PROPERTIES
SELECTION RANGE TO ARRAY
SELECTION TO ARRAY
SET FIELD RELATION