
Click above to get retro games delivered to your door ever month!
X-Hacker.org- ClipOn 3.0 Reference - c_wread()
[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
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")
See Also: C_WWRITE() C_WINDOW() C_XWINDOW() C_WSAVE() C_WRESTORE()
Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson