DCX - Dialog Control Xtension Home | Translations | Download | Forum | Bug Tracker
v1.3.7
StatusBar
This control enables you to create a status bar.

Control Styles
These control styles are available when creating a StatusBar control. Remember that the general styles disabled, group, notheme, tabstop and transparent apply to all DCX controls.
grip Status bar displays a sizing grip.
noparentalign Status isn't auto-positioned when dialog's size changes.
noresize Status isn't auto-resized when dialog's size changes
tooltips Status bar has tooltips (tooltips only work for cells that have no text or cells where the text does not fit in the cell width).
top The statusbar is auto-positioned at top of dialog window.

/xdid flags
Control commands are input to the control with the /xdid command.
/xdid -k
This command lets you set the status bar background color.
Syntax:
/xdid -k [DNAME] [ID] [RGB]
Example:
/xdid -k dcx 4 $rgb(255,0,0)
 
Note. You can use -1 for RGB to revert to default color.

/xdid -l
This command lets you set the status bar cell divisions. Every value givin is the position of the cell's right border. For example, if you have a 600 pixel width statusbar, you could use the values 200 400 -1 to get 3 200 pixel wide cells. If a cell has the value -1 for right border position, the cell will extend to the right edge of the statusbar control.
Syntax:
/xdid -l [DNAME] [ID] [POS] (POS POS ...)
Example:
/xdid -l dcx 4 200 400 -1

/xdid -t
This command lets you set the icon, text and tooltip of a statusbar cell.
Syntax:
/xdid -t [DNAME] [ID] [N] [+FLAGS] [#ICON] (Cell Text) $chr(9) (Tooltip)
Example:
/xdid -t dcx 4 2 +p 0 Cell Text $chr(9) Cell 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.
  • Cell text is optional.
  • Tooltip is only displayed if cell text is absent or cell text is too long to fit in cell.

/xdid -v
This command lets you change the text of a statusbar cell.
Syntax:
/xdid -v [DNAME] [ID] [N] (TEXT)
Example:
/xdid -v dcx 4 2 New Text
 
Note. Text is optional.

/xdid -w
This command lets you add an icon to the statusbar image list.
Syntax:
/xdid -w [DNAME] [ID] [+FLAGS] [INDEX] [FILENAME]
Example:
/xdid -w dcx 4 + 113 C:/mIRC/shell.dll
Parameters:
+FLAGS Icon flags
g Convert to grayscale icon.
INDEX Icon index in icon archive
FILENAME Icon archive filename
 
Note. Use 0 for INDEX if the file is a single icon file.

/xdid -y
This command lets you clear the statusbar image list.
Syntax:
/xdid -y [DNAME] [ID]
Example:
/xdid -y dcx 4

$xdid() Properties
The $xdid identifier is a given mIRC alias that communicates with the DCX DLL to extract information in DCX controls.
$xdid().parts
This property lets you retreive the status bar cell division parts.
Syntax:
$xdid(dialog, ID).parts
Example:
$xdid(dcx, 4).parts

$xdid().selstart
This returns the index of the first selected character position in the control.
Syntax:
$xdid(dialog, ID).selstart
Example:
$xdid(dcx, 4).selstart

$xdid().text
This property lets you retreive the Nth status bar cell text.
Syntax:
$xdid(dialog, ID, N).text
Example:
$xdid(dcx, 4, 2).text

$xdid().tooltip
This property lets you retreive the status bar tooltip of the Nth cell.
Syntax:
$xdid(dialog, ID, N).tooltip
Example:
$xdid(dcx, 4, 3).tooltip

StatusBar Events
These events are fired when activity occurs in the StatusBar control.
dclick
Double-click over a status bar cell.
Syntax:
/cb_alias DNAME dclick ID CELL
Example:
/cb_alias dcx dclick 4
Parameters:
CELL Cell number where the event was triggered.

help
Launched when you click on a control using the ? contexthelp button.
Syntax:
/cb_alias DNAME help ID
Example:
/cb_alias dcx help 4

rclick
Right-click over a status bar cell.
Syntax:
/cb_alias DNAME rclick ID CELL
Example:
/cb_alias dcx rclick 4
Parameters:
CELL Cell number where the event was triggered.

sclick
Single left click over a status bar cell.
Syntax:
/cb_alias DNAME sclick ID CELL
Example:
/cb_alias dcx sclick 4
Parameters:
CELL Cell number where the event was triggered.

Contact © 2005-2006 Last Updated: 14th January, 07

Valid XHTML 1.0 Transitional Valid CSS!