| Latest revision |
Your text |
| Line 1: |
Line 1: |
| − | __NOTOC__{{mirc title|Dialog Components}}
| + | {{mIRC Guide}} |
| | + | |
| | '''Dialog Components''' are individual [[Dialogs - mIRC|dialog]] elements that can be added onto the main dialog window. Below is a list of all the natively provided dialog components in [[mIRC]]. | | '''Dialog Components''' are individual [[Dialogs - mIRC|dialog]] elements that can be added onto the main dialog window. Below is a list of all the natively provided dialog components in [[mIRC]]. |
| | | | |
| − | == Components ==
| + | __NOTOC__ |
| − | {| class="wikitable"
| + | {| style="width: 500px;" |
| − | {| border="0" cellpadding="0" cellspacing="25px" style="background: rgba(0,0,0,.01); border-radius: 6px; box-shadow: 0 0 7px rgba(0,0,0,.17); margin: 0 auto;" | + | | |
| − | |- style="color: rgba(0,0,0,.65);"
| + | {| |
| − | ! Button !! Check !! Toggle !! Text
| + | | |
| − | |-
| + | * [[#Button|Button]] |
| − | | [[File:MIRCdlgButton_n.png|link=#Button|center|135px]]
| + | * [[#Check|Check]] |
| − | || [[File:MIRCdlgCheck_n.png|link=#Check|center|135px]]
| + | * [[#Combo|Combo]] |
| − | || [[File:MIRCdlgToggle_n.png|link=#Check|center|135px]]
| + | * [[#Group|Group]] |
| − | || [[File:MIRCdlgLabel_n.png|link=#Text|center|135px]]
| + | |} |
| − | |- style="color: rgba(0,0,0,.65);"
| + | | |
| − | ! Group Box !! Icon !! Edit !! Scroll
| + | {| |
| − | |-
| + | | |
| − | | [[File:MIRCdlgGroup_n.png|link=#Group_Box|center|135px]]
| + | * [[#Image|Image]] |
| − | || [[File:MIRCdlgImage_n.png|link=#Icon|center|135px]]
| + | * [[#Label|Label]] |
| − | || [[File:MIRCdlgText_n.png|link=#Edit|center|135px]]
| + | * [[#Link|Link]] |
| − | || [[File:MIRCdlgScroll_n.png|link=#Scroll|center|135px]]
| + | * [[#List|List]] |
| − | |- style="color: rgba(0,0,0,.65);"
| + | |} |
| − | ! Link !! Menu !! Radio !! Tab
| + | | |
| − | |-
| + | {| |
| − | | [[File:MIRCdlgLink_n1.png|link=#Link|center|135px]]
| + | | |
| − | || [[File:MIRCdlgMenu_n.png|link=#Menu|135px]]
| + | * [[#Menu|Menu]] |
| − | || [[File:MIRCdlgRadio_n.png|link=#Radio|135px]]
| + | * [[#Radio|Radio]] |
| − | || [[File:MIRCdlgTab_n.png|link=#Tab|135px]]
| + | * [[#Scroll|Scroll]] |
| − | |- style="color: rgba(0,0,0,.65);"
| + | * [[#Tab|Tab]] |
| − | ! List !! Combo
| + | |} |
| − | |-
| + | | |
| − | | [[File:MIRCdlgList_n.png|link=#List|center|135px]]
| + | {| |
| − | || [[File:MIRCdlgCombo_n.png|link=#Combo|center|135px]]
| + | | |
| | + | * [[#Toggle Button|Toggle Button]] |
| | + | * [[#Text|Text]] |
| | + | |} |
| | |} | | |} |
| | | | |
| | + | == Components == |
| | | | |
| − | == Button == | + | === Button === |
| − | The button control is a user interface control that responds to click events. | + | The button control is user interface control that responds to click events. |
| − | | + | ==== Syntax ==== |
| − | === Synopsis === | + | button "<text>", <id>, <x> <y> <width> <height>[, <style>] |
| − | <pre>button "<text>", <id>, <x> <y> <width> <height>[, <style>]</pre>
| + | ==== Styles ==== |
| − | | |
| − | === Styles === | |
| | {| class="wikitable" | | {| class="wikitable" |
| | |- | | |- |
| Line 47: |
Line 50: |
| | | default || Sets the button to be the default button. This causes the button to be selected upon dialog creation. | | | default || Sets the button to be the default button. This causes the button to be selected upon dialog creation. |
| | |- | | |- |
| − | | ok || Sets the button to be the OK button. The OK button closes the dialog and in modal mode returns the return value set. | + | | ok || Sets the button to be the OK button. The OK button closes the dialog and in modal mode returns the return value set. |
| | |- | | |- |
| | | cancel || Closes the dialog as if it was canceled – similar to clicking the X button. | | | cancel || Closes the dialog as if it was canceled – similar to clicking the X button. |
| Line 55: |
Line 58: |
| | | multi || Allows the text in the button to wrap around to multiple lines. | | | multi || Allows the text in the button to wrap around to multiple lines. |
| | |- | | |- |
| − | | disable|| Disables the button. | + | | disable || Disables the button. |
| | |- | | |- |
| | | hide || Makes the button invisible. | | | hide || Makes the button invisible. |
| | |- | | |- |
| − | | result|| In modal mode, returns the text of the button. | + | | result || In modal mode, returns the text of the button. |
| | |} | | |} |
| − | | + | ==== Events ==== |
| − | ==== /did ==== | |
| − | | |
| − | * -f - sets focus on the button
| |
| − | * -t - sets the button as the default button
| |
| − | * -e - enables the button
| |
| − | * -b - disables the button
| |
| − | * -v - makes the button visible
| |
| − | * -h - hides the button
| |
| − | * -r - clears the button's text (caption)
| |
| − | * -a - Adds to the button's text (caption)
| |
| − | | |
| − | ==== $did ====
| |
| − | | |
| − | $did(<name>,<id>)[.property]
| |
| − | | |
| − | Without any property, return the text (caption) of the button, same as the .text property
| |
| − | | |
| − | Properties:
| |
| − | * .text - returns the text of the button (caption)
| |
| − | * .len - returns the length of the button's text (caption)
| |
| − | * .next - returns the id of the next control in order of tab keypress
| |
| − | * .prev - returns the id of the previous control in order of tab keypress
| |
| − | * .visible - returns $true if the button is visible, otherwise $false
| |
| − | * .enabled - returns $true if the button is enabled, otherwise $false
| |
| − | | |
| − | === Events ===
| |
| | {| class="wikitable" | | {| class="wikitable" |
| | |- | | |- |
| − | ! Event !! Description | + | ! Event !! Description |
| | |- | | |- |
| − | | sclick || Triggers upon single click | + | | sclick || Triggers upon a single click |
| | |} | | |} |
| − | | + | ==== Example ==== |
| − | === Example === | + | <source lang="mIRC"> |
| − | <source lang="mIRC">; init alias | + | ; init alias |
| | alias example { | | alias example { |
| | dialog -m example example | | dialog -m example example |
| Line 102: |
Line 79: |
| | ; dialog structure | | ; dialog structure |
| | dialog Example { | | dialog Example { |
| − | title "Example" | + | title "WikiChip - Example" |
| | size -1 -1 100 50 | | size -1 -1 100 50 |
| | option dbu | | option dbu |
| Line 113: |
Line 90: |
| | on *:dialog:example:sclick:1-4:{ | | on *:dialog:example:sclick:1-4:{ |
| | echo -a $did($dname, $did).text is clicked. | | echo -a $did($dname, $did).text is clicked. |
| − | }</source>
| |
| − |
| |
| − | <div style="display: block; text-align: center;">[[File:MIRCdlgButton Example.png]]</div>
| |
| − |
| |
| − | == Check ==
| |
| − | The checkbox control is a user interface element that permits the user to select or deselect an option. The checkbox control is a combination of a check box and a label. The mIRC check control has three states: Checked, Unchecked, and Indeterminate.
| |
| − |
| |
| − | === Synopsis ===
| |
| − | <pre>check "<text>", <id>, <x> <y> <width> <height>[, <style>]</pre>
| |
| − |
| |
| − | === Styles ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Style !! Description
| |
| − | |-
| |
| − | | push || Toggle Button
| |
| − | |-
| |
| − | | left || Places the text on the left side of the control.
| |
| − | |-
| |
| − | | 3state || Enables Indeterminate State.
| |
| − | |-
| |
| − | | multi || Allows the text in the check box to wrap around to multiple lines.
| |
| − | |-
| |
| − | | disable || Disables the check box.
| |
| − | |-
| |
| − | | hide || Makes the check box invisible.
| |
| − | |-
| |
| − | | result || In modal mode, returns the text of the check box.
| |
| − | |}
| |
| − |
| |
| − | ==== /did ====
| |
| − |
| |
| − | * -f - sets focus on the checkbox
| |
| − | * -t - sets the checkbox as the default control
| |
| − | * -e - enables the checkbox
| |
| − | * -b - disables the checkbox
| |
| − | * -v - makes the checkbox visible
| |
| − | * -h - hides the checkbox
| |
| − | * -c - mark the checkbox as checked
| |
| − | * -u - mark the checkbox as unchecked, if you use -cu, it marks a 3dstate checkbox as indeterminate.
| |
| − | * -r - clear the text of the checkbox (caption)
| |
| − | * -a - adds text to the text of the checkbox (caption)
| |
| − |
| |
| − | ==== $did ====
| |
| − |
| |
| − | $did(<name>,<id>)[.property]
| |
| − |
| |
| − | Without any property, returns the text (caption) of the checkbox, same as the .text property
| |
| − |
| |
| − | Properties:
| |
| − |
| |
| − | * .text - returns the text (caption) of the checkbox line or Nth line
| |
| − | * .len - returns the length of the text of the checkbox (caption)
| |
| − | * .state - returns the state of the checkboxes, 0 = unchecked, 1 = checked, 2 = indeterminate (for 3stage checkboxes)
| |
| − | * .next - returns the id of the next control in order of tab keypress
| |
| − | * .prev - returns the id of the previous control in order of tab keypress
| |
| − | * .visible - returns $true if the checkbox is visible, otherwise $false
| |
| − | * .enabled - returns $true if the checkbox is enabled, otherwise $false
| |
| − |
| |
| − | === Events ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Event !! Description
| |
| − | |-
| |
| − | | sclick || Triggers upon single click
| |
| − | |}
| |
| − |
| |
| − | === Example ===
| |
| − | <source lang="mIRC">; init alias
| |
| − | alias example {
| |
| − | dialog -m example example
| |
| − | }
| |
| − | ; dialog structure
| |
| − | dialog Example {
| |
| − | title "Example"
| |
| − | size -1 -1 100 50
| |
| − | option dbu
| |
| − | check "Example 1", 1, 4 10 40 12, 3state
| |
| − | check "Example 2", 2, 50 10 40 12
| |
| − | check "Example 3", 3, 4 30 40 12
| |
| − | button "Done", 4, 50 30 40 12, ok
| |
| | } | | } |
| − | ; events
| + | </source> |
| − | on *:dialog:example:init:0:{
| |
| − | did -cu $dname 1
| |
| − | did -c $dname 2
| |
| − | }
| |
| − | on *:dialog:example:sclick:1-3:{
| |
| − | echo -a $did($dname, $did).text is clicked. $&
| |
| − | State: $dstate $+ .
| |
| − | }
| |
| − | alias -l dstate {
| |
| − | var %s UnChecked Checked Indeterminate
| |
| − | return $gettok(%s, $calc($did($dname, $did).state + 1), 32)
| |
| − | }</source>
| |
| − | <div style="display: block; text-align: center;">[[File:MIRCdlgCheck Example.png]]</div>
| |
| − | | |
| − | | |
| − | == Text ==
| |
| − | A text is simply a [[GUI]] label component with text designed for displaying information with no user input. By default, the text will wrap to the next line if needed.
| |
| − | | |
| − | === Synopsis ===
| |
| − | <pre>text "<text>", <id>, <x> <y> <width> <height>[, <style>]</pre>
| |
| − | | |
| − | === Styles ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Style !! Description
| |
| − | |-
| |
| − | | nowrap || Prevents the text from wrapping. Any text that does not fit will simply be cut off.
| |
| − | |-
| |
| − | | center || Centers the text in the label.
| |
| − | |-
| |
| − | | right || Right-aligned the text in the label.
| |
| − | |-
| |
| − | | disable || Disables the label. (grays it out)
| |
| − | |-
| |
| − | | hide|| Makes the label invisible.
| |
| − | |-
| |
| − | | result|| In modal mode, returns the text of the label.
| |
| − | |}
| |
| − | | |
| − | ==== /did ====
| |
| − | * '''-f''' - sets focus on the text control
| |
| − | * '''-e''' - enable the text control
| |
| − | * '''-b''' - disable the text control
| |
| − | * '''-v''' - make the text control visible
| |
| − | * '''-h''' - hide the text control
| |
| − | * '''-r''' - clears the text of the text control
| |
| − | * '''-a''' - adds text to the text control
| |
| − | | |
| − | ==== $did ====
| |
| − | | |
| − | $did(<name>,<id>)[.property]
| |
| − | | |
| − | Without any property, return the text (caption) of the text control, same as the .text property
| |
| − | | |
| − | Properties:
| |
| − | * .text - returns the text of the text control (caption)
| |
| − | * .len - returns the length of the text of the text control (caption)
| |
| − | * .next - returns the id of the next control in order of tab keypress
| |
| − | * .prev - returns the id of the previous control in order of tab keypress
| |
| − | * .visible - returns $true if the text control is visible, otherwise $false
| |
| − | * .enabled - returns $true if the text control is enabled, otherwise $false
| |
| − | | |
| − | === Events ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Event !! Description
| |
| − | |-
| |
| − | | sclick || Triggers upon single click
| |
| − | |}
| |
| | | | |
| − | === Example === | + | === Check === |
| − | <source lang="mIRC">; init alias
| + | The checkbox control is user interface element that permits the user to select or unselect an option. The checkbox control is a combination of a check box and a label. The mIRC check control has three states: Checked, Unchecked, and Indeterminate. |
| − | alias example {
| + | ==== Syntax ==== |
| − | dialog -m example example
| + | check "<text>", <id>, <x> <y> <width> <height>[, <style>] |
| − | }
| |
| − | ; dialog structure
| |
| − | dialog Example {
| |
| − | title "Example"
| |
| − | size -1 -1 100 70
| |
| − | option dbu
| |
| − | text "This label does not wrap.", 1, 4 10 40 15, nowrap
| |
| − | text "This is a simple label.", 2, 4 30 40 15
| |
| − | text "I am right-aligned.", 3, 4 50 40 15, right
| |
| − | button "Done", 4, 50 30 40 12, ok
| |
| − | }</source>
| |
| − | <div style="display: block; text-align: center;">[[File:MIRCdlgLabel Example.png]]</div> | |
| | | | |
| | + | === Combo === |
| | + | The combo control provides a way choose an item from a selection of item in either a list of drop-down fashion. |
| | + | ==== Syntax ==== |
| | + | combo <id>, <x> <y> <width> <height>[, <style>] |
| | | | |
| − | == Group Box == | + | === Group === |
| | This is a static control with a group box frame and an optional title that shows up at the top of the frame. | | This is a static control with a group box frame and an optional title that shows up at the top of the frame. |
| | + | ==== Syntax ==== |
| | + | box "<title>", <id>, <x> <y> <width> <height>[, <style>] |
| | | | |
| − | '''Note:''' This only displays the group box but does not actually group the controls that you position within it.
| + | === Image === |
| − | If you want to e.g. enable / disable them together, you need to do that programmatically.
| + | A image control is a simple container that holes images and icons. |
| − | | + | ==== Syntax ==== |
| − | === Synopsis === | + | icon <id>, <x> <y> <width> <height>[, <filename>[, <index>]], <style> |
| − | <pre>box "<title>", <id>, <x> <y> <width> <height>[, <style>]</pre>
| |
| | | | |
| − | === Styles === | + | === Label === |
| − | {| class="wikitable"
| + | A label is simply a gui component with text designed for displaying information with no user input. By default, the text will wrap to the next line if needed. |
| − | |-
| + | ==== Syntax ==== |
| − | ! Style !! Description
| + | text "<text>", <id>, <x> <y> <width> <height>[, <style>] |
| − | |-
| |
| − | | disable || Disables the group box.
| |
| − | |-
| |
| − | | hide || Makes the group box invisible.
| |
| − | |-
| |
| − | | result || In modal mode, returns the text of the button.
| |
| − | |-
| |
| − | | left || Put the title on the left
| |
| − | |-
| |
| − | | center || Put the title in the center
| |
| − | |-
| |
| − | | right || Put the title on the right
| |
| − | |-
| |
| − | |}
| |
| | | | |
| − | ==== /did ==== | + | === Link === |
| | + | A link control, just like a label, is a static control with the additional behavior that when clicked opens the URL in the default web browser. |
| | + | ==== Syntax ==== |
| | + | link "<URL>", <id>, <x> <y> <width> <height>[, <style>] |
| | | | |
| − | * -f - set focus on the box
| + | === List === |
| − | * -e - enable the box
| + | The list control provides a way to display a list of items. |
| − | * -b - disable the box
| + | ==== Syntax ==== |
| − | * -v - make the box visible
| + | list <id>, <x> <y> <width> <height>[, <style>] |
| − | * -h - hide the box
| |
| − | * -r - clear the box's text (caption)
| |
| − | * -a - Adds to the box's text (caption)
| |
| | | | |
| − | ==== $did ==== | + | === Menu === |
| | + | A menu control that allows a hierarchal organization of elements called menu items. |
| | + | ==== Syntax ==== |
| | + | menu "<text>", <menuid> [, <menuid>] |
| | + | item "<text>", <id [, <menuid>] |
| | + | item break, <id [, <menuid>] |
| | | | |
| − | $did(<name>,<id>)[.property]
| + | === Radio === |
| | + | Radio buttons are a group of controls that allow the user to choose only one of a predefined set of options. |
| | + | ==== Syntax ==== |
| | + | radio "<text>", <id>, <x> <y> <width> <height>[, <style> [group]] |
| | | | |
| − | Without any property, return the text (caption) of the box, same as the .text property
| + | === Scroll === |
| | + | A scrollbar is a simple component that can be used to scroll something. A scrollbar operates within a given range. |
| | + | ==== Syntax ==== |
| | + | scroll "<text>", <id>, <x> <y> <width> <height>, <style> |
| | | | |
| − | Properties:
| + | === Tab === |
| − | * .text - returns the text of the box (caption)
| + | A tab control is a container component capable of holding all the other components inside it. A tab control can have multiple tabs, each can store another set of controls. |
| − | * .len - returns the length of the box's text (caption)
| + | ==== Syntax ==== |
| − | * .next - returns the id of the next control in order of tab keypress
| + | tab "<text>", <id>, <x> <y> <width> <height>, <style> |
| − | * .prev - returns the id of the previous control in order of tab keypress
| + | tab "<text>", <id>, <style> |
| − | * .visible - returns $true if the box is visible, otherwise $false
| |
| − | * .enabled - returns $true if the box is enabled, otherwise $false
| |
| | | | |
| − | === Events === | + | === Toggle Button === |
| − | This control has no events.
| + | A toggle button is specialized button control which has the ability to be selected. Like a checkbox control it has a checked and an unchecked state. A toggle button cannot have a third state. |
| | + | ==== Syntax ==== |
| | + | check "<text>", <id>, <x> <y> <width> <height>, push[ <style>] |
| | | | |
| − | === Example === | + | === Text === |
| − | <source lang="mIRC">; init alias
| |
| − | alias example {
| |
| − | dialog -m example example
| |
| − | }
| |
| − | ; dialog structure
| |
| − | dialog Example {
| |
| − | title "Example"
| |
| − | size -1 -1 90 120
| |
| − | option dbu
| |
| − | box "A Settings", 1, 4 4 80 40
| |
| − | box "B Settings", 2, 4 50 80 40
| |
| − | button "Done", 4, 40 100 40 12, ok
| |
| − | }</source>
| |
| − | <div style="display: block; text-align: center;">[[File:MIRCdlgGroup Example.png]]</div>
| |
| − | | |
| − | | |
| − | == Icon ==
| |
| − | An icon control is a simple container that holds images and icons.
| |
| − | | |
| − | '''Note''': You cannot make an empty icon control, you must give a filename.
| |
| − | | |
| − | === Synopsis ===
| |
| − | <pre>icon <id>, <x> <y> <width> <height>[, <filename>[, <index>]], <style></pre>
| |
| − | | |
| − | === Styles ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Style !! Description
| |
| − | |-
| |
| − | | disabled || Prevents the image from being shown. Frame might still show on some themes.
| |
| − | |-
| |
| − | | hide || Hides the image.
| |
| − | |-
| |
| − | | noborder || Hide the border around the image.
| |
| − | |-
| |
| − | | top || Aligns the image with the top of the container. Only applies if the image size is smaller than the container.
| |
| − | |-
| |
| − | | left || Aligns the image with the left of the container. Only applies if the image size is smaller than the container.
| |
| − | |-
| |
| − | | bottom || Aligns the image with the bottom of the container. Only applies if the image size is smaller than the container.
| |
| − | |-
| |
| − | | right || Aligns the image with the right of the container. Only applies if the image size is smaller than the container.
| |
| − | |-
| |
| − | | small || Use small factor image size.
| |
| − | |-
| |
| − | | large || Use large factor image size.
| |
| − | |-
| |
| − | | actual || Use actual factor image size.
| |
| − | |}
| |
| − | | |
| − | ==== /did ====
| |
| − | | |
| − | * -f - sets focus on the icon
| |
| − | * -e - enables the button
| |
| − | * -b - disables the button
| |
| − | * -v - makes the button visible
| |
| − | * -h - hides the button
| |
| − | * -g - sets a new icon/bmp to an icon control, /did -g <name> <id> [n] <filename> where [n] is the optional index for the icon in the file
| |
| − | | |
| − | ==== $did ====
| |
| − | | |
| − | $did(<name>,<id>)<.property>
| |
| − | | |
| − | Properties:
| |
| − | * .next - returns the id of the next control in order of tab keypress
| |
| − | * .prev - returns the id of the previous control in order of tab keypress
| |
| − | * .visible - returns $true if the icon is visible, otherwise $false
| |
| − | * .enabled - returns $true if the icon is enabled, otherwise $false
| |
| − | | |
| − | === Events ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Event !! Description
| |
| − | |-
| |
| − | | mouse || Triggers when a mouse moves over the image.
| |
| − | |-
| |
| − | | sclick || Triggers upon a left mouse click on the image.
| |
| − | |-
| |
| − | | uclick || Triggers upon a release of the left mouse click.
| |
| − | |-
| |
| − | | dclick || Triggers upon a double left mouse click.
| |
| − | |-
| |
| − | | rclick || Triggers upon a right mouse click on the image.
| |
| − | |-
| |
| − | | drop || Triggers upon a drop click on the image.
| |
| − | |}
| |
| − | | |
| − | === Example ===
| |
| − | <source lang="mIRC">; init alias
| |
| − | alias example {
| |
| − | dialog -m example example
| |
| − | }
| |
| − | ; dialog structure
| |
| − | dialog Example {
| |
| − | title "Example"
| |
| − | size -1 -1 100 110
| |
| − | option dbu
| |
| − |
| |
| − | icon 1, 10 10 80 80, "C:\Users\Public\Pictures\Sample Pictures\Penguins.jpg", actual
| |
| − |
| |
| − | button "Done", 7, 10 95 40 12, ok
| |
| − | }</source>
| |
| − | <div style="display: block; text-align: center;">[[File:MIRCdlgImage Example.png]]</div>
| |
| − | | |
| − | == Edit ==
| |
| | The edit control can behave as a normal text box as well as a rich text control. | | The edit control can behave as a normal text box as well as a rich text control. |
| | + | ==== Syntax ==== |
| | + | edit "<text>", <id>, <x> <y> <width> <height>[, <style>] |
| | | | |
| − | === Synopsis ===
| + | [[Category:mIRC]] |
| − | <pre>edit "<text>", <id>, <x> <y> <width> <height>[, <style>]</pre>
| |
| − | | |
| − | === Styles ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Style !! Description
| |
| − | |-
| |
| − | | disabled || Disables the text control.
| |
| − | |-
| |
| − | | read || Sets the control to read-only.
| |
| − | |-
| |
| − | | pass || Treats the textbox as a password field. Stars-out the text.
| |
| − | |-
| |
| − | | hide || Hides the text control.
| |
| − | |-
| |
| − | | right || Right aligns the text.
| |
| − | |-
| |
| − | | center || Center aligns the text.
| |
| − | |-
| |
| − | | multi || Allows the text to span multiple lines.
| |
| − | |-
| |
| − | | hsbar || Always show the horizontal scrollbar.
| |
| − | |-
| |
| − | | autohs || Show the horizontal scrollbar automatically when needed.
| |
| − | |-
| |
| − | | vsbar || Allows show the vertical scrollbar.
| |
| − | |-
| |
| − | | autovs || Show the vertical scrollbar automatically when needed.
| |
| − | |-
| |
| − | | rich || Creates a rich-edit control instead of the normal text control.
| |
| − | |-
| |
| − | | return || Accepts the return key. Allowing the user to create a new line.
| |
| − | |-
| |
| − | | limit N || Limits the text to N characters.
| |
| − | |}
| |
| − | | |
| − | ==== /did ====
| |
| − | | |
| − | * -f - set focus on the editbox
| |
| − | * -e - enable the editbox
| |
| − | * -b - disable the editbox
| |
| − | * -v - make the editbox visible
| |
| − | * -h - hide the editbox
| |
| − | * -r - clear the edit's text
| |
| − | * -a - Adds to the editbox's text. You can use $crlf if the editbox has 'multi' style to add a newline.
| |
| − | * -n - enables the editbox
| |
| − | * -m - disables editbox
| |
| − | * -c - sets the selected text in the editbox, /did -c <name> <id> <line> [[n [n2]], set the selection on line <line>, where n and n2 represent the start/end position of the selection in the line
| |
| − | * -d - if you used the 'multi' style, deletes the Nth line in the editbox
| |
| − | * -i - inserts the text on the Nth line of the editbox (if you are not using the 'multi' style, it overwrites everything)
| |
| − | * -o - overwrite the Nth line (if you are not using the 'multi' style, it overwrite everything) in the editbox
| |
| − | * -j - resets the edited setting of the editbox
| |
| − | | |
| − | ==== $did ====
| |
| − | | |
| − | $did(<name>,<id>,[N])[.property]
| |
| − | | |
| − | Without any property, return the text (caption) of the editbox, same as the .text property
| |
| − | | |
| − | Properties:
| |
| − | * .text - returns the text of the editbox or the Nth line if the 'multi' style has been used (caption)
| |
| − | * .len - returns the length of the editbox's text (caption)
| |
| − | * .lines - returns the number of lines in the editbox
| |
| − | * .sel - If N is non-zero, returns the line number of the starting position of selection
| |
| − | * .seltext - returns the selected text in the editbox
| |
| − | * .selstart - returns the position of the start of the selection in the editbox
| |
| − | * .selend - returns the position of the end of the selection in the editbox
| |
| − | * .edited - returns $true if the content of the editbox was changed
| |
| − | * .next - returns the id of the next control in order of tab keypress
| |
| − | * .prev - returns the id of the previous control in order of tab keypress
| |
| − | * .visible - returns $true if the button is visible, otherwise $false
| |
| − | * .enabled - returns $true if the button is enabled, otherwise $false
| |
| − | | |
| − | === Events ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Event !! Description
| |
| − | |-
| |
| − | | mouse|| Triggers when a mouse moves over the text.
| |
| − | |-
| |
| − | | edit|| Triggers when the text has changed/edited.
| |
| − | |}
| |
| − | | |
| − | === Example ===
| |
| − | <source lang="mIRC">; init alias
| |
| − | alias example {
| |
| − | dialog -m example example
| |
| − | }
| |
| − | ; dialog structure
| |
| − | dialog Example {
| |
| − | title "Example"
| |
| − | size -1 -1 100 110
| |
| − | option dbu
| |
| − |
| |
| − | edit "Left", 1, 10 10 80 20,
| |
| − | edit "Center", 2, 10 40 80 20, center
| |
| − | edit "Right", 3, 10 70 80 20, right
| |
| − |
| |
| − | button "Done", 7, 10 95 40 12, ok
| |
| − | }</source>
| |
| − | <div style="display: block; text-align: center;">[[File:MIRCdlgText Example.png]]</div>
| |
| − | | |
| − | | |
| − | == Scroll ==
| |
| − | A scrollbar is a simple dialog component that can be used to scroll something. A scrollbar operates within a given range.
| |
| − | | |
| − | === Synopsis ===
| |
| − | <pre>scroll "<text>", <id>, <x> <y> <width> <height>, <style></pre>
| |
| − | | |
| − | === Styles ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Style !! Description
| |
| − | |-
| |
| − | | left || Positions the scrollbar at the left side of the rectangular area specified.
| |
| − | |-
| |
| − | | right || Positions the scrollbar at the right side of the rectangular area specified.
| |
| − | |-
| |
| − | | top || Positions the scrollbar at the top side of the rectangular area specified.
| |
| − | |-
| |
| − | | bottom || Positions the scrollbar at the bottom side of the rectangular area specified.
| |
| − | |-
| |
| − | | horizontal || Creates a horizontal scrollbar instead of a vertical one.
| |
| − | |-
| |
| − | | range || Sets the range of the scrollbar, Syntax: range <low> <high>.
| |
| − | |}
| |
| − | | |
| − | ==== /did ====
| |
| − | * '''-f''' - sets focus on the scrollbar
| |
| − | * '''-e''' - enables the scrollbar
| |
| − | * '''-b''' - disables the scrollbar
| |
| − | * '''-v''' - makes the scrollbar visible
| |
| − | * '''-h''' - hides the scrollbar
| |
| − | * '''-z''' - Sets the range of the scrollbar, /did -z <name> <id> [n [n2]]
| |
| − | | |
| − | ==== $did ====
| |
| − | | |
| − | $did(<name>,<id>)<.property>
| |
| − | | |
| − | Properties:
| |
| − | * .sel - returns the value of the current position of the scrollbar
| |
| − | * .lines - returns the current maximum value used for the range
| |
| − | * .next - returns the id of the next control in order of tab keypress
| |
| − | * .prev - returns the id of the previous control in order of tab keypress
| |
| − | * .visible - returns $true if the button is visible, otherwise $false
| |
| − | * .enabled - returns $true if the button is enabled, otherwise $false
| |
| − | | |
| − | === Events ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Event !! Description
| |
| − | |-
| |
| − | | scroll || Triggers upon a scrollbar value change only.
| |
| − | |}
| |
| − | | |
| − | === Example ===
| |
| − | <source lang="mIRC">; init alias
| |
| − | alias example {
| |
| − | dialog -m example example
| |
| − | }
| |
| − | ; dialog structure
| |
| − | dialog Example {
| |
| − | title "Example"
| |
| − | size -1 -1 90 65
| |
| − | option dbu
| |
| − |
| |
| − | text "0%", 1, 30 20 20 20
| |
| − | scroll , 2, 60 5 5 40, range 0 100
| |
| − |
| |
| − | button "Done", 13, 25 50 40 12, ok
| |
| − | }
| |
| − | on *:dialog:example:scroll:2:{
| |
| − | did -ra example 1 $did(example, 2).sel $+ %
| |
| − | }</source>
| |
| − | <div style="display: block; text-align: center;">[[File:MIRCdlgScroll Example.png]]</div>
| |
| − | | |
| − | | |
| − | == Link ==
| |
| − | A link control, just like a label, is a static control with the additional behavior that, when you put your mouse over the control, the cursor because a little hand, indicating you can interact with that link, usually to open an URL.
| |
| − | | |
| − | To make the link actually open the web page, you need to code an ON DIALOG SCLICK event.
| |
| − | | |
| − | === Synopsis ===
| |
| − | <pre>link "text", <id>, <x> <y> <width> <height>[, <style>]</pre>
| |
| − | | |
| − | === Styles ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Style !! Description
| |
| − | |-
| |
| − | | disable || Disables the link. (grays it out)
| |
| − | |-
| |
| − | | hide || Makes the link invisible.
| |
| − | |-
| |
| − | | result || In modal mode, returns the URL.
| |
| − | |}
| |
| − | | |
| − | ==== /did ====
| |
| − | * '''-f''' - sets focus on the link control
| |
| − | * '''-e''' - enables the link
| |
| − | * '''-b''' - disables the link
| |
| − | * '''-v''' - makes the link visible
| |
| − | * '''-h''' - hides the link
| |
| − | * '''-a''' - Adds text to the link's text (caption)
| |
| − | * '''-r''' - Deletes the text (caption) of the link
| |
| − | | |
| − | ==== $did ====
| |
| − | | |
| − | $did(<name>,<id>)[.property]
| |
| − | | |
| − | Without any property, return the text (caption) of the link, same as the .text property
| |
| − | | |
| − | Properties:
| |
| − | * .text - returns the text (caption) of the link control
| |
| − | * .next - returns the id of the next control in order of tab keypress
| |
| − | * .prev - returns the id of the previous control in order of tab keypress
| |
| − | * .visible - returns $true if the button is visible, otherwise $false
| |
| − | * .enabled - returns $true if the button is enabled, otherwise $false
| |
| − | | |
| − | === Events ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Event !! Description
| |
| − | |-
| |
| − | | sclick || Triggers upon single click
| |
| − | |-
| |
| − | | dclick || Triggers upon double click
| |
| − | |}
| |
| − | | |
| − | === Example ===
| |
| − | <source lang="mIRC">; init alias
| |
| − | alias example {
| |
| − | dialog -m example example
| |
| − | }
| |
| − | ; dialog structure
| |
| − | dialog Example {
| |
| − | title "Example"
| |
| − | size -1 -1 100 50
| |
| − | option dbu
| |
| − | link "http://www.wikichip.org/", 1, 4 10 80 12
| |
| − | button "Done", 4, 50 30 40 12, ok
| |
| − | }
| |
| − | ; click event
| |
| − | on *:dialog:example:sclick:1: url -a $did(example,$did)</source>
| |
| − | <div style="display: block; text-align: center;">[[File:MIRCdlgLink Example.png]]</div>
| |
| − | | |
| − | == Menu ==
| |
| − | A menu control that allows a hierarchical organization of elements called menu items.
| |
| − | | |
| − | === Synopsis ===
| |
| − | <pre>menu "<text>", <menuid> [, <menuid>]
| |
| − | item "<text>", <id [, <menuid>]
| |
| − | item break, <id [, <menuid>]</pre>
| |
| − | | |
| − | '''Note:''' Menu items can nest under other menus by simply specifying their parent menu ID.
| |
| − | | |
| − | === Styles ===
| |
| − | This element has no available styles.
| |
| − | | |
| − | === Events ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Event !! Description
| |
| − | |-
| |
| − | | menu || Triggers upon menu click
| |
| − | |}
| |
| − | | |
| − | ==== /did ====
| |
| − | * '''-e''' - enables the menu/item
| |
| − | * '''-b''' - disables the menu/item
| |
| − | * '''-v''' - makes the menu/item visible
| |
| − | * '''-h''' - hides the menu/item
| |
| − | * '''-a''' - Adds an item to a menu, /did -a <name> <menuid> <newid> <text>
| |
| − | * '''-i''' - Inserts an item to a menu before the item identified by the specified <id>, /did -i <name> <id> <newid> <text>
| |
| − | * '''-d''' - Deletes the item from the menu, /did -d <name> <id>
| |
| − | | |
| − | ==== $did ====
| |
| − | | |
| − | No $did support for a menu or an item.
| |
| − | | |
| − | === Example ===
| |
| − | <source lang="mIRC">; init alias
| |
| − | alias example {
| |
| − | dialog -m example example
| |
| − | }
| |
| − | ; dialog structure
| |
| − | dialog Example {
| |
| − | title "Example"
| |
| − | size -1 -1 100 110
| |
| − | option dbu
| |
| − |
| |
| − | menu "&File", 1
| |
| − | item "&New", 11, 1
| |
| − | item "&Open...", 12, 1
| |
| − | item "&Save", 13, 1
| |
| − | item "Save &As...", 14, 1
| |
| − | menu "&Edit", 2
| |
| − | item "Some Item1", 21, 2
| |
| − | item break, 22, 2
| |
| − | item "Some Item2", 23, 2
| |
| − | menu "&View", 3
| |
| − | item "Some Item3", 31, 3
| |
| − | item break, 32, 3
| |
| − | item "Some Item4", 33, 3
| |
| − | menu "&Help", 4
| |
| − | item "Some Item5", 41, 4
| |
| − | item break, 42, 4
| |
| − | item "Some Item6", 43, 4
| |
| − |
| |
| − | button "Done", 7, 10 95 40 12, ok
| |
| − | }</source>
| |
| − | <div style="display: block; text-align: center;">[[File:MIRCdlgMenu Example.png]]</div>
| |
| − | | |
| − | | |
| − | == Radio ==
| |
| − | Radio buttons are a group of controls that can be configured to only allow the user to choose one of a predefined set of options.
| |
| − | | |
| − | === Synopsis ===
| |
| − | <pre>radio "<text>", <id>, <x> <y> <width> <height>[, <style> [group]]</pre>
| |
| − | | |
| − | === Styles ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Style !! Description
| |
| − | |-
| |
| − | | left || Places the text on the left side of the control.
| |
| − | |-
| |
| − | | push || Creates a radio button in the form of normal buttons.
| |
| − | |-
| |
| − | | disable || Disables the button.
| |
| − | |-
| |
| − | | hide || Makes the button invisible.
| |
| − | |-
| |
| − | | result || In modal mode, returns the text of the button.
| |
| − | |-
| |
| − | | group || Identifies the first radio button in a group of severals radio buttons, only one can be checked at a time.
| |
| − | |}
| |
| − | | |
| − | ==== /did ====
| |
| − | | |
| − | * -f - sets focus on the radio
| |
| − | * -t - sets the radio as the default control
| |
| − | * -e - enables the radio
| |
| − | * -b - disables the radio
| |
| − | * -v - makes the radio visible
| |
| − | * -h - hides the radio
| |
| − | * -c - mark the radio as checked
| |
| − | * -u - mark the checkboradio as unchecked
| |
| − | * -r - clear the text of the radio (caption)
| |
| − | * -a - adds text to the text of the radio (caption)
| |
| − | | |
| − | ==== $did ====
| |
| − | | |
| − | $did(<name>,<id>)[.property]
| |
| − | | |
| − | Without any property, returns the text (caption) of the radio, same as the .text property
| |
| − | | |
| − | Properties:
| |
| − | | |
| − | * .text - returns the text (caption) of the radio line or Nth line
| |
| − | * .len - returns the length of the text of the radio (caption)
| |
| − | * .state - returns the state of the radio, 0 = unchecked, 1 = checked
| |
| − | * .next - returns the id of the next control in order of tab keypress
| |
| − | * .prev - returns the id of the previous control in order of tab keypress
| |
| − | * .visible - returns $true if the radio is visible, otherwise $false
| |
| − | * .enabled - returns $true if the radio is enabled, otherwise $false
| |
| − | | |
| − | === Events ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Event !! Description
| |
| − | |-
| |
| − | | sclick || Triggers upon single click
| |
| − | |}
| |
| − | | |
| − | === Example ===
| |
| − | <source lang="mIRC">; init alias
| |
| − | alias example {
| |
| − | dialog -m example example
| |
| − | }
| |
| − | ; dialog structure
| |
| − | dialog Example {
| |
| − | title "Example"
| |
| − | size -1 -1 90 80
| |
| − | option dbu
| |
| − |
| |
| − | ; 1st group
| |
| − | text "Sex:", 1, 4 4 10 10
| |
| − | radio "Male", 2, 4 13 20 10, group
| |
| − | radio "Female", 3, 30 13 30 10
| |
| − |
| |
| − | ; 2nd group
| |
| − | text "Marital Status:", 4, 4 25 50 10
| |
| − | radio "Single", 5, 4 33 22 10, group left
| |
| − | radio "Married", 6, 30 33 25 10, left
| |
| − | radio "Other", 7, 60 33 22 10, left
| |
| − |
| |
| − | ; 3rd group
| |
| − | text "Favorite Color:", 8, 4 45 50 10
| |
| − | radio "Red", 9, 4 55 20 10, group push
| |
| − | radio "Green", 10, 25 55 20 10, push
| |
| − | radio "Blue", 11, 46 55 20 10, push
| |
| − | radio "Other", 12, 67 55 20 10, push
| |
| − | button "Done", 13, 40 68 40 12, ok
| |
| − | }</source>
| |
| − | <div style="display: block; text-align: center;">[[File:MIRCdlgRadio Example.png]]</div>
| |
| − | | |
| − | | |
| − | == Tab ==
| |
| − | A tab control is a container component capable of holding all of the other components. A tab control can have multiple tabs, and each tab can store another set of controls.
| |
| − | | |
| − | '''Note''': You cannot have more than one tab control per dialog with mIRC
| |
| − | | |
| − | === Synopsis ===
| |
| − | <pre>tab "<text>", <id>, <x> <y> <width> <height>, <style>
| |
| − | tab "<text>", <id>, <style></pre>
| |
| − | | |
| − | The first tab definition in the synopsis specifies the main tab control and its size, the other definition adds an item to the tab
| |
| − | | |
| − | To add a control to a tab item, specify the "tab <id>" style for the control, where <id> is the id of that tab item
| |
| − | | |
| − | === Styles ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Style !! Description
| |
| − | |-
| |
| − | | disable || Disables all the controls inside the specified tab.
| |
| − | |}
| |
| − | | |
| − | ==== /did ====
| |
| − | | |
| − | * -f - sets focus on the tab
| |
| − | * -e - enables the tab
| |
| − | * -b - disables the tab
| |
| − | * -v - makes the tab visible
| |
| − | * -h - hides the tab
| |
| − | * -r - clears the text of the tab item (caption)
| |
| − | * -a - adds to the text of the tab item (caption)
| |
| − | | |
| − | ==== $did ====
| |
| − | | |
| − | $did(<name>,<id>)[.property]
| |
| − | | |
| − | Without any property, returns the text (caption) of the radio, same as the .text property
| |
| − | | |
| − | Properties:
| |
| − | | |
| − | * .text - returns the text (caption) of the tab item
| |
| − | * .len - returns the length of the text of the tab item (caption)
| |
| − | * .next - returns the id of the next control in order of tab keypress
| |
| − | * .prev - returns the id of the previous control in order of tab keypress
| |
| − | * .visible - returns $true if the tab is visible, otherwise $false
| |
| − | * .enabled - returns $true if the tab is enabled, otherwise $false
| |
| − | | |
| − | ==== $dialog ====
| |
| − | | |
| − | You can use $dialog(<name>).tab to know which tab is currently selected, returns the Nth tab number
| |
| − | | |
| − | === Events ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Event !! Description
| |
| − | |-
| |
| − | | sclick || Triggers upon single click
| |
| − | |}
| |
| − | | |
| − | === Example ===
| |
| − | <source lang="mIRC">; init alias
| |
| − | alias example {
| |
| − | dialog -m example example
| |
| − | }
| |
| − | ; dialog structure
| |
| − | dialog Example {
| |
| − | title "Example"
| |
| − | size -1 -1 100 110
| |
| − | option dbu
| |
| − |
| |
| − | tab "Tab 1", 1, 10 10 80 80
| |
| − | tab "Tab 2", 2
| |
| − | tab "Tab 3", 3
| |
| − |
| |
| − | button "111", 4, 20 30 40 40, tab 1
| |
| − | button "222", 5, 20 30 40 40, tab 2
| |
| − | button "333", 6, 20 30 40 40, tab 3
| |
| − |
| |
| − | button "Done", 7, 10 95 40 12, ok
| |
| − | }</source>
| |
| − | <div style="display: block; text-align: center;">[[File:MIRCdlgTab Example.png]]</div>
| |
| − | | |
| − | == List ==
| |
| − | The list control provides a way to display a list of items.
| |
| − | | |
| − | === Synopsis ===
| |
| − | <pre>list <id>, <x> <y> <width> <height>[, <style>]</pre>
| |
| − | | |
| − | === Styles ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Style !! Description
| |
| − | |-
| |
| − | | disable || Disables the list control.
| |
| − | |-
| |
| − | | hide || Hides the list control.
| |
| − | |-
| |
| − | | sort || Sorts the items in the list.
| |
| − | |-
| |
| − | | multsel || Allows multiple items to be selected without holding the click/shift/control.
| |
| − | |-
| |
| − | | extsel || Allows extra selection support, you can use the control/shift keys to keep the selection and click on different entry in the list.
| |
| − | |-
| |
| − | | vsbar || Always show the vertical scrollbar.
| |
| − | |-
| |
| − | | hsbar || Alwas show the horizontal scrollbar.
| |
| − | |-
| |
| − | | check || Turns the list into a list of checkbox items.
| |
| − | |-
| |
| − | | radio || Turns the list into a list of radio items.
| |
| − | |}
| |
| − | | |
| − | ==== /did ====
| |
| − | | |
| − | * -f - sets focus on the list
| |
| − | * -e - enables the list
| |
| − | * -b - disables the list
| |
| − | * -v - makes the list visible
| |
| − | * -h - hides the list
| |
| − | * -c - selects the Nth line in the list: /did -c <name> <id> <line>
| |
| − | * -u - unselects the Nth line in the list
| |
| − | * -k - keeps the selection of others lines when selecting/unselecting
| |
| − | * -s - if you used the 'check' or 'radio' style, mark the check/radio of the Nth line as checked
| |
| − | * -l - if you used the 'check' or 'radio' style, mark the check/radio of the Nth line as unchecked
| |
| − | * -r - clears the list
| |
| − | * -a - adds a line to the end of the list
| |
| − | * -d - deletes the Nth line in the list
| |
| − | * -i - inserts a line at Nth line position in the list
| |
| − | * -o - overwrites the Nth line with the next text in the list
| |
| − | * -z - resets the width of the horizontal scrollbar in the list
| |
| − | | |
| − | ==== $did ====
| |
| − | | |
| − | $did(<name>,<id>,[N])[.property]
| |
| − | | |
| − | Without any properties, returns the text of the Nth line in the list, same as the .text property.
| |
| − | | |
| − | * .text - returns the Nth line in the list
| |
| − | * .len - returns the length of the Nth line in the list
| |
| − | * .lines - returns the number of lines in the list
| |
| − | * .sel - returns the line number of the Nth line selected line in the list, if N = 0, returns the total number of selected line
| |
| − | * .seltext - returns the first selected line in the list
| |
| − | * .next - returns the id of the next control in tab key order
| |
| − | * .prev - returns the id of the previous control in tab key order
| |
| − | * .visible - returns $true if the list is visible, otherwise $false
| |
| − | * .enabled - returns $true if the list is enabled, otherwise $false
| |
| − | * .csel - if the 'radio' or 'check' style is used, returns the line number of the Nth checked line in the list, if N = 0, returns the total number of checked line
| |
| − | * .cstate - if the 'radio' or 'check' style is used, returns the state of the check/radio control of the Nth line in the list 1 = checked, 0 = unchecked
| |
| − | | |
| − | === Events ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Event !! Description
| |
| − | |-
| |
| − | | mouse || Triggers when a mouse moves the list control.
| |
| − | |-
| |
| − | | sclick || Triggers when an item is clicked.
| |
| − | |-
| |
| − | | dclick || Triggers when an item is double clicked.
| |
| − | |}
| |
| − | | |
| − | === Example ===
| |
| − | <source lang="mIRC">; init alias
| |
| − | alias example {
| |
| − | dialog -m example example
| |
| − | }
| |
| − | ; dialog structure
| |
| − | dialog Example {
| |
| − | title "Example"
| |
| − | size -1 -1 100 110
| |
| − | option dbu
| |
| − |
| |
| − | list 1, 10 10 80 20, multsel
| |
| − | list 2, 10 40 80 20, radio
| |
| − | list 3, 10 70 80 20, check
| |
| − |
| |
| − | button "Done", 7, 10 95 40 12, ok
| |
| − | }
| |
| − | on 1:dialog:example:init:*: {
| |
| − | did -a example 1 Item A
| |
| − | did -a example 1 Item B
| |
| − | did -a example 1 Item C
| |
| − | did -a example 2 Item A
| |
| − | did -a example 2 Item B
| |
| − | did -a example 2 Item C
| |
| − | did -a example 3 Item A
| |
| − | did -a example 3 Item B
| |
| − | did -a example 3 Item C
| |
| − | }</source>
| |
| − | <div style="display: block; text-align: center;">[[File:MIRCdlgList Example.png]]</div>
| |
| − | | |
| − | | |
| − | == Combo ==
| |
| − | The combo control provides a way to choose an item from a selection of items in either a list, or from a drop-down fashion selection box.
| |
| − | | |
| − | === Synopsis ===
| |
| − | <pre>combo <id>, <x> <y> <width> <height>[, <style>]</pre>
| |
| − | | |
| − | === Styles ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Style !! Description
| |
| − | |-
| |
| − | | disable || Disables the combo control.
| |
| − | |-
| |
| − | | hide || Hides the combo control.
| |
| − | |-
| |
| − | | sort || Sorts the items in the combo control.
| |
| − | |-
| |
| − | | drop || Creates a drop-down combo control.
| |
| − | |-
| |
| − | | edit || Used with 'drop' style, creates a drop-down editable combo control.
| |
| − | |-
| |
| − | | vsbar || Always show the vertical scrollbar.
| |
| − | |-
| |
| − | | hsbar || Always show the horizontal scrollbar.
| |
| − | |}
| |
| − | | |
| − | ==== /did ====
| |
| − | | |
| − | * -f - sets focus on the combo
| |
| − | * -e - enables the combo
| |
| − | * -b - disables the combo
| |
| − | * -v - makes the combo visible
| |
| − | * -h - hides the combo
| |
| − | * -c - selects the Nth line in the combo: /did -c <name> <id> <line>
| |
| − | * -r - clears the combo, use N = 0 to clear the text of the editable editbox of the combo
| |
| − | * -a - adds a line to the end of the combo, use N = 0 to add to the editable editbox of the combo
| |
| − | * -d - deletes the Nth line in the combo
| |
| − | * -i - inserts a line at Nth line position in the combo
| |
| − | * -o - overwrites the Nth line with the next text in the combo
| |
| − | | |
| − | ==== $did ====
| |
| − | | |
| − | $did(<name>,<id>,[N])[.property]
| |
| − | | |
| − | Without any properties, returns the text of the Nth line in the list, same as the .text property.
| |
| − | | |
| − | * .text - returns the Nth line in the combo, use N = 0 to access the text of the editable editbox of the combo
| |
| − | * .len - returns the length of the Nth line in the combo
| |
| − | * .lines - returns the number of lines in the combo
| |
| − | * .sel - returns the line number selected line in the combo
| |
| − | * .seltext - returns the first selected line in the combo
| |
| − | * .next - returns the id of the next control in tab key order
| |
| − | * .prev - returns the id of the previous control in tab key order
| |
| − | * .visible - returns $true if the list is visible, otherwise $false
| |
| − | * .enabled - returns $true if the list is enabled, otherwise $false
| |
| − | | |
| − | === Events ===
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Event !! Description
| |
| − | |-
| |
| − | | mouse || Triggers when a mouse moves the combo control.
| |
| − | |-
| |
| − | | sclick || Triggers when an item is clicked.
| |
| − | |}
| |
| − | | |
| − | === Example ===
| |
| − | <source lang="mIRC">; init alias
| |
| − | alias example {
| |
| − | dialog -m example example
| |
| − | }
| |
| − | ; dialog structure
| |
| − | dialog Example {
| |
| − | title "Example"
| |
| − | size -1 -1 100 110
| |
| − | option dbu
| |
| − |
| |
| − | combo 1, 10 10 80 50, drop
| |
| − | combo 2, 10 50 80 50
| |
| − |
| |
| − | button "Done", 7, 10 95 40 12, ok
| |
| − | }
| |
| − | on 1:dialog:example:init:*: {
| |
| − | did -a example 1 Item A
| |
| − | did -a example 1 Item B
| |
| − | did -a example 1 Item C
| |
| − | did -a example 2 Item A
| |
| − | did -a example 2 Item B
| |
| − | did -a example 2 Item C
| |
| − | }</source>
| |
| − | <div style="display: block; text-align: center;">[[File:MIRCdlgCombo Example.png]]</div>
| |
| − | | |
| − | | |
| − | [[Category:mIRC|dialog components]] | |
