Runs a dialog to ask the user whether they want to close the whole window, close the current tab, or cancel.
If num_tabs is non-negative, the message to the user will state that there are num_tabs open tabs. If
num_tabs is negative, then the message to the user will state simply that there are "multiple open tabs".
If show_confirm_box is true a checkbox is added to the dialog to allow the user to set
whether they wish to see this dialog in future. The initial state of the checkbox is determined by the value stored at
confirm_box_checked and the value at confirm_box_checked after returning records the state of the checkbox. If
show_confirm_box is false, confirm_box_checked is ignored and may be
null.
| parent |
transient parent of the dialog, or null. |
| num_tabs |
the number of open tabs for display to user |
| show_confirm_box |
whether to ask the user if this confirmation shall be shown in the future |
| confirm_box_checked |
state of confirmation checkbox |
|
CANCEL if cancelled, YES if the user wants to close the window, CLOSE if the user wants to close the tab, and NONE for an error. |