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

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

Valid XHTML 1.0 Transitional Valid CSS!