DCX - Dialog Control Xtension
 
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.

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

Valid XHTML 1.0 Transitional Valid CSS!