version 2003
PA_UseAutomaticRelations (oneToMany; manyToOne)
Parameter | Type | Description | |
oneToMany | char | 1 to activate automatic one-to-many relation | |
manyToOne | char | 1 to activate automatic many-to-one relation |
Description
The routine PA_UseAutomaticRelations prepares the API to use (or not use) automatic relations in calls that load a record (such as PA_NextRecord, PA_GotoSelectedRecord)
Note that this call is local to your plug-in, it does not affect 4D commands as AUTOMATIC RELATIONS does.
Default is both automatic relations on.
Examples
(1) Activate automatic relation when loading the next record of a selection.
PA_UseAutomaticRelations(1, 1); PA_NextRecord( aTableNumber);
(2) Deactivate automatic relations while walking through a selection.
PA_UseAutomaticRelations(0, 0); for (i = 1; i <= PA_GetSelectedRecords(aTableNum); i++) { PA_GotoSelectedRecord(aTableNum); . . . }
See Also
AUTOMATIC RELATIONS.
Error Handling
PA_GetLastError keeps the last error that occurred before calling PA_UseAutomaticRelations.