{"title":"ModalPageHandler attribute","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/attributes/devenv-modalpagehandler-attribute/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/attributes/devenv-modalpagehandler-attribute, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/attributes/devenv-modalpagehandler-attribute","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Specifies that the method is a ModalPageHandler method, which handles specific pages that are run modally.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Applies to","slug":"applies-to","at":167,"chars":134},{"level":2,"title":"Syntax","slug":"syntax","at":301,"chars":971},{"level":3,"title":"Arguments","slug":"arguments","at":1027,"chars":245},{"level":2,"title":"Remarks","slug":"remarks","at":1272,"chars":620},{"level":2,"title":"Related information","slug":"related-information","at":1892,"chars":111}],"text":"> Version: _Available or changed with runtime version 1.0._\nSpecifies that the method is a ModalPageHandler method, which handles specific pages that are run modally.\n## Applies to\n Method\n> NOTE\n> The ModalPageHandler attribute can only be set inside codeunits with the SubType property set to Test.\n## Syntax\n> Version: _Available or changed with runtime version 1.0._\n```al\n[ModalPageHandler]\nprocedure ModalPageHandler(var Page: TestPage)\n```\n> IMPORTANT\n> The above signature requires the ModalPageHandler method to be global. See https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-al-methods.md%23local-and-global-scope.\n> Version: _Available or changed with runtime version 2.1._\n```al\n[ModalPageHandler]\nprocedure ModalPageHandler(var Page: Page; var Response: Action)\n```\n> IMPORTANT\n> The above signature requires the ModalPageHandler method to be global. See https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-al-methods.md%23local-and-global-scope.\n### Arguments\nPage\nType: ../methods-auto/testpage/testpage-data-type\nA specific page.\nPage\nType: ../methods-auto/page/page-data-type\nA specific page.\nResponse\nType: ../methods-auto/action/action-option\nThe action that the user took on the page.\n## Remarks\nThe ModalPageHandler method is called when a modal page is invoked in the code.\nYou 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. Learn more about handler methods in Create Handler Methods<../devenv-creating-handler-methods>.\n## Related information\nGet Started with AL<../devenv-get-started>\nDeveloping Extensions<../devenv-dev-overview>"}