User    Pass    













Key Benefits




Standards Supported




Download Now


API Documentation


Developers Guide


Code Examples


Updated Builds


Technical Articles






Jump to:

General WebRenderer Functions

  WebRenderer example code base.


Advanced WebRenderer functions


Application test examples


Deploying WebRenderer

WebRenderer DOM




WebRenderer Event Listeners




All WebRenderer events are processed through the com.webrenderer.event package classes. Events available in this package include:

 Example code:

 Event categories:



WebRenderer provides many powerful Events that help track the progress and interactivity of rendered documents.

Browser, Network, Mouse, Keyboard, Print, DOM, JavaScript and Window events are available for each WebRenderer browser canvas.

Usage and details of the WebRenderer events are as follows;

 Browser Events  (click for more info) 
 Network Events
 Mouse Events
 Keyboard Events
 Print Events
 DOM Events
 JavaScript Events
 Prompt Events
 Window Events

Browser Events: 

onBeforeNavigate description

The WebRenderer BrowserListener and BrowserAdapter makes available URLs loading, HTTP Header information, HTTP POST information, page titles, width and height etc.

browser.addBrowserListener(new BrowserListener() {
     // Fired as a document is navigating to a new URL
     public void onBeforeNavigate(BrowserEvent e) {
     // Fired before a document has started loading - Use this to cancel document loads
     public void onLoadIntercept(BrowserEvent e) {
              System.out.println("onLoadIntercept :"+e.getURL());
              // If the loading URL contains "www.google.com"
              if(e.getURL().indexOf("www.google.com") != -1) {
                        // Stopping the document from loading
     // Fired when links in the browser status bar change - such as moving the mouse over URLs
     public void onLinkChange(BrowserEvent e) {
     // Fired when page loading is cancelled
     public void onNavigationCancelled(BrowserEvent e) {
              System.out.println("onNavigationCancelled: " + e.getURL());
     // Fired when the document title changes
     public void onTitleChange(BrowserEvent e) {
              // The document title is available
              System.out.println("onTitleChange: " + e.getTitle());
     // Fired when the URL changes
     public void onURLChange(BrowserEvent e) {
              System.out.println("onURLChange: ");

Network Events:

The NetworkListener and NetworkAdapter classes provde WebRenderer with useful information regarding the document loading process.

IBrowserCanvas browser = BrowserFactory.spawnMozilla();

browser.addNetworkListener(new com.webrenderer.event.NetworkListener() {
     // Fired when a document completes downloading
     public void onDocumentComplete(com.webrenderer.event.NetworkEvent e) {
              System.out.println("onDocumentComplete - Document completed downloading");
     // Fired when a document begins loading
     public void onDocumentLoad(com.webrenderer.event.NetworkEvent e) {
      // Fired when an HTTP response is received (only fired for IMozillaBrowserCanvas)
      public void onHTTPResponse(com.webrenderer.event.NetworkEvent e) {
               System.out.println("onHTTPResponse - (e.getStatusText()): "+ e.getStatusText());
               System.out.println("onHTTPResponse - (e.getStatus()): "+ e.getStatus());
               System.out.println("onHTTPResponse - (e.getHeaders()): "+ e.getHeaders()); 
      // Fired if there is a network error
      public void onNetworkError(com.webrenderer.event.NetworkEvent e) {
               System.out.println("onNetworkError - (e.getFailure()): "+ e.getFailure());
      // Fired when the network status changes - Status is the paged download progress
      public void onNetworkStatus(com.webrenderer.event.NetworkEvent e) {
               System.out.println("onNetworkStatus  - (e.getStatus()): "+e.getStatus());
      // Fired to update the progress of the document load - useful for status and progress bars
      public void onProgressChange(com.webrenderer.event.NetworkEvent e) {
               System.out.println("onProgressChange - (e.getCurrentProgress): "+ e.getCurrentProgress());
               System.out.println("onProgressChange - (e.getMaximumProgress): "+ e.getMaximumProgress());

Capturing Key Events within WebRenderer

Capturing Key Events witin the WebRenderer component follow standard Java convention. A key listener is added to the component, and the events are implemented and results are returned.

IBrowserCanvas browser = BrowserFactory.spawnMozilla();

browser.addKeyListener(new com.webrenderer.event.KeyListener() {
     // Fired when a key is pressed - combination of key down and key up
     public void onKeyPress(com.webrenderer.event.KeyEvent e) {
              System.out.println("Key pressed:"+e);
     // Fired when a key is held down
     public void onKeyDown(com.webrenderer.event.KeyEvent e) {
               System.out.println("Key down");
      // Fired when a key is released
      public void onKeyUp(com.webrenderer.event.KeyEvent e) {
               System.out.println("Key up");

Capturing Mouse Events within WebRenderer

Capturing Mouse Events within the WebRenderer component follows convention in standard java. A Mouse listener is added, interfaces are implemented  and events are returned to the browsers functions.

browser = BrowserFactory.spawnMozilla();

browser.addMouseListener(new com.webrenderer.event.MouseListener() {
       public void onClick(com.webrenderer.event.MouseEvent e){
                 System.out.println("Mouse pressed:"+e);
                 // Finding out what button has been pressed
                 if ((e.getModifiers() & 4)>0)
                        System.out.println("Right Button Pressed");
                        System.out.println("Left Button Pressed");
       public void onMouseDown(com.webrenderer.event.MouseEvent e) {
                 System.out.println("Mouse down");
       public void onMouseUp(com.webrenderer.event.MouseEvent e) {
                 System.out.println("Mouse up");
       public void onDoubleClick(com.webrenderer.event.MouseEvent e) {
                  System.out.println("Double Click");

Print Events:

The WebRenderer print listener tracks the status of print jobs firing on status changes.

browser.addPrintListener(new PrintListener() {
       // Fires when the printer status changes after calling IBrowserCanvas print method
       public void onStatusChange(PrintEvent e) {
                 // Gets the status of the print job - which is either start, cancelled or undefined
                 System.out.println("Print status changed to: " + e.getStatus());

DOM Events:

The DOM Event listener class is useful for listening for changes within HTML pages namely on input and selection elements such as checkboxes, radio buttons, buttons and textfields.

browser.addDOMListener(new DOMListener() {
       // Fires when the printer status changes after calling IBrowserCanvas print method
       public void onButtonClicked(DOMEvent e) {
                 // Fired when any HTML Button is clicked
                 System.out.println("HTML Button clicked");
                 // Getting the selected element
                 IElement element = e.getTargetElement();
       public void onCheckboxChecked(DOMEvent e) {
                 // Fired when any HTML Checkbox is selected
                 System.out.println("HTML Checkbox selected");
                 // Getting the selected element
                 IElement element = e.getTargetElement();
       public void onCheckboxUnchecked(DOMEvent e) {
                 // Fired when any HTML Checkbox is un-checked/selected
                 System.out.println("HTML Checkbox unselected");
                 // Getting the selected element
                 IElement element = e.getTargetElement();
       public void onInputTextChanged(DOMEvent e) {
                 // Fired when any HTML Text input field changes
                 System.out.println("HTML Text input changed");
                 // Getting the selected element
                 IElement element = e.getTargetElement();
       public void onRadioSelected(DOMEvent e) {
                 // Fired when any HTML Radio Button is selected
                 System.out.println("HTML Radio Button selected");
                 // Getting the selected element
                 IElement element = e.getTargetElement();

Javascript Events:

The onJavaDialog event is fired when a Javascript error dialog is shown. The purpose of this event is to know when a Javascript error dialog is to be shown and handle it in a graceful manner. The blockDialog method in JavascriptEvent prevents the dialog from showing.

browser.addJavascriptListener(new JavascriptListener(){
       public void onJavascriptDialog(JavascriptEvent e) {
                 e.blockDialog(); //Stops the dialog from being shown

Prompt Events:

Prompt Events are fired when a Javascript alert dialog is shown (Internet Explorer) or any dialog is shown (Mozilla). Using the blockDialog method in PromptEvent one can prevent dialogs from showing and therefore not require user interaction.

browser.addPromptListener(new PromptListener(){
       public void onPromptDialog(PromptEvent e) {
                 System.out.println("Blocking a dialog with type: "+e.getDialogType());
                 e.blockPromptDialog(); //Stops the dialog from being shown

Window Events:

The Window Events class allows for the captuing of popup window events and gives handles to the popup window browser objects. The Window Event class also has methods for capturing popup window resize and destroy events.

browser.addWindowListener(new WindowListener() {
       // Fired when a popup window is to be displayed

       public void onNewWindow(WindowtEvent e) {
                 // If this event is captured you must handle the display of the popup window
                 IBrowserCanvas browser = e.getPopupBrowser();
                 // The browser can then be placed into a JFrame and displayed. This is useful for customizing popups.
       // Fired when the Window receives a resize event
       public void onWindowResize(WindowtEvent e) {
                 System.out.println("Browser resize event: - Width: " + e.getWidth() + " and Height: " + e.getHeight() );
       // Fired when the browser window is destroyed
       public void onWindowDestroy(WindowtEvent e) {
                 System.out.println("Browser Window destroyed");




Millions of deployments and counting.. Users of JadeLiquid's tools can be found in every corner of the Earth




 > Enabling Flash in WebRenderer - Article
 > Browser Zoom Effect using WebRenderer - Article
 > Applet deployment techniques - Article
 > WebRenderer core features on display! - Article
   Additional News  
 > Enabling HTML 5 WebSockets in WebRenderer - Blog
 > 64bit WebRenderer deployment with Web Start - Blog
 > Deploying WebRenderer Server Edition in Tomcat - Blog
 > WebRenderer 6 adds performance text search - Blog


 Java and the Java Logo are trademarks or registered trademarks of Oracle Corporation in the United States and other countries 

Privacy Policy  |   Disclaimer