Version 6.3.8 for Windows
 —  Dialog Component Reference  —

RECALC-LAYOUT Action

This document covers the following topics:


Description

Causes the control bar layout for the specified dialog to be recalculated, which may result in the bar positions and/or sizes being adjusted. The control bars include the newer tool-bar and status bar controls, but not the traditional tool bar and status bar available in earlier Natural versions.

Normally, Natural implicity causes a layout recalculation where necessary (e.g. immediately before the After-Open Event , or if a bar is created or moved). However, in order to reduce the number of screen refreshes to a minimum, it may be that only a delayed implicit layout recalculation is performed. Since some operations, such as getting the dialog's client area via the INQ-INNER-RECT Action, require that the bars are in their final positions, a preceding manually-triggered layout recalculation may be necessary in some cases. Note that this is not the case for all bars defined statically with the dialog editor, because Natural automatically does an immediate layout recalculation before calling the user's AFTER-OPEN event handler.

Note that an immediate layout recalculation will clear any outstanding delayed layout recalculation request. Also, multiple delayed layout recalculation requests are consolidated (i.e., do not cause multiple refreshes).

Top of page

Parameters

Name/Data Type Explanation
HANDLE OF GUI Input

Handle of the dialog whose bar layout is to be recalculated.

Mode (L) Input (optional parameter)

If true (default), an immediate layout recalculation is performed. If false, a delayed layout recalculation is performed.

Example:

PROCESS GUI ACTION RECALC-LAYOUT WITH #DLG$WINDOW 
GIVING #RESPONSE 

Top of page