- Home
- General Usage
- DCX Controls
- DCX Features
- About DCX
|
| 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 |
|
