PA_UseAutomaticRelations


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 .