mirc●vxd●mobi

Home | Download | Forum | Bug Tracker

v1.4.1

XTreebar

XTreebar is a command implemented to control the mIRC Treebar.

/xtreebar Commands

The /xtreebar command is used to control the mIRC Treebar and change various properties.

/xtreebar -c
This command changes the mIRC Treebar colors.
Syntax:	/xtreebar -c [+COLORFLAGS] [COLOUR]
Example:	/xtreebar -c +b 255
Parameters:
+COLORFLAGS	Color flags.
b	Background color.
e	Event color.
E	Event background color.
i	Insert mark color.
l	Line color.
s	Selected text color.
S	Selected background color.
t	Text color.
m	Message color.
M	Message background color.
COLOR	The color in $rgb() format.

Note. This requires /xtreebar -T to be activated.

/xtreebar -f
This command allows you to change the mIRC Treebar font.
Syntax:	/xtreebar -f [+FONTFLAGS] [CHARSET] [SIZE] [FONTNAME]
Example:	/xtreebar -f +i default 20 Verdana
Parameters:
+FONTFLAGS	Font style flags.
a	Font is anti-aliased.
b	Font is bold.
d	Default font.
i	Font is italic.
s	Font is strikedout.
u	Font is underlined.
CHARSET	Can be any of the following: ansi, baltic, chinesebig, default, easteurope, gb2312, greek, hangul, mac, oem, russian, shiftjis, symbol, turkish, vietnamese.
SIZE	Font size in points.
FONTNAME	Font name. Ex: Tahoma, Courier New, Arial, ...

/xtreebar -s
This command allows you to change the mIRC Treebar styles.
Syntax:	/xtreebar -s [STYLES]
Example:	/xtreebar -s tooltips scroll singleexpand
Parameters:
trackselect	Enables hot-tracking.
notrackselect	Disables hot-tracking.
tooltips	Enables tooltips on items
notooltips	Disables tooltip on items.
balloon	Enables balloon styled tooltips. See note for further information.
noballoon	Disables balloon styled tooltips.
infotip	Enables modification of the tooltip text within the $xtreebar_callback. See note for further information.
noinfotip	Disables modification of the tooltip text.
hasbuttons	Enables ± buttons on the side of items containing child items for expand/collapse operations.
nohasbuttons	Disables ± buttons on the side of items containing child items for expand/collapse operations.
rootlines	Enables lines to be connected to the root item.
norootlines	Disables lines to be connected to the root item.
singleexpand	Causes the item being selected to expand and the item being unselected to collapse upon selection in the tree view.
nosingleexpand	Disables singleexpand.
scroll	Enables horizontal and vertical scrolling in the mIRC Treebar.
noscroll	Disables horizontal and vertical scrolling in the mIRC Treebar.
showsel	Selections will be shown when mIRC Treebar loses focus.
noshowsel	Selections will not be shown when mIRC Treebar loses focus.
autohscroll	Remove the horizontal scrollbar and auto-scroll depending on mouse position. (Vista)
noautohscroll	Enables the horizontal scrollbar and auto-scroll depending on mouse position. (Vista)
doublebuffer	Specifies how the background is erased or filled. (Vista)
nodoublebuffer	Specifies how the background is erased or filled. (Vista)
fadebuttons	Fade expand buttons in or out when the mouse moves away or into a state of hovering over the control. (Vista)
nofadebuttons	Does not fade expand buttons in or out when the mouse moves away or into a state of hovering over the control. (Vista)
indent	Indents the tree view for the expand buttons. (Vista)
noindent	Does not indent the tree view for the expand buttons. (Vista)
richtooltip	Allow rich tooltips in the tree view (custom drawn with icon and text). (Vista)
norichtooltip	Disables rich tooltips in the tree view (custom drawn with icon and text). (Vista)

Note. Using noscroll while the scrollbar is visible may lead to graphical glitches. When using infotip, the alias $xtreeview_callback(gettooltip, [TYPE], [TEXT]) is called. Use return [NEW_TIP_TEXT] to change the tooltip text, and return nothing to prevent the tip from being displayed. balloon can only be used AFTER tooltips has been enabled, in a seperate /xtreebar command.

/xtreebar -w
This command allows you to change the mIRC Treebar images.
Syntax:	/xtreebar -w [POS] [+FLAGS] [INDEX] [FILE]
Example:	/xtreebar -w 0 + 1 icons.icl /xtreebar -w clear /xtreebar -w default
Parameters:
clear	Clears the icon list.
default	Reverts the icon list to the default icons.
POS	The position to add the new icon. Use 0 to add to the end.
+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.

Note. This requires /xtreebar -T to be activated.

/xtreebar -T
This command allows you to enable or disable DCX controlled drawing of the mIRC TreeBar.
Syntax:	/xtreebar -T [0\|1]
Example:	/xtreebar -T 1

Note. When enabled, the script function $xtreebar_callback(geticons, [TYPE], [TEXT]) will be called for each item. This will allow you to configure the appearance of each item in the TreeBar. The same alias is called when an item is added to the TreeBar. This will allow you to configure the appearance of the new item. The $xtreebar_callback alias should return 2 image indexes, IMAGE SELECTEDIMAGE. (eg. return 2 5)

$xtreebar Properties

The $xtreebar identifier is used to retrieve information about the mIRC TreeBar.

$xtreebar().icon
Returns the current icons being used by the mIRC TreeBar item.
Syntax:	$xtreebar(N).icon
Example:	$xtreebar(3).icon
Parameters:
N	The index of the item.

Note. If N is 0, this property retrieves the last item in the mIRC Treebar.

$xtreebar().item
Returns the text of the mIRC TreeBar item.
Syntax:	$xtreebar(N).item
Example:	$xtreebar(3).item
Parameters:
N	The index of the item.

Note. If N is 0, this property retrieves the total number of items in the mIRC Treebar. Returns $null if unsuccessful.

Last Updated: 12th July, 09