| Home | Download | Forum | Bug Tracker

|  | 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.
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.

Control Styles
alpha
autoticks
both
bottom
downisleft
left
nothumb
noticks
right
select
tooltips
top
vertical
/xdid Flags
-c
-g
-j
-l
-m
-n
-o
-q
-r
-t
-u
-v
$xdid() Properties
line
page
range
selrange
value
Events
bottom
help
linedown
lineup
pagedown
pageup
showtip
top
trackend

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