| Home | Download | Forum | Bug Tracker

|  | v1.4.0

Edit
Normal edit control.
Control Styles
These control styles are available when creating a Edit control. Remember that the general styles disabled, group, hidden, notheme, tabstop and transparent apply to all DCX controls except the embedded Dialog and Window controls.
alpha | Control is alpha blended.
autohs | Text scrolling is automatically scrolled horizontally without need of a horizontal scrollbar.
autovs | Text scrolling is automatically scrolled vertically without need of a vertical scrollbar.
center | Text is centered.
hsbar | Displays a horizontal scrollbar.
lowercase | Converts all characters to lowercase as they are typed into the edit control.
multi | Enables a multiline edit.
number | Allows only digits to be entered into the edit control.
password | Displays an asterisk (*) for each character typed into the edit control.
readonly | Prevents the user from typing or editing text in the edit control.
return | Specifies that a carriage return be inserted when the user presses the ENTER key while entering text into a multiline edit control in a dialog box.
right | Text is right justified.
showsel | When the control loses focus, the selection is still displayed.
tooltips | The edit will have a tooltip.
uppercase | Converts all characters to uppercase as they are typed into the edit control.
vsbar | Displays a vertical scrollbar.
Note. Even with number style, it is still possible to paste non-digits into the edit control. password does not work with multi style.
/xdid flags
Control commands are input to the control with the /xdid command.
/xdid -a
This command lets you add text to the end of the edit.
Syntax: | /xdid -a [DNAME] [ID] [TEXT]
Example: | /xdid -a dcx 4 New Text
/xdid -c
This command will copy the text in the edit to the clipboard.
Syntax: | /xdid -c [DNAME] [ID]
Example: | /xdid -c dcx 4
/xdid -d
This command lets you delete the Nth line of text in the edit.
Syntax: | /xdid -d [DNAME] [ID] [N]
Example: | /xdid -d dcx 4 2
Note. Only works with multi.
/xdid -i
This command lets you insert a line at the Nth position in the edit.
Syntax: | /xdid -i [DNAME] [ID] [N] (TEXT)
Example: | /xdid -i dcx 4 5 New Text
Note. If the multi style is not used, will overwrite the whole text.
/xdid -j
This command lets you trigger the password style of the edit control on the fly.
Syntax: | /xdid -j [DNAME] [ID] [1|0]
Example: | /xdid -j dcx 4 1
Note. If anyone could find me the ascii value of the big DOT used for the default password character on XP, please leave a message.
/xdid -l
This command lets you change the readonly style.
Syntax: | /xdid -l [DNAME] [ID] [1|0]
Example: | /xdid -l dcx 4 1
/xdid -o
This command lets you overwrite the Nth line in the edit.
Syntax: | /xdid -o [DNAME] [ID] [N] [TEXT]
Example: | /xdid -o dcx 4 5 New Text
Note. If the multi style is not used, will overwrite the whole text.
/xdid -q
This command lets you set a char length limit on the edit.
Syntax: | /xdid -q [DNAME] [ID] [LIMIT]
Example: | /xdid -q dcx 4 8
/xdid -r
This command lets you clear the contents of the edit.
Syntax: | /xdid -r [DNAME] [ID]
Example: | /xdid -r dcx 4
/xdid -t
This command lets you load the contents of a file directly in the edit.
Syntax: | /xdid -t [DNAME] [ID] [FILENAME]
Example: | /xdid -t dcx 4 C:/mIRC/blah.txt
/xdid -u
This command lets you save the contents of the edit directly in a file.
Syntax: | /xdid -u [DNAME] [ID] [FILENAME]
Example: | /xdid -u dcx 4 C:/mIRC/blah.txt
/xdid -y
This command lets you ignore callbacks for repeated keydown events when the user holds a button.
Syntax: | /xdid -y [DNAME] [ID] [1|0]
Example: | /xdid -y dcx 4 1
Note. Repeated keys are ignored by default. A value of 1 will prevent callbacks from being generated for repeated keydown events.
/xdid -E
This command lets you set the cue text. It behaves like a ghostly value when the edit control is empty.
Syntax: | /xdid -E [DNAME] [ID] [TEXT]
Example: | /xdid -E dcx 4 Username
/xdid -P
This command lets you paste the contents of the clipboard into the edit control.
Syntax: | /xdid -P [DNAME] [ID]
Example: | /xdid -P dcx 4
Note. The text will be pasted directly into the current caret position. See /xdid -S.
/xdid -S
This command lets you set the selection range (and/or caret position) in the edit control.
Syntax: | /xdid -S [DNAME] [ID] [START] (END)
Example: | /xdid -S dcx 4 1 3 /xdid -S dcx 4 5
Note. When the END parameter is not specified, then this command will set the caret position to START.
$xdid() Properties
The $xdid identifier is a given mIRC alias that communicates with the DCX DLL to extract information in DCX controls.
$xdid().caretpos
This property lets you retreive the position of the cursor.
Syntax: | $xdid(dialog, ID).caretpos
Example: | $xdid(dcx, 4).caretpos
Note. The return value is LINE COLUMN
$xdid().cue
This returns the cue banner text in the control.
Syntax: | $xdid(dialog, ID).cue
Example: | $xdid(dcx, 4).cue
$xdid().ispass
This property lets you retreive if the password style is set on the edit control.
Syntax: | $xdid(dialog, ID).ispass
Example: | $xdid(dcx, 4).ispass
$xdid().isreadonly
Is the edit control using the readonly style?
Syntax: | $xdid(dialog, ID).isreadonly
Example: | $xdid(dcx, 4).isreadonly
$xdid().num
This property lets you retreive the number of lines in the edit.
Syntax: | $xdid(dialog, ID).num
Example: | $xdid(dcx, 4).num
$xdid().sel
This returns the index of the first and last selected character position in the control.
Syntax: | $xdid(dialog, ID).sel
Example: | $xdid(dcx, 4).sel
$xdid().selend
This returns the index of the last selected character position in the control.
Syntax: | $xdid(dialog, ID).selend
Example: | $xdid(dcx, 4).selend
$xdid().selstart
This returns the index of the first selected character position in the control.
Syntax: | $xdid(dialog, ID).selstart
Example: | $xdid(dcx, 4).selstart
$xdid().seltext
This returns the selected text in the control.
Syntax: | $xdid(dialog, ID).seltext
Example: | $xdid(dcx, 4).seltext
$xdid().text
This property lets you retreive the Nth line in the edit or the whole edit text.
Syntax: | $xdid(dialog, ID, [N]).text
Example: | $xdid(dcx, 4, 2).text
Note. If the multi is not used, you can ignore N when retrieving the edit text.
Edit Events
These events are fired when activity occurs in the Edit control.
copy
When the user copies text from the edit control.
Syntax: | /cb_alias DNAME copy ID
Example: | /cb_alias dcx copy 4
Return | nocopy this value to block the copy operation.
cut
When the user cuts text from the edit control.
Syntax: | /cb_alias DNAME cut ID
Example: | /cb_alias dcx cut 4
Return | nocut Return this value to block the cut operation.
dragbegin
Triggers when one or more files are dropped onto the control.
Syntax: | /cb_alias DNAME dragbegin ID COUNT
Example: | /cb_alias dcx dragbegin 4 3
Parameters:
COUNT | Total number of files dragged into the control.
Return | cancel to stop the drag drop events from occuring.
dragfile
The filename of the file which was dropped onto the edit control.
Syntax: | /cb_alias DNAME dragfile ID FILENAME
Example: | /cb_alias dcx dragfile 4 C:/mIRC/blah.txt
dragfinish
Event triggered when processing of drag drop is complete.
Syntax: | /cb_alias DNAME dragfinish ID
Example: | /cb_alias dcx dragfinish 4
edit
When the text is edited in the edit control.
Syntax: | /cb_alias DNAME edit ID
Example: | /cb_alias dcx edit 4
help
Launched when you click on a control using the ? contexthelp button.
Syntax: | /cb_alias DNAME help ID
Example: | /cb_alias dcx help 4
keydown
When a key is pressed in the edit control.
Syntax: | /cb_alias DNAME keydown ID KEYCODE
Example: | /cb_alias dcx keydown 4 65
keyup
When a key is unpressed in the edit control.
Syntax: | /cb_alias DNAME keyup ID KEYCODE
Example: | /cb_alias dcx keyup 4 65
paste
When the user pastes text into the edit control.
Syntax: | /cb_alias DNAME paste ID
Example: | /cb_alias dcx paste 4
Return | nopaste Return this value to block the paste operation.
return
When the enter key is pressed in the edit control.
Syntax: | /cb_alias DNAME return ID
Example: | /cb_alias dcx return 4
| Control Styles alpha autohs autovs center hsbar lowercase multi number password readonly return right showsel tooltips uppercase vsbar /xdid Flags -a -c -d -i -j -l -o -q -r -t -u -y -E -P -S $xdid() Properties caretpos cue ispass isreadonly num sel selend selstart seltext text Events copy cut dragbegin dragfile dragfinish edit help keydown keyup paste return

Contact | © 2005-2007 | Last Updated: 25th December, 07