Package org.eclipse.swt.browser

Interface OpenWindowListener

All Superinterfaces:
EventListener, SWTEventListener
Functional Interface:
This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
@FunctionalInterface 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:

  • Method Summary

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

  • Method Details

    • 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) WindowEvent.required: true if the platform requires the user to provide a Browser to handle the new window or false otherwise.
      • (out) WindowEvent.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