|
Java Platform 1.2 Beta 4 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--java.awt.Window | +--java.awt.Dialog | +--com.sun.java.swing.JDialog
contentPane
should be the parent of any children of
the JDialog. From the older java.awt.Window
object you
would normally do something like this:
dialog.add(child);Using JDialog the proper semantic is:
dialog.getContentPane().add(child);The same priniciple holds true for setting layout managers, removing components, listing children, etc. All these methods should normally be sent to the
contentPane
instead of to the JDialog.
The contentPane
is always non-null. Attempting to set it
to null generates an exception. The default contentPane
has a BorderLayout manager set on it.
Please see the JRootPane documentation for a complete
description of the contentPane
, glassPane
,
and layeredPane
components.
NOTE: For 1.1, Modal dialogs are currently constrained to only allow lightweight popup menus (JPopupMenu, JComboBox, JMenuBar) because of window ownership limitations in AWT1.1. This creates the further limitation of not being able to mix Swing popup components with AWT heavyweight components in a modal dialog since the heavyweight components would always overlap the lightweights, potentially obscuring the popup menu. (A heavyweight component uses a native-platform component (peer) component for its implementation -- AWT components are heavyweight components.)
For the keyboard keys used by this component in the standard Look and Feel (L&F) renditions, see the JDialog key assignments.
Warning: serialized objects of this class will not be compatible with future swing releases. The current serialization support is appropriate for short term storage or RMI between Swing1.0 applications. It will not be possible to load serialized Swing1.0 objects with future releases of Swing. The JDK1.2 release of Swing will be the compatibility baseline for the serialized form of Swing objects.
JOptionPane
,
JRootPane
, Serialized FormInner Class Summary | |
protected | JDialog.AccessibleJDialog
The class used to obtain the AccessibleRole for this object. |
Field Summary | |
protected AccessibleContext | accessibleContext
|
protected JRootPane | rootPane
|
protected boolean | rootPaneCheckingEnabled
|
Fields inherited from class java.awt.Component | |
BOTTOM_ALIGNMENT , CENTER_ALIGNMENT , LEFT_ALIGNMENT , RIGHT_ALIGNMENT , TOP_ALIGNMENT |
Constructor Summary | |
JDialog()
Creates a non-modal dialog without a title and without a specified Frame owner. |
|
JDialog(Frame owner,
boolean modal)
Creates a modal or non-modal dialog without a title and with the specified owner frame. |
|
JDialog(Frame owner,
String title,
boolean modal)
Creates a modal or non-modal dialog with the specified title and the specified owner frame. |
|
JDialog(Frame owner,
String title)
Creates a non-modal dialog with the specified title and with the specified owner frame. |
|
JDialog(Frame owner)
Creates a non-modal dialog without a title with the specifed Frame as its owner. |
Method Summary | |
protected void | addImpl(Component comp,
Object constraints,
int index)
By default, children may not be added directly to a this component, they must be added to its contentPane instead. |
protected JRootPane | createRootPane()
Called by the constructor methods to create the default rootPane. |
protected void | dialogInit()
Called by the constructors to init the JDialog properly. |
AccessibleContext | getAccessibleContext()
Get the AccessibleContext associated with this JDialog |
Container | getContentPane()
Returns the contentPane object for this dialog. |
int | getDefaultCloseOperation()
Returns the operation which occurs when the user initiates a "close" on this dialog. |
Component | getGlassPane()
Returns the glassPane object for this dialog. |
JMenuBar | getJMenuBar()
Returns the menubar set on this dialog. |
JLayeredPane | getLayeredPane()
Returns the layeredPane object for this dialog. |
JRootPane | getRootPane()
Returns the rootPane object for this dialog. |
protected boolean | isRootPaneCheckingEnabled()
|
protected void | processWindowEvent(WindowEvent e)
Handles window events depending on the state of the defaultCloseOperation property. |
void | setContentPane(Container contentPane)
Sets the contentPane property. |
void | setDefaultCloseOperation(int operation)
Sets the operation which will happen by default when the user initiates a "close" on this dialog. |
void | setGlassPane(Component glassPane)
Sets the glassPane property. |
void | setJMenuBar(JMenuBar menu)
Sets the menubar for this dialog. |
void | setLayeredPane(JLayeredPane layeredPane)
Sets the layeredPane property. |
void | setLayout(LayoutManager manager)
By default the layout of this component may not be set, the layout of its contentPane should be set instead. |
void | setLocationRelativeTo(Component c)
Sets the location of the dialog relative to the specified component. |
protected void | setRootPane(JRootPane root)
Sets the rootPane property. |
protected void | setRootPaneCheckingEnabled(boolean enabled)
If true then calls to add() and setLayout() will cause an exception to be thrown. |
void | update(Graphics g)
Just calls paint(g) . |
Methods inherited from class java.awt.Dialog | |
addNotify , getTitle , isModal , isResizable , paramString , setModal , setResizable , setTitle , show |
Methods inherited from class java.awt.Window | |
addWindowListener , applyResourceBundle , applyResourceBundle , dispose , getFocusOwner , getInputContext , getLocale , getOwnedWindows , getOwner , getToolkit , getWarningString , isShowing , pack , postEvent , processEvent , removeWindowListener , toBack , toFront |
Methods inherited from class java.awt.Container | |
add , add , add , add , add , addContainerListener , countComponents , deliverEvent , doLayout , findComponentAt , findComponentAt , getAlignmentX , getAlignmentY , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getInsets , getLayout , getMaximumSize , getMinimumSize , getPreferredSize , insets , invalidate , isAncestorOf , layout , list , list , locate , minimumSize , paint , paintComponents , preferredSize , print , printComponents , processContainerEvent , remove , remove , removeAll , removeContainerListener , removeNotify , validate , validateTree |
Methods inherited from class java.lang.Object | |
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait |
Field Detail |
protected JRootPane rootPane
getRootPane()
,
setRootPane(com.sun.java.swing.JRootPane)
protected boolean rootPaneCheckingEnabled
isRootPaneCheckingEnabled()
,
setRootPaneCheckingEnabled(boolean)
protected AccessibleContext accessibleContext
Constructor Detail |
public JDialog()
public JDialog(Frame owner)
owner
- the Frame from which the dialog is displayedpublic JDialog(Frame owner, boolean modal)
owner
- the Frame from which the dialog is displayed
modal
- true for a modal dialog, false for one that allows
others windows to be active at the same timepublic JDialog(Frame owner, String title)
owner
- the Frame from which the dialog is displayed
title
- the String to display in the dialog's title barpublic JDialog(Frame owner, String title, boolean modal)
NOTE: Any popup components (JComboBox, JPopupMenu, JMenuBar) created within a modal dialog will be forced to be lightweight.
owner
- the frame from which the dialog is displayed
title
- the String to display in the dialog's title bar
modal
- true for a modal dialog, false for one that allows
others windows to be active at the same timeMethod Detail |
protected void dialogInit()
protected JRootPane createRootPane()
protected void processWindowEvent(WindowEvent e)
defaultCloseOperation
property.setDefaultCloseOperation(int)
public void setDefaultCloseOperation(int operation)
The value is set to HIDE_ON_CLOSE by default.
Window.addWindowListener(java.awt.event.WindowListener)
,
getDefaultCloseOperation()
public int getDefaultCloseOperation()
setDefaultCloseOperation(int)
public void update(Graphics g)
paint(g)
. This method was overridden to
prevent an unneccessary call to clear the background.public void setJMenuBar(JMenuBar menu)
menubar
- the menubar being placed in the dialoggetJMenuBar()
public JMenuBar getJMenuBar()
setJMenuBar(com.sun.java.swing.JMenuBar)
protected boolean isRootPaneCheckingEnabled()
addImpl(java.awt.Component, java.lang.Object, int)
,
setLayout(java.awt.LayoutManager)
,
setRootPaneCheckingEnabled(boolean)
protected void setRootPaneCheckingEnabled(boolean enabled)
addImpl(java.awt.Component, java.lang.Object, int)
,
setLayout(java.awt.LayoutManager)
,
isRootPaneCheckingEnabled()
protected void addImpl(Component comp, Object constraints, int index)
thisComponent.getContentPane().add(child)An attempt to add to directly to this component will cause an runtime exception to be thrown. Subclasses can disable this behavior.
setRootPaneCheckingEnabled(boolean)
public void setLayout(LayoutManager manager)
thisComponent.getContentPane().setLayout(new BorderLayout())An attempt to set the layout of this component will cause an runtime exception to be thrown. Subclasses can disable this behavior.
setRootPaneCheckingEnabled(boolean)
public JRootPane getRootPane()
setRootPane(com.sun.java.swing.JRootPane)
,
RootPaneContainer.getRootPane()
protected void setRootPane(JRootPane root)
root
- the rootPane object for this dialoggetRootPane()
public Container getContentPane()
setContentPane(java.awt.Container)
,
RootPaneContainer.getContentPane()
public void setContentPane(Container contentPane)
contentPane
- the contentPane object for this dialoggetContentPane()
,
RootPaneContainer.setContentPane(java.awt.Container)
public JLayeredPane getLayeredPane()
setLayeredPane(com.sun.java.swing.JLayeredPane)
,
RootPaneContainer.getLayeredPane()
public void setLayeredPane(JLayeredPane layeredPane)
layeredPane
- the layeredPane object for this dialoggetLayeredPane()
,
RootPaneContainer.setLayeredPane(com.sun.java.swing.JLayeredPane)
public Component getGlassPane()
setGlassPane(java.awt.Component)
,
RootPaneContainer.getGlassPane()
public void setGlassPane(Component glassPane)
glassPane
- the glassPane object for this dialoggetGlassPane()
,
RootPaneContainer.setGlassPane(java.awt.Component)
public void setLocationRelativeTo(Component c)
c
- the component in relation to which the dialog's location
is determinedpublic AccessibleContext getAccessibleContext()
|
Java Platform 1.2 Beta 4 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |