| Home | Download | Forum | Bug Tracker

|  | v1.4.0

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.

Control Styles
grip
noauto
noparentalign
noresize
tooltips
top
/xdid Flags
-k
-l
-t
-v
-w
-y
$xdid() Properties
parts
text
tooltip
Events
dclick
help
rclick
sclick

Contact | © 2005-2007 | Last Updated: 25th December, 07