boolean PushScreen(BSTR pszScreenName)
boolean PullScreen(BSTR pszScreenName)
boolean RestoreScreen(BSTR pszScreenName)
Function PushScreen(pszScreenName As String) As Boolean
Stores the present display image in a file in the RF Client.
Function PullScreen(pszScreenName As String) As Boolean
Retrieves onto the display an image previously stored in a file in the RF Client, and deletes the file.
Function RestoreScreen(pszScreenName As String) As Boolean
Retrieves onto the display an image previously stored in a file in the RF Client.
Return value
True=successful, False=error, unknown file, unable to create the file, RF
link lost.
Parameters
pszScreenName
The name of the file (without extension, up to 8 characters)
to store / retrieve the display data.
Remarks
The name must contain legal characters for MS-DOS filenames. Do not
include dots (.) and other special characters (* , $ \ : etc).
Example
Public wsRfIo As New RFIO
Public Sub Main()
wsRfIo.RFPrint 0, 0, " Push / Pull Screens", WLCLEAR + WLREVERSE ' Clears the screen
wsRfIo.RFPrint 0, 1, "====================", WLNORMAL ' Do not set WLFLUSHOUTPUT
wsRfIo.RFPrint 0, 2, " SCREEN NUMBER ONE ", WLNORMAL ' in
these lines
wsRfIo.RFPrint 0, 3, " SCREEN NUMBER ONE ", WLREVERSE ' for
performance improvement
wsRfIo.RFPrint 0, 7, " SCREEN NUMBER ONE ", WLNORMAL + WLFLUSHOUTPUT ' Sends to terminal
' It is a good idea to set the WSLFLUSHOUTPUT option in the last RFPrint line
' to send the text to the RF Terminal before saving the screen
on RF Device
wsRfIo.PushScreen "SC_ONE" ' Be careful with DOS filenames, do not exceed 8 characters
wsRfIo.RFPrint 0, 0, " Push / Pull Screens", WLCLEAR + WLREVERSE ' Clears the screen
wsRfIo.RFPrint 0, 1, "====================", WLNORMAL ' Do not set WLFLUSHOUTPUT
wsRfIo.RFPrint 0, 2, " SCREEN NUMBER TWO ", WLNORMAL ' in
these lines
wsRfIo.RFPrint 0, 3, " SCREEN NUMBER TWO ", WLREVERSE ' for performance
improvement
wsRfIo.RFPrint 0, 7, " SCREEN NUMBER TWO ", WLNORMAL + WLFLUSHOUTPUT ' Sends to terminal
wsRfIo.PushScreen "SC_TWO" ' Be careful with DOS filenames, do not exceed 8 characters
wsRfIo.RestoreScreen "SC_ONE" ' This screen is NOT deleted from RF device memory
wsRfIo.PullScreen "SC_TWO" ' This screen is deleted from RF device memory
End Sub
See also RFIO