From Xojo Documentation
| This item was deprecated in version 2021r3.
Please use MessageDialog.ShowModal as a replacement.
Displays the MessageDialog window as a sheet window (macOS only) for the passed Window.
On non-Mac platforms, it displays the MessageDialog as a modal dialog (same as ShowModal). Returns a MessageDialogButton, which indicates which button was pressed. To find out which button was pressed, compare it to the button instances in the dialog.
The following example creates and manages a "Save Changes" dialog box without the need to create an instance of the Window class.
Var b As MessageDialogButton // for handling the result
d.Icon = MessageDialog.GraphicCaution // display warning icon
d.ActionButton.Caption = "Save"
d.CancelButton.Visible = True // show the Cancel button
d.AlternateActionButton.Visible = True // show the "Don't Save" button
d.AlternateActionButton.Caption = "Don't Save"
d.Message = "Do you want to save changes to this document before closing?"
d.Explanation = "If you don't save, your changes will be lost. "
b = d.ShowModalWithin(Window1) // display the dialog in Window1
Select Case b // determine which button was pressed.
// user pressed Save
// user pressed Don't Save
// user pressed Cancel