Click above to get retro games delivered to your door ever month!

 C_WREAD()

 DESCRIPTION

 The C_WREAD() function reads a previously saved ClipOn window from
 a disk file and restores the window on the screen.  The window
 image is retrieved exactly as it was when it was originally saved,
 and the memory needed for the window is once again allocated.  The
 automatic screen restore can be overridden to only read the window
 from the disk file and not to the screen.  (Refer to Chapter 3 for
 a complete discussion about ClipOn windows.)

 NOTES

 The numeric reference for the ClipOn window is a pointer to the
 window in memory.  Be careful not to change the value of this
 pointer, or the window will be unaccessible.

 SYNTAX

 C_WREAD(file [,restore] [,network])

 PARAMETERS

 file (C) is the full name of the disk file where the window is
 saved.  The drive and directory name can be included, if needed.

 restore (L) indicates whether or not the window should be restored
 to the screen after retrieval from the disk file.  Specify true
 (.T.) if the window should be restored to the screen, or false
 (.F.) to only read the window from the disk file and not restore it
 to the screen.  If restore is not specified, the default is to
 restore the window to the screen.

 network (L) indicates whether or not the program is running on a
 network.  If the program is running on a network pass true (.T.) so
 the file can be opened with the proper share access, otherwise pass
 false (.F.).  If network is not specified, the default of false (.F.)
 is used.

 RETURNS

 C_WREAD() returns a numeric reference variable for the ClipOn window.

 EXAMPLES

 w1 = c_wsave(10,10,20,70)     && Creates a window
 ...
 c_wwrite(w1,"WINDOW.FIL")     && Save window w1 to disk file
 ...
 clear
 ...
 && Read window from disk file and restore it on the screen; get new window
 && variable w2 for later use
 w2 = c_wread("WINDOW.FIL")