Window Restoration Commands

The following commands record the sizes and positions of open windows so that SQA Robot can restore the testing environment during playback. They also indicate the windows within which user actions occur.

StartSaveWindowPostions
EndSaveWindowPostions

These statements tell SQA Robot that,during playback, the intervening Window SetContext, Window MoveTo, and Window SetPostion commands are for windows restoration only. All playback timings default are set to zero to process these commands as quickly as possible. If any commands fails between StartSaveWindowPostions and EndSaveWindowPositions, that failure is reported to the test log as a warning, not a script command failure.

Window SetContext
Window SetPostion

The Window SetContext statement defines the context window for subsequent test cases and user actions, and Window SetPostion indicates the postion, size, and status of that context window. These statements can vary, depending on the window within which user actions occur.

During recording, SQA Robot saves the postions of windows that are normal,minimized, or maximized if Auto Record Window Size is checked in the Recording Options dialog box. It does not save the positions of hidden windows. During playback, SQA Robot restores the windows to their positions when the test procedure was recoreded. SQA Robot writes messages to the test log for any windows it cannot find on playback.

Window Restoration Commands