This member of Class WaveLinkIO is supported on iOS, Windows Mobile, Windows CE, Palm, and DOS.
The PushScreen Method saves the current displayed screen directly to the device’s non-volatile memory for later restoration.
Syntax
public void PushScreen(String fileName)
throws WaveLinkError
public void PushScreen(String fileName, int screenFlags)
throws WaveLinkError
Parameters
|
fileName |
The file in which to store the screen image |
|
screenFlags |
A flag that determines whether widgets are pushed with the screen. The possible values for screenFlags are: WLIGNORE_WIDGETS - Includes widgets in image file WLINCLUDE_WIDGETS - Does not include widgets in image file |
Throws
WaveLinkError
Remarks
Use the PushScreen Method to save a current screen file to device memory.
Use the RestoreScreen Method if you wish to restore a screen without deleting it from the device memory.
When used in conjunction, PushScreen and PullScreen or RestoreScreen can temporarily interrupt a displayed screen within your application, then restore the screen to its original state. This creates faster display when re-using screens.
We recommend that you clear the output queue immediately before using the PushScreen method.
Example
WaveLinkIO IOIface = new WaveLinkIO();
.
.
.
try {
// Flush the output before using PushScreen.
// You can flush the output with:
// 1. An input call
// 2. TheRFFlushoutput Method.
// 3. The RFPrint RFPrint Method when WLFLUSHOUTPUT is set as the display mode.
IOIface.RFPrint(0, 7, " Version 3.01 ",
WaveLinkIO.WLNORMAL
| WaveLinkIO.WLFLUSHOUTPUT);
IOIface.PushScreen("Version");
.
.
.
// Re-display the Version screen later.
IOIface.PullScreen("Version");
}
catch (WaveLinkError wlErr) {
//Do error handling
}
Was this article useful?
The topic was:
Inaccurate
Incomplete
Not what I expected
Other