- Home
- General Usage
- DCX Controls
- DCX Features
- About DCX
|
| MultiCombo |
This control enables you to create a multicombo control, which is a custom combo box that supports user defined dropdowns.
Root control: custom
|
| 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().dropstate |
| This property lets you retreive the current drop state. |
| Syntax: |
$xdid(dialog, ID).dropstate |
| Example: |
$xdid(dcx, 4).dropstate |
| Return | -1 - error.
0 - not dropped.
1 - dropped. |
|
$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().style |
| This property lets you retreive the controls current style. |
| Syntax: |
$xdid(dialog, ID).style |
| Example: |
$xdid(dcx, 4).style |
| Return | 0 Custom
1 Colour grid
2 Listbox |
|
$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 |
| Return | WIDTH 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. |
|
