Class JDialog

java.lang.Object

vaadinx.awt.Component

vaadinx.awt.Container

vaadinx.awt.Window

vaadinx.awt.Dialog

vaadinx.swing.JDialog

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible, WindowConstants, RootPaneContainer

public class JDialog
extends Dialog
implements WindowConstants, RootPaneContainer

Emulator for JDialog. R_leaf_peer_lockdown-locked peer is SJDialog.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class Dialog

Dialog.ModalityType

Field Summary

Fields

Modifier and Type	Field	Description
protected JRootPane	rootPane
protected boolean	rootPaneCheckingEnabled

Fields inherited from class Dialog

DEFAULT_MODALITY_TYPE

Fields inherited from class Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, FILL_CHROME, FILL_DEFAULT, LEFT_ALIGNMENT, listenerList, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Fields inherited from interface WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Constructor Summary

Constructors

Constructor	Description
JDialog()
JDialog(Dialog owner)
JDialog(Dialog owner, boolean modal)
JDialog(Dialog owner, String title)
JDialog(Dialog owner, String title, boolean modal)
JDialog(Dialog owner, String title, boolean modal, GraphicsConfiguration gc)
JDialog(Frame owner)
JDialog(Frame owner, boolean modal)
JDialog(Frame owner, String title)
JDialog(Frame owner, String title, boolean modal)
JDialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)
JDialog(Window owner)
JDialog(Window owner, String title)
JDialog(Window owner, String title, Dialog.ModalityType modalityType)
JDialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)
JDialog(Window owner, Dialog.ModalityType modalityType)

Method Summary

Modifier and Type	Method	Description
protected void	addImpl(Component comp, Object constraints, int index)
protected JRootPane	createRootPane()
protected void	dialogInit()	Mirror of JFrame.frameInit, and of the JDK's own JDialog.dialogInit: build the root pane through createRootPane() and plant it via setRootPane(JRootPane), then turn root-pane checking on — each as a call, so a subclass override of any hook actually runs (R_no_vaadin_in_api limb 2).
AccessibleContext	getAccessibleContext()
Container	getContentPane()	Delegates to the root pane, as the JDK's does.
int	getDefaultCloseOperation()
Component	getGlassPane()
JMenuBar	getJMenuBar()
JLayeredPane	getLayeredPane()
JRootPane	getRootPane()
TransferHandler	getTransferHandler()
protected boolean	isRootPaneCheckingEnabled()	Whether add / remove / setLayout redirect into the content pane.
protected String	paramString()
protected void	processWindowEvent(WindowEvent e)	Mirrors JFrame.processWindowEvent minus the EXIT_ON_CLOSE branch — JDialog rejects EXIT_ON_CLOSE at set-time.
void	remove(Component comp)
void	setContentPane(Container newPane)	Delegates to the root pane, as the JDK's does — so dialog.getContentPane() and dialog.getRootPane().getContentPane() are the same pane by construction rather than by a mirror kept in step.
void	setDefaultCloseOperation(int operation)	JDialog rejects EXIT_ON_CLOSE at set-time per JDK contract — only JFrame may terminate the JVM.
void	setGlassPane(Component glass)
void	setJMenuBar(JMenuBar bar)	The JDK's one-line delegation to getRootPane().setJMenuBar(menu), which is now literally that — so dialog.setJMenuBar(x) and dialog.getRootPane().setJMenuBar(x) are the same bar.
void	setLayeredPane(JLayeredPane layered)
void	setLayout(LayoutManager manager)	Stores the manager and invalidates as AWT does, minus the CSS dispatch — see Window.windowLayout.
protected void	setRootPane(JRootPane newRootPane)	The JDK's body: remove the outgoing root pane, then add the incoming one, with root-pane checking cleared so addImpl(Component, Object, int)'s redirect falls through instead of routing the new root pane into the old one's content pane.
protected void	setRootPaneCheckingEnabled(boolean enabled)
void	setTransferHandler(TransferHandler h)	Stores the handler and fires "transferHandler"; no drop target is installed.

Methods inherited from class Dialog

blocksAfterVisibilityChange, dispose, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, setVisible, show

Methods inherited from class Window

addNotify, addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, applyVisibleToPeer, applyVisibleToPeerImpl, createBufferStrategy, createBufferStrategy, disposePeer, fireWindowEvent, fireWindowFocusEvent, fireWindowStateEvent, getBackground, getBounds, getBounds, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getHeight, getIconImages, getInputContext, getLayout, getLocale, getLocation, getLocation, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getSize, getSize, getToolkit, getWarningString, getWidth, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, getX, getY, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setSize, setSize, toBack, toFront

Methods inherited from class Container

add, add, add, add, add, addContainerListener, addSlotChild, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, fireHierarchyEvent, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, peerContentElement, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, removeSlotChild, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusDownCycle, update, validate, validateTree

Methods inherited from class Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, applyBackgroundToPeer, awtListeners, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, defaultFillCssClass, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, fireComponentEvent, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isThemeDefault, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, suppressMouseBridge, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, withPeer, withPeerOnLiveUI

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

rootPane

protected JRootPane rootPane

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

Constructor Details

JDialog

public JDialog()
        throws HeadlessException

Throws:

HeadlessException

JDialog

public JDialog(Frame owner)

JDialog

public JDialog(Frame owner,
 boolean modal)

JDialog

public JDialog(Frame owner,
 String title)

JDialog

public JDialog(Frame owner,
 String title,
 boolean modal)

JDialog

public JDialog(Frame owner,
 String title,
 boolean modal,
 GraphicsConfiguration gc)

JDialog

public JDialog(Dialog owner)

JDialog

public JDialog(Dialog owner,
 boolean modal)

JDialog

public JDialog(Dialog owner,
 String title)

JDialog

public JDialog(Dialog owner,
 String title,
 boolean modal)

JDialog

public JDialog(Dialog owner,
 String title,
 boolean modal,
 GraphicsConfiguration gc)

JDialog

public JDialog(Window owner)

JDialog

public JDialog(Window owner,
 Dialog.ModalityType modalityType)

JDialog

public JDialog(Window owner,
 String title)

JDialog

public JDialog(Window owner,
 String title,
 Dialog.ModalityType modalityType)

Throws:

IllegalArgumentException - if owner is neither a Frame nor a Dialog

JDialog

public JDialog(Window owner,
 String title,
 Dialog.ModalityType modalityType,
 GraphicsConfiguration gc)

Method Details

dialogInit

protected void dialogInit()

Mirror of JFrame.frameInit, and of the JDK's own JDialog.dialogInit: build the root pane through createRootPane() and plant it via setRootPane(JRootPane), then turn root-pane checking on — each as a call, so a subclass override of any hook actually runs (R_no_vaadin_in_api limb 2). Carries the JDK's full five-line body: enableEvents and setBackground are here because JDialog.dialogInit has them too, where JWindow.windowInit has neither — see JFrame.frameInit for why both land on deliberate nothings.

getContentPane

public Container getContentPane()

Delegates to the root pane, as the JDK's does.

Specified by:

getContentPane in interface RootPaneContainer

setContentPane

public void setContentPane(Container newPane)

Delegates to the root pane, as the JDK's does — so dialog.getContentPane() and dialog.getRootPane().getContentPane() are the same pane by construction rather than by a mirror kept in step.

Specified by:

setContentPane in interface RootPaneContainer

addImpl

protected void addImpl(Component comp,
 Object constraints,
 int index)

Overrides:

addImpl in class Container

setLayout

public void setLayout(LayoutManager manager)

Description copied from class: Window

Stores the manager and invalidates as AWT does, minus the CSS dispatch — see Window.windowLayout.

Overrides:

setLayout in class Window

Parameters:

manager - may be null, as AWT allows

remove

public void remove(Component comp)

Overrides:

remove in class Container

setRootPaneCheckingEnabled

protected void setRootPaneCheckingEnabled(boolean enabled)

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

Whether add / remove / setLayout redirect into the content pane. The redirect consults this method rather than the field, so a subclass override is honoured (R_no_vaadin_in_api second limb, D_r12_provenance).

getRootPane

public JRootPane getRootPane()

Specified by:

getRootPane in interface RootPaneContainer

setRootPane

protected void setRootPane(JRootPane newRootPane)

The JDK's body: remove the outgoing root pane, then add the incoming one, with root-pane checking cleared so addImpl(Component, Object, int)'s redirect falls through instead of routing the new root pane into the old one's content pane.

createRootPane

protected JRootPane createRootPane()

getLayeredPane

public JLayeredPane getLayeredPane()

Specified by:

getLayeredPane in interface RootPaneContainer

setLayeredPane

public void setLayeredPane(JLayeredPane layered)

Specified by:

setLayeredPane in interface RootPaneContainer

getGlassPane

public Component getGlassPane()

Specified by:

getGlassPane in interface RootPaneContainer

setGlassPane

public void setGlassPane(Component glass)

Specified by:

setGlassPane in interface RootPaneContainer

getDefaultCloseOperation

public int getDefaultCloseOperation()

setDefaultCloseOperation

public void setDefaultCloseOperation(int operation)

JDialog rejects EXIT_ON_CLOSE at set-time per JDK contract — only JFrame may terminate the JVM. The other three values are accepted silently. Validation + gesture-disarm delegated to the SJDialog peer (which throws IllegalArgumentException on unknown values, matching Swing's D_never_fail_on_gaps contract).

processWindowEvent

protected void processWindowEvent(WindowEvent e)

Mirrors JFrame.processWindowEvent minus the EXIT_ON_CLOSE branch — JDialog rejects EXIT_ON_CLOSE at set-time.

Overrides:

processWindowEvent in class Dialog

setJMenuBar

public void setJMenuBar(JMenuBar bar)

The JDK's one-line delegation to getRootPane().setJMenuBar(menu), which is now literally that — so dialog.setJMenuBar(x) and dialog.getRootPane().setJMenuBar(x) are the same bar. It is planted in the root pane's layered pane, above the content pane.

Fires no "JMenuBar" property change: neither class fires anything. JInternalFrame is the only class in javax.swing that does (its MENU_BAR_PROPERTY), which is why the absence here is a decision and not an oversight (R_decline_effect_only, D_window_fanout).

getJMenuBar

public JMenuBar getJMenuBar()

paramString

protected String paramString()

Overrides:

paramString in class Dialog

getAccessibleContext

public AccessibleContext getAccessibleContext()

Specified by:

getAccessibleContext in interface Accessible

Overrides:

getAccessibleContext in class Dialog

setTransferHandler

public void setTransferHandler(TransferHandler h)

Stores the handler and fires "transferHandler"; no drop target is installed. Window-level drop is not wired — JComponent's own setTransferHandler is (D_drag_and_drop) — so what is declined is the effect (R_decline_effect_only, D_owed_events).

getTransferHandler

public TransferHandler getTransferHandler()