DCX - Dialog Control Xtension
 
Web Control
Web HTML control.
Root control: Static

/xdid flags
Control commands are input to the control with the /xdid command.
/xdid -c
Send commands to the browser.
Syntax:
/xdid -c [DNAME] [ID] [+FLAGS] [CMD] (ARGS)
Example:
/xdid -c dcx 4 +s opticalzoom 120
Parameters:
+FLAGS Can be any of
s Set the value.
d Display the dialog for setting this value. (may not exist on the version you have)
CMD The command to execute.
zoom [N] Set the zoom factor. (limited to 0 to 4)
opticalzoom [N] Set the optical zoom percentage. (limited to 10 to 1000)
save Save the current webpage.
saveas Save the current webpage via a save dialog.
print Print the current webpage.
printpreview View a preview of the current webpage being printed.
pagesetup Open the print setup dialog.
find Opens the browsers find dialog.
cut Cut selected content to clipboard.
copy Copy selected content to clipboard.
paste Paste clipboard to carets location in browser.
undo Undo last action.
redo Redo action that was previously undone.
selectall Select all the browsers content.
clearselection Clear the current selection.
stopdownload Stop the current download.
ARGS The arguments for the given CMD

/xdid -g
This command is like hitting the Home button in IE.
Syntax:
/xdid -g [DNAME] [ID]
Example:
/xdid -g dcx 4

/xdid -i
This command is like hitting the Forward button in IE.
Syntax:
/xdid -i [DNAME] [ID]
Example:
/xdid -i dcx 4

/xdid -j
This command lets you execute some javascript code.
Syntax:
/xdid -j [DNAME] [ID] [JAVASCRIPT CODE]
Example:
/xdid -j dcx 4 alert('Hello')

/xdid -k
This command is like hitting the Back button in IE.
Syntax:
/xdid -k [DNAME] [ID]
Example:
/xdid -k dcx 4

/xdid -m
This does the same as /xdid -n but allows setting some flags too.
Syntax:
/xdid -m [DNAME] [ID] [+FLAGS] [+MASK] (URL)
Example:
/xdid -m dcx 4 +bf +b http://dcx.scriptsdb.org
Parameters:
+FLAGS Can be any combination of
h Disable adding url to history
r Disables reading url from cache.
w Disables adding this url to cache.
a Enabled Auto Search when url fails.
e Forces url to be opened in the Restricted Zone.
m Enabled Popup Manager.
u Disabled downloads.
x Enable ActiveX Installing (You will still be prompted for allow/disallow)
b toggle address bar on/off
f toggle fullscreen on/off
s toggle statusbar on/off
+MASK is used to set the flags on or off /xdid -m dname +bf +b will turn the address bar on, & disable fullscreen.
URL is optional, if not supplied then you can use the command to just set flags.

/xdid -n
This command lets you navigate to an url.
Syntax:
/xdid -n [DNAME] [ID] [URL]
Example:
/xdid -n dcx 4 http://dcx.scriptsdb.org

/xdid -r
This command is like hitting the Refresh button in IE.
Syntax:
/xdid -r [DNAME] [ID]
Example:
/xdid -r dcx 4

/xdid -t
This command is like hitting the Stop button in IE.
Syntax:
/xdid -t [DNAME] [ID]
Example:
/xdid -t 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().opticalzoom
This property lets you retrieve the current optical zoom percentage.
Syntax:
$xdid(dialog, ID).opticalzoom
Example:
$xdid(dcx, 4).opticalzoom

$xdid().ready
This property lets you retrieve the ready state. If it is $true the control is ready for another command, else you should wait.
Syntax:
$xdid(dialog, ID).ready
Example:
$xdid(dcx, 4).ready

$xdid().script
This property lets you call a script that returns a result.
Syntax:
$xdid(dialog, ID, scriptcommand).script
Example:
$xdid(dcx, 4, document.title).script

$xdid().statusbar
This property lets you retrieve the enabled state of the statusbar. If it is $true the statusbar is displayed, otherwise it's hidden.
Syntax:
$xdid(dialog, ID).statusbar
Example:
$xdid(dcx, 4).statusbar

$xdid().statustext
This property lets you retrieve the text displayed in the statusbar.
Syntax:
$xdid(dialog, ID).statustext
Example:
$xdid(dcx, 4).statustext

$xdid().url
This property lets you retrieve the current loaded url.
Syntax:
$xdid(dialog, ID).url
Example:
$xdid(dcx, 4).url

$xdid().zoom
This property lets you retrieve the current zoom factor.
Syntax:
$xdid(dialog, ID).zoom
Example:
$xdid(dcx, 4).zoom

Web Control Events
These events are fired when activity occurs in the Web Control control.
back
When the state of the back button changes.
Syntax:
/cb_alias DNAME back ID ENABLED
Example:
/cb_alias dcx back 4 $true
 
Note. ENABLED can be either $true or $false to indicate the enabled state of the back button.

dl_begin
When downloading is about to begin.
Syntax:
/cb_alias DNAME dl_begin ID
Example:
/cb_alias dcx dl_begin 4

dl_complete
When the downloading is complete.
Syntax:
/cb_alias DNAME dl_complete ID
Example:
/cb_alias dcx dl_complete 4

dl_progress
Downloading progress update.
Syntax:
/cb_alias DNAME dl_progress ID CURRENT TOTAL
Example:
/cb_alias dcx dl_progress 4 259700 1000000
Parameters:
CURRENT Current dowload position.
TOTAL Maximum download position.
 
Note.
  • CURRENT can be -1. If anyone knows why this occurs, please let us know here.
  • TOTAL can be 0, so make sure to check this before performing any calculation with it.
  • It is advised you use the values provided by CURRENT and TOTAL to display progress as these values may change with later revisions of Internet Explorer.

doc_complete
When the document has been downloaded.
Syntax:
/cb_alias DNAME doc_complete ID URL
Example:
/cb_alias dcx doc_complete 4 http://dcx.scriptsdb.org/

forward
When the state of the forward button changes.
Syntax:
/cb_alias DNAME forward ID ENABLED
Example:
/cb_alias dcx forward 4 $false
 
Note. ENABLED can be either $true or $false to indiciate the enabled state of the forward button.

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

nav_begin
When the text is clicked.
Syntax:
/cb_alias DNAME nav_begin ID URL
Example:
/cb_alias dcx nav_begin 4 http://dcx.scriptsdb.org/
Returncancel return this value to block the navigation.

nav_complete
When the control is finished navigating to the URL.
Syntax:
/cb_alias DNAME nav_complete ID URL
Example:
/cb_alias dcx nav_complete 4 http://dcx.scriptsdb.org/

nav_error
When the control has encountered an error navigating to the URL.
Syntax:
/cb_alias DNAME nav_error ID CODE URL
Example:
/cb_alias dcx nav_error 4 404 http://dcx.scriptsdb.org/
 
Note. The code shown is an example only, don't expect that value.

status
When the statusbar text changes.
Syntax:
/cb_alias DNAME status ID NEW_TEXT
Example:
/cb_alias dcx status 4 New statusbar text

title
when the title changes.
Syntax:
/cb_alias DNAME title ID NEW_TEXT
Example:
/cb_alias dcx title 4 The other page title

win_close
When a window is attempted to be closed.
Syntax:
/cb_alias DNAME win_close ID [child|main]
Example:
/cb_alias dcx win_close 4 child
Returncancel Return this value to block the window from closing.

win_open
When a new window is attempted to be opened.
Syntax:
/cb_alias DNAME win_open ID
Example:
/cb_alias dcx win_open 4
Returncancel Return this value to block the new window from opening.

Contact © 2005-2025 Last Updated: 18th February, 25

Valid XHTML 1.0 Transitional Valid CSS!