Specify Form Run Options dialog box

For components that support shortcut menus for Find, Add, and Details forms, use this dialog box to set up and maintain specifications for opening the relevant form.

For event handlers with one of the form navigation response types, use this dialog box to set up and maintain the specifications which run or execute a form based on an event.

Field/Option Description
Form Specify the internal name (not the caption) of the form to be run.
Filter This is the filter to be applied to the form being opened. Specify the filter as an SQL WHERE clause using the FILTER keyword and property names as parameters (instead of column names). You can include substitution keywords.

The entire string, after any substitutions are performed, is passed to the IDO in its Filter property prior to the load collection call.

If the filter is for a subcollection, and there are substitutions for variables included in it, then a dependency is created between the subcollection and the variable. When the variable's value is changed, the subcollection is refreshed.

If the filter is for a list source, and there are substitutions for variables included in it, then a dependency is created between the list source and the variable. When the variable's value is changed, the list source is invalidated.

Distinct Select the check box to apply the DISTINCT keyword to the primary collection on the form being opened. Otherwise, clear this check box.
OrderBy Specify the ORDERBY keyword, which controls the sorting of the primary collection on the form being opened.
GroupBy Specify the GROUPBY keyword for the primary collection on the form being opened.
Set Variables Specify values for variables, components, or properties used in the event handler.
Property This field applies only to opening an Add/Details form. Specify the property in the parent form that is used to filter the child form being opened.
OK/Cancel Optional This field applies only to opening modal child forms.

Select the check box to eliminate the OK or Cancel prompt when a user closes a modal child form with the Close box. Clear the check box to have the prompt display.

Reload After Child Saves (RLACS) This field applies only to opening linked child forms.

Select the check box to refresh the current IDO item in the parent form's collection after the child form's primary collection is saved. Otherwise, clear the check box.

Use this option in cases in which saving the child form might cause the data in the parent form's current item to be obsolete.

Container Type Select how the form is to be displayed:
  • Default - runs the form as a Linked Form in a separate window
  • Popup Window - opens the form in a pop-up window
  • SubForm - adds the form as a subform
SubForm Container

This field applies only if you select the SubForm container type.

Specify the name of the subform component.

LinkBy This field applies only to opening linked child forms. Specify the WinStudio LINKBY keyword.
Set Variable on Link Update This field applies only to opening linked child forms. Specify targets and values for variables