org.eclipse.swt.browser
Interface OpenWindowListener

All Superinterfaces:
java.util.EventListener, SWTEventListener

public interface OpenWindowListener
extends SWTEventListener

This listener interface may be implemented in order to receive a WindowEvent notification when a new Browser needs to be provided by the application.

Since:
3.0
See Also:
Browser.addOpenWindowListener(OpenWindowListener), Browser.removeOpenWindowListener(OpenWindowListener), CloseWindowListener, VisibilityWindowListener

Method Summary
 void open(WindowEvent event)
          This method is called when a new window needs to be created.
 

Method Detail

open

void open(WindowEvent event)
This method is called when a new window needs to be created.

A particular Browser can be passed to the event.browser field to host the content of a new window.

A standalone system browser is used to host the new window if the event.required field value is false and if the event.browser field is left null. The event.required field is true on platforms that don't support a standalone system browser for new window requests.

The navigation is cancelled if the event.required field is set to true and the event.browser field is left null.

The following fields in the WindowEvent apply:

Parameters:
event - the WindowEvent that needs to be passed a new Browser to handle the new window request
Since:
3.0