Form Definition window: Fields


Form Name

Displays the name used to store and access the form. Forms can be given any name, but if your application is stand-alone, there are two specially named forms that should be part of your application.

If your application will integrate with Microsoft Dynamics GP, you won't need to create the Main Menu or About Box forms because Microsoft Dynamics GP already has them.


Allows you to set a series category for the form. The form series allows you to group related forms in a Dexterity application together using categories like Sales, Financial and System. For example, you could assign all of the forms used in an Inventory application to the Inventory series. You will use these series groupings when you use the Modifier or use Dexterity Utilities to perform dictionary maintenance activities.

If you're creating Dexterity applications that integrate with Microsoft Dynamics GP, be sure you select the series your application is integrating with. This will allow security and pathname support to function properly in your application.

Windows tab

Displays the windows that have been created for this form, and allows you to create new windows, open a window layout, delete a window or set the main window for a form.

The first window name in the list is the main window for this form - the window that will appear first when the form is opened. At runtime, closing the main window will close this form. The main window is set using the Set Main button. Refer to Windows for more information about creating windows.

Tables tab

Displays the tables attached to the form and allows you to attach or detach tables, edit the table definition or set table options. You need to attach tables to a form in order for the windows associated with the form to have access to the information in the tables, and in order for you to reference the tables in scripts. Refer to Tables for more information about creating tables.

To attach a table, click Attach to open the Table Lookup window. Select a table to attach and click OK; the table will be attached to the form. To detach the table from the form, select the table and click Detach.

Clicking Options opens the Table Options window, which allows you to specify how the form will access a particular table. The form can access the table in read-only, read/write, or exclusive use modes. You also can choose whether the table will be opened the first time it's accessed by a script or when the form is opened. If the table is a SQL table, additional SQL options can also be specified.

Menus tab

Displays the menus that have been created for this form, and allows you to add, edit, delete or rearrange menus. Refer to Form-based Menus for more information about creating menus.

Application-level menus are part of the Main Menu form, and as such are always available for any form in the application. Application-level menus can inherit predefined menu items, such as the items for Dexterity's macro system.

Form-level menus are used to add menu items that are specific to a single form. The menus defined for forms other than the Main Menu form are visible only when a window attached to the form is active. Form-level menus can't inherit predefined menu items.

To indicate where the form-level menus will appear on the menu bar, open the Main Menu form, and click the Menus tab to display a list of existing menus. Click New to open the Menu Definition window and add a special menu with the name Temporary to the Main Menu form. The Temporary menu won't be displayed; it only acts as a placeholder. If you don't add a Temporary menu, form-level menus will appear after the last menu displayed.

The order menus are listed in the window, top to bottom, will be the order they are displayed, left to right, on the menu bar. If you create a new menu, it will appear after the selected menu in the list. If you need to change the position of a menu, select its name in the list, and click the Up or Down buttons.

Constants tab

Displays the constants that have been created for this form, and allows you to add, edit or delete constants. Form-level constants are designed to be used by a specific form in the application. You should use them when several scripts on a form use a constant, but there is little need to use the constant elsewhere in the application. Refer to Form-level constants for more information.

Scripts tab

Displays the scripts that have been attached to this form, and allows you to add, edit or delete scripts.

Clicking the Pre Script button allows you to add a script that runs when the form opens; clicking Post Script allows you to add a script that runs when the form closes. A script icon will appear next to the Pre Script or Post Script button to indicate that a script has been attached.

You can also add form-level procedures and form-level user-defined functions. Click the appropriate radio button at the top of the tab to display the type of script you wish to work with. Refer to Form procedures and Form functions for more information.

Commands tab

Displays the commands that have created for this form, and allows you add, edit, or delete commands. Refer to Commands for more information.

Documentation Feedback