DCX - Dialog Control Xtension
v1.4.0
XStatusBar
The /xstatusbar command is used to create and control a statusbar docked directly within the main mIRC window, without the need of creating a dialog to host it.

/xstatusbar Commands
The /xstatusbar command is used to control the docked StatusBar.
/xstatusbar -f
This command lets you change the XStatusBar font.
Syntax:
/xstatusbar -f [+FLAGS] [CHARSET] [SIZE] [FONTNAME]
Example:
/xstatusbar -f +abs ansi 10 Tahoma
Parameters:
+FLAGS 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, or vietnamese.
SIZE Font size in points.
FONTNAME Font name. Ex: Tahoma, Courier New, Arial, ...
 
Note.
  • Font names are limited to 31 chars (system definition).
  • When using +d, CHARSET SIZE and FONTNAME can be omitted.

/xstatusbar -k
This command lets you set the status bar background color.
Syntax:
/xstatusbar -k [RGB]
Example:
/xstatusbar -k $rgb(255,0,0)
 
Note.
  • You can use -1 for RGB to revert to default color.
  • This command will only work if the computer has no visual styles applied (XP themes). To use this on machines with visual styles enabled, apply the notheme style.

/xstatusbar -l
This command lets you set the width of status bar cells. A value of -1 will cause the cell to automatically stretch, filling the remainding space. Values can also be a percentage, such as 20%.
Syntax:
/xstatusbar -l [POS] (POS POS ...)
Example:
/xstatusbar -l 10% 200 400 -1

/xstatusbar -t
This command lets you set the icon, text and tooltip of a statusbar cell.
Syntax:
/xstatusbar -t [N] [+FLAGS] [#ICON] (Cell Text) $chr(9) (Tooltip)
Example:
/xstatusbar -t 2 +p 0 Cell Text $chr(9) Tooltip Text
Parameters:
N Status bar cell number to modify.
+FLAGS Status bar cell flags.
p Popup style border around cell.
n No borders around cell.
#ICON Icon number for the statusbar cell (0 for no icon)
 
Note. Tooltip is only displayed if cell text is absent or cell text is too long to fit in cell.

/xstatusbar -v
This command lets you change the text of a statusbar cell.
Syntax:
/xstatusbar -v [N] (TEXT)
Example:
/xstatusbar -v 2 New Text

/xstatusbar -w
This command lets you add an icon to the statusbar image list.
Syntax:
/xstatusbar -w [+FLAGS] [INDEX] [FILENAME]
Example:
/xstatusbar -w + 113 shell32.dll
Parameters:
INDEX Icon index in icon archive
FILENAME Icon archive filename
 
Note. Use 0 for INDEX if the file is a single icon file.

/xstatusbar -y
This command lets you clear the statusbar image list.
Syntax:
/xstatusbar -y
Example:
/xstatusbar -y

/xstatusbar -A
This command enables/disables a statusbar in the mIRC window and applies the styles specified.
Syntax:
/xstatusbar -A [1|0] (STYLE)
Example:
/xstatusbar -A 1 notheme
Parameters:
STYLE Styles supported by the StatusBar control.
 
Note.
  • Syntax for controlling the mIRC StatusBar using /xstatusbar is identical to the syntax for the DCX StatusBar control.
  • eg. /xstatusbar -l 200 200 100 -1

$xstatusbar Properties
The $xstatusbar identifier is used to retrieve the information from the docked statusbar.
$xstatusbar().parts
Returns the number of parts in the mIRC StatusBar.
Syntax:
$xstatusbar().parts
Example:
$xstatusbar().parts

$xstatusbar().text
Returns the text on the mIRC Statusbar part.
Syntax:
$xstatusbar(N).text
Example:
$xstatusbar(5).text

$xstatusbar().tooltip
Returns the tooltip for the mIRC Statusbar part.
Syntax:
$xstatusbar(N).tooltip
Example:
$xstatusbar(2).tooltip

$xstatusbar().visible
Returns whether or not the mIRC StatusBar is visible.
Syntax:
$xstatusbar().visible
Example:
$xstatusbar().visible

XStatusbar Signals
XStatusBar signals are enabled by default and sent to mIRC containing information about mouse activity over the XStatusBar. To enable or disable signal messages for XStatusBar, refer to /dcx xSignal
Signal:
DCXStatusbar EVENT HWND PART
Example:
DCXStatusbar sclick 133826 3
Parameters:
xstatusbar The event signal identifier.
DCXStatusbar This is to let the user know which event was triggered.
EVENT Information about event occurred.
dclick A part of the statusbar was double clicked.
rdclick A part of the statusbar was double right-clicked.
sclick A part of the statusbar was single left-clicked.
rclick A part of the statusbar was single right-clicked.
HWND The hwnd of the XStatusBar.
PART The ID of the part which the event occurred on.
Contact 2005-2007 Last Updated: 25th December, 07

Valid XHTML 1.0 Transitional Valid CSS!