This member of RFIO Object is supported on iOS, Windows Mobile, Windows CE, Palm, and DOS.
The RestoreScreen method restores a screen file as the current display screen. RestoreScreen will NOT remove the screen file from the RF device’s memory.
VB
bStatus = object.RestoreScreen (pszScreen)
VC++
HRESULT hr = object->RestoreScreen(LPCTSTR pszScreen, BOOL *bStatus);
Return Value
|
bStatus |
The status of the function returned as Boolean True or False values. Use the RFGetLastError method to return the error value. |
Parameters
|
pszScreen |
The screen file name to be restored. |
Remarks
Use the PushScreen Method to save a current screen file to an RF devices memory. Use the PullScreen Method if you wish to restore a screen while deleting it from the RF device’s memory. When used in conjunction, PushScreen and PullScreen or RestoreScreen allow you to temporarily interrupt a displayed screen within your application, then restore the screen to its original state. This allows for faster display when re-using screens.
Example
' VB Sample Code
Dim wlio As New RFIO
.
.
.
' flush the output before using PushScreen.
' You can flush the output with:
' 1. An input call
' 2. The RFFlushoutput method
' 3. The RFPrint method when WLFLUSHOUTPUT is set as the
' display mode
wlio.RFPrint 0, 7, "Version 3.01 ", _
WLNORMAL + WLFLUSHOUTPUT
wlio.PushScreen "Version"
.
.
.
' re-display the Version screen later
wlio.RestoreScreen "Version"
Was this article useful?
The topic was:
Inaccurate
Incomplete
Not what I expected
Other