INQ-INNER-RECT Action

This document covers the following topics:


Description

Retrieves the dimensions of the client rectangle, or the dimensions and relative position of the interior rectangle, of the screen, a dialog element, or the client window of a dialog. For SDI (standard window) dialogs and MDI child dialogs, the client window is the interior window onto which the dialog elements are usually placed. For MDI frame dialogs, it is the MDI client window (the window that hosts the MDI child dialogs). For dialog elements, the client rectangle is the area excluding any frame components such as borders, margins and scroll bars. If the dialog element possesses an implicit child client window (as is the case with tab controls, for example), this action applies to this client window rather than to its parent.

The interior rectangle is, in most cases, identical to the client rectangle. The exception is the screen, where the client rectangle is the full screen size and the interior rectangle is the screen area that excludes any desktop toolbars (such as the system taskbar).

Parameters

Name/Data Type Explanation
HANDLE OF GUI Input

Handle of the dialog or dialog element. If NULL-HANDLE is specified, the screen is implied.

Width (I4) Output

Returns the width (in pixels) of the client rectangle, if neither the Left nor the Top parameter is supplied, or the width of the interior rectangle otherwise.

Height (I4) Output

Returns the height (in pixels) of the client rectangle, if neither the Left nor the Top parameter is supplied, or the height of the interior rectangle otherwise.

Left (I4) Output (optional parameter)

Returns the horizontal offset (in pixels) of the left edge of the interior rectangle relative to the left edge of the client rectangle.

Top (I4) Output (optional parameter)

Returns the vertical offset (in pixels) of the top edge of the interior rectangle relative to the top edge of the client rectangle.

Response (I4) Output

Natural error (if applicable).

Example:

 
PROCESS GUI ACTION INQ-INNER-RECT WITH #DLG$WINDOW #WIDTH #HEIGHT GIVING 
#RESPONSE 
#IF-1.STRING := #HEIGHT /* Display the width and height 
#IF-2.STRING := #WIDTH