Revision as of 23:26, 22 December 2013

The $dialog() identifier can be used in one of two ways:

1. To create a modal dialog
2. To be used as an identifier in order to get properties for a specific dialog window

Modal vs Modeless

mIRC has the ability to create a special kind of dialog, known as a modal dialog. Modal dialogs can be called from within a script using the $dialog() identifier. These dialogs are special in that they stop a script from continuing until one of the following conditions are met:

1. The dialog is closed
2. The dialog returns a value

Modal dialogs are different among modeless dialogs for a variety of reasons, but the most important ones are:

1. They don't allow users to do anything else in mIRC until their conditions are met.
2. They return information via the $dialog() identifier inside the script.
3. They are generally only used when immediate action is necessary.

Modal dialogs should never be used unless absolutely necessary; they are mainly for critical user input. While modeless dialogs can be executed and navigated away from, or even minimized, it should be noted that modal dialogs do not have these abilities.

Creating A Modal Dialog

We can take a quick look at how to create a modal dialog via the following piece of code:

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

Here we can break down what we are looking at:

• Name - The name you will give to the dialog and use to refer to it later.
• Table - The table name used to create the dialog
• Parent - The parent window of the dialog, this can be a window name or one of the following:

-1 : Desktop window

-2 : Main mIRC window

-3 : Currently active window

-4 : Currently active dialog (Note: If there is no dialog open, this defaults to -3)

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

Use As An Identifier

$dialog(), in use as an identifier, can be used to get information regarding any dialog you specify, and its properties. To get the properties of a dialog you specify, you simply append a period after $dialog() and the property name, such as $dialog(mydialog).title to get the title of the dialog named mydialog. Don't worry, this is all explained further below.

Synopsis

$dialog(<name/N>)[.property]

Name - The name of the dialog you want to reference.

N - If you want to reference a dialog by it's ID number, you would specify the ID number here. If you specify 0, mIRC will return the number of currently open dialogs.

Property - Here is where you would specify the property that you want to retrieve about a specific dialog.

List of Properties

More coming