ModalPageHandler Attribute

Version: Available or changed with runtime version 1.0.

Specifies that the method is a ModalPageHandler method, which handles specific pages that are run modally.

Applies To

• Method

Note

The ModalPageHandler attribute can only be set inside codeunits with the SubType property set to Test.

Syntax

Version: Available or changed with runtime version 1.0.

[ModalPageHandler]
procedure ModalPageHandler(var Page: TestPage)

Important

The above signature requires the ModalPageHandler method to be global. For more information, see Local and global scope in AL methods.

Version: Available or changed with runtime version 2.1.

[ModalPageHandler]
procedure ModalPageHandler(var Page: Page; var Response: Action)

Important

The above signature requires the ModalPageHandler method to be global. For more information, see Local and global scope in AL methods.

Arguments

Page
 Type: TestPage
A specific page.

Page
 Type: Page
A specific page.

Response
 Type: Action
The action that the user took on the page.

Remarks

The ModalPageHandler method is called when a modal page is invoked in the code.

You use handler methods to automate tests by handling instances when user interaction is required by the code that is being tested by the test method. In these instances, the handler method is run instead of the requested user interface. The handler method should simulate the user interaction for the test case, such as validating messages, making selections, or entering values. You declare a handler type attribute on the method. For more information about handler methods, see Create Handler Methods.

See Also

Get Started with AL
Developing Extensions