DCX - Dialog Control Xtension
 
MultiCombo
This control enables you to create a multicombo control, which is a custom combo box that supports user defined dropdowns.

Control Styles
These control styles are available when creating a MultiCombo 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.
colourgrid dropdown colour grid.
listbox Combo that is a list with an edit box
 
Note.
  • When creating a MultiCombo control, it is important to remember that the size of the dropdown portion is set by a measureitem callback.
  • When no style is supplied then the dropdown portion is assumed to be supplied by you via the /xdid -C command.
  • NB: Styles can't be combined.

/xdid flags
Control commands are input to the control with the /xdid command.
/xdid -a
This command lets you add an item to the listbox/colourgrid portion of the control.
Syntax:
/xdid -a [DNAME] [ID] [#RGB] (TEXT)
Example:
/xdid -a dcx 4 $rgb(255,0,0) red
Parameters:
#RGB The RGB colour to display in colourgrid mode.
TEXT the text to display for this item.
 
Note. This only affects the control when in listbox or colourgrid mode.

/xdid -c
This command lets you select the Nth item.
Syntax:
/xdid -c [DNAME] [ID] [N]
Example:
/xdid -c dcx 4 5
 
Note. This only affects the control when in listbox or colourgrid mode.

/xdid -d
This command lets you delete the Nth item.
Syntax:
/xdid -d [DNAME] [ID] [N]
Example:
/xdid -d dcx 4 6
 
Note. This only affects the control when in listbox or colourgrid mode.

/xdid -i
This command lets you insert an item.
Syntax:
/xdid -i [DNAME] [ID] [N] [RGB] (TEXT)
Example:
/xdid -i dcx 4 2 $rgb(0,255,0) green
 
Note. This only affects the control when in listbox or colourgrid mode.

/xdid -m
This command loads the colourgrid with mIRC's current colours.
Syntax:
/xdid -m [DNAME] [ID]
Example:
/xdid -m dcx 4
 
Note. This only affects the control when in colourgrid mode.

/xdid -o
This command lets you overwrite an item.
Syntax:
/xdid -o [DNAME] [ID] [N] [RGB] (TEXT)
Example:
/xdid -o dcx 4 2 $rgb(0,255,0) green
 
Note. This only affects the control when in listbox or colourgrid mode.

/xdid -r
This command lets you clear all the items.
Syntax:
/xdid -r [DNAME] [ID]
Example:
/xdid -r dcx 4
 
Note. This only affects the control when in listbox or colourgrid mode.

/xdid -s
This command shows or hides the dropdown.
Syntax:
/xdid -s [DNAME] [ID] [1 or 0]
Example:
/xdid -s dcx 4 1

/xdid -t
This command sets the text shown in the editbox portion of the control.
Syntax:
/xdid -t [DNAME] [ID] (TEXT)
Example:
/xdid -t dcx 4 woohoo
 
Note. Supplying an empty text clears the editbox.

/xdid -u
This command makes the currently selected item unselected.
Syntax:
/xdid -u [DNAME] [ID]
Example:
/xdid -u dcx 4
 
Note. This only affects the control when in listbox or colourgrid mode.

/xdid -C
This command lets you add a custom control as a dropdown.
Syntax:
/xdid -C [DNAME] [ID] [ID] [CONTROL] [X] [Y] [W] [H] (OPTIONS)
Example:
/xdid -C dcx 4 200 listview 0 0 100 100 report showgrid
 
Note. This removes any pre-existing drop controls.

/xdid -D
This command lets you delete the any pre-existing drop controls.
Syntax:
/xdid -D [DNAME] [ID]
Example:
/xdid -D dcx 4
 
Note. This also deletes the internally created listbox or colourgrid controls.

$xdid() Properties
The $xdid identifier is a given mIRC alias that communicates with the DCX DLL to extract information in DCX controls.
$xdid().colour
This property lets you retreive the Nth items colour.
Syntax:
$xdid(dialog, ID, [N]).colour
Example:
$xdid(dcx, 4, 1).colour
 
Note.
  • You can use a value of 0 for N to retrieve the colour of the editbox.
  • This only affects the control when in colourgrid mode.

$xdid().num
This property lets you retreive the total number of items.
Syntax:
$xdid(dialog, ID).num
Example:
$xdid(dcx, 4).num
 
Note. This only affects the control when in listbox or colourgrid mode.

$xdid().sel
This property lets you retreive the selected item number.
Syntax:
$xdid(dialog, ID).sel
Example:
$xdid(dcx, 4).sel
 
Note. This only affects the control when in listbox or colourgrid mode.

$xdid().seltext
This property lets you retreive selected item text.
Syntax:
$xdid(dialog, ID).seltext
Example:
$xdid(dcx, 4).seltext
 
Note. This only affects the control when in listbox or colourgrid mode.

$xdid().text
This property lets you retreive the Nth items text.
Syntax:
$xdid(dialog, ID, [N]).text
Example:
$xdid(dcx, 4, 1).text
 
Note.
  • You can use a value of 0 for N to retrieve the text of the editbox.
  • This only affects the control when in listbox or colourgrid mode.

MultiCombo Events
These events are fired when activity occurs in the MultiCombo control.
dclick
When an item is double-clicked in the listbox/colourgrid.
Syntax:
/cb_alias DNAME dclick ID ITEM
Example:
/cb_alias dcx dclick 4 6
Parameters:
ITEM Item number where the event was triggered.

edit
When the text is edited in the editbox.
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

measureitem
When the size of the dropdown needs renewed.
Syntax:
/cb_alias DNAME measureitem ID
Example:
/cb_alias dcx measureitem 4
ReturnWIDTH HEIGHT The desired width and height of the dropdown.

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

sclick
When an item is selected in the listbox/colourgrid.
Syntax:
/cb_alias DNAME sclick ID ITEM
Example:
/cb_alias dcx sclick 4 6
Parameters:
ITEM Item number where the event was triggered.

Contact © 2005-2022 Last Updated: 19th November, 22

Valid XHTML 1.0 Transitional Valid CSS!