_Added in 1.9.0_

*$dialog(name,table,[parent])*

Creates a modal dialog.

*Parameters*

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. (optional)

*Example*

<pre>
; Create a dialog table.
dialog Example {
 title        "Example" 
 size        -1 -1 100 50
 option      dbu
  button "Example 1", 1, 4 10 40 12
}

; Create and open the dialog using 'Example' table.
//noop $dialog(Example, Example)
</pre>

_See also [[/dialog]]._

-----------------------------------------------------------------------------

*$dialog(name|N)*

Returns information about a dialog.

*Parameters*

name|N - Name of the dialog or if N = 0, number of dialogs, otherwise the Nth dialog.

*Properties*

.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]].
.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.

*Example*

<pre>
; Print number of dialogs.
//echo -ag $dialog(0)

; Print name of the first dialog.
//echo -ag $dialog(1)
</pre>