Home > Reference > Script steps reference > Windows script steps > New Window

New Window

Purpose 

Creates a new window based on the foreground window. You can create a document window, a floating document window, or a dialog window.

Format 

New Window[Name: <name of window>; Height: n; Width: n; Top: n; Left: n; Style: Document/Floating Document/Dialog]

Options 

Click Specify to set options for the new window.

•	Window Name is the name you specify for your new window. You can enter literal text or click Specify to create a window name from a calculation.

•	Height is the height of the new window in points. You can enter a number or click Specify to generate a number from a calculation.

•	Width is the width of the new window in points. You can enter a number or click Specify to generate a number from a calculation.

•	Distance from top is the new window’s distance in points from the top of the screen (OS X) or top of the FileMaker Pro window (Windows). You can enter a number or click Specify to generate a number from a calculation.

•	Distance from left is the new window’s distance in points from the left of the screen (OS X) or left of the FileMaker Pro window (Windows). You can enter a number or click Specify to generate a number from a calculation.

•	Window Styles settings let you specify that the new window is a document window (default setting) or a dialog window. To specify a window style, select Specify Advanced Style or click Specify. See Specify Advanced Style Options dialog box.

Note  If you clear the Specify Advanced Style checkbox, you will lose any advanced style settings that have been created.

Compatibility 

 

Where the script step runs	Supported
FileMaker Pro	Yes
FileMaker Server scheduled script	Yes
FileMaker Go	Partial
Custom Web Publishing	Partial
FileMaker WebDirect	Partial
Runtime solution	Yes

Originated in 

FileMaker Pro 6.0 or earlier

Description 

A new window has the same layout, same table, same found set, and same current record as the original window. You can specify the new window is a document window, a floating document window, or a dialog window.

•	Document windows allow users to minimize, maximize, restore, or close them or start a new FileMaker Pro process as they work in FileMaker Pro.

•	Floating document windows remain on top of other FileMaker Pro windows even when they become inactive.

•	Dialog windows are modal. They appear in the foreground and can’t be minimized. Users cannot activate an open document window before closing an open dialog window.

Create document windows for typical user-input tasks or tasks that can take place in a random order. Use dialog windows to collect required or prerequisite information or to alert users.

Notes

•	In FileMaker WebDirect and Custom Web Publishing, this script step opens a new virtual window in the web browser. Inactive virtual windows remain open but are not visible. To change the current (active) virtual window, use the Select Window script step.

•	Window style settings are not supported in FileMaker Go, FileMaker WebDirect, or Custom Web Publishing.

•	Window names created with the New Window script step do not have to be unique.

•	Window name selection is not case-sensitive.

•	It is not necessary to enter values for each option. When no value is entered, FileMaker Pro uses the default value associated with the Window menu > New Window command.

•	Minimum height and minimum width depend on the operating system of the user performing the script. If the height or width you specify are less than the minimum, FileMaker Pro uses the minimum values.

•	If the window height or width values you specify exceed the user’s screen resolution, FileMaker Pro uses the maximum values possible.

•	You can create a new window off-screen by supplying negative top and/or left values, which can be useful for multiple monitor environments.

•	There are some restrictions when you use script steps with dialog windows. For more information, see Specify Advanced Style Options dialog box.

•	When a dialog window is open, subsequent New Window script steps create only dialog windows.

Kiosk mode (FileMaker Pro Advanced)

•	Any new document window created in Kiosk mode is a standard Kiosk-mode window and the status toolbar is hidden.

•	No Kiosk properties apply to dialog windows opened in Kiosk mode. For example, the status toolbar shows.

•	When multiple Kiosk and non-Kiosk files are open, if a non-kiosk file opens a new dialog window, the user can’t switch to other windows (including a window created in Kiosk mode)

Example 1 

Goes to the Customers layout in a new window and sorts by the Customer ID field.

New Window [Top: Get ( WindowTop ) + 25; Left: Get ( WindowLeft ) + 25; Style: Document]
Go to Layout ["Customers"]
Sort Records by Field [Descending; Customers::Customer ID]

Example 2 

Goes to the Print Invoices layout in a new floating window and enters Preview Mode.

New Window [Name: "Print Invoices"; Top: Get ( WindowTop ) + 25; Left: Get ( WindowLeft ) + 25; Style: Floating Document]
Go to Layout ["Print Invoices"]
Enter Preview Mode [ ]

Related topics 

Go to Layout script step

Defining calculation fields

Script steps reference (alphabetical list)

Script steps reference (category list)