| Home | Download | Forum | Bug Tracker

|  | v1.4.0

Rebar
This control enables you to create a rebar control. This control acts as a container for other controls. The rebar control is consisted of bands that host an icon, text and a child control.

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

borders | Borders appear between rebar bands.
bottom | The rebar is auto-positioned at bottom of dialog window.
dblclktoggle | Double click on band text toggles min/max resizing of the band. (Single click is default)
fixedorder | Bands are always in the same order but can be dragged on different lines/columns.
noauto | Prevents the rebar from being auto-positioned and resized by the parent window. The user will be responsible for the positioning and resizing of the rebar.
noparentalign | The rebar isnt auto-positioned when dialogs size changes.
noresize | The rebar isnt auto-resized when dialogs size changes.
right | The rebar is auto-positioned to the right side of the dialog (must be used with vertical style).
tooltips | The rebar bands have tooltips.
varheight | The rebar control displays bands at the minimum required height, when possible. Without this style, the rebar control displays all bands at the same height, using the height of the tallest visible band to determine the height of other bands. Even if this style is applied, bands on the same row will display the height of the highest band on that row.
vertical | The rebar is auto-positioned to the left side of the dialog (gives a vertical rebar).
verticalgrip | The size grip will be displayed vertically instead of horizontally in a vertical rebar control. (must be used with vertical)

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

/xdid -a
This command lets you add bands to the rebar. These bands can optionally host a supported child control.
Syntax: | /xdid -a [DNAME] [ID] [N] [+FLAGS] [CX] [CY] [WIDTH] [ICON] [COLOR] (TEXT) [TAB] [CID] [CONTROL] [X] [Y] [W] [H] (OPTIONS) [TAB] (TOOLTIP)
Example: | /xdid -a dcx 4 0 +f 0 25 20 2 $rgb(0,0,255) ComboEx $chr(9) 12 comboex 10 10 400 25 dropedit $chr(9) Tooltip text
Parameters:
N | Band position index number (Use 0 to insert at the end).
+FLAGS | Item flags.
c | The button text is colored, using COLOR as the text color. (Only works with notheme)
e | The band has an edge at the top and bottom of the child window.
f | The band cant be sized. With this style, the sizing grip is not displayed on the band.
g | The band will always have a sizing grip, even if it is the only band in the rebar.
h | The band will not be visible.
n | The band will never have a sizing grip, even if there is more than one band in the rebar.
w | The band is on a new line.
CX | Minimal width to which the rebar band child control can be resized.
CY | Minimal height to which the rebar band child control can be resized.
WIDTH | Width of the rebar band when created.
ICON | Icon index to be displayed (Use 0 for no icon).
COLOR | Rebar band text color (Only works with XP themes disabled).
TEXT | Band 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 create. Values can be: button, colorcombo, comboex, listview, pbar, richedit, statusbar, toolbar, trackbar, treeview divider, panel or tab
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 | Band 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).
- If you are using the vertical style, CX, CY, and WIDTH are the minimal height, minimal width, and height values.
- If the band is the last one created on a band row, the WIDTH value is ignored and the band stretches to the end of the rebar control.
- The control part of the command is optional and can be empty if you do not wish to have a control in the band.

/xdid -d
This command lets you delete the Nth rebar band.
Syntax: | /xdid -d [DNAME] [ID] [N]
Example: | /xdid -d dcx 4 2

/xdid -i
This command lets you hide the Nth rebar band.
Syntax: | /xdid -i [DNAME] [ID] [N]
Example: | /xdid -i dcx 4 2

/xdid -j
This command lets you show the Nth rebar band.
Syntax: | /xdid -j [DNAME] [ID] [N]
Example: | /xdid -j dcx 4 2

/xdid -k
This command lets you change the icon on a rebar band.
Syntax: | /xdid -k [DNAME] [ID] [N] [ICON]
Example: | /xdid -k dcx 4 2 0
Parameters:
N | Band position index number.
ICON | Icon index number from the icon list (0 for no icon).

/xdid -l
This command lets you lock the Nth rebar band or all the bands.
Syntax: | /xdid -l [DNAME] [ID] [N|all]
Example: | /xdid -l dcx 4 all

/xdid -m
This command lets you maximize the Nth rebar band.
Syntax: | /xdid -m [DNAME] [ID] [N]
Example: | /xdid -m dcx 4 2

/xdid -n
This command lets you minimize the Nth rebar band.
Syntax: | /xdid -n [DNAME] [ID] [N]
Example: | /xdid -n dcx 4 2

/xdid -t
This command lets you change the text on a rebar band.
Syntax: | /xdid -t [DNAME] [ID] [N] (Itemtext)
Example: | /xdid -t dcx 4 2 New Text

/xdid -u
This command lets you move the Nth rebar band to the Mth position.
Syntax: | /xdid -u [DNAME] [ID] [N] [M]
Example: | /xdid -u dcx 4 3 1

/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 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 rebar 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 rebar band child control ID ($null if no child control on the band).
Syntax: | $xdid(dialog, ID, N).childid
Example: | $xdid(dcx, 4, 2).childid

$xdid().num
This property lets you retreive the number of bands of a rebar.
Syntax: | $xdid(dialog, ID).num
Example: | $xdid(dcx, 4).num

$xdid().text
This property lets you retreive a Nth rebar band text.
Syntax: | $xdid(dialog, ID, N).text
Example: | $xdid(dcx, 4, 1).text

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

change
When the rebar controls height changes because of band movement.
Syntax: | /cb_alias DNAME change ID W H
Example: | /cb_alias dcx change 4 150 25
Parameters:
W | New rebar control width.
H | New rebar control height.

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 a rebar band (excluding the area occupied by a child control).
Syntax: | /cb_alias DNAME rclick ID BAND
Example: | /cb_alias dcx rclick 4 2
Parameters:
BAND | Rebar band item index number over which the event was triggered.

sclick
When a sclick event is fired over a rebar band (excluding the area occupied by a child control).
Syntax: | /cb_alias DNAME sclick ID BAND
Example: | /cb_alias dcx sclick 4 2
Parameters:
BAND | Rebar band item index number over which the event was triggered.

Control Styles
borders
bottom
dblclktoggle
fixedorder
noauto
noparentalign
noresize
right
tooltips
varheight
vertical
verticalgrip
/xdid Flags
-a
-d
-i
-j
-k
-l
-m
-n
-t
-u
-w
-y
$xdid() Properties
childid
num
text
Events
change
help
rclick
sclick

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