com.jniwrapper.win32.ie
Class FrameBrowserSupport

java.lang.Object
  extended by com.jniwrapper.win32.ie.FrameBrowserSupport
All Implemented Interfaces:
ParentWindow, WebBrowser

public class FrameBrowserSupport
extends java.lang.Object
implements WebBrowser

This class represents a frame browser object.


Nested Class Summary
 
Nested classes/interfaces inherited from interface com.jniwrapper.win32.ie.WebBrowser
WebBrowser.Properties
 
Constructor Summary
FrameBrowserSupport(com.jniwrapper.win32.shdocvw.IWebBrowser2 browser, WebBrowser parent)
          Create frame browser wrapper.
 
Method Summary
 void addBrowserWindowListener(BrowserWindowListener listener)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void addDisposeListener(DisposeListener listener)
          This methd always throw UnsupportedOperationException error because the FrameImpl implementation doesn't support this functionality yet.
 void addNavigationListener(NavigationEventListener l)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void addNewWindowListener(NewWindowEventListener listener)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void addPropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void addStatusListener(StatusEventListener l)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void close()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void execute(BrowserCommand command)
          Executes the specified WebBrowser command.
 java.lang.Object executeScript(java.lang.String javaScript)
          Executes specified JavaScript code in a currently opened document.
 AuthenticationHandler getAuthenticationHandler()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 java.lang.Object getBrowserPeer()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 java.lang.String getContent()
          Returns the string that represents HTML content of a currently loaded document in WebBrowser.
 java.lang.String getContent(boolean original)
          Returns the string that represents HTML content of a currently loaded document in WebBrowser.
 java.util.Set<Cookie> getCookies(java.lang.String url)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 java.util.Set<Cookie> getCookies(java.net.URL url)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 DialogEventHandler getDialogEventHandler()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 DisposeListener[] getDisposeListeners()
          This methd always throw UnsupportedOperationException error because the FrameImpl implementation doesn't support this functionality yet.
 org.w3c.dom.html.HTMLDocument getDocument()
          Returns an instance of HTMLDocument that represents the HTML document currently loaded into the WebBrowser and provides access to the contents of the HTML Document Object Model (DOM).
 WebBrowserEventsHandler getEventHandler()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 HttpSecurityHandler getHttpSecurityHandler()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 KeyFilter getKeyFilter()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 java.lang.String getLocationURL()
          Returns the string that represents a URL of the resource that WebBrowser component is currently displayed.
 java.util.List<NavigationEventListener> getNavigationListeners()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 NewWindowEventHandler getNewWindowHandler()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 java.util.List<NewWindowEventListener> getNewWindowListeners()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 com.jniwrapper.win32.automation.OleMessageLoop getOleMessageLoop()
          Returns the OleMessageLoop thread in which executes all WebBrowser component operations.
 WebBrowser getParentBrowser()
          Returns the parent of the current WebBrowser instance or null if it hasn't parent.
 WebBrowser.Properties getProperties()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 ProxyConfiguration getProxy()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 ReadyState getReadyState()
          Returns the current ReadyState of the WebBrowser Control.
 WebBrowser getRecentChild()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 ScriptErrorListener getScriptErrorListener()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 java.util.List<StatusEventListener> getStatusListeners()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 int getZoomValue()
           
 void goBack()
          Navigates backward one item in the history list.
 void goForward()
          Navigates forward one item in the history list.
 void goHome()
          Navigates to the current home or start page.
 boolean isClosed()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 boolean isSilent()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void navigate(java.lang.String location)
          Navigates to a resource identified by a URL or to a file identified by a full path.
 void navigate(java.lang.String location, java.lang.String postData)
          Navigates to a web resource specified by a HTTP URL with HTTP post data.
 void navigate(java.lang.String location, java.lang.String targetName, java.lang.String postData)
          Navigates to an entire web resource specified by a HTTP URL with HTTP post data into a specified window defined by targetName.
 void navigate(java.lang.String location, java.lang.String targetName, java.lang.String postData, java.lang.String headers)
          Navigates to an entire web resource specified by a HTTP URL with HTTP post data into a specified window defined by targetName.
 void refresh()
          Reloads the file that is currently displayed in the object.
 void removeBrowserWindowListener(BrowserWindowListener listener)
          Removes window listener.
 void removeDisposeListener(DisposeListener listener)
          This methd always throw UnsupportedOperationException error because the FrameImpl implementation doesn't support this functionality yet.
 void removeNavigationListener(NavigationEventListener l)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void removeNewWindowListener(NewWindowEventListener listener)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void removePropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void removeStatusListener(StatusEventListener l)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void setAuthenticationHandler(AuthenticationHandler handler)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void setContent(java.lang.String htmlContent)
          Sets the specified HTML content to the current WebBrowser document.
 void setCookie(java.lang.String url, Cookie cookie)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void setCookies(java.net.URL url, java.util.Set<Cookie> cookies)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void setDialogEventHandler(DialogEventHandler handler)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void setEventHandler(WebBrowserEventsHandler handler)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void setHttpSecurityHandler(HttpSecurityHandler h)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void setKeyFilter(KeyFilter keyFilter)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void setNewWindowHandler(NewWindowEventHandler newWindowHandler)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void setParentBrowser(WebBrowser webBrowser)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void setProxy(ProxyConfiguration conf)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void setScriptErrorListener(ScriptErrorListener listener)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void setSilent(boolean isSilent)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void setZoomValue(int value)
           
 void stop()
          Cancels any pending navigation or download operation and stops any dynamic page elements, such as background sounds and animations.
 void trackChildren()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 WebBrowser waitChildCreation()
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 WebBrowser waitChildCreation(java.lang.Runnable operationThatCreatesChild)
          This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.
 void waitReady()
          Causes a current thread to wait for the completion of the current operation in the browser.
 void waitReady(long timeout)
          Causes a current thread to wait for the completion of a current operation in the browser for a specified amount of milliseconds.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

FrameBrowserSupport

public FrameBrowserSupport(com.jniwrapper.win32.shdocvw.IWebBrowser2 browser,
                           WebBrowser parent)
Create frame browser wrapper.

Parameters:
browser - interface reference to Internet Explorer COM object
parent - parent browser
Method Detail

navigate

public void navigate(java.lang.String location)
Navigates to a resource identified by a URL or to a file identified by a full path. The WebBrowser can browse to any location in the local file system, on the network, or on the World Wide Web.

This method is executes asynchronously. To make sure that required resource is loaded completely use the NavigationEventListener.entireDocumentCompleted event.

Specified by:
navigate in interface WebBrowser
Parameters:
location - the URL of the resource to display or the full path to the file location. The parameter cannot be null.
Throws:
java.lang.IllegalArgumentException - when location parameter is null.
java.lang.IllegalStateException - when WebBrowser component was disposed by invoking WebBrowser.close() method or for some unknown reasons.
See Also:
navigate(String, String), navigate(String, String, String), NavigationEventListener.entireDocumentCompleted(WebBrowser, String)

navigate

public void navigate(java.lang.String location,
                     java.lang.String postData)
Navigates to a web resource specified by a HTTP URL with HTTP post data. The WebBrowser can browse to any location in the local file system, on the network, or on the World Wide Web.

This method is executes asynchronously. To make sure that required resource is loaded completely use the NavigationEventListener.entireDocumentCompleted event.

Specified by:
navigate in interface WebBrowser
Parameters:
location - the URL of the resource to display or the full path to the file location. The parameter cannot be null.
postData - HTTP post data (for example, "name=Alex&product=Pizza"), can be null.
Throws:
java.lang.IllegalArgumentException - when location parameter is null.
java.lang.IllegalStateException - when WebBrowser component was disposed by invoking WebBrowser.close() method or for some unknown reasons.
See Also:
navigate(String), navigate(String, String, String), NavigationEventListener.entireDocumentCompleted(WebBrowser, String)

navigate

public void navigate(java.lang.String location,
                     java.lang.String targetName,
                     java.lang.String postData)
Navigates to an entire web resource specified by a HTTP URL with HTTP post data into a specified window defined by targetName.

This method is executes asynchronously. To make sure that required resource is loaded completely use the NavigationEventListener.entireDocumentCompleted event.

Specified by:
navigate in interface WebBrowser
Parameters:
location - the URL of the resource to display or the full path to the file location. The parameter cannot be null.
targetName - The string that contains the name of the frame in which to display the resource. The possible values for this parameter are.
  • _blank - Load the link into a new unnamed window.
  • _parent - Load the link into the immediate parent of the document the link is in.
  • _self - Load the link into the same window the link was clicked in.
  • _top - Load the link into the full body of the current window.
  • WindowName - A named HTML frame. If no frame or window exists that matches the specified target name, a new window is opened for the specified link.
postData - HTTP post data (for example, "name=Alex&product=Pizza").
Throws:
java.lang.IllegalStateException - when WebBrowser component was disposed by invoking WebBrowser.close() method or for some unknown reasons.
See Also:
navigate(String), navigate(String, String), NavigationEventListener.entireDocumentCompleted(WebBrowser, String)

navigate

public void navigate(java.lang.String location,
                     java.lang.String targetName,
                     java.lang.String postData,
                     java.lang.String headers)
Description copied from interface: WebBrowser
Navigates to an entire web resource specified by a HTTP URL with HTTP post data into a specified window defined by targetName.

This method is executes asynchronously. To make sure that required resource is loaded completely use the NavigationEventListener.entireDocumentCompleted event.

Specified by:
navigate in interface WebBrowser
Parameters:
location - the URL of the resource to display or the full path to the file location. The parameter cannot be null.
targetName - The string that contains the name of the frame in which to display the resource. The possible values for this parameter are.
  • _blank - Load the link into a new unnamed window.
  • _parent - Load the link into the immediate parent of the document the link is in.
  • _self - Load the link into the same window the link was clicked in.
  • _top - Load the link into the full body of the current window.
  • WindowName - A named HTML frame. If no frame or window exists that matches the specified target name, a new window is opened for the specified link.
postData - HTTP post data (for example, "name=Alex&product=Pizza").
headers - The string that contains additional HTTP headers to send to the server. These headers are added to the default Windows Internet Explorer headers. For example, headers can specify the action required of the server, the type of data being passed to the server, or a status code. This parameter is ignored if the URL is not an HTTP (or HTTPS) URL.
See Also:
WebBrowser.navigate(String), WebBrowser.navigate(String, String), NavigationEventListener.entireDocumentCompleted(WebBrowser, String)

getLocationURL

public java.lang.String getLocationURL()
Returns the string that represents a URL of the resource that WebBrowser component is currently displayed.

If the resource is a folder or file on the network or local computer, the name is the full path of the folder or file in the Universal Naming Convention (UNC) format.

If this method is called before the first navigation is complete, the WebBrowser returns an empty string.

Specified by:
getLocationURL in interface WebBrowser
Returns:
location the string that represents a URL of a currently loaded resource
Throws:
java.lang.IllegalStateException - when WebBrowser component was disposed by invoking WebBrowser.close() method or for some unknown reasons.
See Also:
NavigationEventListener.entireDocumentCompleted(WebBrowser, String)

getDocument

public org.w3c.dom.html.HTMLDocument getDocument()
Returns an instance of HTMLDocument that represents the HTML document currently loaded into the WebBrowser and provides access to the contents of the HTML Document Object Model (DOM).

Before receiving an instance of HTMLDocument make sure that the entire document is loaded completely. For this you can use the NavigationEventListener.entireDocumentCompleted(WebBrowser, String) event.

Specified by:
getDocument in interface WebBrowser
Returns:
The HTML document currently loaded into the WebBrowser. This instance supports all the required properties and methods to access the entire contents of the active HTML document.
Throws:
java.lang.IllegalStateException - when WebBrowser.waitReady() method isn't called after last call of WebBrowser.navigate() or WebBrowser.setContent() methods; or when WebBrowser component was disposed by invoking WebBrowser.close() method or for some unknown reasons.
See Also:
WebBrowser.waitReady(), WebBrowser.navigate(String), WebBrowser.setContent(String), NavigationEventListener.entireDocumentCompleted(WebBrowser, String)

getParentBrowser

public WebBrowser getParentBrowser()
Description copied from interface: WebBrowser
Returns the parent of the current WebBrowser instance or null if it hasn't parent. If the WebBrowser control is in a frame, this method returns the WebBrowser instance of the main document that contains this frame. Otherwise, it delegates to the top-level WebBrowser control, if there is one.

Specified by:
getParentBrowser in interface WebBrowser
Returns:
the parent of the browser or null if the browser hasn't parent.
See Also:
Browser.getParentBrowser(), HeadlessBrowser.getParentBrowser(), IEAutomation.getParentBrowser()

setParentBrowser

public void setParentBrowser(WebBrowser webBrowser)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
setParentBrowser in interface WebBrowser
Parameters:
webBrowser - the parent of the browser.
Throws:
java.lang.UnsupportedOperationException - always

goForward

public void goForward()
Navigates forward one item in the history list.

During a browsing session, the WebBrowser control maintain a history list of all Web sites visited during a session. Use the StatusEventListener.forwardButtonEnabled event to check the enabled state of forward navigation.

To manage WebBrowser's history use the BrowserHistory class.

Specified by:
goForward in interface WebBrowser
Throws:
java.lang.IllegalStateException - when WebBrowser component was disposed by invoking WebBrowser.close() method or for some unknown reasons.
See Also:
WebBrowser.goBack(), WebBrowser.goHome(), BrowserHistory

goBack

public void goBack()
Navigates backward one item in the history list.

During a browsing session, the WebBrowser control maintain a history list of all Web sites visited during a session. Use the StatusEventListener.backButtonEnabled event to check the enabled state of back navigation.

To manage WebBrowser's history use the BrowserHistory class.

Specified by:
goBack in interface WebBrowser
Throws:
java.lang.IllegalStateException - when WebBrowser component was disposed by invoking WebBrowser.close() method or for some unknown reasons.
See Also:
WebBrowser.goForward(), WebBrowser.goHome(), BrowserHistory

goHome

public void goHome()
Navigates to the current home or start page.

The user can indicate the URL to use for the home page from the Internet Options dialog box, which is accessible from the Tools menu of Windows Internet Explorer, or in the Control Panel.

Specified by:
goHome in interface WebBrowser
Throws:
java.lang.IllegalStateException - when WebBrowser component was disposed by invoking WebBrowser.close() method or for some unknown reasons.
See Also:
WebBrowser.goForward(), WebBrowser.goBack()

stop

public void stop()
Cancels any pending navigation or download operation and stops any dynamic page elements, such as background sounds and animations.

Specified by:
stop in interface WebBrowser
Throws:
java.lang.IllegalStateException - when WebBrowser component was disposed by invoking WebBrowser.close() method or for some unknown reasons.
See Also:
refresh(), navigate(String), NavigationEventListener.entireDocumentCompleted(WebBrowser, String)

refresh

public void refresh()
Description copied from interface: WebBrowser
Reloads the file that is currently displayed in the object.

This method is the same as clicking the Refresh button or pressing F5 in Windows Internet Explorer.

To save time and network bandwidth, the WebBrowser control store pages from recently visited sites in cached memory on the user's hard disk. When you revisit a Web site, the page is reloaded from the local disk instead of being downloaded again from the server. To ensure that you are viewing the most current version of the page, you can force a fresh download by using this method. This method adds the "Pragma: No-cache" HTTP header to the request.

Specified by:
refresh in interface WebBrowser

execute

public void execute(BrowserCommand command)
Description copied from interface: WebBrowser
Executes the specified WebBrowser command. Each WebBrowser command must inherit the BrowserCommand abstract class.

For example, to print currently loaded web page, the following command should be executed:

 WebBrowser browser = new HeadlessBrowser();
 browser.execute(new PrintCommand());

Specified by:
execute in interface WebBrowser
Parameters:
command - the specified WebBrowser command.
See Also:
PrintCommand, PrintPreviewCommand, SaveAsCommand

setContent

public void setContent(java.lang.String htmlContent)
Description copied from interface: WebBrowser
Sets the specified HTML content to the current WebBrowser document.

This method is executes asynchronously. To make sure that the new HTML content was applied to the document completely, use the NavigationEventListener.entireDocumentCompleted event. It may be necessary when the document contains some resources (such as images or JavaScript files) that require some time to download.

Specified by:
setContent in interface WebBrowser
Parameters:
htmlContent - a string that represents HTML content to set to the current document.
See Also:
WebBrowser.navigate(String), WebBrowser.navigate(String, String), WebBrowser.navigate(String, String, String), WebBrowser.getContent(), WebBrowser.getContent(boolean), NavigationEventListener.entireDocumentCompleted(WebBrowser, String)

getContent

public java.lang.String getContent()
Description copied from interface: WebBrowser
Returns the string that represents HTML content of a currently loaded document in WebBrowser. To make sure that the document is loaded completely use the NavigationEventListener.entireDocumentCompleted event.

Note: the outerHTML propertry of the document HTML element is used in this method. So, it always returns the actual HTML of the document. To get the HTML that was downloaded from the server use the getContent(true) method.

Specified by:
getContent in interface WebBrowser
Returns:
the string that contains a combination of text and tags.
See Also:
WebBrowser.setContent(String), WebBrowser.getContent(boolean), NavigationEventListener.entireDocumentCompleted(WebBrowser, String)

getContent

public java.lang.String getContent(boolean original)
Description copied from interface: WebBrowser
Returns the string that represents HTML content of a currently loaded document in WebBrowser. To make sure that the document is loaded completely use the NavigationEventListener.entireDocumentCompleted event.

Specified by:
getContent in interface WebBrowser
Parameters:
original - if true then returns the original HTML content (like View Source command in context menu of Internet Explorer browser), otherwise this method returns the actual content of a document according to its DOM.
Returns:
the HTML content of a document, opened in a browser.
See Also:
WebBrowser.getContent(), WebBrowser.setContent(String), NavigationEventListener.entireDocumentCompleted(WebBrowser, String)

executeScript

public java.lang.Object executeScript(java.lang.String javaScript)
Description copied from interface: WebBrowser
Executes specified JavaScript code in a currently opened document.

Script executed through the IHTMLWindow2.execScript method can access all global variables available to the calling script.

Specified by:
executeScript in interface WebBrowser
Parameters:
javaScript - the string that specifies the code to be executed.
Returns:
the result of JavaScript execution, if any (String, or COM object).

getReadyState

public ReadyState getReadyState()
Description copied from interface: WebBrowser
Returns the current ReadyState of the WebBrowser Control.

Specified by:
getReadyState in interface WebBrowser
Returns:
the current state of the WebBrowser Control.

addPropertyChangeListener

public void addPropertyChangeListener(java.lang.String propertyName,
                                      java.beans.PropertyChangeListener listener)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
addPropertyChangeListener in interface WebBrowser
Parameters:
propertyName - property name.
listener - listener instance.
Throws:
java.lang.UnsupportedOperationException - always

removePropertyChangeListener

public void removePropertyChangeListener(java.lang.String propertyName,
                                         java.beans.PropertyChangeListener listener)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
removePropertyChangeListener in interface WebBrowser
Parameters:
propertyName - property name.
listener - listener instance.
Throws:
java.lang.UnsupportedOperationException - always

waitReady

public void waitReady()
Description copied from interface: WebBrowser
Causes a current thread to wait for the completion of the current operation in the browser.

Important: successful call of this method guaranties that you can get DOM document of loaded page. Please see typical usage of this method in the code below:

     // navigate to Google page
     browser.navigate("google.com");
 

// wait until page completely loaded browser.waitReady();

// DOM document is available Document document = browser.getDocument();

If you miss WebBrowser.waitReady() call after navigation call then IllegalStateException is thrown in WebBrowser.getDocument() call.

Specified by:
waitReady in interface WebBrowser
See Also:
WebBrowser.navigate(String), WebBrowser.setContent(String), WebBrowser.getDocument()

waitReady

public void waitReady(long timeout)
Description copied from interface: WebBrowser
Causes a current thread to wait for the completion of a current operation in the browser for a specified amount of milliseconds.

Specified by:
waitReady in interface WebBrowser
Parameters:
timeout - the number of milliseconds to wait.

getBrowserPeer

public java.lang.Object getBrowserPeer()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getBrowserPeer in interface WebBrowser
Returns:
an instance of the native WebBrowser peer.
Throws:
java.lang.UnsupportedOperationException - always

addNavigationListener

public void addNavigationListener(NavigationEventListener l)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
addNavigationListener in interface WebBrowser
Parameters:
l - browser event listener.
Throws:
java.lang.UnsupportedOperationException - always

removeNavigationListener

public void removeNavigationListener(NavigationEventListener l)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
removeNavigationListener in interface WebBrowser
Parameters:
l - browser event listener.
Throws:
java.lang.UnsupportedOperationException - always

addStatusListener

public void addStatusListener(StatusEventListener l)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
addStatusListener in interface WebBrowser
Parameters:
l - browser event listener.
Throws:
java.lang.UnsupportedOperationException - always

removeStatusListener

public void removeStatusListener(StatusEventListener l)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
removeStatusListener in interface WebBrowser
Parameters:
l - browser event listener.
Throws:
java.lang.UnsupportedOperationException - always

getNavigationListeners

public java.util.List<NavigationEventListener> getNavigationListeners()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getNavigationListeners in interface WebBrowser
Returns:
list of browser event listeners
Throws:
java.lang.UnsupportedOperationException - always

getStatusListeners

public java.util.List<StatusEventListener> getStatusListeners()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getStatusListeners in interface WebBrowser
Returns:
list of browser event listeners
Throws:
java.lang.UnsupportedOperationException - always

getEventHandler

public WebBrowserEventsHandler getEventHandler()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getEventHandler in interface WebBrowser
Returns:
browser event handler
Throws:
java.lang.UnsupportedOperationException - always

setAuthenticationHandler

public void setAuthenticationHandler(AuthenticationHandler handler)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
setAuthenticationHandler in interface WebBrowser
Parameters:
handler - the authentication handler
Throws:
java.lang.UnsupportedOperationException - always
See Also:
WebBrowser.getAuthenticationHandler()

getAuthenticationHandler

public AuthenticationHandler getAuthenticationHandler()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getAuthenticationHandler in interface WebBrowser
Returns:
the current browser authentication handler or null.
Throws:
java.lang.UnsupportedOperationException - always
See Also:
WebBrowser.setAuthenticationHandler(AuthenticationHandler)

setEventHandler

public void setEventHandler(WebBrowserEventsHandler handler)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
setEventHandler in interface WebBrowser
Parameters:
handler - event handler
Throws:
java.lang.UnsupportedOperationException - always

getDialogEventHandler

public DialogEventHandler getDialogEventHandler()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getDialogEventHandler in interface WebBrowser
Returns:
the dialog events handler or null if it's was not specified.
Throws:
java.lang.UnsupportedOperationException - always
See Also:
WebBrowser.setDialogEventHandler(DialogEventHandler), WebBrowser.setSilent(boolean), WebBrowser.isSilent(), Browser.getDialogEventHandler(), HeadlessBrowser.getDialogEventHandler()

setDialogEventHandler

public void setDialogEventHandler(DialogEventHandler handler)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
setDialogEventHandler in interface WebBrowser
Parameters:
handler - dialog event handler
Throws:
java.lang.UnsupportedOperationException - always
See Also:
WebBrowser.getDialogEventHandler(), WebBrowser.setSilent(boolean), WebBrowser.isSilent(), Browser.setDialogEventHandler(com.jniwrapper.win32.ie.event.DialogEventHandler), HeadlessBrowser.setDialogEventHandler(com.jniwrapper.win32.ie.event.DialogEventHandler)

setScriptErrorListener

public void setScriptErrorListener(ScriptErrorListener listener)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
setScriptErrorListener in interface WebBrowser
Parameters:
listener - javascript error listener
Throws:
java.lang.UnsupportedOperationException - always

getScriptErrorListener

public ScriptErrorListener getScriptErrorListener()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getScriptErrorListener in interface WebBrowser
Returns:
script error listener
Throws:
java.lang.UnsupportedOperationException - always

close

public void close()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
close in interface WebBrowser
Throws:
java.lang.UnsupportedOperationException - always
See Also:
WebBrowser.isClosed()

isClosed

public boolean isClosed()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
isClosed in interface WebBrowser
Returns:
true if the WebBrowser instance is closed and disposed.
Throws:
java.lang.UnsupportedOperationException - always
See Also:
WebBrowser.close()

setSilent

public void setSilent(boolean isSilent)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
setSilent in interface WebBrowser
Parameters:
isSilent - if true then enter to silent mode else leave silent mode.
Throws:
java.lang.UnsupportedOperationException - always

isSilent

public boolean isSilent()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
isSilent in interface WebBrowser
Returns:
true if in silent mode else returns false.
Throws:
java.lang.UnsupportedOperationException - always

setCookie

public void setCookie(java.lang.String url,
                      Cookie cookie)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
setCookie in interface WebBrowser
Parameters:
url - specifies an URL, a new cookie will be associated with.
cookie - specifies a new cookie.
Throws:
java.lang.UnsupportedOperationException - always

getCookies

public java.util.Set<Cookie> getCookies(java.lang.String url)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getCookies in interface WebBrowser
Parameters:
url - specifies an URL.
Returns:
cookies, that are associated with the specified URL.
Throws:
java.lang.UnsupportedOperationException - always

setNewWindowHandler

public void setNewWindowHandler(NewWindowEventHandler newWindowHandler)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
setNewWindowHandler in interface WebBrowser
Parameters:
newWindowHandler - new window handler
Throws:
java.lang.UnsupportedOperationException - always

getNewWindowHandler

public NewWindowEventHandler getNewWindowHandler()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getNewWindowHandler in interface WebBrowser
Returns:
new window handler
Throws:
java.lang.UnsupportedOperationException - always

addNewWindowListener

public void addNewWindowListener(NewWindowEventListener listener)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
addNewWindowListener in interface WebBrowser
Parameters:
listener - new window listener
Throws:
java.lang.UnsupportedOperationException - always

removeNewWindowListener

public void removeNewWindowListener(NewWindowEventListener listener)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
removeNewWindowListener in interface WebBrowser
Parameters:
listener - new window listener
Throws:
java.lang.UnsupportedOperationException - always

getNewWindowListeners

public java.util.List<NewWindowEventListener> getNewWindowListeners()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getNewWindowListeners in interface WebBrowser
Returns:
new window listeners
Throws:
java.lang.UnsupportedOperationException - always

trackChildren

public void trackChildren()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
trackChildren in interface ParentWindow
Throws:
java.lang.UnsupportedOperationException - always

getRecentChild

public WebBrowser getRecentChild()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getRecentChild in interface ParentWindow
Returns:
recent opened child window after the last trackChildren() method call. If there isn't opened windows after this call then returns null.
Throws:
java.lang.UnsupportedOperationException - always

waitChildCreation

public WebBrowser waitChildCreation()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
waitChildCreation in interface ParentWindow
Returns:
recent created child
Throws:
java.lang.UnsupportedOperationException - always

waitChildCreation

public WebBrowser waitChildCreation(java.lang.Runnable operationThatCreatesChild)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
waitChildCreation in interface ParentWindow
Parameters:
operationThatCreatesChild - operation
Returns:
child created by the operation
Throws:
java.lang.UnsupportedOperationException - always

setKeyFilter

public void setKeyFilter(KeyFilter keyFilter)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
setKeyFilter in interface WebBrowser
Parameters:
keyFilter - key filter
Throws:
java.lang.UnsupportedOperationException - always

getKeyFilter

public KeyFilter getKeyFilter()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getKeyFilter in interface WebBrowser
Returns:
key filter
Throws:
java.lang.UnsupportedOperationException - always

getProperties

public WebBrowser.Properties getProperties()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getProperties in interface WebBrowser
Returns:
extended browser properties.
Throws:
java.lang.UnsupportedOperationException - always

addBrowserWindowListener

public void addBrowserWindowListener(BrowserWindowListener listener)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
addBrowserWindowListener in interface WebBrowser
Parameters:
listener - the window listener
Throws:
java.lang.UnsupportedOperationException - always

removeBrowserWindowListener

public void removeBrowserWindowListener(BrowserWindowListener listener)
Description copied from interface: WebBrowser
Removes window listener.

Specified by:
removeBrowserWindowListener in interface WebBrowser
Parameters:
listener - the window listener

getOleMessageLoop

public com.jniwrapper.win32.automation.OleMessageLoop getOleMessageLoop()
Description copied from interface: WebBrowser
Returns the OleMessageLoop thread in which executes all WebBrowser component operations. Each WebBrowser instance with its children run in its own OleMessageLoop thread.

Specified by:
getOleMessageLoop in interface WebBrowser
Returns:
the OleMessageLoop thread.

setProxy

public void setProxy(ProxyConfiguration conf)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
setProxy in interface WebBrowser
Parameters:
conf - the proxy settings. This parameter cannot be null.
Throws:
java.lang.UnsupportedOperationException - always
See Also:
WebBrowser.getProxy(), Browsers.setProxy(ProxyConfiguration)

getProxy

public ProxyConfiguration getProxy()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getProxy in interface WebBrowser
Returns:
the proxy settings for the current WebBrowser control.
Throws:
java.lang.UnsupportedOperationException - always
See Also:
WebBrowser.setProxy(ProxyConfiguration), Browsers.getProxy()

getCookies

public java.util.Set<Cookie> getCookies(java.net.URL url)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getCookies in interface WebBrowser
Parameters:
url - specifies an URL.
Returns:
cookies, that are associated with the specified URL.
Throws:
java.lang.UnsupportedOperationException - always

setCookies

public void setCookies(java.net.URL url,
                       java.util.Set<Cookie> cookies)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
setCookies in interface WebBrowser
Parameters:
url - specifies an URL, a new cookie will be associated with.
cookies - the collection of Cookie objects.
Throws:
java.lang.UnsupportedOperationException - always

setHttpSecurityHandler

public void setHttpSecurityHandler(HttpSecurityHandler h)
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
setHttpSecurityHandler in interface WebBrowser
Parameters:
h - the specified HTTP security handler.
Throws:
java.lang.UnsupportedOperationException - always
See Also:
WebBrowser.getHttpSecurityHandler()

getHttpSecurityHandler

public HttpSecurityHandler getHttpSecurityHandler()
This methd always throw UnsupportedOperationException error because the FrameBrowserSupport implementation doesn't support this functionality yet.

Specified by:
getHttpSecurityHandler in interface WebBrowser
Returns:
the current http security handler that allows processing any security problems or null if it's not present
Throws:
java.lang.UnsupportedOperationException - always
See Also:
WebBrowser.setHttpSecurityHandler(com.jniwrapper.win32.ie.event.HttpSecurityHandler)

addDisposeListener

public void addDisposeListener(DisposeListener listener)
This methd always throw UnsupportedOperationException error because the FrameImpl implementation doesn't support this functionality yet.

Specified by:
addDisposeListener in interface WebBrowser
Parameters:
listener - the listener to receive browser dispose events.
Throws:
java.lang.UnsupportedOperationException - always

removeDisposeListener

public void removeDisposeListener(DisposeListener listener)
This methd always throw UnsupportedOperationException error because the FrameImpl implementation doesn't support this functionality yet.

Specified by:
removeDisposeListener in interface WebBrowser
Parameters:
listener - the listener to remove.
Throws:
java.lang.UnsupportedOperationException - always

getDisposeListeners

public DisposeListener[] getDisposeListeners()
This methd always throw UnsupportedOperationException error because the FrameImpl implementation doesn't support this functionality yet.

Specified by:
getDisposeListeners in interface WebBrowser
Returns:
an array of all registered listeners for the current Browser instance.
Throws:
java.lang.UnsupportedOperationException - always

getZoomValue

public int getZoomValue()
Specified by:
getZoomValue in interface WebBrowser

setZoomValue

public void setZoomValue(int value)
Specified by:
setZoomValue in interface WebBrowser