GET-FIRST-WINDOW Action

This document covers the following topics:


Description

Gets the first or last window (dialog or dialog element) in Z-order (depth) sequence that has the same parent as the specified reference window. The window returned can be the reference window itself if the reference window is at the top of the Z-order sequence.

Parameters

Name/Data Type Explanation
HANDLE OF GUI Input

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

HANDLE OF GUI Output

First or last window in Z-order sequence containing reference window.

Reverse (L) Input (optional parameter)

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

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

Response (I4) Output

Natural error (if applicable).

Example:

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