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