MAXIMIZE WINDOW

Home

4D v16.3

MAXIMIZE WINDOW


MAXIMIZE WINDOW {( window )}

Parameter	Type	Description
window	WinRef	Window reference number or if omitted, all current process frontmost windows (Windows) or current process frontmost window (Mac OS)

Description

The MAXIMIZE WINDOW command triggers the expansion of the window whose reference number was passed in window. If this parameter is omitted, the effect is the same but is applied to all the frontmost windows of the current process (Windows) or to the frontmost window of the current process (Mac OS).

This command has the same effect as a click on the zoom box of a 4D application window. Windows you want to maximize must have a zoom box. If the window type does not have a zoom box, the command does nothing (for more information about this point, refer to Window Types (compatibility) section).

A later click on the zoom box or a call to the MINIMIZE WINDOW command reduces the window to its initial size. On Windows, a call to MINIMIZE WINDOW without parameters sets the size of all application windows to their initial sizes.

If window is already maximized, the command does nothing.

On Windows

The size of the window is increased to match the current size of the application window. The maximized window is set to be the frontmost window. If you do not pass the window parameter, the command is applied to all the application windows.

Windows zoom box

In cases where the command is applied to a window whose size is subject to constraints (for example, a form window):

If no size constraint is in conflict with the target size, the window is "maximized" (i.e., it is restored to the size of the parent MDI ("Multiple Document Interface") window; its title bar and borders are hidden, and its control buttons - minimize, restore and close - are moved to the right of the application menu bar).
If at least one size constraint is in conflict (for example, if the width of the MDI window is 100 and the form window's maximum width is set to 80), the window is not "maximized", but only restored to its maximum allowed size. This size is defined either by the MDI window, or by the constraint. This way, the interface remains consistent when windows with constraints are resized.

On Mac OS

The size of the window is increased to match the size of its contents. If you do not pass the window parameter, the command is applied to the frontmost window of the current process.

Zoom box on Mac OS

The zoom is based on the contents of the window; so, the command must be called in a context where the contents of the window are defined, for example in a form method. Otherwise, the command does nothing.
The window is set to its "maximum" size. If the window is actually a form whose size was defined in the form properties, the window size is set to those values.

Example 1

This example sets the window size of your form to full screen when it is opened. To achieve this, the following code is placed in the form method:

  ` In the Form method

 

 MAXIMIZE WINDOW

Example 2

This example illustrates how size constraints are handled on Windows. The following form has a size constraint (maximum width=400):

The method of the button contains simply:

MAXIMIZE WINDOW(Current form window)

In this context, when the user clicks on the button:

... the window is not "maximized"; only its height is increased: