From WikiChip
Editing mirc/dialogs
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
This page supports semantic in-text annotations (e.g. "[[Is specified as::World Heritage Site]]") to build structured and queryable content provided by Semantic MediaWiki. For a comprehensive description on how to use annotations or the #ask parser function, please have a look at the getting started, in-text annotation, or inline queries help pages.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
{{mirc title|Dialogs}} | {{mirc title|Dialogs}} | ||
− | '''Dialogs''' make it possible to create custom dialog windows inside of mIRC. The | + | [[Category:mIRC]] |
+ | |||
+ | '''Dialogs''' make it possible to create custom dialog windows inside of mIRC. The [[/dialog command - mIRC|/dialog command]] is the key way to opening new dialogs, and the [[Dialog components - mIRC|Dialog components]] are the objects within the dialog, such as buttons, labels, etc. | ||
=== What dialogs are === | === What dialogs are === | ||
Line 7: | Line 9: | ||
=== mIRC Dialogs === | === mIRC Dialogs === | ||
− | mIRC dialogs are created by users through custom scripts. Through these dialog interactions, the dialogs adhere to an event listener, the | + | mIRC dialogs are created by users through custom scripts. Through these dialog interactions, the dialogs adhere to an event listener, the [[On dialog - mIRC|ON DIALOG]] event. Through this event, all aspects of the custom dialogs, as well as their controls, can be monitored, tracked, and modified. |
=== Scope === | === Scope === | ||
− | The scope of this article is to generally familiarize users with the term '''dialogs''', and what exactly it is they are used for within mIRC. Since these components are geared towards more advanced scripters, beginners should make sure they have already gone through the preceding tutorials from the | + | The scope of this article is to generally familiarize users with the term '''dialogs''', and what exactly it is they are used for within mIRC. Since these components are geared towards more advanced scripters, beginners should make sure they have already gone through the preceding tutorials from the [[Introduction - mIRC|mIRC Introduction]] page, all the way leading up to '''Dialogs''' |
=== Two types of dialog === | === Two types of dialog === | ||
− | They are two type of | + | They are two type of dialog, modeless dialog and modal dialog, modeless dialog. |
Modals dialog are dialog which block the current script execution, you cannot access others windows, usually used to get a quick user input. | Modals dialog are dialog which block the current script execution, you cannot access others windows, usually used to get a quick user input. | ||
− | mIRC has built-in modals dialog, {{mIRC|$?}}'s | + | mIRC has built-in modals dialog, {{mIRC|$?}}'s famillies and {{mIRC|$input}} are modals dialogs. |
Modeless dialog can be opened indefinitely and does not halt the script execution. | Modeless dialog can be opened indefinitely and does not halt the script execution. | ||
+ | mIRC also has modeless dialog, such as the mIRC Options dialog (alt + o). | ||
==== Modeless dialog ==== | ==== Modeless dialog ==== | ||
Line 57: | Line 60: | ||
<source lang="mIRC">dialog -l <name> { | <source lang="mIRC">dialog -l <name> { | ||
+ | |||
title "text" | title "text" | ||
+ | |||
icon filename, index | icon filename, index | ||
+ | |||
size x y w h | size x y w h | ||
− | option type ( | + | |
+ | option type (dbu, pixels, notheme, disable) | ||
+ | |||
text "text", id, x y w h, style (right, center, nowrap) | text "text", id, x y w h, style (right, center, nowrap) | ||
+ | |||
edit "text", id, x y w h, style (right, center, multi, pass, read, return, hsbar, vsbar, autohs, autovs, limit N, rich) | edit "text", id, x y w h, style (right, center, multi, pass, read, return, hsbar, vsbar, autohs, autovs, limit N, rich) | ||
+ | |||
button "text", id, x y w h, style (default, ok, cancel, flat, multi) | button "text", id, x y w h, style (default, ok, cancel, flat, multi) | ||
+ | |||
check "text", id, x y w h, style (left, push, 3state) | check "text", id, x y w h, style (left, push, 3state) | ||
+ | |||
radio "text", id, x y w h, style (left, push) | radio "text", id, x y w h, style (left, push) | ||
+ | |||
box "text", id, x y w h, style | box "text", id, x y w h, style | ||
+ | |||
scroll "text", id, x y w h, style (top left bottom right horizontal range N N) | scroll "text", id, x y w h, style (top left bottom right horizontal range N N) | ||
+ | |||
list id, x y w h, style (sort, extsel, multsel, size, vsbar, hsbar, check, radio) | list id, x y w h, style (sort, extsel, multsel, size, vsbar, hsbar, check, radio) | ||
+ | |||
combo id, x y w h, style (sort, edit, drop, size, vsbar, hsbar) | combo id, x y w h, style (sort, edit, drop, size, vsbar, hsbar) | ||
+ | |||
icon id, x y w h, filename, index, style (noborder top left bottom right small large actual) | icon id, x y w h, filename, index, style (noborder top left bottom right small large actual) | ||
+ | |||
link "text", id, x y w h | link "text", id, x y w h | ||
+ | |||
tab "text", id, x y w h | tab "text", id, x y w h | ||
+ | |||
tab "text", id | tab "text", id | ||
+ | |||
menu "text", menuid [, menuid] | menu "text", menuid [, menuid] | ||
+ | |||
item "text", id [, menuid] | item "text", id [, menuid] | ||
+ | |||
item break, id [, menuid] | item break, id [, menuid] | ||
+ | |||
}</source> | }</source> | ||
Line 85: | Line 109: | ||
* size - Required, set the size of the dialog, you can use -1 for any of the x, y, w and h parameter to specify a default position, x and y sets as -1 should center the dialog in the window | * size - Required, set the size of the dialog, you can use -1 for any of the x, y, w and h parameter to specify a default position, x and y sets as -1 should center the dialog in the window | ||
* option - Can be used to set different options for the dialog, type is a space seperated list of options: | * option - Can be used to set different options for the dialog, type is a space seperated list of options: | ||
− | + | ** dbu - This option will ensure the dialog looks the same under any size display using dialog base units | |
− | ** dbu - | + | ** pixels - This option is set by default if you don't use the dbu option, it uses simple pixels value to display |
− | ** | + | ** notheme - This option prevents mIRC from applying a your current windows theme to the dialog |
− | ** notheme - This option prevents mIRC from applying your current windows theme to the dialog | ||
** disable - This option can use used to wait a bit before the controls in the dialog can be used, preventing accidents | ** disable - This option can use used to wait a bit before the controls in the dialog can be used, preventing accidents | ||
− | * Others elements are used to create controls, see the | + | * Others elements are used to create controls, see the [[Dialog Components - mIRC|dialog Components page]] |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | You can use a variable name as a style for any control, the variable is set (global variable) with the value of that control when the dialog is closed: | |
− | + | <source lang="mIRC">edit "", 2, 10 10 100 20, autohs %myedit</source> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | <source lang="mIRC"> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | </source> | ||
=== /did command & $did identifier === | === /did command & $did identifier === | ||
Line 133: | Line 123: | ||
The {{mIRC|/did}} command can be used to change the various state of the control while {{mIRC|$did}} can be used to retrieve values and states of controls. | The {{mIRC|/did}} command can be used to change the various state of the control while {{mIRC|$did}} can be used to retrieve values and states of controls. | ||
− | Check the | + | Check the [[Dialog Components - mIRC|dialog Components page]], which describe the usage of the two per control. |
=== Others tools === | === Others tools === | ||
Line 143: | Line 133: | ||
{{mIRC|$didtok}}(name,id,C) returns a tokenized list of item from a combo/edit/list control. | {{mIRC|$didtok}}(name,id,C) returns a tokenized list of item from a combo/edit/list control. | ||
− | {{mIRC|$didwm}}(name,id,wildcard,N) and {{mIRC|$didreg}}(name,id,regex,N) returns the number of the line that match the | + | {{mIRC|$didwm}}(name,id,wildcard,N) and {{mIRC|$didreg}}(name,id,regex,N) returns the number of the line that match the expresion, starting at the optional line N, in the the control. |
==== /loadbuf, /savebuf and /filter ==== | ==== /loadbuf, /savebuf and /filter ==== | ||
Line 152: | Line 142: | ||
== See Also == | == See Also == | ||
− | * | + | * [[Dialog Components - mIRC|Dialog Components]] |
− | * | + | * [[On dialog - mIRC|ON DIALOG Event]] |
− | [[ |