| Home | Download | Forum | Bug Tracker

|  | v1.4.0

Stacker
The stacker control is like a vertical container, placing controls on each other like steps on a ladder. Each control has a title, which can be collapsed to show/hide the child control.

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

gradient | Show items with a gradient background.
noformat | Disables support for mIRC codes in control (faster).
shadow | Display text with a shadow. The shadow color depends on the color specified by the item, not the Stacker.
tooltips | The stacker will have a tooltip.
Note. shadow will only work if the text color is not black or the same as the default text color on the current windows theme (ie. $rgb(0, 0, 0) or $dcx(GetSystemColor, COLOR_WINDOWTEXT) respectively). Change it by using xdid -C

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

/xdid -a
This command lets you add a new item to the stacker.
Syntax: | /xdid -a [DNAME] [ID] [N] [+FLAGS] [IMAGE] [SIMAGE] [COLOR] [BGCOLOR] Item Text [TAB] [CID] [CONTROL] [X] [Y] [W] [H] (OPTIONS)
Example: | /xdid -a dcx 4 0 + 1 2 $rgb(255,0,0) $rgb(0,0,255) New Item $chr(9) 5 button 0 0 150 25 default
Parameters:
N | The Nth position to insert the new item.
+FLAGS | There are currently no flags.
IMAGE | The image to use.
SIMAGE | The selected image to use.
COLOR | Foreground color for the item header.
BGCOLOR | Background color for the item header.
CID | Unique control ID for the DCX Control. Must be unique for all the controls of the dialog!
CONTROL | The type of DCX Control to be created.
pbar | Creates a Progressbar control.
treeview | Creates a TreeView control.
toolbar | Creates a Toolbar control.
statusbar | Creates a Statusbar control.
comboex | Creates a ComboEx control.
listview | Creates a Listview control.
trackbar | Creates a Trackbar control.
rebar | Creates a Rebar control.
colorcombo | Creates a ColorCombo control.
button | Creates a Button control.
richedit | Creates a RichEdit control.
ipaddress | Creates a IpAddress control.
updown | Creates an UpDown control.
webctrl | Creates a WebCtrl.
pager | Creates a Pager control.
line | Creates a Line control.
box | Creates a Box control.
radio | Creates a Radio control.
check | Creates a Check control.
edit | Creates a Edit control.
scroll | Creates a Scroll control.
image | Creates a Image control.
list | Creates a List control.
link | Creates a Link control.
text | Creates a Text control.
divider | Creates a Divider control.
panel | Creates a Panel control.
tab | Creates a Tab control.
window | Docks a mIRC @window. The first parameter in OPTIONS must be the @window name.
dialog | Docks a mIRC dialog. The first parameter in OPTIONS must be the dialog name.
X | X position of control.
Y | Y position of control.
W | Width of control.
H | Height of control.
OPTIONS | Optional styles and options available on each individual controls.
Note.

- You can use 0 for N to insert at the end of the stacker.
- Most of the time parameters X, Y, W, and H are ignored.
- You can use 0 or -1 for IMAGE and SIMAGE to use no image.

/xdid -c
This command lets you select an item.
Syntax: | /xdid -c [DNAME] [ID] [N]
Example: | /xdid -c dcx 4 1

/xdid -d
This command lets you delete an item and any child control.
Syntax: | /xdid -d [DNAME] [ID] [N]
Example: | /xdid -d dcx 4 1

/xdid -r
This command lets you delete all items and any child controls.
Syntax: | /xdid -r [DNAME] [ID]
Example: | /xdid -r dcx 4

/xdid -u
This command lets you clear any selection.
Syntax: | /xdid -u [DNAME] [ID]
Example: | /xdid -u dcx 4

/xdid -w
This command lets you add a image file to the internal list.
Syntax: | /xdid -w [DNAME] [ID] [+FLAGS] [FILE]
Example: | /xdid -w dcx 4 + Start.bmp
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.

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

/xdid -T
This command lets you set the tooltip text for item N.
Syntax: | /xdid -T [DNAME] [ID] [N] Text
Example: | /xdid -T dcx 4 1 Text

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

$xdid().childid
This property retrieves the ID of the child control on the item at the specified index.
Syntax: | $xdid(dialog, ID, N).childid
Example: | $xdid(dcx, 4, 2).childid

$xdid().haschild
This property returns $true if an item has a child control.
Syntax: | $xdid(dialog, ID, N).haschild
Example: | $xdid(dcx, 4, 2).haschild

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

$xdid().sel
This property retrieves the selected item ID.
Syntax: | $xdid(dialog, ID).sel
Example: | $xdid(dcx, 4).sel

$xdid().text
This property retrieves the item text.
Syntax: | $xdid(dialog, ID, N).text
Example: | $xdid(dcx, 4, 2).text

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

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

help
Launched when you click on a control using the ? contexthelp button.
Syntax: | /cb_alias DNAME help ID
Example: | /cb_alias dcx help 4

lbdown
When the left mouse button is clicked down.
Syntax: | /cb_alias DNAME lbdown ID ITEM
Example: | /cb_alias dcx lbdown 4 6
Parameters:
ITEM | Item number where the event was triggered.

lbup
When the left mouse button is released.
Syntax: | /cb_alias DNAME lbup ID ITEM
Example: | /cb_alias dcx lbup 4 4
Parameters:
ITEM | Item number where the event was triggered.

rclick
When you right-click on the stacker.
Syntax: | /cb_alias DNAME rclick ID ITEM
Example: | /cb_alias dcx rclick 4 3
Parameters:
ITEM | Item number where the event was triggered.

sclick
When an item is selected in the stacker.
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
gradient
noformat
shadow
tooltips
/xdid Flags
-a
-c
-d
-r
-u
-w
-y
-T
$xdid() Properties
childid
haschild
num
sel
text
Events
dclick
help
lbdown
lbup
rclick
sclick

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