Open form window

Home

4D v16.3

Open form window


Open form window ( {aTable ;} formName {; type {; hPos {; vPos {; *}}}} ) -> Function result

Parameter	Type	Description
aTable	Table	Table of the form or Default table, if omitted
formName	String	Name of the form
type	Longint	Window type
hPos	Longint	Horizontal position of the window
vPos	Longint	Vertical position of the window
*	Operator	Save current position and size of the window
Function result	WinRef	Window reference number

Description

The Open form window command opens a new window using the size and resizing properties of the form formName.

Note that formName is not displayed in the window. If you want to display the form, you have to call a command which loads a form (ADD RECORD for example).

Unlike the Open window command, no method is associated to the window's close box. Clicking on this close box cancels and closes the window, except if the On Close Box form event has been activated for the form. In this case, the code associated with the On Close Box event will be executed.

If formName is resizable, the window opened will contain a zoom box as well as a grow box.

Note: To know the main properties of a form, use the FORM GET PROPERTIES command.

The optional type parameter allows you to specify a type for the window. You must pass one of the following predefined constants (placed in the Open Form Window theme):

Constant	Type	Value
Form has full screen mode Mac	Longint	65536
Modal form dialog box	Longint	1
Movable form dialog box	Longint	5
Palette form window	Longint	1984
Plain form window	Longint	8
Pop up form window	Longint	32
Sheet form window	Longint	33
Toolbar form window	Longint	35

Notes:

The Form has full screen mode Mac constant must be added to one of the other type constants.
For more information about window types, refer to the Window Types section.

By default, if the type parameter is not passed, a window of the Plain form window type is opened.

Close box
Windows of the Movable form dialog box, Plain form window, and Palette form window types have a close box. No method is associated to the window's close box. Clicking on this close box cancels and closes the window, except if the On Close Box form event has been activated for the form. In this case, the code associated with this event will be executed.

Size control
If "Window Size" properties of the formName are not set to "fixed", the opened window can be resized by the user. A zoom box can be available,depending on the window type. If the Fixed Width and/or Fixed Height property is checked in the form properties, the window will not be resizable.

Note: Some attributes (grow box, close box...) of the window created depend on the interface specifications of the operating system for the chosen type. It is therefore possible to obtain different results depending on the platform used.

The optional parameter hPos allows you to define the horizontal position of the window. You can pass a defined position to this parameter (distance in pixels from the left edge of the application window to the left internal edge of the window) or one of the following predefined constants placed in the Open Form Window theme:

Constant	Type	Value
Horizontally centered	Longint	65536
On the left	Longint	131072
On the right	Longint	196608

The optional parameter vPos allows you to define the vertical position of the window. You can pass a defined position to this parameter (distance in pixels from the top of the application window to the top internal edge of the window) or one of the following predefined constants placed in the Open Form Window theme:

Constant	Type	Value
At the bottom	Longint	393216
At the top	Longint	327680
Vertically centered	Longint	262144

These parameters take into account the presence of the tool bar and menu bar as well as the current size of the application's window (on Windows).

If you pass the optional parameter *, the current position and size of the window are memorized when closed. When the window is reopened again, its previous position and size are respected. In this case, the vPos and hPos parameters are only used the first time the window is opened.

Note: To reopen a window at vPos and hPos initial coordinates when the * parameter is used, hold down the Shift key while the window is being opened.

 $myWin:=Open form window("sheet form";Sheet form window)

  // For the moment, the window is created but remains hidden

 DIALOG([aTable];"dialForm")

  //lThe On Load event is generated then the sheet window is displayed; it "drops down"

  //from the bottom of the title bar

4D v16.3

Open form window

Open form window

Description

Example 1

Example 2

Example 3