DCX - Dialog Control Xtension
 
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, hidden, notheme, tabstop and transparent apply to all DCX controls except the embedded Dialog and Window controls.
grip Status bar displays a sizing grip.
noauto Prevents the statusbar from being auto-positioned and resized by the parent window. The user will be responsible for the positioning and resizing of the statusbar.
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.
  • 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.

/xdid -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:
/xdid -l [DNAME] [ID] [POS] (POS POS ...)
Example:
/xdid -l dcx 4 10% 200 400 -1

/xdid -t
This command lets you set the icon, text and tooltip of a statusbar cell. Child controls could also be created in place 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) Tooltip Text
Parameters:
N Status bar cell number to modify.
+FLAGS Status bar cell flags.
c Allows you to add controls to the statusbar (requires different syntax). Use H of for default size.
f Supports mIRC formatted text.
p Popup style border around cell.
n No borders around cell.
#ICON Icon number for the statusbar cell (0 for no icon)
Variable parameters ARGS:
c
[N] [+c] [#ICON] [CID] [CONTROL] [X] [Y] [W] [H] (STYLES)
CONTROL The type of DCX Control to create. Values can be:
button, calendar, comboex, datetime, directshow, ipaddress, listview, pbar, richedit, statusbar, toolbar, trackbar, treeview, updown, webctrl
box, check, edit, image, line, link, list, radio, scroll, text
divider, pager, panel, rebar, stacker or tab.
X The X-offset of the control is ignored but required.
Y The Y-offset of the control is ignored but required.
W The width of the control is ignored but required.
H The height of the control. The cell height is used if a value of 0 is supplied.
 
Note. 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

/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 shell32.dll
Parameters:
+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.
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().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 2
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 5
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 3
Parameters:
CELL Cell number where the event was triggered.

Contact � 2005-2009 Last Updated: 12th July, 09

Valid XHTML 1.0 Transitional Valid CSS!