PAGE.RUNMODAL Function

Creates, runs, and closes a specified page object. When a page is run modally, no input, such as a keyboard or mouse click, can occur except for objects on the modal page.

Syntax

  
[Action :=] Page.RUNMODAL(Number[, Record][, Field])  

Parameters

Number
Type: Integer

The number of the page that you want to run. If you enter zero (0), then the default lookup window for the current page is displayed. On the View menu, choose the C/AL Symbols Menu to select the page from a list.

If the page that you specify does not exist, then a run-time error occurs.

Record
Type: Record

By default, this function shows the record that was last displayed on the page. For each object, information is stored about the most recently shown record and the attached key and filters.

Use this optional parameter to select a specific record to display on the page. The record must be of the same type as the table that is attached to the page. When the record is displayed, the key and filters that are attached to the record are used.

Field
Type: Field

Use this optional parameter to select a specific field on which focus will be put.

Property Value/Return Value

Type: Action

Specifies what action the user took on the page. The following table shows the possible return values for the different user actions. In some cases, the actions for the return values are different when the page displays in the Microsoft Dynamics NAV Web client than in the Microsoft Dynamics NAV Windows client.

Return value Microsoft Dynamics NAV Windows client Microsoft Dynamics NAV Web client
OK To close the page window, the user does one of the following:

- Chooses the OK button.
- Chooses the X button when there was no Cancel button on the window.
- Presses the Esc key when there is no Cancel button on the window.
To close the page window, the user does one of the following:

- Chooses the Close button.
- Chooses the X button when there is no Cancel button on the window.
Cancel To close the page window, the user does one of the following:

- Chooses the Cancel button.
- Chooses the X button when there is a Cancel button on the window.
- Presses the Esc key when there is a Cancel button on the window.
To close the page window, the user does one of the following:

- Chooses the Cancel button.
- Chooses the X button when there is a Cancel button on the window.
LookupOK To close a lookup window, the user does one of the following:

- Chooses the OK button.
- Chooses an item in the Lookup window.
To close a lookup window, the user chooses the OK button.
LookupCancel To close a lookup window, the user chooses the Cancel button. Same as Microsoft Dynamics NAV Windows client.
Yes To close a confirmation window, the user selects Yes. Same as Microsoft Dynamics NAV Windows client.
No To close a confirmation window, the user does one of the following:

- Chooses the No button.
- Chooses the X button.
- Presses the Esc key.
To close a confirmation window, the user does one of the following:

- Chooses the No button.
- Chooses the X button.
RunObject The user selected an option that ran another Dynamics NAV object. Same as Microsoft Dynamics NAV Windows client.
RunSystem The user selected an option that ran an external program. Same as Microsoft Dynamics NAV Windows client.

Remarks

The page is run modally. If you do not know the specific page that you want to run when you are designing your application, then use this function or the PAGE.RUN Function and specify the page in the Action parameter.

If you do know which page that you want to run, then you can create a Page variable, set the Subtype of the variable to a specific page, and then use the RUN Function (Page) or RUNMODAL Function (Page) on the Page variable.

When you want to close the page, use the CurrPage.CLOSE function. CurrPage is a predefined system variable.

Example

This example shows how to call page 21.

IF Page.RUNMODAL(21, MyRecord, ...) = Action::LookupOK THEN...;  

See Also

Page Data Type