org.eclipse.swt.browser

Interface OpenWindowListener

All Superinterfaces:

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

Modifier and Type	Method and Description
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:

• (in/out) required true if the platform requires the user to provide a Browser to handle the new window or false otherwise.
• (out) browser the new (unique) Browser that will host the content of the new window.
• (in) widget the Browser that is requesting to open a new window

Parameters:

event - the WindowEvent that needs to be passed a new Browser to handle the new window request

Since:

3.0