PA_UseAutomaticRelations

4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next

version 2003


PA_UseAutomaticRelations (oneToMany; manyToOne)

ParameterTypeDescription
oneToManychar1 to activate automatic one-to-many relation
manyToOnechar1 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.


4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next