• Home
• com.resare.repackage
• org.eclipse.swt.macosx.x86_64
• 3.105.0.v20160603-0902
• source code
• Browser.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

org.eclipse.swt.browser.Browser Maven / Gradle / Ivy

/*******************************************************************************
 * Copyright (c) 2003, 2012 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.swt.browser;

import org.eclipse.swt.*;
import org.eclipse.swt.widgets.*;

/**
 * Instances of this class implement the browser user interface
 * metaphor.  It allows the user to visualize and navigate through
 * HTML documents.
 * 

 * Note that although this class is a subclass of Composite,
 * it does not make sense to set a layout on it.
 * 
 * 

 * 
Styles:
 * 
MOZILLA, WEBKIT
 * 
Events:
 * 
CloseWindowListener, LocationListener, OpenWindowListener, ProgressListener, StatusTextListener, TitleListener, VisibilityWindowListener
 * 
 * 

 * Note: At most one of the styles MOZILLA and WEBKIT may be specified.
 * 
 * 

 * IMPORTANT: This class is not intended to be subclassed.
 * 
 *
 * @see Browser snippets
 * @see SWT Examples: ControlExample, BrowserExample
 * @see Sample code and further information
 *
 * @since 3.0
 * @noextend This class is not intended to be subclassed by clients.
 */

public class Browser extends Composite {
	WebBrowser webBrowser;
	int userStyle;
	boolean isClosing;

	static int DefaultType = SWT.DEFAULT;

	static final String NO_INPUT_METHOD = "org.eclipse.swt.internal.gtk.noInputMethod"; //$NON-NLS-1$
	static final String PACKAGE_PREFIX = "org.eclipse.swt.browser."; //$NON-NLS-1$
	static final String PROPERTY_DEFAULTTYPE = "org.eclipse.swt.browser.DefaultType"; //$NON-NLS-1$

/**
 * Constructs a new instance of this class given its parent
 * and a style value describing its behavior and appearance.
 * 

 * The style value is either one of the style constants defined in
 * class SWT which is applicable to instances of this
 * class, or must be built by bitwise OR'ing together
 * (that is, using the int "|" operator) two or more
 * of those SWT style constants. The class description
 * lists the style constants that are applicable to the class.
 * Style bits are also inherited from superclasses.
 * 
 *
 * @param parent a widget which will be the parent of the new instance (cannot be null)
 * @param style the style of widget to construct
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the parent is null
 * 
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent
 * 
 * @exception SWTError 

 *    
ERROR_NO_HANDLES if a handle could not be obtained for browser creation
 * 
 *
 * @see Widget#getStyle
 *
 * @since 3.0
 */
public Browser (Composite parent, int style) {
	super (checkParent (parent), checkStyle (style));
	userStyle = style;

	String platform = SWT.getPlatform ();
	if ("gtk".equals (platform)) { //$NON-NLS-1$
		parent.getDisplay ().setData (NO_INPUT_METHOD, null);
	}

	style = getStyle ();
	webBrowser = new BrowserFactory ().createWebBrowser (style);
	if (webBrowser != null) {
		webBrowser.setBrowser (this);
		webBrowser.create (parent, style);
		return;
	}
	dispose ();
	SWT.error (SWT.ERROR_NO_HANDLES);
}

static Composite checkParent (Composite parent) {
	String platform = SWT.getPlatform ();
	if (!"gtk".equals (platform)) return parent; //$NON-NLS-1$

	/*
	* Note.  Mozilla provides all IM support needed for text input in web pages.
	* If SWT creates another input method context for the widget it will cause
	* indeterminate results to happen (hangs and crashes). The fix is to prevent
	* SWT from creating an input method context for the  Browser widget.
	*/
	if (parent != null && !parent.isDisposed ()) {
		Display display = parent.getDisplay ();
		if (display != null) {
			if (display.getThread () == Thread.currentThread ()) {
				display.setData (NO_INPUT_METHOD, "true"); //$NON-NLS-1$
			}
		}
	}
	return parent;
}

static int checkStyle(int style) {
	String platform = SWT.getPlatform ();
	if (DefaultType == SWT.DEFAULT) {
		/*
		* Some Browser clients that explicitly specify the native renderer to use
		* (by creating a Browser with style SWT.MOZILLA or SWT.WEBKIT) may also
		* need to specify that all "default" Browser instances (those created with
		* style SWT.NONE) should use this renderer as well.  This may be needed in
		* order to avoid incompatibilities that can arise from having multiple
		* native renderers loaded within the same process.  A client can do this by
		* setting the "org.eclipse.swt.browser.DefaultType" java system property to
		* a value like "mozilla" or "webkit".
		*/

		/*
		* Plug-ins need an opportunity to set the org.eclipse.swt.browser.DefaultType
		* system property before the first Browser is created.  To facilitate this,
		* reflection is used to reference non-existent class
		* org.eclipse.swt.browser.BrowserInitializer the first time a Browser is created.
		* A client wishing to use this hook can do so by creating a fragment of
		* org.eclipse.swt that implements this class and sets the system property in its
		* static initializer.
		*/
		try {
			Class.forName ("org.eclipse.swt.browser.BrowserInitializer"); //$NON-NLS-1$
		} catch (ClassNotFoundException e) {
			/* no fragment is providing this class, which is the typical case */
		}

		String value = System.getProperty (PROPERTY_DEFAULTTYPE);
		if (value != null) {
			int index = 0;
			int length = value.length();
			do {
				int newIndex = value.indexOf(',', index);
				if (newIndex == -1) {
					newIndex = length;
				}
				String current = value.substring(index, newIndex).trim();
				if (current.equalsIgnoreCase ("mozilla")) { //$NON-NLS-1$
					DefaultType = SWT.MOZILLA;
					break;
				} else if (current.equalsIgnoreCase ("webkit")) { //$NON-NLS-1$
					DefaultType = SWT.WEBKIT;
					break;
				} else if (current.equalsIgnoreCase ("ie") && "win32".equals (platform)) { //$NON-NLS-1$ //$NON-NLS-2$
					DefaultType = SWT.NONE;
					break;
				}
				index = newIndex + 1;
			} while (index < length);
		}
		if (DefaultType == SWT.DEFAULT) {
			DefaultType = SWT.NONE;
		}
	}

	if ((style & (SWT.MOZILLA | SWT.WEBKIT)) == 0) {
		style |= DefaultType;
	}

	if ((style & (SWT.MOZILLA | SWT.WEBKIT)) == (SWT.MOZILLA | SWT.WEBKIT)) {
		style &= ~SWT.WEBKIT;
	}
	if ((style & SWT.MOZILLA) != 0 || (style & SWT.WEBKIT) != 0) {
		return style;
	}

	if ("win32".equals (platform)) { //$NON-NLS-1$
		/*
		* For IE on win32 the border is supplied by the embedded browser, so remove
		* the style so that the parent Composite will not draw a second border.
		*/
		return style & ~SWT.BORDER;
	}
	return style;
}

@Override
protected void checkWidget () {
	super.checkWidget ();
}

/**
 * Clears all session cookies from all current Browser instances.
 *
 * @since 3.2
 */
public static void clearSessions () {
	WebBrowser.clearSessions ();
}

/**
 * Returns the value of a cookie that is associated with a URL.
 * Note that cookies are shared amongst all Browser instances.
 *
 * @param name the cookie name
 * @param url the URL that the cookie is associated with
 * @return the cookie value, or null if no such cookie exists
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the name is null
 *    
ERROR_NULL_ARGUMENT - if the url is null
 * 
 *
 * @since 3.5
 */
public static String getCookie (String name, String url) {
	if (name == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	if (url == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	return WebBrowser.GetCookie (name, url);
}

/**
 * Sets a cookie on a URL.  Note that cookies are shared amongst all Browser instances.
 *
 * The value parameter must be a cookie header string that
 * complies with RFC 2109.
 * The value is passed through to the native browser unchanged.
 * 

 * Example value strings:
 * foo=bar (basic session cookie)
 * foo=bar; path=/; domain=.eclipse.org (session cookie)
 * foo=bar; expires=Thu, 01-Jan-2030 00:00:01 GMT (persistent cookie)
 * foo=; expires=Thu, 01-Jan-1970 00:00:01 GMT (deletes cookie foo)
 *
 * @param value the cookie value
 * @param url the URL to associate the cookie with
 * @return true if the cookie was successfully set and false otherwise
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the value is null
 *    
ERROR_NULL_ARGUMENT - if the url is null
 * 
 *
 * @since 3.5
 */
public static boolean setCookie (String value, String url) {
	if (value == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	if (url == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	return WebBrowser.SetCookie (value, url, true);
}

/**
 * Adds the listener to the collection of listeners who will be
 * notified when authentication is required.
 * 

 * This notification occurs when a page requiring authentication is
 * encountered.
 * 
 *
 * @param listener the listener which should be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.5
 */
public void addAuthenticationListener (AuthenticationListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.addAuthenticationListener (listener);
}

/**
 * Adds the listener to the collection of listeners who will be
 * notified when the window hosting the receiver should be closed.
 * 

 * This notification occurs when a javascript command such as
 * window.close gets executed by a Browser.
 * 
 *
 * @param listener the listener which should be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void addCloseWindowListener (CloseWindowListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.addCloseWindowListener (listener);
}

/**
 * Adds the listener to the collection of listeners who will be
 * notified when the current location has changed or is about to change.
 * 

 * This notification typically occurs when the application navigates
 * to a new location with {@link #setUrl(String)} or when the user
 * activates a hyperlink.
 * 
 *
 * @param listener the listener which should be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void addLocationListener (LocationListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.addLocationListener (listener);
}

/**
 * Adds the listener to the collection of listeners who will be
 * notified when a new window needs to be created.
 * 

 * This notification occurs when a javascript command such as
 * window.open gets executed by a Browser.
 * 
 *
 * @param listener the listener which should be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void addOpenWindowListener (OpenWindowListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.addOpenWindowListener (listener);
}

/**
 * Adds the listener to the collection of listeners who will be
 * notified when a progress is made during the loading of the current
 * URL or when the loading of the current URL has been completed.
 *
 * @param listener the listener which should be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void addProgressListener (ProgressListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.addProgressListener (listener);
}

/**
 * Adds the listener to the collection of listeners who will be
 * notified when the status text is changed.
 * 

 * The status text is typically displayed in the status bar of
 * a browser application.
 * 
 *
 * @param listener the listener which should be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void addStatusTextListener (StatusTextListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.addStatusTextListener (listener);
}

/**
 * Adds the listener to the collection of listeners who will be
 * notified when the title of the current document is available
 * or has changed.
 *
 * @param listener the listener which should be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void addTitleListener (TitleListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.addTitleListener (listener);
}

/**
 * Adds the listener to the collection of listeners who will be
 * notified when a window hosting the receiver needs to be displayed
 * or hidden.
 *
 * @param listener the listener which should be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void addVisibilityWindowListener (VisibilityWindowListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.addVisibilityWindowListener (listener);
}

/**
 * Navigate to the previous session history item.
 *
 * @return true if the operation was successful and false otherwise
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @see #forward
 *
 * @since 3.0
 */
public boolean back () {
	checkWidget();
	return webBrowser.back ();
}

@Override
protected void checkSubclass () {
	String name = getClass ().getName ();
	int index = name.lastIndexOf ('.');
	if (!name.substring (0, index + 1).equals (PACKAGE_PREFIX)) {
		SWT.error (SWT.ERROR_INVALID_SUBCLASS);
	}
}

/**
 * Executes the specified script.
 * 

 * Executes a script containing javascript commands in the context of the current document.
 * If document-defined functions or properties are accessed by the script then this method
 * should not be invoked until the document has finished loading (ProgressListener.completed()
 * gives notification of this).
 *
 * @param script the script with javascript commands
 *
 * @return true if the operation was successful and false otherwise
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the script is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @see ProgressListener#completed(ProgressEvent)
 *
 * @since 3.1
 */
public boolean execute (String script) {
	checkWidget();
	if (script == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	return webBrowser.execute (script);
}

/**
 * Attempts to dispose the receiver, but allows the dispose to be vetoed
 * by the user in response to an onbeforeunload listener
 * in the Browser's current page.
 *
 * @return true if the receiver was disposed, and false otherwise
 *
 * @exception SWTException 

 *    
ERROR_WIDGET_DISPOSED - if the receiver has been disposed
 *    
ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
 * 
 *
 * @see #dispose()
 *
 * @since 3.6
 */
public boolean close () {
	checkWidget();
	if (webBrowser.close ()) {
		isClosing = true;
		dispose ();
		isClosing = false;
		return true;
	}
	return false;
}

/**
 * Returns the result, if any, of executing the specified script.
 * 

 * Evaluates a script containing javascript commands in the context of
 * the current document.  If document-defined functions or properties
 * are accessed by the script then this method should not be invoked
 * until the document has finished loading (ProgressListener.completed()
 * gives notification of this).
 * 

 * If the script returns a value with a supported type then a java
 * representation of the value is returned.  The supported
 * javascript -> java mappings are:
 * 

 * 
javascript null or undefined -> null
 * 
javascript number -> java.lang.Double
 * 
javascript string -> java.lang.String
 * 
javascript boolean -> java.lang.Boolean
 * 
javascript array whose elements are all of supported types -> java.lang.Object[]
 * 
 *
 * An SWTException is thrown if the return value has an
 * unsupported type, or if evaluating the script causes a javascript
 * error to be thrown.
 *
 * @param script the script with javascript commands
 *
 * @return the return value, if any, of executing the script
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the script is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_FAILED_EVALUATE when the script evaluation causes a javascript error to be thrown
 *    
ERROR_INVALID_RETURN_VALUE when the script returns a value of unsupported type
 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @see Browser#evaluate(String,boolean)
 * @see ProgressListener#completed(ProgressEvent)
 *
 * @since 3.5
 */
public Object evaluate (String script) throws SWTException {
	checkWidget();
	return evaluate (script, false);
}

/**
 * Returns the result, if any, of executing the specified script.
 * 

 * Evaluates a script containing javascript commands.
 * When trusted is true script is executed in the context of Chrome
 * with Chrome security privileges.
 * When trusted is false script is executed in the context of the
 * current document with normal privileges.
 * 

 * If document-defined functions or properties are accessed by the script then
 * this method should not be invoked until the document has finished loading
 * (ProgressListener.completed() gives notification of this).
 * 

 * If the script returns a value with a supported type then a java
 * representation of the value is returned.  The supported
 * javascript -> java mappings are:
 * 

 * 
javascript null or undefined -> null
 * 
javascript number -> java.lang.Double
 * 
javascript string -> java.lang.String
 * 
javascript boolean -> java.lang.Boolean
 * 
javascript array whose elements are all of supported types -> java.lang.Object[]
 * 
 * An SWTException is thrown if the return value has an
 * unsupported type, or if evaluating the script causes a javascript
 * error to be thrown.
 * 

 * Note: Chrome security context is applicable only to Browsers with style SWT.Mozilla.
 * 
 * @param script the script with javascript commands
 * @param trusted true> or false depending on the security context to be used
 *
 * @return the return value, if any, of executing the script
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the script is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_FAILED_EVALUATE when the script evaluation causes a javascript error to be thrown
 *    
ERROR_INVALID_RETURN_VALUE when the script returns a value of unsupported type
 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @see ProgressListener#completed(ProgressEvent)
 */
public Object evaluate (String script, boolean trusted) throws SWTException {
	checkWidget();
	if (script == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	return webBrowser.evaluate (script, trusted);
}

/**
 * Navigate to the next session history item.
 *
 * @return true if the operation was successful and false otherwise
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @see #back
 *
 * @since 3.0
 */
public boolean forward () {
	checkWidget();
	return webBrowser.forward ();
}

/**
 * Returns the type of native browser being used by this instance.
 * Examples: "ie", "mozilla", "voyager", "webkit"
 *
 * @return the type of the native browser
 *
 * @since 3.5
 */
public String getBrowserType () {
	checkWidget();
	return webBrowser.getBrowserType ();
}

/**
 * Returns true if javascript will be allowed to run in pages
 * subsequently viewed in the receiver, and false otherwise.
 * Note that this may not reflect the javascript enablement on the currently-
 * viewed page if setJavascriptEnabled() has been invoked during
 * its lifetime.
 *
 * @return the receiver's javascript enabled state
 *
 * @exception SWTException 

 *    
ERROR_WIDGET_DISPOSED - if the receiver has been disposed
 *    
ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
 * 
 *
 * @see #setJavascriptEnabled
 *
 * @since 3.5
 */
public boolean getJavascriptEnabled () {
	checkWidget();
	return webBrowser.jsEnabledOnNextPage;
}

@Override
public int getStyle () {
	/*
	* If SWT.BORDER was specified at creation time then getStyle() should answer
	* it even though it is removed for IE on win32 in checkStyle().
	*/
	return super.getStyle () | (userStyle & SWT.BORDER);
}

/**
 * Returns a string with HTML that represents the content of the current page.
 *
 * @return HTML representing the current page or an empty String
 * if this is empty
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.4
 */
public String getText () {
	checkWidget();
	return webBrowser.getText ();
}

/**
 * Returns the current URL.
 *
 * @return the current URL or an empty String if there is no current URL
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @see #setUrl
 *
 * @since 3.0
 */
public String getUrl () {
	checkWidget();
	return webBrowser.getUrl ();
}

/**
 * Returns the JavaXPCOM nsIWebBrowser for the receiver, or null
 * if it is not available.  In order for an nsIWebBrowser to be returned all
 * of the following must be true: 

 *    
the receiver's style must be SWT.MOZILLA
 *    
the classes from JavaXPCOM >= 1.8.1.2 must be resolvable at runtime
 *    
the version of the underlying XULRunner must be >= 1.8.1.2
 * 
 *
 * @return the receiver's JavaXPCOM nsIWebBrowser or null
 *
 * @since 3.3
 */
public Object getWebBrowser () {
	checkWidget();
	return webBrowser.getWebBrowser ();
}

/**
 * Returns true if the receiver can navigate to the
 * previous session history item, and false otherwise.
 *
 * @return the receiver's back command enabled state
 *
 * @exception SWTException 

 *    
ERROR_WIDGET_DISPOSED - if the receiver has been disposed
 *    
ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
 * 
 *
 * @see #back
 */
public boolean isBackEnabled () {
	checkWidget();
	return webBrowser.isBackEnabled ();
}

@Override
public boolean isFocusControl () {
	checkWidget();
	if (webBrowser.isFocusControl ()) return true;
	return super.isFocusControl ();
}

/**
 * Returns true if the receiver can navigate to the
 * next session history item, and false otherwise.
 *
 * @return the receiver's forward command enabled state
 *
 * @exception SWTException 

 *    
ERROR_WIDGET_DISPOSED - if the receiver has been disposed
 *    
ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
 * 
 *
 * @see #forward
 */
public boolean isForwardEnabled () {
	checkWidget();
	return webBrowser.isForwardEnabled ();
}

/**
 * Refresh the current page.
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void refresh () {
	checkWidget();
	webBrowser.refresh ();
}

/**
 * Removes the listener from the collection of listeners who will
 * be notified when authentication is required.
 *
 * @param listener the listener which should no longer be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.5
 */
public void removeAuthenticationListener (AuthenticationListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.removeAuthenticationListener (listener);
}

/**
 * Removes the listener from the collection of listeners who will
 * be notified when the window hosting the receiver should be closed.
 *
 * @param listener the listener which should no longer be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void removeCloseWindowListener (CloseWindowListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.removeCloseWindowListener (listener);
}

/**
 * Removes the listener from the collection of listeners who will
 * be notified when the current location is changed or about to be changed.
 *
 * @param listener the listener which should no longer be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void removeLocationListener (LocationListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.removeLocationListener (listener);
}

/**
 * Removes the listener from the collection of listeners who will
 * be notified when a new window needs to be created.
 *
 * @param listener the listener which should no longer be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void removeOpenWindowListener (OpenWindowListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.removeOpenWindowListener (listener);
}

/**
 * Removes the listener from the collection of listeners who will
 * be notified when a progress is made during the loading of the current
 * URL or when the loading of the current URL has been completed.
 *
 * @param listener the listener which should no longer be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void removeProgressListener (ProgressListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.removeProgressListener (listener);
}

/**
 * Removes the listener from the collection of listeners who will
 * be notified when the status text is changed.
 *
 * @param listener the listener which should no longer be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void removeStatusTextListener (StatusTextListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.removeStatusTextListener (listener);
}

/**
 * Removes the listener from the collection of listeners who will
 * be notified when the title of the current document is available
 * or has changed.
 *
 * @param listener the listener which should no longer be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void removeTitleListener (TitleListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.removeTitleListener (listener);
}

/**
 * Removes the listener from the collection of listeners who will
 * be notified when a window hosting the receiver needs to be displayed
 * or hidden.
 *
 * @param listener the listener which should no longer be notified
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the listener is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void removeVisibilityWindowListener (VisibilityWindowListener listener) {
	checkWidget();
	if (listener == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	webBrowser.removeVisibilityWindowListener (listener);
}

/**
 * Sets whether javascript will be allowed to run in pages subsequently
 * viewed in the receiver.  Note that setting this value does not affect
 * the running of javascript in the current page.
 *
 * @param enabled the receiver's new javascript enabled state
 *
 * @exception SWTException 

 *    
ERROR_WIDGET_DISPOSED - if the receiver has been disposed
 *    
ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
 * 
 *
 * @since 3.5
 */
public void setJavascriptEnabled (boolean enabled) {
	checkWidget();
	webBrowser.jsEnabledOnNextPage = enabled;
}

/**
 * Renders a string containing HTML.  The rendering of the content occurs asynchronously.
 * The rendered page will be given trusted permissions; to render the page with untrusted
 * permissions use setText(String html, boolean trusted) instead.
 * 

 * The html parameter is Unicode-encoded since it is a java String.
 * As a result, the HTML meta tag charset should not be set. The charset is implied
 * by the String itself.
 *
 * @param html the HTML content to be rendered
 *
 * @return true if the operation was successful and false otherwise.
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the html is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @see #setText(String,boolean)
 * @see #setUrl
 *
 * @since 3.0
 */
public boolean setText (String html) {
	checkWidget();
	return setText (html, true);
}

/**
 * Renders a string containing HTML.  The rendering of the content occurs asynchronously.
 * The rendered page can be given either trusted or untrusted permissions.
 * 

 * The html parameter is Unicode-encoded since it is a java String.
 * As a result, the HTML meta tag charset should not be set. The charset is implied
 * by the String itself.
 * 

 * The trusted parameter affects the permissions that will be granted to the rendered
 * page.  Specifying true for trusted gives the page permissions equivalent
 * to a page on the local file system, while specifying false for trusted
 * gives the page permissions equivalent to a page from the internet.  Page content should
 * be specified as trusted if the invoker created it or trusts its source, since this would
 * allow (for instance) style sheets on the local file system to be referenced.  Page
 * content should be specified as untrusted if its source is not trusted or is not known.
 *
 * @param html the HTML content to be rendered
 * @param trusted false if the rendered page should be granted restricted
 * permissions and true otherwise
 *
 * @return true if the operation was successful and false otherwise.
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the html is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @see #setText(String)
 * @see #setUrl
 *
 * @since 3.6
 */
public boolean setText (String html, boolean trusted) {
	checkWidget();
	if (html == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	return webBrowser.setText (html, trusted);
}

/**
 * Begins loading a URL.  The loading of its content occurs asynchronously.
 *
 * @param url the URL to be loaded
 *
 * @return true if the operation was successful and false otherwise.
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the url is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @see #getUrl
 * @see #setUrl(String,String,String[])
 *
 * @since 3.0
 */
public boolean setUrl (String url) {
	checkWidget();
	return setUrl (url, null, null);
}

/**
 * Begins loading a URL.  The loading of its content occurs asynchronously.
 * 

 * If the URL causes an HTTP request to be initiated then the provided
 * postData and header arguments, if any, are
 * sent with the request.  A value in the headers argument
 * must be a name-value pair with a colon separator in order to be sent
 * (for example: "user-agent: custom").
 *
 * @param url the URL to be loaded
 * @param postData post data to be sent with the request, or null
 * @param headers header lines to be sent with the request, or null
 *
 * @return true if the operation was successful and false otherwise.
 *
 * @exception IllegalArgumentException 

 *    
ERROR_NULL_ARGUMENT - if the url is null
 * 
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.6
 */
public boolean setUrl (String url, String postData, String[] headers) {
	checkWidget();
	if (url == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	return webBrowser.setUrl (url, postData, headers);
}

/**
 * Stop any loading and rendering activity.
 *
 * @exception SWTException 

 *    
ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
 *    
ERROR_WIDGET_DISPOSED when the widget has been disposed
 * 
 *
 * @since 3.0
 */
public void stop () {
	checkWidget();
	webBrowser.stop ();
}
}