com.jniwrapper.win32.ie
Class Browser

java.lang.Object
  extended byjava.awt.Component
      extended byjava.awt.Container
          extended byjavax.swing.JComponent
              extended bycom.jniwrapper.win32.ie.Browser
All Implemented Interfaces:
java.awt.image.ImageObserver, java.awt.MenuContainer, ParentWindow, java.io.Serializable, SingleThreadedComponent, WebBrowser

public class Browser
extends javax.swing.JComponent
implements WebBrowser

This component implements the WebBrowser interface and provides various capabilities for a Java application, such as Web surfing, documents viewing, etc.

See Also:
Serialized Form

Nested Class Summary
 
Nested classes inherited from class javax.swing.JComponent
javax.swing.JComponent.AccessibleJComponent
 
Nested classes inherited from class java.awt.Container
java.awt.Container.AccessibleAWTContainer
 
Nested classes inherited from class java.awt.Component
java.awt.Component.AccessibleAWTComponent, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy
 
Nested classes inherited from class com.jniwrapper.win32.ie.WebBrowser
WebBrowser.Properties
 
Field Summary
 
Fields inherited from class javax.swing.JComponent
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
Browser()
          Creates browser component.
Browser(com.jniwrapper.win32.automation.OleMessageLoop oleMessageLoop)
          Creates browser component.
Browser(com.jniwrapper.win32.automation.OleMessageLoop oleMessageLoop, java.lang.String pathKey)
          Creates browser component.
Browser(java.lang.String pathKey)
          Creates browser component.
 
Method Summary
 void addBrowserWindowListener(BrowserWindowListener listener)
          Adds window listener.
 void addFocusListener(java.awt.event.FocusListener listener)
           
 void addNavigationListener(NavigationEventListener listener)
          Adds browser navigation event listener.
 void addNewWindowListener(NewWindowEventListener listener)
          Adds new window listener.
 void addNotify()
           
 void addStatusListener(StatusEventListener listener)
          Adds browser status event listener.
 void addTrustedSizeToZone(java.lang.String pattern)
           
 void close()
          Closes browser.
 void execute(BrowserCommand command)
          Executes specified command.
 java.lang.Object executeScript(java.lang.String javaScript)
          Executes specified JavaScript code in a currently opened document.
 void firePropertyChange(java.lang.String propertyName, java.lang.Object oldValue, java.lang.Object newValue)
          Fires property change event.
 AuthenticateHandler getAuthenticateHandler()
          Returns browser authenticate handler.
 java.lang.Object getBrowserPeer()
          Returns an instance of the native web browser peer.
 BrowserWindowListener[] getBrowserWindowListeners()
          Returns an array of window listeners.
 java.lang.String getContent()
          Returns the HTML content of a document, opened in a browser.
 org.w3c.dom.Element getContextElement()
          Returns element on which the context menu was invoked last time.
 ContextMenuProvider getContextMenuProvider()
          Returns the context menu provider for the browser.
 java.util.Set getCookies(java.lang.String url)
          Returns cookies, that are associated with the specified URL.
 DialogEventHandler getDialogEventHandler()
          Gets dialog event handler.
 HTMLDocument getDocument()
          Returns DOM document for page loaded into the browser.
 WebBrowserEventsHandler getEventHandler()
          Returns browser event handler.
 java.awt.event.FocusListener[] getFocusListeners()
           
 KeyFilter getKeyFilter()
          Returns key filter.
 java.lang.String getLocationURL()
          Returns the URL of the resource that Internet Explorer is currently displaying.
 java.util.List getNavigationListeners()
          Returns browser navigation event listeners.
 NewWindowEventHandler getNewWindowHandler()
          Returns new window handler.
 java.util.List getNewWindowListeners()
          Returns new window listeners.
 com.jniwrapper.win32.automation.OleMessageLoop getOleMessageLoop()
          Return browser OLE message loop.
 WebBrowser getParentBrowser()
          Returns the parent of the browser.
 WebBrowser.Properties getProperties()
          Returns extended browser properties.
 ReadyState getReadyState()
          Returns the current ReadyState of the browser.
 WebBrowser getRecentChild()
          Returns recent created child object since last trackChildren() method call.
 java.awt.Image getScreenShot(boolean wholePage)
          Returns an image that represent screen shot of the page.
 ScriptErrorListener getScriptErrorListener()
          Returns script error listener for current page.
 java.util.List getStatusListeners()
          Returns browser status event listeners.
 java.lang.String getStatusText()
          Returns the status text of the browser.
 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 home page.
 boolean isSilent()
          Return true if alert, confirmation and error dialogs are disabled else returns false.
 void navigate(java.lang.String location)
          Navigates to a resource specified by a URL or to the file identified by a full path.
 void navigate(java.lang.String location, java.lang.String postData)
          Navigates to a resource specified by a HTTP URL.
 void navigate(java.lang.String location, java.lang.String targetName, java.lang.String postData)
          Navigates the browser to a location that might not be able to be expressed as a URL, such as a pointer to an item identifier list (PIDL) for an entity in the Microsoft Windows shell namespace.
 void refresh()
          Reloads the file that is currently displayed in the object.
 void removeBrowserWindowListener(BrowserWindowListener listener)
          Removes window listener.
 void removeFocusListener(java.awt.event.FocusListener listener)
           
 void removeNavigationListener(NavigationEventListener listener)
          Removes browser navigation event listener.
 void removeNewWindowListener(NewWindowEventListener listener)
          Removes new window listener.
 void removeStatusListener(StatusEventListener listener)
          Removes browser status event listener.
 void setAuthenticateHandler(AuthenticateHandler handler)
          Sets browser authenticate handler.
 void setBounds(int x, int y, int width, int height)
           
 void setContent(java.lang.String htmlContent)
          Set new HTML content.
 void setContextMenuProvider(ContextMenuProvider contextMenuProvider)
          Sets the context menu provider for the browser.
 void setCookie(java.lang.String url, Cookie cookie)
          Creates a new cookie for the specified URL using WinINet API.
 void setCursor(java.awt.Cursor cursor)
           
 void setDialogEventHandler(DialogEventHandler handler)
          Sets dialog event handler.
 void setEnabled(boolean enabled)
           
 void setEventHandler(WebBrowserEventsHandler handler)
          Sets browser event handler.
 void setKeyFilter(KeyFilter keyFilter)
          Sets key filter.
 void setNewWindowHandler(NewWindowEventHandler newWindowHandler)
          Sets new window handler.
 void setParent(Browser browser)
           
 void setParentBrowser(WebBrowser browser)
          Sets the parent of the browser.
 void setScriptErrorListener(ScriptErrorListener listener)
          Setups javascript error listener for current page.
 void setSilent(boolean isSilent)
          Disables or enables alert, confirmation and error dialogs.
 void stop()
          Cancels any pending navigation or download operation and stops any dynamic page elements, such as background sounds and animations.
 void trackChildren()
          Starts to collect information about child object creation.
 WebBrowser waitChildCreation()
          Blocks execution until child is created since last trackChildren() call and returns this child.
 WebBrowser waitChildCreation(java.lang.Runnable operationThatCreatesChild)
          Executes operation specified in the parameter and returns when child created by the operation is opened.
 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 javax.swing.JComponent
addAncestorListener, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update, updateUI
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, repaint, resize, resize, setBounds, setComponentOrientation, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface com.jniwrapper.win32.ie.WebBrowser
addPropertyChangeListener, removePropertyChangeListener
 

Constructor Detail

Browser

public Browser()
Creates browser component.


Browser

public Browser(java.lang.String pathKey)
Creates browser component.

Parameters:
pathKey - the registry subkey string where the host stores its registry settings

Browser

public Browser(com.jniwrapper.win32.automation.OleMessageLoop oleMessageLoop)
Creates browser component.

Parameters:
oleMessageLoop - the browser will be created in this message loop

Browser

public Browser(com.jniwrapper.win32.automation.OleMessageLoop oleMessageLoop,
               java.lang.String pathKey)
Creates browser component.

Parameters:
oleMessageLoop - the browser will be created in this message loop
pathKey - the registry subkey string where the host stores its registry settings
Method Detail

setParent

public void setParent(Browser browser)

addFocusListener

public void addFocusListener(java.awt.event.FocusListener listener)

removeFocusListener

public void removeFocusListener(java.awt.event.FocusListener listener)

getFocusListeners

public java.awt.event.FocusListener[] getFocusListeners()

addNotify

public void addNotify()

setBounds

public void setBounds(int x,
                      int y,
                      int width,
                      int height)

getParentBrowser

public WebBrowser getParentBrowser()
Description copied from interface: WebBrowser
Returns the parent of the browser.

Specified by:
getParentBrowser in interface WebBrowser
Returns:
the parent of the browser or null if the browser not has the parent.

setParentBrowser

public void setParentBrowser(WebBrowser browser)
Description copied from interface: WebBrowser
Sets the parent of the browser.

Specified by:
setParentBrowser in interface WebBrowser
Parameters:
browser - the parent of the browser.

executeScript

public java.lang.Object executeScript(java.lang.String javaScript)
Executes specified JavaScript code in a currently opened document.

Specified by:
executeScript in interface WebBrowser
Parameters:
javaScript - JavaScript to execute.
Returns:
the result of JavaScript execution, if any.

navigate

public void navigate(java.lang.String location)
Navigates to a resource specified by a URL or to the file identified by a full path.

Specified by:
navigate in interface WebBrowser
Parameters:
location - URL to navigate to.

addTrustedSizeToZone

public void addTrustedSizeToZone(java.lang.String pattern)

navigate

public void navigate(java.lang.String location,
                     java.lang.String postData)
Navigates to a resource specified by a HTTP URL.

Specified by:
navigate in interface WebBrowser
Parameters:
location - URL to navigate to.
postData - HTTP post data (for example, "name=Alex&product=Pizza")

navigate

public void navigate(java.lang.String location,
                     java.lang.String targetName,
                     java.lang.String postData)
Navigates the browser to a location that might not be able to be expressed as a URL, such as a pointer to an item identifier list (PIDL) for an entity in the Microsoft Windows shell namespace.

Specified by:
navigate in interface WebBrowser
Parameters:
location - URL to navigate to.
targetName - string that contains the name of the frame in which to display the resource.
postData - HTTP post data (for example, "name=Alex&product=Pizza").

getLocationURL

public java.lang.String getLocationURL()
Returns the URL of the resource that Internet Explorer is currently displaying.

Specified by:
getLocationURL in interface WebBrowser
Returns:
location URL

goForward

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

Specified by:
goForward in interface WebBrowser

goBack

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

Specified by:
goBack in interface WebBrowser

goHome

public void goHome()
Navigates to the home page.

Specified by:
goHome in interface WebBrowser

refresh

public void refresh()
Reloads the file that is currently displayed in the object.

Specified by:
refresh in interface WebBrowser

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

execute

public void execute(BrowserCommand command)
Executes specified command.

Specified by:
execute in interface WebBrowser
Parameters:
command - browser command.

getDocument

public HTMLDocument getDocument()
Returns DOM document for page loaded into the browser.

Specified by:
getDocument in interface WebBrowser
Returns:
DOM document
Throws:
java.lang.IllegalStateException - if WebBrowser.waitReady() method isn't called after last call of WebBrowser.navigate() or WebBrowser.setContent() methods.
See Also:
WebBrowser.waitReady(), WebBrowser.navigate(String), WebBrowser.setContent(String)

setContent

public void setContent(java.lang.String htmlContent)
Set new HTML content.

Specified by:
setContent in interface WebBrowser
Parameters:
htmlContent - HTML content to set.

getContent

public java.lang.String getContent()
Returns the HTML content of a document, opened in a browser.

Specified by:
getContent in interface WebBrowser
Returns:
the HTML content of a document, opened in a browser.

setContextMenuProvider

public void setContextMenuProvider(ContextMenuProvider contextMenuProvider)
Sets the context menu provider for the browser.

If context menu provider for the browser is null then show default context menu. If the provider isn't null then show custom menu or don't show any menu (depends from ContextMenuProvider implementation).

Parameters:
contextMenuProvider - context menu provider instance or null.

getContextMenuProvider

public ContextMenuProvider getContextMenuProvider()
Returns the context menu provider for the browser.

If context menu provider for the browser is null then show default context menu. If the provider isn't null then show custom menu or don't show any menu (depends from ContextMenuProvider implementation).

Returns:
context menu provider instance or null.

getStatusText

public java.lang.String getStatusText()
Returns the status text of the browser.

Specified by:
getStatusText in interface WebBrowser
Returns:
the status text of the browser.

getReadyState

public ReadyState getReadyState()
Returns the current ReadyState of the browser.

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

firePropertyChange

public void firePropertyChange(java.lang.String propertyName,
                               java.lang.Object oldValue,
                               java.lang.Object newValue)
Fires property change event.

Parameters:
propertyName - property name
oldValue - old property value
newValue - new property value

getBrowserPeer

public java.lang.Object getBrowserPeer()
Returns an instance of the native web browser peer.

Specified by:
getBrowserPeer in interface WebBrowser
Returns:
native peer object.
Throws:
java.lang.IllegalStateException - if the passed browser does not have a native peer.

waitReady

public void waitReady()
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)
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.

getContextElement

public org.w3c.dom.Element getContextElement()
Returns element on which the context menu was invoked last time.

Returns:
context element object.

addNavigationListener

public void addNavigationListener(NavigationEventListener listener)
Adds browser navigation event listener.

Specified by:
addNavigationListener in interface WebBrowser
Parameters:
listener - browser event listener.

removeNavigationListener

public void removeNavigationListener(NavigationEventListener listener)
Removes browser navigation event listener.

Specified by:
removeNavigationListener in interface WebBrowser
Parameters:
listener - browser event listener.

getNavigationListeners

public java.util.List getNavigationListeners()
Returns browser navigation event listeners.

Specified by:
getNavigationListeners in interface WebBrowser
Returns:
list of browser event listeners

addStatusListener

public void addStatusListener(StatusEventListener listener)
Adds browser status event listener.

Specified by:
addStatusListener in interface WebBrowser
Parameters:
listener - browser event listener.

getStatusListeners

public java.util.List getStatusListeners()
Returns browser status event listeners.

Specified by:
getStatusListeners in interface WebBrowser
Returns:
list of browser event listeners

removeStatusListener

public void removeStatusListener(StatusEventListener listener)
Removes browser status event listener.

Specified by:
removeStatusListener in interface WebBrowser
Parameters:
listener - browser event listener.

setAuthenticateHandler

public void setAuthenticateHandler(AuthenticateHandler handler)
Sets browser authenticate handler.

Specified by:
setAuthenticateHandler in interface WebBrowser
Parameters:
handler - authenticate handler

getAuthenticateHandler

public AuthenticateHandler getAuthenticateHandler()
Returns browser authenticate handler.

Specified by:
getAuthenticateHandler in interface WebBrowser
Returns:
browser authenticate handler

getEventHandler

public WebBrowserEventsHandler getEventHandler()
Returns browser event handler.

Specified by:
getEventHandler in interface WebBrowser
Returns:
browser event handler

setEventHandler

public void setEventHandler(WebBrowserEventsHandler handler)
Sets browser event handler.

Specified by:
setEventHandler in interface WebBrowser
Parameters:
handler - event handler

setScriptErrorListener

public void setScriptErrorListener(ScriptErrorListener listener)
Setups javascript error listener for current page.

Specified by:
setScriptErrorListener in interface WebBrowser
Parameters:
listener - javascript error listener

getScriptErrorListener

public ScriptErrorListener getScriptErrorListener()
Returns script error listener for current page.

Specified by:
getScriptErrorListener in interface WebBrowser
Returns:
script error listener

close

public void close()
Closes browser.

Specified by:
close in interface WebBrowser

setSilent

public void setSilent(boolean isSilent)
Disables or enables alert, confirmation and error dialogs.

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

isSilent

public boolean isSilent()
Return true if alert, confirmation and error dialogs are disabled else returns false.

Specified by:
isSilent in interface WebBrowser
Returns:
true if in silent mode else returns false.

getOleMessageLoop

public com.jniwrapper.win32.automation.OleMessageLoop getOleMessageLoop()
Return browser OLE message loop.

Specified by:
getOleMessageLoop in interface SingleThreadedComponent
Returns:
browser OLE message loop.

getDialogEventHandler

public DialogEventHandler getDialogEventHandler()
Gets dialog event handler.

Specified by:
getDialogEventHandler in interface WebBrowser
Returns:
dialog event handler

setDialogEventHandler

public void setDialogEventHandler(DialogEventHandler handler)
Sets dialog event handler.

Specified by:
setDialogEventHandler in interface WebBrowser
Parameters:
handler - dialog event handler

setNewWindowHandler

public void setNewWindowHandler(NewWindowEventHandler newWindowHandler)
Sets new window handler.

Specified by:
setNewWindowHandler in interface WebBrowser
Parameters:
newWindowHandler - new window handler

getNewWindowHandler

public NewWindowEventHandler getNewWindowHandler()
Returns new window handler.

Specified by:
getNewWindowHandler in interface WebBrowser
Returns:
new window handler

addNewWindowListener

public void addNewWindowListener(NewWindowEventListener listener)
Adds new window listener.

Specified by:
addNewWindowListener in interface WebBrowser
Parameters:
listener - new window listener

removeNewWindowListener

public void removeNewWindowListener(NewWindowEventListener listener)
Removes new window listener.

Specified by:
removeNewWindowListener in interface WebBrowser
Parameters:
listener - new window listener

getNewWindowListeners

public java.util.List getNewWindowListeners()
Returns new window listeners.

Specified by:
getNewWindowListeners in interface WebBrowser
Returns:
new window listeners

trackChildren

public void trackChildren()
Description copied from interface: ParentWindow
Starts to collect information about child object creation.

Specified by:
trackChildren in interface ParentWindow

getRecentChild

public WebBrowser getRecentChild()
Description copied from interface: ParentWindow
Returns recent created child object since last trackChildren() method call.

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.

waitChildCreation

public WebBrowser waitChildCreation()
Description copied from interface: ParentWindow
Blocks execution until child is created since last trackChildren() call and returns this child.

In other words, this method waits until getRecentChild() call returns non-null object.

Specified by:
waitChildCreation in interface ParentWindow
Returns:
recent created child

waitChildCreation

public WebBrowser waitChildCreation(java.lang.Runnable operationThatCreatesChild)
Description copied from interface: ParentWindow
Executes operation specified in the parameter and returns when child created by the operation is opened.

Specified by:
waitChildCreation in interface ParentWindow
Parameters:
operationThatCreatesChild - operation
Returns:
child created by the operation

setCookie

public void setCookie(java.lang.String url,
                      Cookie cookie)
Creates a new cookie for the specified URL using WinINet API. This is an analogue of the InternetSetCookie native function.

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

getCookies

public java.util.Set getCookies(java.lang.String url)
Returns cookies, that are associated with the specified URL. This is an analogue of the InternetGetCookie native function.

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

setKeyFilter

public void setKeyFilter(KeyFilter keyFilter)
Description copied from interface: WebBrowser
Sets key filter.

Specified by:
setKeyFilter in interface WebBrowser
Parameters:
keyFilter - key filter

getKeyFilter

public KeyFilter getKeyFilter()
Description copied from interface: WebBrowser
Returns key filter.

Specified by:
getKeyFilter in interface WebBrowser
Returns:
key filter

getScreenShot

public java.awt.Image getScreenShot(boolean wholePage)
Returns an image that represent screen shot of the page.

Parameters:
wholePage - if true returns the whole page not just what is visible
Returns:
an image that represent screen shot of the page

getProperties

public WebBrowser.Properties getProperties()
Description copied from interface: WebBrowser
Returns extended browser properties.

Specified by:
getProperties in interface WebBrowser
Returns:
extended browser properties.

addBrowserWindowListener

public void addBrowserWindowListener(BrowserWindowListener listener)
Description copied from interface: WebBrowser
Adds window listener.

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

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

getBrowserWindowListeners

public BrowserWindowListener[] getBrowserWindowListeners()
Description copied from interface: WebBrowser
Returns an array of window listeners.

Specified by:
getBrowserWindowListeners in interface WebBrowser
Returns:
an array of window listeners

setCursor

public void setCursor(java.awt.Cursor cursor)

setEnabled

public void setEnabled(boolean enabled)