AdiIRC

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)