RestoreScreen Method

This member of Class WaveLinkIO is supported on iOS, Windows Mobile, Windows CE, Palm, and DOS.

The RestoreScreen Method paints the screen with the specified stored image without deleting the image file.

Syntax

public void RestoreScreen(String fileName)
throws WaveLinkError
public void RestoreScreen(String fileName, int screenFlags)
throws WaveLinkError

Parameters

fileName

The file containing the 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.

Example

WaveLinkIO IOIface = new WaveLinkIO();

.

.

.

try {

// 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.

IOIface.RFPrint(0, 7, " Version 3.01 ", WaveLinkIO.WLNORMAL | WaveLinkIO.WLFLUSHOUTPUT);

IOIface.PushScreen("Version");

.

.

.

//Re-display the Version screen later.

IOIface.RestoreScreen("Version");

}

catch (WaveLinkError wlErr) {

//Do error handling

}

 


Was this article useful?    

The topic was:

Inaccurate

Incomplete

Not what I expected

Other

Privacy and Legal