[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
##############################################################################
###+--------------+###########################################################
#+-| RESTORE_AREA |---------------------------------+#########################
#| +--------------+ Restores the last screen saved |#########################
#| by save_screen or save_area |#########################
#+--------------------------------------------------+#########################
##############################################################################
##############################################################################
#+--| Summary |------------+##################################################
#| #INCLUDE io.hdr |##################################################
#+-------------------------+##################################################
##############################################################################
##############################################################################
#+--| Syntax |------------------------------+#################################
#| PROCEDURE restore_area PROTOTYPE |#################################
#+------------------------------------------+#################################
##############################################################################
##############################################################################
########+---| Description |-----------------------------------------+#########
########| The restore_area procedure restores the last screen saved |#########
########| by either the save_screen or save_area procedure. |#########
########+-----------------------------------------------------------+#########
##############################################################################
##############################################################################
##########+---| Design |-------------------------------------------+##########
##########| The save_area and restore_area procedures behave as a |##########
##########| stack. That is, the first item saved is the last item |##########
##########| restored. Use savescrn() and restorescrn functions if |##########
##########| you require random saving/restoring of screens. |##########
##########+--------------------------------------------------------+##########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| * Save portion of the screen for a memo field. |#########
#########| |#########
#########| save_area ( 50,0,20,79 ) |#########
#########| DO edit_the_memo |#########
#########| DO restore_area |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########| * As long as screens can be restored in the order |#########
#########| * they are saved, the restore_area eliminates the |#########
#########| * need to manage screen variables. |#########
#########| |#########
#########| save_screen() && #1 entire screen saved |#########
#########| save_area(0,0,4,70) && #2 |#########
#########| save_area(10,20,24,40) && #3 |#########
#########| restore_area() && restores screen 3 |#########
#########| restore_area() && restores screen 2 |#########
#########| restore_area() && restores entire screen |#########
#########+----------------------------------------------------------+#########
##############################################################################
See Also:
save_area
save_screen
savescrn()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson