| 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