Sets the window modal, preventing user interaction with any other window of the same application until the window is closed or made non- modal. If modal is true, the window will be modal. If it is false it will not be modal.
A window should be set modal if it requires user interaction before the rest of the application can continue, e.g. a message box.
See also: get_modal() , modal