| Home | Download | Forum | Bug Tracker

|  | v1.4.0

ComboEx
This control enables you to create a comboex control, which is a combo box extended to support icons.

Control Styles
These control styles are available when creating a ComboEx 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.

dropdown | Simple dropdown combo.
dropedit | Dropdown combo with an editbox.
hscroll | Enables the horizontal scroll bar in the listbox part.
simple | Combo that is a list with an edit box
Note. When creating a ComboEx control, it is important to remember that the height of the control includes the dropdown list portion.

/xdid flags
Control commands are input to the control with the /xdid command.

/xdid -a
This command lets you add an item to the comboex.
Syntax: | /xdid -a [DNAME] [ID] [N] [INDENT] [#ICON] [#SELECTED] [#OVERLAY] [Item Text]
Example: | /xdid -a dcx 4 3 0 1 2 0 Visit scriptsdb.org
Parameters:
N | Position where the comboex item will be added.
INDENT | Number of indent widths from the left border.
#ICON | Icon displayed when item is not selected.
#SELECTED | Icon displayed when item is selected.
#OVERLAY | Overlay icon of the item (Note: Not functional yet)
Note.

- You can use 0 for the N value to insert the item at the end of the comboex.
- Every unit of INDENT is a 10 pixel indent.
- Use 0 for #ICON or #SELECTED if you wish to use no icon.
- Use -1 for N to set the text for the editable part of the comboex (only used with dropedit style).

/xdid -c
This command lets you select the Nth comboex item.
Syntax: | /xdid -c [DNAME] [ID] [N]
Example: | /xdid -c dcx 4 5

/xdid -d
This command lets you delete the Nth comboex item.
Syntax: | /xdid -d [DNAME] [ID] [N]
Example: | /xdid -d dcx 4 6

/xdid -r
This command lets you clear all the comboex items.
Syntax: | /xdid -r [DNAME] [ID]
Example: | /xdid -r dcx 4

/xdid -u
This command makes the currently selected comboex item unselected.
Syntax: | /xdid -u [DNAME] [ID]
Example: | /xdid -u dcx 4

/xdid -w
This command lets you add an icon to the comboex image list.
Syntax: | /xdid -w [DNAME] [ID] [+FLAGS] [INDEX] [FILENAME]
Example: | /xdid -w dcx 4 + 113 shell32.dll
Parameters:
+FLAGS | Icon flags
a | Uses the icon associated with the given file (as shown in Windows Explorer). Note: File must exist.
f | Uses the icon associated with the given filetype. Note: Filename is the extension (eg. BMP, PNG, AVI, etc).
g | Convert to grayscale icon.
P | If GDI+ is enabled, this will use GDI+ to extract the icon.
INDEX | Icon index in icon archive
FILENAME | Icon archive filename
Note. Use 0 for INDEX if the file is a single icon file.

/xdid -y
This command lets you clear the comboex image list.
Syntax: | /xdid -y [DNAME] [ID]
Example: | /xdid -y dcx 4

$xdid() Properties
The $xdid identifier is a given mIRC alias that communicates with the DCX DLL to extract information in DCX controls.

$xdid().find
This property lets you retreive the comboex item index of the Nth found comboex item matching the input search patern.
Syntax: | $xdid(dialog, ID, [TAB][MATCHTEXT][TAB], TYPE, N).find
Example: | $xdid(dcx, 4, $chr(9) *Item* $chr(9), W, 3).find
Parameters:
MATCHTEXT | String composed of wildcards or regex paterns used for the search.
TYPE | Value indicating if the search is using a regex patern or wildcard string.
W | MATCHTEXT is a wildcard string.
R | MATCHTEXT is a regex patern.
N | Parameter indicating to return the Nth match.
Note.

- The [TAB] characters surrounding the matchtext are mandatory or else it won't work.
- If N is 0, returns the total number of matching items found.

$xdid().num
This property lets you retreive the total number of comboex items.
Syntax: | $xdid(dialog, ID).num
Example: | $xdid(dcx, 4).num

$xdid().sel
This property lets you retreive the comboex selected item number.
Syntax: | $xdid(dialog, ID).sel
Example: | $xdid(dcx, 4).sel

$xdid().seltext
This property lets you retreive selected comboex item text.
Syntax: | $xdid(dialog, ID).seltext
Example: | $xdid(dcx, 4).seltext

$xdid().text
This property lets you retreive the Nth comboex item 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.

ComboEx Events
These events are fired when activity occurs in the ComboEx control.

dclick
When an item is double-clicked in a simple comboex.
Syntax: | /cb_alias DNAME dclick ID ITEM
Example: | /cb_alias dcx dclick 4 6
Parameters:
ITEM | Item number where the event was triggered.

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 that has
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 a comboex with 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

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

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

Control Styles
dropdown
dropedit
hscroll
simple
/xdid Flags
-a
-c
-d
-r
-u
-w
-y
$xdid() Properties
find
num
sel
seltext
text
Events
dclick
dragbegin
dragfile
dragfinish
edit
help
return
sclick

Contact | © 2005-2007 | Last Updated: 25th December, 07