- Home
- General Usage
- DCX Controls
- DCX Features
- About DCX
|
| 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. |
|
|
