Difference between revisions of "RESTORE RECORDVIEW"

From Recital Documentation Wiki
Jump to: navigation, search
Line 1: Line 1:
 
==Class==
 
==Class==
Fields and Records
+
Screen Forms
  
  
Line 12: Line 12:
  
 
==See Also==
 
==See Also==
[[DO]], [[ON KEY]], [[REPLACE()]], [[SAVE RECORDVIEW]], [[SET KEY]], [[SET KEY TO]], [[SET PCKEYS]], [[SKIP]]
+
[[@...GET]], [[DO]], [[CHANGE]], [[EDIT]], [[ON KEY]], [[READ]], [[REPLACE()]], [[SAVE RECORDVIEW]], [[SET KEY]], [[SET KEY TO]], [[SET PCKEYS]], [[SKIP]]
  
  
Line 40: Line 40:
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Commands]]
 
[[Category:Commands]]
 +
[[Category:Screen Forms]]
 +
[[Category:Screen Forms Commands]]

Revision as of 11:56, 4 June 2009

Class

Screen Forms


Purpose

Restore a previously saved workarea status


Syntax

RESTORE RECORDVIEW FROM <memvar>


See Also

@...GET, DO, CHANGE, EDIT, ON KEY, READ, REPLACE(), SAVE RECORDVIEW, SET KEY, SET KEY TO, SET PCKEYS, SKIP


Description

The RESTORE RECORDVIEW command restores a workarea status that was previously saved to the specified <memvar> with the SAVE RECORDVIEW command. RESTORE RECORDVIEW restores the following information:

  • Workarea number
  • Current record number
  • Current index order
  • Lock status

The SAVE and RESTORE RECORDVIEW commands are useful in validation and hot key procedures when you want to move off the current record, execute a validation procedure, and then return to the same record. The SKIP 0 command must be used prior to a GOTO command in order to flush locked records to the disk if they have been modified. SET CLIPPER must be ON for SKIP 0 to work correctly.


Example

procedure check_value
  save recordview to m_recv
  // Validate data
  restore recordview from m_recv
return


Products

Recital Database Server, Recital Mirage Server, Recital Terminal Developer