PA_LoadRecord

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

version 2003


PA_LoadRecord (tableNum)

ParameterTypeDescription
tableNumshortTable number

Description

The routine PA_LoadRecord loads or reloads the current record for the table number tableNum. If there is no current record PA_LoadRecord does nothing.

PA_LoadRecord works like the 4th Dimension command LOAD RECORD. Please refer to the 4th Dimension documentation to learn more about loading records and its modes (read only, read write, locked)

Example

Loop or loading an unlocked record.

   /*
      waiting the record to be unlocked
      a timeout is used to avoid infinite loop
      a call to PA_Yield MUST BE DONE in such case, to give
      the 4D scheduler time to process other tasks. If this is
      not done, the user will think its computer is frozen.
   */
   void LoadRecordUnlocked(short tNum, long timeOut)
   {
      long   start;
      if(timeOut <= 0)
         timeOut = 60;//default value
   // GetTicks is a routine returns the tick count under Windows and MacOS
      start = GetTicks();
      do
      {
         PA_Yield();
         PA_LoadRecord(tableNum);
      } while ( PA_Locked(tableNum) || ((GetTicks() - start) < timeOut) );
   }

See Also

LOAD RECORD, PA_Locked.

Error Handling

Use PA_GetLastError to see if an error occurred (bad table number).


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