DCX - Dialog Control Xtension
 
RichEdit
This control enables you to create a richedit. The richedit interprets the mIRC control codes to display the colors and bold/underline effects. The richedit control loads it's internal Color Palette as the actual mIRC colors as default behavior. You can modify the colors using the /xdid commands.

The Color Palette is the richedit's internal color list of 16 values used to process mIRC color codes and convert them to disaplyed colors.

Control Styles
These control styles are available when creating a RichEdit 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.
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.
multi Enables a multiline richedit.
readonly Text cannot be edited manually.
right Text is right justified.
tooltips The richedit will have a tooltip.
vsbar Displays a vertical scrollbar.

/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 richedit.
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 richedit.
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 richedit.
Syntax:
/xdid -i [DNAME] [ID] [N] [TEXT]
Example:
/xdid -i dcx 4 2 New Text
 
Note. If the multi style is not used, overwrites all text.

/xdid -k
This command lets you change the richedit background color.
Syntax:
/xdid -k [DNAME] [ID] [RGB]
Example:
/xdid -k dcx 4 $rgb(255,0,0)
 
Note. Use -1 to revert to default.

/xdid -l
This command lets you change a color in the richedit palette.
Syntax:
/xdid -l [DNAME] [ID] [N] [RGB]
Example:
/xdid -l dcx 4 5 $rgb(255,0,0)
Parameters:
N An index between 1-16

/xdid -m
This command lets you load the mIRC color palette into the richedit.
Syntax:
/xdid -m [DNAME] [ID]
Example:
/xdid -m dcx 4

/xdid -n
This command lets you toggle the automatic hyperlinking of urls to enable the link event.
Syntax:
/xdid -n [DNAME] [ID] [1|0]
Example:
/xdid -n dcx 4 1

/xdid -o
This command lets you overwrite the Nth line in the richedit.
Syntax:
/xdid -o [DNAME] [ID] [N] [TEXT]
Example:
/xdid -o dcx 4 5 New Text
 
Note. If the multi style is not used, overwrites all text.

/xdid -q
This command lets you load a custom palette into the richedit control.
Syntax:
/xdid -q [DNAME] [ID] [COLOR1] [COLOR2] ... [COLOR16]
Example:
/xdid -q dcx 4 2 $rgb(255,0,0)
 
Note.
  • The number of colors is limited to 16, everything past the 16th color is ignored.
  • You can give the command a number of colors inferior to 16, it will then only add thoses colors in order to the palette starting at 1.

/xdid -r
This command lets you clear the contents of the richedit.
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 richedit.
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 richedit 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 -P
This command lets you paste the contents of the clipboard into the richedit control.
Syntax:
/xdid -P [DNAME] [ID]
Example:
/xdid -P dcx 4
 
Note.
  • Formatting in the text is kept when using this command.
  • 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 richedit 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 -Z
This command lets you zoom the text of the richedit.
Syntax:
/xdid -Z [DNAME] [ID] [NUMERATOR] [DENOMINATOR]
Example:
/xdid -Z dcx 4 200 100
 
Note. The percentage of zooming is calculated by dividing the numerator by denominator (NUMERATOR / DENOMINATOR * 100)

$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, LINE COLUMN).caretpos
Example:
$xdid(dcx, 4, 14 3).caretpos

$xdid().num
This property lets you retreive the number of lines in the richedit.
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 richedit or the whole richedit text.
Syntax:
$xdid(dialog, ID, N).text
Example:
$xdid(dcx, 4, 1).text
 
Note. If the multi style is not used, you can ignore the N parameter to retrieve the richedit text.

RichEdit Events
These events are fired when activity occurs in the RichEdit control.
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 richedit control.
Syntax:
/cb_alias DNAME keydown ID KEYCODE
Example:
/cb_alias dcx keydown 4 64

keyup
When a key is unpressed in the richedit control.
Syntax:
/cb_alias DNAME keyup ID KEYCODE
Example:
/cb_alias dcx keyup 4 64

lbup
When the left mouse button is released.
Syntax:
/cb_alias DNAME lbup ID
Example:
/cb_alias dcx lbup 4

link
When a link is clicked.
Syntax:
/cb_alias DNAME link ID EVENT LINK
Example:
/cb_alias dcx link 4 sclick http://dcx.scriptsdb.org
Parameters:
EVENT Mouse event which triggered the callback
sclick Single left click.
dclick Double left click.
rclick Single right click.
LINK The URL which was clicked.

rclick
When the right mouse button is clicked on the richedit control.
Syntax:
/cb_alias DNAME rclick ID
Example:
/cb_alias dcx rclick 4

return
When the Enter key is pressed in the richedit control.
Syntax:
/cb_alias DNAME return ID
Example:
/cb_alias dcx return 4

sclick
When the left mouse button is clicked.
Syntax:
/cb_alias DNAME sclick ID
Example:
/cb_alias dcx sclick 4

selchange
When the selection range is changed.
Syntax:
/cb_alias DNAME selchange ID START END TEXT
Example:
/cb_alias dcx selchange 4 2 6 text has been sel
Parameters:
START The starting position of the selection range.
END The ending position of the selection range.
TEXT The text selected.

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

Valid XHTML 1.0 Transitional Valid CSS!