Method XbpDialog():showModal() Foundation
Displays the XbpDialog object as a modal dialog.
:showModal( [<oXbpFocus>] ) --> xResult
This method returns the result of the modal dialog. This is the value assigned to the :modalResult instance variable.
The method :showModal() displays an XbpDialog object as a modal form. Contrary to the :show() method, :showModal() does not terminate until one of the following conditions is met:
The method :showModal() is ideal for showing dialogs designed to return a result of a certain kind. These dialogs typically have an Ok and Cancel push button and must be closed by the user before being able to work with other dialogs of the application. Internally, :showModal() uses the method XbpWindow:setModalState() to disable the Xbase Part specified in parameter <oOwner> to method :new() or :create().
The method :showModal() uses an internal event loop that dispatches events while the modal XbpDialog window is being displayed. The event loop ensures that the application continues to function, even though its standard event loop is not executed until :showModal() returns. The event loop executes until the user either closes the XbpDialog object using its close, default or cancel buttons, or if the application terminates the dialog by assigning a result value to the instance variable :modalResult. See the documentation on :modalResult for further information. Also see the :default and :cancel instance variables of the XbpPushbutton class to learn more about defining default buttons for a modal dialog.
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.