GET-NEXT-WINDOW Action

This document covers the following topics:

Description

Gets the next or previous window (dialog or dialog element), if any, in Z-order (depth) sequence that has the same parent as the specified reference window.

Parameters

Name/Data Type Explanation
HANDLE OF GUI Input

Reference window. This can be a dialog or dialog element.

HANDLE OF GUI Output

Next or previous window in Z-order sequence containing reference window, or NULL-HANDLE if no such window is available (i.e., end of list)

Reverse (L) Input (optional parameter)

If set to FALSE (= default), the next window in the Z-order sequence will be returned.

If set to TRUE, the previous window in the Z-order sequence will be returned.

Response (I4) Output

Natural error (if applicable).

Example: 

PROCESS GUI ACTION GET-NEXT-WINDOW WITH #CHILD #NEXT GIVING #RESPONSE