DCX - Dialog Control Xtension
 
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
Returnnocopy 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
Returnnocut 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.
Returncancel 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
Returnnopaste 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

Contact � 2005-2009 Last Updated: 12th July, 09

Valid XHTML 1.0 Transitional Valid CSS!