com.teamdev.jexplorer.event

Class NavigationAdapter

java.lang.Object

com.teamdev.jexplorer.event.NavigationAdapter

All Implemented Interfaces:

NavigationListener

public abstract class NavigationAdapter
extends java.lang.Object
implements NavigationListener

An abstract adapter class for receiving navigation events.

Constructor Summary

Constructors

Constructor and Description
NavigationAdapter()

Method Summary

Methods

Modifier and Type	Method and Description
void	downloadBegin() Invoked when a navigation operation begins.
void	downloadComplete() Invoked when a navigation operation finishes, is halted, or fails.
void	frameDocumentCompleted(Browser browser, java.lang.String url) Invoked when a document has been completely loaded and initialized.
void	mainDocumentCompleted(Browser browser, java.lang.String url) Invoked when main document has been completely loaded and initialized.
void	navigationCompleted(Browser browser, java.lang.String url) Invoked when navigation operation has been completed.
void	progressChanged(int progress, int progressMax) Invoked when the progress of download operation has been updated.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NavigationAdapter

public NavigationAdapter()

Method Detail

downloadBegin

public void downloadBegin()

Description copied from interface: NavigationListener

Invoked when a navigation operation begins.

This event is fired shortly after the EventsHandler.beforeNavigate(com.teamdev.jexplorer.Browser, String, String, byte[], String) event, unless the navigation is canceled. Any animation or "busy" indication that the container needs to display should be connected to this event.

Each downloadBegin event will have a corresponding downloadCompleted event.

Specified by:

downloadBegin in interface NavigationListener

downloadComplete

public void downloadComplete()

Description copied from interface: NavigationListener

Invoked when a navigation operation finishes, is halted, or fails.

Unlike navigationCompleted, which are fired only when a URL is successfully navigated to, this event is always fired after a navigation starts. Any animation or "busy" indication that the container needs to display should be connected to this event.

Each downloadBegin event will have a corresponding downloadCompleted event.

Specified by:

downloadComplete in interface NavigationListener

frameDocumentCompleted

public void frameDocumentCompleted(Browser browser,
                          java.lang.String url)

Description copied from interface: NavigationListener

Invoked when a document has been completely loaded and initialized.

- In pages with no frames or where multiple frames are loaded, this event fires once after loading is complete.
- In pages where multiple frames are loaded, this event fires for each frame where the downloadBegin event has fired.

The value of the URL parameter might not match the URL that was originally given to the WebBrowser Control. One possible reason for this is that the URL might be converted to a qualified form. For example, if an application specified a URL of www.teamdev.com in a call to the WebBrowser.navigate method, then the URL passed into this event is http://www.teamdev.com/. In addition, if the server has redirected the browser to a different URL, the redirected URL is passed into the URL parameter.

Specified by:

frameDocumentCompleted in interface NavigationListener

Parameters:

browser - browser instance in which this event is fired.

url - url of loaded document

mainDocumentCompleted

public void mainDocumentCompleted(Browser browser,
                         java.lang.String url)

Description copied from interface: NavigationListener

Invoked when main document has been completely loaded and initialized. In pages with no frames or where multiple frames are loaded, this event fires once after loading is complete.

The value of the URL parameter might not match the URL that was originally given to the WebBrowser Control. One possible reason for this is that the URL might be converted to a qualified form. For example, if an application specified a URL of www.teamdev.com in a call to the WebBrowser.navigate method, then the URL passed into this event is http://www.teamdev.com/. In addition, if the server has redirected the browser to a different URL, the redirected URL is passed into the URL parameter.

Specified by:

mainDocumentCompleted in interface NavigationListener

Parameters:

browser - browser instance in which this event is fired.

url - url of loaded document

navigationCompleted

public void navigationCompleted(Browser browser,
                       java.lang.String url)

Description copied from interface: NavigationListener

Invoked when navigation operation has been completed.

Internet Explorer 6: this method invoked after first navigation only.

Specified by:

navigationCompleted in interface NavigationListener

Parameters:

browser - browser object in which this event is fired.

url - url of loaded document

progressChanged

public void progressChanged(int progress,
                   int progressMax)

Description copied from interface: NavigationListener

Invoked when the progress of download operation has been updated.

Specified by:

progressChanged in interface NavigationListener

Parameters:

progress - value that specifies current progress, or -1 when download is completed

progressMax - maximum progress value