Added in 1.9.0
$dialog(name,table,[parent])
Creates a modal dialog.
See also /dialog, on DIALOG, Dialog Items.
Parameters
| Parameter | Description |
| name | Name of the dialog to create. |
| table | Name of the dialog table to use. |
| [parent] | Name of the parent window to associate the dialog with or -1 = Desktop window, -2 = Main AdiIRC window, -3 = Currently active window, -4 = Currently active dialog. (optional) |
Example
: Create a dialog table.
Dialog Example1 {
title "This is Example 1"
size -1 -1 172 129
option dbu
tab "Tab A", 14, 2 0 165 123
tab "Tab B", 15
tab "Tab C", 16
edit "", 17, 8 16 154 104, tab 16 multi return autohs vsbar
menu "&File", 1
item "&New", 6, 1
item "&Open", 7, 1
item break, 8, 1
item "&Save", 9, 1
item "Save &as", 10, 1
menu "&Edit", 2
item "&Copy", 11, 2
item "P&aste", 12, 2
menu "&view", 3
item "&All", 13, 3
menu "&Help", 4
item "&About", 5, 4
}
; Create and open the dialog using the 'Example' table.
//noop $dialog(Example, Example)
$dialog(name|N)
Returns information about a dialog.
Parameters
| Parameter | Description |
| name|N | Name of the dialog or if N = 0, number of dialogs, otherwise the Nth dialog. |
Properties
| Property | Description |
| .result | Returns ID of the 'result' button if specified. |
| .x | Returns the X position of the dialog. |
| .y | Returns the Y position of the dialog. |
| .w | Returns the width of the dialog. |
| .h | Returns the height of the dialog. |
| .cw | Returns the width of the dialog client area. |
| .ch | Returns the height of the dialog client area. |
| .title | Returns the dialog title. |
| .modal | Returns $true if the dialog is modal, otherwise $false. |
| .state | Returns minimized/maximized/hidden/normal. (AdiIRC only) |
| .table | Returns the name of the dialog table. |
| .ok | Returns ID of the 'ok' button if specified. |
| .cancel | Returns ID of the 'cancel' button if specified. |
| .focus | Returns ID of the control that currently has focus. |
| .active | Returns $true if the dialog is active, otherwise $false. |
| .tab | Returns id of tab that is currently displayed. |
| .hwnd | Returns the window handle. |
| .icon | Returns the filename of the icon file. (AdiIRC only) |
| .local | Returns $true if the dialog is a local dialog, otherwise $false. (AdiIRC only) |
| .dbu | Returns $true if the dialog was created with the dbu option, otherwise $false. (AdiIRC only) |
| .default | Returns the id of the "default" button, if defined. (AdiIRC only) |
Example
; Print number of dialogs. //echo -ag $dialog(0) ; Print name of the first dialog. //echo -ag $dialog(1)