$dialog

From Scriptwiki
Revision as of 13:49, 24 August 2006 by Cail (talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

$dialog

Dialogs created with $dialog() are modal, ie. they halt the script until the dialog is closed, they return a value, and they don't allow access to other windows while the dialog is open. These types of dialogs should only be displayed for immediate user input. The $dialog() identifier works the same way as other identifiers:

 %result = $dialog(name,table[,parent])

Where name is the name by which you'll refer to the dialog, table is the dialog table name used to create dialog (see below), and parent is the parent window of the dialog, this can be a window name, or:
-1 = Desktop window
-2 = Main mIRC window
-3 = Currently active window
-4 = Currently active dialog
if no dialog is open, defaults to -3 behaviour.

Note: This type of dialog cannot be called from a remote script event.

You can also use the $dialog(name/N) identifier to list any open dialogs, where N returns the Nth open dialog. If N is zero, the total number of open dialogs is returned.

$dialog() also supports these properties:

x,y,w,h	returns the size and position of the dialog
cw,ch	returns width and height of client area of dialog
title	returns the title of the dialog
modal	returns $true if the dialog is modal, otherwise $false
table	returns the dialog table that the dialog is using

ok	returns the id of the Ok button if you specified one
cancel	returns the id of the Cancel button if you specified one
result	returns the id of the Result button if you specified one
focus	returns id of control that currently has focus
tab	returns id of tab that is currently displayed
active	returns $true if dialog is the active window, otherwise $false
hwnd	returns dialog window handle