DWebPro Browser is a stand alone Internet browser that can use the Microsoft Internet Explorer or Mozilla (Gecko) rendering engine. The DWebPro Browser provides many useful features, including kiosk mode. The following graphic shows the DWebPro Browser in use with DWebPro:
The DWebPro Browser
Control over the operation of the DWebPro Browser is possible by
modifying the browser.ini
configuration file that is located in the same folder of the
DWebPro Browser executable (i.e. deploy\engine\browser). You can read more
information on the options available below.
You can download the DWebPro Browser from the DWebPro add-ons Web page.
Configuring the DWebPro Browser
The fields in the DWebPro Browser configuration file,
browser.ini, are shown below:
[Browser] ; Browser settings Engine=IE DisableRightClick=1 DisableCopy=1 HideScrollBars=0 HideTaskBarIcon=0 KioskMode=0 Silent=1 HideHost=1 AvoidFlicker=0
FullScreen=0 UseFixedTitle=1 FixedTitle=DWebPro Browser 2 [##PAGE_TITLE##] UseFixedSize=1 FixedWidth=790 FixedHeight=450 WindowState=Normal BorderStyle=Sizeable BorderIconSystemMenu=1 BorderIconMinimize=1 BorderIconMaximize=1
StayOnTop=1 AlwaysOnTop=1 ShowAddressBar=1 ShowNavigationBar=1 ShowStatusBar=1 ShowProgressBar=1 DisableStatusText=1 [KioskMode] ; Kiosk Mode settings AltTab=1 AltEsc=1 AltF4=0 WinKeys=1 AppKey=1 CtrlEsc=1 AltReturn=1 TaskBar=1 Desktop=1 StartButton=1 SysTray=1 TaskLinks=1 TaskManager=1 RightClick=0 CloseShortCut=Shift+F4 ClosePassword=password [PrintOptions] ; Print settings DisablePrint=0 EnableOptions=1 Header=DWeb Browser Header Footer=DWeb Browser Footer MarginBottom=1.00000 MarginLeft=1.00000 MarginRight=1.00000 MarginTop=1.00000
Browser Engine
Engine
Engine
specifies whether the DWebPro Browser uses the Internet Explorer or
Gecko/Mozilla rendering engine. The default setting is
IE.
Accepted values: IE, Gecko
Disable Right Click
DisableRightClick
DisableRightClick specifies whether the DWebPro
Browser allows the right-click context menu in the browser. This
feature works only with the IE rendering engine. Set this value to
0 to allow the right-click context menu or 1 to
disallow the right-click context menu. The default setting is
1.
Accepted values: 0, 1
Disable Copy
DisableCopy
DisableCopy specifies whether the DWebPro
Browser allows the copy/cut (i.e., CTRL+C, CTRL+X) feature. Set
this value to 0 to allow the copy/cut feature or 1 to
disallow the copy/cut feature. The default setting is
1.
Accepted values: 0, 1
Disable Cache
DisableCache
DisableCache specifies whether the DWebPro
Browser uses the internal cache to speed up the web pages
rendering. Set this value to 0 to allow the use of the cache
or 1 to disallow it. The default setting is
0.
Accepted values: 0, 1
Hide ScrollBars
HideScrollBars
HideScrollBars specifies whether the DWebPro
Browser hides or displays the vertical and horizontal scrollbars.
This feature works only with the IE rendering engine. Set this
value to 0 to hide scrollbars or 1 to show
scrollbars. The default setting is 0.
Accepted values: 0, 1
Hide TaskBar Icon
HideTaskBarIcon
HideTaskBarIcon specifies whether the DWebPro
Browser displays the application icon in the Windows taskbar. Set
this value to 0 to not show the application in the Windows
taskbar or 1 to show the application in the Windows taskbar.
The default setting is 0.
Accepted values: 0, 1
Kiosk Mode
KioskMode
KioskMode specifies whether the DWebPro Browser
should process settings in the [KioskMode] section of the
browser.ini file. Set this value to
0 to not process [KioskMode] settings or 1 to
process [KioskMode] settings. The default setting is
0.Accepted values: 0, 1
Silent
Silent
Silent
specifies whether the DWebPro Browser should display JavaScript
error messages, if they occur. Set this value to 0 to
display JavaScript error messages or 1 to not display
JavaScript error messages. The default setting is 1.
Accepted values: 0, 1
Hide Host
HideHost
HideHost specifies whether the DWebPro Browser
should hide or display the host portion of the URL in the browser's
address bar. For example, a URL of:
http://localhost:8080/catalog/index.php would display as:
/catalog/index.php if you hide the host. Set this value to
0 to show the full URL or 1 to hide the host portion
of the URL. The default setting is 1.
Accepted values: 0, 1
Avoid Flicker
AvoidFlicker
The AvoidFlicker field specifies if the DWebPro
Browser has to avoid the flicker of the web page (this happens due
to an internal bug of the MSHTML ActiveX). This feature works only
with the IE render engine. Set this value to 0 to avoid page
flicker 1 to disable this feature. The default setting is
0.
Accepted values: 0, 1
Full Screen
FullScreen
The FullScreen field specifies if
display the browser window in full screen. Set thus value to
1 for fullscreen, 0 for normal
window. The default setting is 0.
Accepted values: 0, 1
Use Fixed Title
UseFixedTitle
UseFixedTitle specifies whether the DWebPro
Browser should shows fixed title, as specified in the
FixedTitle field as a form caption or use the current page
title. Set this value to 0 to use the current page title or
1 to use the FixedTitle field value as the caption.
The default setting is 1.
Accepted values: 0, 1
Fixed Title
FixedTitle
FixedTitle specifies the title that DWebPro
Browser displays when the UseFixedTitle field is set to
1. If UseFixedTitle field is set to 1, you can
use a value in this field of ##PAGE_TITLE## to replace the
title with that of the current page. The default setting is DWeb
Browser 2 [##PAGE_TITLE##].
Accepted values: string
Use Fixed Size
UseFixedSize
UseFixedSize specifies whether the DWebPro
Browser should display at a fixed size, as defined by the
FixedWidth and FixedHeight fields. Set this value to
0 to not use fixed sizing or 1 to use fixed sizing,
as defined in the FixedWidth and FixedHeight fields.
The default setting is 1.
Accepted values: 0, 1
Fixed Width
FixedWidth
FixedWidth specifies the width, in pixels, of
the DWebPro Browser when using the UseFixedSize option. The
default setting is 790.
Accepted values: integer
Fixed Height
FixedHeight
FixedHeight specifies the height, in pixels, of
the DWebPro Browser when using the UseFixedSize option. The
default setting is 450.
Accepted values: integer
Window State
WindowState
WindowState specifies the initial state of the
DWebPro Browser. Valid options are: Normal,
Minimized, or Maximized. The default setting is
Normal.
Accepted values: Normal, or Minimized, or
Maximized
Border Style
BorderStyle
BorderStyle specifies the border style to use for the DWebPro Browser. Valid options are: Sizeable, Dialog, None, Single, SizeToolWin, or ToolWindow. The default setting is Sizeable.
Sizeable
|
Standard resizable border | |
Dialog
|
Not resizable, standard dialog box border | |
Single
|
Not resizable, single-line border | |
None
|
Not resizable, no visible border line | |
ToolWindow
|
Like Single but with a smaller caption | |
SizeToolWin
|
Like Sizeable with a smaller caption |
Accepted values: Sizeable, or Dialog, or
None, or Single, or SizeToolWin, or ToolWindow
Border Icon System Menu
BorderIconSystemMenu
BorderIconSystemMenu specifies whether the
DWebPro Browser displays the system menu icon in the title bar. Set
this value to 0 to not display the system menu icon or
1 to display the system menu icon. The default setting is
1.
Accepted values: 0, or 1
Border Icon Minimize
BorderIconMinimize
BorderIconMinimize specifies whether the DWebPro
Browser displays the minimize button in the title bar. Set this
value to 0 to not display the minimize button or 1 to
display the minimize button. The default setting is 1.
Accepted values: 0, or 1
Border Icon Maximize
BorderIconMaximize
BorderIconMaximize specifies whether the DWebPro
Browser displays the maximize button in the title bar. Set this
value to 0 to not display the maximize button or 1 to
display the maximize button. The default setting is 1.
Accepted values: 0, or 1
Stay On Top
StayOnTop
StayOnTop specifies if DWebPro Browser has
display itself as top most form or not. Other windows can be over
the the DWebPro Browser window if they set them as top most windows
as well. Set this value to 0 to display the DWebPro Browser
as a normal window or 1 to display the DWebPro Browser as a
top-most window. The default setting is 1.
Accepted values: 0, or 1
Always On Top
AlwaysOnTop
AlwaysOnTop specifies if DWebPro Browser has
display itself as top most form or not even when it is deactivated.
This setting is usally used for Kiosk mode use. This configuration
fields overrides StayOnTop. Set this value to 0 to display
the DWebPro Browser as a normal window or 1 to display the
DWebPro Browser as a top-most window. The default setting is
1.
Accepted values: 0, or 1
Show Address Bar
ShowAddressBar
ShowAddressBar specifies whether the DWebPro
Browser displays the address box. Set this value to 0 to
hide the address box or 1 to display the address box. The
default setting is 1.
Accepted values: 0, or 1
Show Navigation Bar
ShowNavigationBar
ShowNavigationBar specifies whether the DWebPro
Browser displays the navigation bar. Set this value to 0 to
hide the navigation bar or 1 to display the navigation bar.
The default setting is 1.
Accepted values: 0, or 1
Show Status Bar
ShowStatusBar
ShowStatusBar specifies whether the DWebPro
Browser displays the status bar. Set this value to 0 to hide
the status bar or 1 to display the status bar. The default
setting is 1.
Accepted values: 0, or 1
Show Progress Bar
ShowProgressBar
ShowProgressBar specifies whether the DWebPro
Browser displays the progress bar. Set this value to 0 to
hide the progress bar or 1 to display the progress bar. The
default setting is 1.
Accepted values: 0, or 1
Disable Status Text
DisableStatusText
DisableStatusText specifies whether the DWebPro
Browser displays status messages in the status bar. Set this value
to 0 to hide status messages or 1 to display status
messages. The default setting is 1.
Accepted values: 0, or 1
Alt Tab
AltTab
The kiosk-mode specific setting,
AltTab, specifies whether the
DWebPro Browser responds to the Windows ALT+TAB key combination.
Set this value to 0 to not respond to the ALT+TAB key
combination or 1 to respond to the ALT+TAB key combination.
The default setting is 1.
Accepted values: 0, or 1
Alt Esc
AltEsc
The kiosk-mode specific setting,
AltEsc, specifies whether the
DWebPro Browser responds to the Windows ALT+ESC key combination.
Set this value to 0 to not respond to the ALT+ESC key
combination or 1 to respond to the ALT+ESC key combination.
The default setting is 1.
Accepted values: 0, or 1
Alt F4
AltF4
The kiosk-mode specific setting,
AltF4, specifies whether the DWebPro
Browser responds to the Windows ALT+F4 key combination. Set this
value to 0 to not respond to the ALT+F4 key combination or
1 to respond to the ALT+F4 key combination. The default
setting is 0.
Accepted values: 0, or 1
Win Keys
WinKeys
The kiosk-mode specific setting,
WinKeys, specifies whether the
DWebPro Browser responds to the Windows key. Set this value to
0 to not respond to the Windows key or 1 to respond
to the Windows key. The default setting is 1.
Accepted values: 0, or 1
App Key
AppKey
The kiosk-mode specific setting,
AppKey, specifies whether the
DWebPro Browser responds to the Windows application key. Set this
value to 0 to not respond to the Windows application key or
1 to respond to the Windows application key. The default
setting is 1.
Accepted values: 0, or 1
Ctrl Esc
CtrlEsc
The kiosk-mode specific setting,
CtrlEsc, specifies whether the
DWebPro Browser responds to the Windows CTRL+ESC key combination.
Set this value to 0 to not respond to the Windows CTRL+ESC
key combination or 1 to respond to the Windows CTRL+ESC key
combination. The default setting is 1.
Accepted values: 0, or 1
Alt Return
AltReturn
The kiosk-mode specific setting,
AltReturn, specifies whether the
DWebPro Browser responds to the Windows ALT+RETURN key combination.
Set this value to 0 to not respond to the Windows ALT+RETURN
key combination or 1 to respond to the Windows ALT+RETURN
key combination. The default setting is 1.
Accepted values: 0, or 1
Task Bar
TaskBar
The kiosk-mode specific setting,
TaskBar, specifies whether the
DWebPro Browser displays the task bar while in kiosk mode. Set this
value to 0 to hide the task bar or 1 to display the
task bar. The default setting is 1.
Accepted values: 0, or 1
Desktop
Desktop
The kiosk-mode specific setting,
Desktop, specifies whether the
DWebPro Browser allows access to the desktop while in kiosk mode.
Set this value to 0 to disallow access to the desktop or
1 to allow access to the desktop. The default setting is
1.
Accepted values: 0, or 1
Start Button
StartButton
The kiosk-mode specific setting,
StartButton, specifies whether the
DWebPro Browser allows access to the Windows Start button while in
kiosk mode. Set this value to 0 to disallow access to the
Start button or 1 to allow access to the Start button. The
default setting is 1.
Accepted values: 0, or 1
Sys Tray
SysTray
The kiosk-mode specific setting,
SysTray, specifies whether the
DWebPro Browser allows access to the Windows system tray while in
kiosk mode. Set this value to 0 to disallow access to the
system tray or 1 to allow access to the system tray. The
default setting is 1.
Accepted values: 0, or 1
Task Links
TaskLinks
The kiosk-mode specific setting,
TaskLinks, specifies whether the
DWebPro Browser allows access to Windows task links while in kiosk
mode. Set this value to 0 to disallow access to task links
or 1 to allow access to task links. The default setting is
1.
Accepted values: 0, or 1
Task Manager
TaskManager
The kiosk-mode specific setting,
TaskManager, specifies whether the
DWebPro Browser allows access to the Windows Task Manager while in
kiosk mode. Set this value to 0 to disallow access to Task
Manager or 1 to allow access to Task Manager. The default
setting is 1.
Accepted values: 0, or 1
Right Click
RightClick
The kiosk-mode specific setting,
RightClick, specifies whether the
DWebPro Browser allows access to the Windows right-click context
menu while in kiosk mode. Set this value to 0 to disallow
access to the right-click context menu or 1 to allow access
to the right-click context menu. The default setting is
1.
Accepted values: 0, or 1
Close Short Cut
CloseShortCut
The kiosk-mode specific setting,
CloseShortCut, specifies the
shortcut keys to close the DWebPro Browser. The default setting is
Shift+F4.
Accepted values: string
Close Password
ClosePassword
The kiosk-mode specific setting,
ClosePassword, specifies the
password prompted of the user before allowing the DWebPro Browser
to be closed. The default setting is password.
Accepted values: string
Disable Print
DisablePrint
DisablePrint specifies whether the DWebPro
Browser allows printing. Set this value to 1 to disable
printing or 0 to allow printing. The default setting is
0. Note that this field is relevant only with the IE
rendering engine. When using the Gecko rendering engine, refer to
the Print header customization section in the
gecko\greprefs\all.js configuration file.Accepted values: 0, or 1
Enable Options
EnableOptions
EnableOptions specifies whether the DWebPro
Browser enables printing options. Set this value to 1 to
enable printing options or 0 to disable printing options.
The default setting is 1. Note that this field is relevant
only with the IE rendering engine. When using the Gecko rendering
engine, refer to the Print header customization section in
the
gecko\greprefs\all.js
configuration file.Accepted values: 0, or 1
Header
Header
Header
specifies the header text that accompanies printed pages from the
DWebPro Browser. The default setting is DWeb Browser Header.
Note that this field is relevant only with the IE rendering engine.
When using the Gecko rendering engine, refer to the Print header
customization section in the
gecko\greprefs\all.js configuration file.Accepted values: string
Footer
Footer
Footer
specifies the footer text that accompanies printed pages from the
DWebPro Browser. The default setting is DWeb Browser Footer.
Note that this field is relevant only with the IE rendering engine.
When using the Gecko rendering engine, refer to the Print header
customization section in the
gecko\greprefs\all.js configuration file.Accepted values: string
Margin Bottom
MarginBottom
MarginBottom specifies the bottom margin, in the
established user measurement units, used for printed pages from the
DWebPro Browser. The default setting is 1.00000. Note that
this field is relevant only with the IE rendering engine. When
using the Gecko rendering engine, refer to the Print header
customization section in the
gecko\greprefs\all.js configuration file.Accepted values: integer
Margin Left
MarginLeft
MarginLeft specifies the left margin, in the
established user measurement units, used for printed pages from the
DWebPro Browser. The default setting is 1.00000. Note that
this field is relevant only with the IE rendering engine. When
using the Gecko rendering engine, refer to the Print header
customization section in the
gecko\greprefs\all.js configuration file.Accepted values: integer
Margin Right
MarginRight
MarginRight specifies the right margin, in the
established user measurement units, used for printed pages from the
DWebPro Browser. The default setting is 1.00000. Note that
this field is relevant only with the IE rendering engine. When
using the Gecko rendering engine, refer to the Print header
customization section in the
gecko\greprefs\all.js configuration file.Accepted values: integer
Margin Top
MarginTop
MarginTop specifies the top margin, in the
established user measurement units, used for printed pages from the
DWebPro Browser. The default setting is 1.00000. Note that
this field is relevant only with the IE rendering engine. When
using the Gecko rendering engine, refer to the Print header
customization section in the
gecko\greprefs\all.js configuration file.Accepted values: integer
How to configure the http.ini file to make DWebPro start the DWebPro Browser
The DWebPro Browser installer automatically configures the
http.ini to start the DWebPro Browser
instead of the default browser. If this doesn't happen or if you
want to configure manually the http.ini you should use the following
settings:
[Browser] OpenUrl=1 Params=%s Url=http://##DWEBPRO_HOSTNAME##:##DWEBPRO_WEBSERVER_PORT##/ Path=##DWEBPRO_PATH##\engine\browser\browser.exe
