DCX TrackBar - Dialog Control Xtension DLL v3.1 by ClickHeRe, twig* & Ook

Home | Download | Forum | Bug Tracker

v3.1

TrackBar

This control enables you to create a track bar.

Control Styles

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

alpha	The control is alpha blended.
autoticks	Trackbar ticks are displayed at every N intervals (set by /xdid -n)
both	Tic marks are displayed on both side of the bar.
bottom	Tic marks appear on the bottom of the trackbar. (horizontal only)
downisleft	By default, the trackbar control uses down equal to right and up equal to left. Use this style to reverse the default, making down equal left and up equal right.
left	Tic marks appear on the left of the trackbar. (vertical only)
nothumb	No track bar thumb appears on the trackbar.
noticks	No tic marks appear on track bar.
right	Tic marks appear on the right of the trackbar. (vertical only)
select	Enable selection points for a trackbar.
tooltips	Tooltip thumb movement displays a tooltip.
top	Tic marks appear on the top of the trackbar. (horizontal only)
vertical	Vertical track bar.

Note. You must specify notheme when using select. Otherwise it will not display the selected range on themed desktops. (XP+).

/xdid flags

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

/xdid -c
This command lets you add a tick mark at the specified position.
Syntax:	/xdid -c [DNAME] [ID] [POS]
Example:	/xdid -c dcx 4 75

/xdid -g
This command lets you set images for specific parts of the trackbar.
Syntax:	/xdid -g [DNAME] [ID] [+FLAGS] [FILENAME]
Example:	/xdid -g dcx 4 +dt C:/mIRC/trackbar.bmp
Parameters:
+FLAGS	Which trackbar component to apply the image to.
b	Trackbar background.
c	Trackbar channel (track).
d	Trackbar dragged thumb.
t	Trackbar normal thumb.

Note. Currently only supports BMP files.

/xdid -j
This command lets you set the trackbar selection.
Syntax:	/xdid -j [DNAME] [ID] [MIN] [MAX]
Example:	/xdid -j dcx 4 0 75

/xdid -l
This command lets you set the line step value.
Syntax:	/xdid -l [DNAME] [ID] [VALUE]
Example:	/xdid -l dcx 4 5

Note. See Lineup and Linedown events.

/xdid -m
This command lets you set the page step value
Syntax:	/xdid -m [DNAME] [ID] [VALUE]
Example:	/xdid -m dcx 4 10

Note. See Pageup and Pagedown events.

/xdid -n
This command lets you set the tick marks frequency.
Syntax:	/xdid -n [DNAME] [ID] [VALUE]
Example:	/xdid -n dcx 4 10

Note. autoticks style must be used.

/xdid -o
This command lets you set the transparency color for trackbar bitmaps.
Syntax:	/xdid -o [DNAME] [ID] [VALUE]
Example:	/xdid -o dcx 4 $rgb(255,0,255)

Note. Use -1 for no transparency color.

/xdid -q
This command lets you clear the tick marks.
Syntax:	/xdid -q [DNAME] [ID]
Example:	/xdid -q dcx 4

/xdid -r
This command lets you set the trackbar range.
Syntax:	/xdid -r [DNAME] [ID] [MIN] [MAX]
Example:	/xdid -r dcx 4 0 100

/xdid -t
This command lets you set the trackbar tracker tooltip position.
Syntax:	/xdid -t [DNAME] [ID] [POSITION]
Example:	/xdid -t dcx 4 right
Parameters:
POSITION	Tooltip position
top	Tooltip appears over the tracker.
bottom	Tooltip appears under the tracker.
left	Tooltip appears left of the tracker.
right	Tooltip appears right of the tracker.

/xdid -u
This command lets you set the trackbar thumb tracker length in pixels.
Syntax:	/xdid -u [DNAME] [ID] [LENGTH]
Example:	/xdid -u dcx 4 10

/xdid -v
This command lets you set the tracker position.
Syntax:	/xdid -v [DNAME] [ID] [POS]
Example:	/xdid -v dcx 4 50

$xdid() Properties

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

$xdid().line
This property lets you retreive the track bar line step value.
Syntax:	$xdid(dialog, ID).line
Example:	$xdid(dcx, 4).line

$xdid().page
This property lets you retreive the track bar page step value.
Syntax:	$xdid(dialog, ID).page
Example:	$xdid(dcx, 4).page

$xdid().range
This property lets you retreive the track bar range.
Syntax:	$xdid(dialog, ID).range
Example:	$xdid(dcx, 4).range

$xdid().selrange
This property lets you retreive the selected track bar range.
Syntax:	$xdid(dialog, ID).selrange
Example:	$xdid(dcx, 4).selrange

$xdid().value
This property lets you retreive the track bar position value.
Syntax:	$xdid(dialog, ID).value
Example:	$xdid(dcx, 4).value

TrackBar Events

These events are fired when activity occurs in the TrackBar control.

bottom
When the user presses the end key.
Syntax:	/cb_alias DNAME bottom ID POS
Example:	/cb_alias dcx bottom 4 100
Parameters:
POS	Track bar position.

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

linedown
When the user decreases the value by using the arrow keys.
Syntax:	/cb_alias DNAME linedown ID POS
Example:	/cb_alias dcx linedown 4 71
Parameters:
POS	Track bar position.

lineup
When the user increases the value by using the arrow keys.
Syntax:	/cb_alias DNAME lineup ID POS
Example:	/cb_alias dcx lineup 4 89
Parameters:
POS	Track bar position.

pagedown
When the user decreases the value in large increments by clicking on the trackbar thumb track.
Syntax:	/cb_alias DNAME pagedown ID POS
Example:	/cb_alias dcx pagedown 4 80
Parameters:
POS	Track bar position.

pageup
When the user increases the value in large increments by clicking on the trackbar thumb track.
Syntax:	/cb_alias DNAME pageup ID POS
Example:	/cb_alias dcx pageup 4 90
Parameters:
POS	Track bar position.

showtip
When a tooltip is about to be displayed for the trackbar.
Syntax:	/cb_alias DNAME showtip ID POS
Example:	/cb_alias dcx showtip 4 83
Parameters:
POS	Track bar position.
Return	TEXT to change the tooltip text.

top
When the user presses the home key.
Syntax:	/cb_alias DNAME top ID POS
Example:	/cb_alias dcx top 4 0
Parameters:
POS	Track bar position.

trackend
When the user releases the left mouse button after dragging the thumb.
Syntax:	/cb_alias DNAME trackend ID POS
Example:	/cb_alias dcx trackend 4 73
Parameters:
POS	Track bar position.