DCX - Dialog Control Xtension Home | Translations | Download | Forum | Bug Tracker
v1.3.7
Tab
The panel control is like an empty borderless dialog which is used to host other controls.

Control Styles
These control styles are available when creating a Tab control. Remember that the general styles disabled, group, notheme, tabstop and transparent apply to all DCX controls.
bottom The tabs are aligned at the bottom. (See note below)
buttons The tabs appear as buttons like a toolbar.
fixedwidth All tabs are the same width.
flat The tab buttons appear flat. (Only with buttons)
flatseps The tab separators are drawn as flat (Only with buttons and flat).
hot The tab item under the mouse is highlighted (may not work on some systems).
multiline The tabs aline themselves on multiple rows (default is single row).
right The tabs are aligned verticaly right (used with vertical). (See note below).
rightjustify The width of each tab is increased so the tab fills the entire width of the row (Only with multi).
scrollopposite Unneeded tabs scroll to the opposite side of the control when a tab is selected.
vertical The tabs are aligned verticaly left. (See note below).
 
Note. Vertical and bottom tabs are not supported coorectly in XP Themes. The control works, but the tabs are not drawn properly. There is no easy fix for this at the moment. It is a bug in the windows theme system, not in the API.

/xdid flags
Control commands are input to the control with the /xdid command.
/xdid -a
This command lets you add a child control to a tab control.
Syntax:
/xdid -a [DNAME] [ID] [N] [ICON] (TEXT) [TAB] [CID] [CONTROL] [X] [Y] [W] [H] (OPTIONS) [TAB] (TOOLTIP)
Example:
/xdid -a dcx 4 0 1 Tab1 $chr(9) 12 richedit 10 10 400 25 multi $chr(9) Tooltip
Parameters:
N Position where the tab will be inserted (Use 0 to insert at the end).
ICON Icon index to be displayed (Use 0 for no icon).
TEXT Tab item text.
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.
treeview Creates a TreeView control.
listview Creates a Listview control.
rebar Creates a Rebar control.
webctrl Creates a WebCtrl.
   
edit Creates a Edit control.
image Creates a Image control.
list Creates a List control.
    
divider Creates a Divider control.
panel Creates a Panel control.
tab Creates a Tab control.
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.
TOOLTIP Not functional yet.
 
Note. The control is optional. You can use the tab control without child controls as a toolbar (like bar of buttons).

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

/xdid -d
This command lets you delete a control added on the panel.
Syntax:
/xdid -d [DNAME] [ID] [CID]
Example:
/xdid -d dcx 4 6
 
Note. The control associated with the tab is removed when you delete a tab item.

/xdid -l
This command lets you change the Nth tab item icon (Use 0 for no icon).
Syntax:
/xdid -l [DNAME] [ID] [N] [ICON]
Example:
/xdid -l dcx 4 2 3

/xdid -m
This command lets you change the tab item width and height (Only works with the fixedwidth).
Syntax:
/xdid -m [DNAME] [ID] [CX] [CY]
Example:
/xdid -m dcx 4 50 20

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

/xdid -t
This command lets you change the Nth tab item text.
Syntax:
/xdid -t [DNAME] [ID] [N] (Itemtext)
Example:
/xdid -t dcx 4 2 New Text

/xdid -w
This command lets you add an icon to the tab image list.
Syntax:
/xdid -w [DNAME] [ID] [+FLAGS] [INDEX] [FILENAME]
Example:
/xdid -w dcx 4 +g 113 C:/mIRC/shell.dll
Parameters:
+FLAGS Icon flags
g Convert to grayscale 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 tab 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().childid
This property lets you retreive Nth tab child control ID ($null if no child control on the tab).
Syntax:
$xdid(dialog, ID, N).childid
Example:
$xdid(dcx, 4, 2).childid

$xdid().icon
This property lets you retreive Nth tab icon.
Syntax:
$xdid(dialog, ID, N).icon
Example:
$xdid(dcx, 4, 2).icon

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

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

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

$xdid().text
This property lets you retreive the Nth tab item text.
Syntax:
$xdid(dialog, ID, N).text
Example:
$xdid(dcx, 4, 1).text

Tab Events
These events are fired when activity occurs in the Tab control.
help
Launched when you click on a control using the ? contexthelp button.
Syntax:
/cb_alias DNAME help ID
Example:
/cb_alias dcx help 4

rclick
When a rclick event is fired over the selected tab band.
Syntax:
/cb_alias DNAME rclick ID ITEM
Example:
/cb_alias dcx rclick 4 2
Parameters:
ITEM Tab item index number over which the event was triggered.

sclick
When a tab item is selected.
Syntax:
/cb_alias DNAME sclick ID ITEM
Example:
/cb_alias dcx sclick 4 2
Parameters:
ITEM Tab item index number over which the event was triggered.

Contact © 2005-2006 Last Updated: 14th January, 07

Valid XHTML 1.0 Transitional Valid CSS!