Class SJWindow

java.lang.Object
com.vaadin.flow.component.Component
com.vaadin.flow.component.dialog.Dialog
com.vaadin.swingbridge.surrogates.SWindow
com.vaadin.swingbridge.surrogates.SJWindow
All Implemented Interfaces:
com.vaadin.flow.component.AttachNotifier, com.vaadin.flow.component.DetachNotifier, com.vaadin.flow.component.HasAriaRole, com.vaadin.flow.component.HasComponents, com.vaadin.flow.component.HasComponentsOfType<com.vaadin.flow.component.Component>, com.vaadin.flow.component.HasElement, com.vaadin.flow.component.HasEnabled, com.vaadin.flow.component.HasSize, com.vaadin.flow.component.HasStyle, com.vaadin.flow.component.HasTheme, com.vaadin.flow.component.shared.HasThemeVariant<com.vaadin.flow.component.dialog.DialogVariant>, ComponentMixin, ContainerMixin, JComponentMixin, Serializable
public class SJWindow extends SWindow
Surrogate for JWindow: an undecorated top-level window — splash screens, toast/notification popups, heavyweight-popup vehicles. JDK shape is JWindow extends java.awt.Window implements RootPaneContainer: no title, no chrome, no close gestures, no defaultCloseOperation (JWindow doesn't implement WindowConstants), no menubar slot. Accordingly this class extends SWindow directly — NOT SFrame, whose title / close-X / close-op state a JWindow must not carry.

Ctor defaults (the entire JWindow delta over SWindow)

  • Undecorated always — SWindow.setUndecoratedChrome(boolean) is on unconditionally: no header, no content padding, no border radius. Box-shadow kept per the documented R_layouts_close_enough divergence.
  • Modeless — a splash/toast must never block the page. Vaadin Dialog defaults to modal; the ctor flips to ModalityMode.MODELESS.
  • No user close gestures — ESC / outside-click dismissal is disarmed. A real JWindow has no chrome to close it from; programmatic setVisible(false) / dispose() are the only close paths, which also means no peer-originated WINDOW_CLOSING ever fires here.
  • Not user-movable / resizable — no title bar to drag, no resize grips. Vaadin Dialog's defaults (draggable=false, resizable=false) already match; unlike SFrame's ctor, nothing is seeded.

Placement

The typical JWindow is explicitly placed: setLocationRelativeTo(null) for a centered splash (the Dialog default — a no-op that also clears prior placement), SWindow.setBounds(int, int, int, int) for a corner toast. Both live on SWindow's geometry surface mapping 1:1 to the overlay's top/left/width/height.

RootPane / contentPane scaffolding

Third consumer of the shared RootPaneScaffold (with SJFrame / SJDialog) — the composition dedup SD_sjdialog's third-consumer trigger anticipated. Public surface mirrors JDK JWindow's RootPaneContainer subset: content pane routing, lazy root pane, layered / glass pass-throughs. The scaffold's menubar slot stays dormant here — JWindow has no setJMenuBar.
See Also:

  • Constructor Details

    • SJWindow

      public SJWindow()
      Ownerless window.

    • SJWindow

      public SJWindow(SWindow owner)
      With owner (any SWindow — frame, dialog, or window — per JDK's owner-chain shape). Null owner is a top-level window.

  • Method Details

    • getContentPane

      public com.vaadin.flow.component.html.Div getContentPane()
      Lazy-creates if never accessed. Never returns null.

    • setContentPane

      public void setContentPane(com.vaadin.flow.component.html.Div newPane)
      Swap the content pane. JDK contract: null throws IllegalComponentStateException; the mirror-into- rootPane invariant holds across swaps. Carried by RootPaneScaffold.

    • add

      public void add(Collection<com.vaadin.flow.component.Component> components)

    • addComponentAtIndex

      public void addComponentAtIndex(int index, com.vaadin.flow.component.Component component)
      Specified by:
      addComponentAtIndex in interface com.vaadin.flow.component.HasComponentsOfType<com.vaadin.flow.component.Component>
      Overrides:
      addComponentAtIndex in class com.vaadin.flow.component.dialog.Dialog

    • remove

      public void remove(com.vaadin.flow.component.Component... components)

    • remove

      public void remove(Collection<com.vaadin.flow.component.Component> components)

    • removeAll

      public void removeAll()
      Specified by:
      removeAll in interface com.vaadin.flow.component.HasComponentsOfType<com.vaadin.flow.component.Component>
      Overrides:
      removeAll in class com.vaadin.flow.component.dialog.Dialog

    • getRootPane

      public SJRootPane getRootPane()
      Description copied from interface: JComponentMixin
      Walks the Vaadin parent chain and returns the first SJRootPane ancestor, or null if none. Mirrors the JDK JComponent.getRootPane() contract (climb-until-root-pane) over the surrogate-layer types.

      Surrogate-layer divergence from JDK signature: returns SJRootPane (Vaadin-rooted) rather than javax.swing.JRootPane. The same R_vaadin_first + SD_sjframe stance that drove JComponentMixin.getTopLevelAncestor() to return Vaadin Component applies here — SJRootPane is deliberately not a JDK JRootPane subclass (it extends com.vaadin.flow.component.html.Div), so a JDK-typed accessor would have to either fabricate a wrapper or stay permanently null. The Vaadin-typed accessor lets SJFrame provide a covariant override that returns its lazy-constructed pane, and lets standalone surrogates report a real ancestor when one exists. Migrators porting Swing code that read the JDK type adjust the variable type at the surrogate stage; the :emulators.JComponent.getRootPane() path keeps the JDK-typed signature for stage-2 import-swap compatibility.

    • createRootPane

      protected SJRootPane createRootPane()
      Subclass hook matching JDK JWindow's createRootPane. Called once on first getRootPane() read.

    • getLayeredPane

      public com.vaadin.flow.component.Component getLayeredPane()

    • setLayeredPane

      public void setLayeredPane(com.vaadin.flow.component.Component layered)

    • getGlassPane

      public com.vaadin.flow.component.Component getGlassPane()

    • setGlassPane

      public void setGlassPane(com.vaadin.flow.component.Component glass)

    • getDefaultButton

      public com.vaadin.flow.component.button.Button getDefaultButton()
      Convenience accessor: getRootPane().getDefaultButton().