About window styles

In the New Window script step, window styles allow you to specify how a new window behaves in a custom app. Each layout and task should be designed with a particular window style in mind.

Document window

Document windows allow users to start a new process or view additional information.

Use document windows for typical user-input tasks or tasks that can take place in any order. For example, open a document window to review an invoice while looking at a customer's purchase history.

Floating document window

Floating document windows remain on top of other windows even when the floating window becomes inactive.

Use floating document windows to display information or tasks that should be visible at all times. For example, open a floating document window to display an interactive table of contents.

Dialog window

Dialog windows appear in the foreground. Users must close all open dialog windows before they can activate open document or floating document windows.

Use dialog windows to collect required information or alert users to situations while blocking access to other windows. For example, open a dialog window to display an alert when a user attempts to modify sensitive data.

  • When a dialog window is open, the New Window script step creates dialog windows or cards but cannot create document or floating document windows.
  • Users can work with non-document windows, such as the Data Viewer and Script Debugger, if these windows are open when a dialog window opens. Users cannot work with the Manage Layout dialog box, the Script Workspace, or the My Apps, Favorites, and Recent windows.
  • Any operations that attempt to open a document or floating document window will fail when a dialog window is open (for example, using a script trigger to run a script from another file). OnTimer scripts do not execute when a dialog window is open unless the script launches from the dialog window itself.
  • Some restrictions apply to the following script steps when they're used with dialog windows.

    • Script step

    Supported

    Restriction with dialog windows

    Adjust Window

    Yes

    Operates only on the current window

    Arrange All Windows

    No

     

    Convert File

    No

     

    Go To Related Record

    Yes

    Can open only a new dialog window

    Move/Resize Window

    Yes

    Operates only on the current window

    New File

    No

     

    New Window

    Yes

    Can open only a new dialog window or a card

    Open File

    No

     

    Open Hosts

    No

     

    Perform Script

    Yes

    Will fail if executed from another open file

    Quit Application

    No

     

    Select Window

    Yes

    Can select only the current dialog window
  • macOS: A FileMaker Pro dialog window does not have all the same qualities or restrictions of a standard macOS dialog window. For example, Apple events can communicate with a file while a FileMaker Pro dialog window is open.

Card

Cards appear in the foreground of the current layout in the active window. Users must close a card before they can work with the card's parent window.

Use cards to collect required information or alert users to situations while allowing access to other windows. For example, open a card to prompt users for find criteria while allowing access to other open windows.

  • Cards can't be minimized or maximized.

  • FileMaker Pro does not include cards in the Window menu.

  • In FileMaker Pro and FileMaker Go, a card's height and width cannot exceed the screen size.

  • In FileMaker WebDirect, a card's height and width can exceed the size of the web browser window. However, the card is cropped to display only the areas within the web browser window. If the content in the card fits within the card's specified height and width, then the card can't be scrolled, even if the card is cropped by the web browser window. To avoid this situation, use the Get(WindowContentHeight) and Get(WindowContentWidth) functions in the New Window script step to set the height and width of the card to fit within the web browser window.

  • Scroll bars appear in the card if the active layout is larger than the card's height or width.

  • You cannot open more than one card from the same parent window.

  • In FileMaker Pro:

    • cards do not contain the status toolbar, the formatting bar, a title bar, or a window frame. To move or resize a card, use the Move/Resize Window script step.

    • when a card is open, the status toolbar and the formatting bar in the parent window aren't active and can't be shown or hidden.

  • In FileMaker WebDirect:

    • when a card is open, the status toolbar and menu bar in the parent window aren't active and can't be shown or hidden.

    • the parent window of a card won't be updated until the card is closed.

  • In FileMaker Go, to hide or show the menu bar or toolbar for a card, you must hide or show the bar before displaying the card. (The gesture or script step for hiding or showing the card is disabled when the card has the focus.)

  • If you select the Close option, the user can close the card by clicking the Close button in FileMaker Pro and FileMaker WebDirect or by tapping outside the card in FileMaker Go. However, if you don't select the Close option, users have no way to close the card unless you include a script (for example, assigned to a button in the card) that performs the Close Window script step.

  • If a script attempts to close a card's parent window, the script first attempts to close the card. If it cannot close the card (for example, a script trigger fails), the script returns an error code.