DialogCreate

comment

Creates a new dialog. It is empty and hidden by default.

Since this creates an object and returns a handle, it must be freed when no longer needed with DialogDestroy.

An empty dialog must be populated with buttons (DialogSetMessage, DialogAddButton, DialogAddQuitButton) and finally displayed with DialogDisplay.

note

While a dialog is open, the player can only interact with the dialog. Everything else is disabled.

An empty dialog completely blocks all player input (except multiboard interaction and probably other scripted custom elements). A player can only exit the game with Alt+F4.

bug

The top-bar menu buttons are greyed out when a dialog is shown. If the player presses Alt+F4 and then clicks "Cancel", the menu buttons become visible and clickable but do nothing.

patch

1.00

Source

common.j (raise an issue to discuss on Github or submit a PR)

return type

dialog

Source code

native DialogCreate                 takes nothing returns dialog