PushScreen Method

This member of RFIO Object is supported on iOS, Windows Mobile, Windows CE, Palm, and DOS.

The PushScreen method saves the current displayed screen directly to an RF device’s non-volatile memory for later restoration.

VB

bStatus = object.PushScreen (pszScreen)

VC++

HRESULT hr = object->PushScreen(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 file name in which the currently displayed screen will be saved.

Remarks

Use the PullScreen Method to restore a previously saved screen file if you wish to remove the screen file from the RF device’s memory. Use the RestoreScreen Method to restore a screen without removing 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.

It is recommended that you clear the output queue immediately before using the PushScreen method.

Example

See the PullScreen Method.

 


Was this article useful?    

The topic was:

Inaccurate

Incomplete

Not what I expected

Other

Privacy and Legal