com.jniwrapper.win32.ie.event
Interface NavigationEventListener

All Superinterfaces:

java.util.EventListener

All Known Implementing Classes:

NavigationEventAdapter

public interface NavigationEventListener

extends java.util.EventListener

The listener interface for receiving event notifications from a WebBrowser control or from the Microsoft Internet Explorer application.

Method Summary

void	documentCompleted(WebBrowser webBrowser, java.lang.String url) Fires when a document has been completely loaded and initialized.
void	downloadBegin() Fires when a navigation operation is beginning.
void	downloadCompleted() Fires when a navigation operation finishes, is halted, or fails.
void	entireDocumentCompleted(WebBrowser webBrowser, java.lang.String url) Fires when a document has been completely loaded and initialized.
void	navigationCompleted(WebBrowser webBrowser, 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.

Method Detail

downloadBegin

public void downloadBegin()

Fires when a navigation operation is beginning.

This event is fired shortly after the event, unless the navigation is canceled. Any animation or "busy" indication that the container needs to display should be connected to this event.

Each event will have a corresponding event.

downloadCompleted

public void downloadCompleted()

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

Unlike , 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 event will have a corresponding event.

documentCompleted

public void documentCompleted(WebBrowser webBrowser,
                              java.lang.String url)

Fires 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 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 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.

The WebBrowser Control fires this event when the document has completely loaded and the ReadyState property has changed to .

Parameters:

webBrowser - the browser object in which this event is fired.

url - url of loaded document

entireDocumentCompleted

public void entireDocumentCompleted(WebBrowser webBrowser,
                                    java.lang.String url)

Fires 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.

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 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.

The WebBrowser Control fires this event when the document has completely loaded and the ReadyState property has changed to .

Parameters:

webBrowser - the browser object in which this event is fired.

url - url of loaded document

navigationCompleted

public void navigationCompleted(WebBrowser webBrowser,
                                java.lang.String url)

Invoked when navigation operation has been completed.

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

Parameters:

webBrowser - the browser object in which this event is fired.

url - url of loaded document

progressChanged

public void progressChanged(int progress,
                            int progressMax)

Invoked when the progress of download operation has been updated.

Parameters:

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

progressMax - maximum progress value