|
![]() |
![]() |
version 2003
PA_GoToSelectedRecord (tableNum; selRecNum)
Parameter | Type | Description | |
tableNum | short | → | Table number |
selRecNum | long | → | Number of selected record to access |
Description
The command
PA_GoToSelectedRecord
moves to the record number
selRecNum
in the current selection of table number
tableNum
, and makes that record the current record. The current selection does not change.
Note that the
selRecNum
parameter is not the same as the number returned by
PA_GetRecordNumber
; it represents the record's position in the current selection. The record's position depends on how the selection is made and whether or not the selection is sorted.
If there are no records in the current selection, or the number is not in the selection, then
PA_GoToSelectedRecord
does nothing.
Before calling
PA_GoToSelectedRecord
the 4D plug-in should indicate if the many-to-one and one-to-many relations should be activated by using
PA_UseAutomaticRelation
.
WARNING
This routine does not use virtual structure
Example
See
PA_RecordsInSelection
for an example of use.
See Also
PA_RecordsInSelection , PA_SelectedRecordNumber .
Error Handling
Use
PA_GetLastError
to see if an error occurred (invalid table number).
Current Selections and Records
The current selection does not change. If
selRecNum
is a valid number (from 1 to the number of records in the current selection), the current record becomes record number
selRecNum
of the selection.