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.