BBjHtmlView

Description

The BBjHtmlView control displays HTML files, and can act as a complete embedded web browser, with support for HTML5, CSS, and JavaScript.

The BBjHtmlView can be configured through STBL options to be either an embedded WebKit browser using JavaFX, or an embedded Chromium-based browser. See STBL Options for BBjHtmlView below.

Access to the JAVAFX_HTMLVIEW and CHROMIUM_HTMLVIEW features requires an active Software Asset Management (SAM) subscription. See Benefits of ‘Software Asset Management' Feature Line.

Implemented Interfaces

DragSource, DropTarget, Focusable, TabTraversable

Creation

BBjAPI > BBjSysGui > BBjWindow > BBjHtmlView

A BBjHtmlView object is created through the following BBjWindow methods:

Return Value	Method
BBjHtmlView	addHtmlView(int ID, number x, number y, number w, number h, string html)
BBjHtmlView	addHtmlView(int ID, number x, number y, number w, number h, string html, string flags)
BBjHtmlView	addHtmlView(int ID, number x, number y, number w, number h, string html, string flags, string chromium_switches$)
BBjHtmlView	addHtmlView(int ID, String html)
BBjHtmlView	addHtmlView(int ID, String html, string flags)
BBjHtmlView	addHtmlView(int ID, String html, string flags, string chromium_switches)
BBjHtmlView	addHtmlView(String html)
BBjHtmlView	addHtmlView(String html, string flags)
BBjHtmlView	addHtmlView(String html, string flags, string chromium_switches)

Methods of BBjHtmlView

Return Value	Method
int	executeAsyncScript(String `script`)
int	executeAsyncScript(String `script`, boolean `await`)
int	executeAsyncScript(String `script`, boolean `await`, boolean `event`)
Object	executeScript(String `script`)
Object	executeScript(String `script`, boolean `await`)
boolean	getAutoNavigate()
string	getClientType()
string	getClientVersion()
string	getDownloadDirectory()
BBjImage	getImage()
string	getText()
string	getUrl()
string	getUserAgent()
void	injectScript(String `script`)
void	injectScript(String `script`, boolean `top`)
void	injectUrl(String `url`)
void	injectUrl(String `url`, boolean `top`)
boolean	print()
void	setAutoNavigate(boolean `autoNavigate`)
void	setDownloadDirectory(String `directory`)
void	setUrl(String `url`)
void	setUrl(String `url`, boolean `reload`)
void	setUserAgent(String `userAgent`)

Methods of BBjHtmlView implemented for DragSource

Return Value	Method
int	getDragActions()
string	getDragType()
void	setDragActions(int `actions`)
void	setDragType(string `type`)

Methods of BBjHtmlView implemented for DropTarget

Return Value	Method
int	getDropActions()
void	setDropActions(int `actions`)
BBjVector	getDropTypes()
void	setDropTypes(BBjVector `types`)

Methods of BBjHtmlView implemented for Focusable

Return Value	Method
boolean	isFocusable()
void	setFocusable(boolean `focus`)

Methods of BBjHtmlView implemented for TabTraversable

Return Value	Method
boolean	isTabTraversable()
void	setTabTraversable(boolean `trav`)

Methods of BBjHtmlView inherited from BBjControl

Constants inherited from BBjControl

Events

Callback Code	Object-oriented Event	Read Record Event	Code
ON_DROP_TARGET_DROP	BBjDropTargetDropEvent	Drop Target Drop Event	D
ON_GAINED_FOCUS	BBjGainedFocusEvent	Control Focus Gained/Lost Event	f
ON_EXECUTE_SCRIPT	BBjExecuteScriptEvent	ExecuteScriptEvent	x
ON_HTMLVIEW_DOWNLOAD	BBjHtmlViewDownloadEvent	HtmlView Download Event	x
ON_HYPERLINK_ACTIVATE	BBjHyperlinkActivateEvent	Hyperlink Activate Event	x
ON_HYPERLINK_ENTER	BBjHyperlinkEnterEvent	Hyperlink Enter Event	x
ON_HYPERLINK_EXIT	BBjHyperlinkExitEvent	Hyperlink Exit Event	x
ON_LOST_FOCUS	BBjLostFocusEvent	Control Focus Gained/Lost Event	f
ON_MOUSE_ENTER	BBjMouseEnterEvent	Mouse Enter/Exit Event	E
ON_MOUSE_EXIT	BBjMouseExitEvent	Mouse Enter/Exit Event	E
ON_NATIVE_JAVASCRIPT	BBjNativeJavaScriptEvent	Native JavaScript Event	x
ON_PAGE_LOADED	BBjPageLoadedEvent	Page Loaded Event	x
ON_POPUP_REQUEST	BBjPopupRequestEvent	Popup Request Event	r
ON_RIGHT_MOUSE_DOWN	BBjRightMouseDownEvent	Right Mouse Button Down Event	R
ON_SCRIPT_FAILED	BBjScriptFailedEvent	Script Failed Event	x
ON_SCRIPT_LOADED	BBjScriptLoadedEvent	Script Loaded Event	x

BUI CSS

STBL Options for BBjHtmlView

Version History

BBj 24.11: Added an optional event argument for executeAsyncScript.

Example

rem ' BBjHtmlView
url$ = "https://en.wikipedia.org"
sysgui = unt
open (sysgui)"X0"
sysgui! = bbjapi().getSysGui()
if info(3,6)<>"5" and info(3,6)<>"6" then
   client = msgbox("BBjHtmlView Client",7+32+512,"BBjHtmlView","Swing","JavaFX","Chromium")
   switch client
      case 1; rem ' Swing
         print stbl("!OPTIONS","CHROMIUM_HTMLVIEW=FALSE",ERR=*NEXT)
         print stbl("!OPTIONS","JAVAFX_HTMLVIEW=FALSE",ERR=*NEXT)
         break
      case 2; rem ' JavaFX
         print stbl("!OPTIONS","CHROMIUM_HTMLVIEW=FALSE",ERR=*NEXT)
         print stbl("!OPTIONS","JAVAFX_HTMLVIEW=TRUE",ERR=*NEXT)
         break
      case 3; rem ' Chromium
         print stbl("!OPTIONS","CHROMIUM_HTMLVIEW=TRUE",ERR=*NEXT)
         print stbl("!OPTIONS","JAVAFX_HTMLVIEW=TRUE",ERR=*NEXT)
         break
   swend
endif
window! = sysgui!.addWindow(25,25,600,500,url$,$00090083$)
window!.setCallback(window!.ON_CLOSE,"eoj")
window!.setCallback(window!.ON_RESIZE,"resize")
htmlview! = window!.addHtmlView(102,25,25,550,450,"",$$)
htmlview!.setUrl(url$)
clientType$ = htmlview!.getClientType()
clientVersion$ = htmlview!.getClientVersion()
title$ = window!.getTitle() + " " + clientType$ + " " + clientVersion$
window!.setTitle(title$)
process_events

eoj:
release

resize:
  gosub event
  width = event!.getWidth() - 50
  height = event!.getHeight() - 50
  htmlview!.setSize(width,height)
  print width,height
return

event:
  event! = sysgui!.getLastEvent()
  print event!.getEventName()," ",event!.getControl()
return