| Home | Translations | Download | Forum | Bug Tracker

|  | v1.3.7

Panel
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 Panel control. Remember that the general styles disabled, group, notheme, tabstop and transparent apply to all DCX controls.
alpha | Control is alpha blended.
/xdid flags
Control commands are input to the control with the /xdid command.
/xdid -c
This command lets you add a child control to a panel control.
Syntax: | /xdid -c [DNAME] [ID] [CID] [CONTROL] [X] [Y] [W] [H] (OPTIONS)
Example: | /xdid -c dcx 4 12 richedit 10 10 400 25 multi
Parameters:
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.
/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
/xdid -l
This command lets you add Cell Layout Algorithm rules to your dialog controls for automatic resizing of the child controls.
Syntax: | /xdid -l [DNAME] [ID] [COMMAND] [PATH] [TAB] [+FLAGS] [CID] [WEIGHT] [W] [H]
Example: | /xdid -l dcx 4 root $chr(9) +pv 0 1 0 0 /xdid -l dcx 4 root 1 2 $chr(9) +fi 7 1 200 300 /xdid -l dcx 4 space 1 $chr(9) + 5 5 5 5
Parameters:
COMMAND | Layout command.
clear | Clears all CLA rules.
root | Sets the root cell element.
cell | Adds a cell element as a child of another cell element.
space | Sets the space padding around a cell element.
update | Updates the cell layout (must be used after adding rules or changing padding settings to refresh display).
PATH | Cell Path from root element (can be root to point to root element).
+FLAGS | Flags to manipulate Cell Layout Algorithm.
f | Creates a fixed cell element.
h | Creates a width fixed cell if used with +f or a horizontal cell pane if used with +p.
i | Indicates that the supplied control ID is valid and is the child control when used with +f or +l.
l | Creates a fill cell element.
p | Creates a pane cell element.
v | Creates a height fixed cell if used with +f or a vertical cell pane if used with +p.
w | When used, it means that the supplied W and H represent the fixed cell width in the applicable direction (if the fixed cell is fixed in width, height or both).
CID | ID of the control (used with fixed or fill cells - use 0 if no control is to be linked to the cell).
WEIGHT | Cell child weight. (used when adding a child cell to a pane cell)
W | Fixed width of control (used with fixed cell).
H | Fixed height of control. (used with fixed cell)
Note. See the Cell Layout Algorithm explanation for concrete examples. If you use the update command in the init event of a dialog, you will have to use ".timer 1 0 xdialog -l dialog update" as a glitch with XP and themes disabled prevents windows from appearing. The timer corrects this problem. When using the space command, the ID WEIGHT W H are in fact the LEFT TOP RIGHT BOTTOM spacings Use the value 0 for the fields not used as the command expects them to be filled even though they aren't used.
/xdid -t
This command lets you set the text for a panel control.
Syntax: | /xdid -t [DNAME] [ID] [TEXT]
Example: | /xdid -t dcx 4 New Window Text
Note. The panel text (and border) is only visible when used with /xdid -x DIALOG ID +bd
Panel Events
These events are fired when activity occurs in the Panel control.
dclick
When the left mouse button is double-clicked.
Syntax: | /cb_alias DNAME dclick ID
Example: | /cb_alias dcx dclick 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
lbdblclk
When the left mouse button is double-clicked.
Syntax: | /cb_alias DNAME lbdblclk ID
Example: | /cb_alias dcx lbdblclk 4
lbdown
When the left mouse button is pressed.
Syntax: | /cb_alias DNAME lbdown ID
Example: | /cb_alias dcx lbdown 4
lbup
When the left mouse button is released.
Syntax: | /cb_alias DNAME lbup ID
Example: | /cb_alias dcx lbup 4
sclick
When the left mouse button is clicked.
Syntax: | /cb_alias DNAME sclick ID
Example: | /cb_alias dcx sclick 4
| Control Styles alpha /xdid Flags -c -d -l -t Events dclick help lbdblclk lbdown lbup sclick

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