/dialog Command - mIRC

mIRC

The /dialog command is used to create a dialog using a given table. The name is what the script/you will use to refer to the table. The standard dialog created using the /dialog command can be used to create model or modeless dialogs. Modeless it does not return a value when the dialog closes. As a result it does not halt the mIRC scripting engine, letting other script to keep processing. Dialogs can be kept open for as you want.

Synopsis[edit]

/dialog -mhbpardievon <name> [table]
/dialog -kcx <name>
/dilaog -g <name> <newName>
/dialog -t <name> [text]
/dialog -s <name> [x y w h]
/dialog -mhbpardievonts <name> [table] [x y w h] [text]

Switches[edit]

Mode:

-m - Modeless dialog
-b - Size Mode: DBU
-p - Size Mode: Pixels
-h - Dialog work with active server connection

Modes Used with -m:

-a - Uses the current window as parent
-d - opens the dialog on the desktop

Modes Used with -d:

-i - Minimize dialog
-e - Restores dialog

Close:

-k - clicks the ok button
-c - clicks the cancel button
-x - closes the dialog without triggering any event

Change:

-t - Sets the dialog's title
-s - Sets the dialog's size [X Y W H]
-o - Sets the dialog on top of all windows
-n - Unset -o
-r - Centers the dialog
-v - Sets the dialog as the active window
-g - Renames dialog <name> <new name>

Parameters[edit]

<name> - Dialog Name
[table] - Table Name
[x y w h] - (x,y) coordinates, width and height
[text] - Text

Example[edit]

Consider:

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
}

Example 1:

;Modeless, Desktop
/dialog -md Example1 Example1

Example 2:

;Change the title of the dialog
/dialog -t Example1 This is Example 2!

Example 3:

;Rename the dialog
/dialog -g Example1 Example3

Example 4:

;Close the dialog, don't trigger any event
/dialog -x Example3

Compatibility[edit]

Added: mIRC v5.5
Added on: 08 Jan 1999
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.