1 /* Dialog.java -- An AWT dialog box
2 Copyright (C) 1999, 2000, 2001, 2002, 2005, 2006
3 Free Software Foundation, Inc.
5 This file is part of GNU Classpath.
7 GNU Classpath is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Classpath is distributed in the hope that it will be useful, but
13 WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Classpath; see the file COPYING. If not, write to the
19 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
22 Linking this library statically or dynamically with other modules is
23 making a combined work based on this library. Thus, the terms and
24 conditions of the GNU General Public License cover the whole
27 As a special exception, the copyright holders of this library give you
28 permission to link this library with independent modules to produce an
29 executable, regardless of the license terms of these independent
30 modules, and to copy and distribute the resulting executable under
31 terms of your choice, provided that you also meet, for each linked
32 independent module, the terms and conditions of the license of that
33 module. An independent module is a module which is not derived from
34 or based on this library. If you modify this library, you may extend
35 this exception to your version of the library, but you are not
36 obligated to do so. If you do not wish to do so, delete this
37 exception statement from your version. */
42 import java
.awt
.peer
.DialogPeer
;
44 import javax
.accessibility
.AccessibleContext
;
45 import javax
.accessibility
.AccessibleRole
;
46 import javax
.accessibility
.AccessibleState
;
47 import javax
.accessibility
.AccessibleStateSet
;
50 * <code>Dialog</code> provides a top-level window normally used to receive
51 * user input in applications.
53 * A dialog always has another top-level window as owner and is only visible
54 * if this owner is visible to the user. The default layout of dialogs is the
55 * <code>BorderLayout</code>. Dialogs can be modal (blocks user input to other
56 * components) or non-modal (user input in other components are allowed).
59 * @author Aaron M. Renn (arenn@urbanophile.com)
60 * @author Tom Tromey (tromey@redhat.com)
62 public class Dialog
extends Window
64 public enum ModalExclusionType
71 public enum ModalityType
79 // Serialization constant
80 private static final long serialVersionUID
= 5920926903803293709L;
83 * @serial Indicates whether or not this dialog box is modal.
85 private boolean modal
;
88 * @serial Indicates whether or not this dialog box is resizable.
90 private boolean resizable
= true;
93 * @serial The title string for this dialog box, which can be
99 * This field indicates whether the dialog is undecorated or not.
101 private boolean undecorated
= false;
104 * Indicates that we are blocked for modality in show
106 private boolean blocked
= false;
109 * Secondary EventQueue to handle AWT events while we are blocked for
112 private EventQueue eq2
= null;
115 * The number used to generate the name returned by getName.
117 private static transient long next_dialog_number
;
120 * Initializes a new instance of <code>Dialog</code> with the specified
121 * parent, that is resizable and not modal, and which has no title.
123 * @param parent The parent frame of this dialog box.
124 * @exception IllegalArgumentException If the owner's GraphicsConfiguration
125 * is not from a screen device, or if owner is null. This exception is
126 * always thrown when GraphicsEnvironment.isHeadless() returns true.
128 public Dialog(Frame parent
)
130 this(parent
, "", false);
134 * Initializes a new instance of <code>Dialog</code> with the specified
135 * parent and modality, that is resizable and which has no title.
137 * @param parent The parent frame of this dialog box.
138 * @param modal <code>true</code> if this dialog box is modal,
139 * <code>false</code> otherwise.
141 * @exception IllegalArgumentException If the owner's GraphicsConfiguration
142 * is not from a screen device, or if owner is null. This exception is
143 * always thrown when GraphicsEnvironment.isHeadless() returns true.
145 public Dialog(Frame parent
, boolean modal
)
147 this(parent
, "", modal
);
151 * Initializes a new instance of <code>Dialog</code> with the specified
152 * parent, that is resizable and not modal, and which has the specified
155 * @param parent The parent frame of this dialog box.
156 * @param title The title string for this dialog box.
158 * @exception IllegalArgumentException If the owner's GraphicsConfiguration
159 * is not from a screen device, or if owner is null. This exceptionnis
160 * always thrown when GraphicsEnvironment.isHeadless() returns true.
162 public Dialog(Frame parent
, String title
)
164 this(parent
, title
, false);
168 * Initializes a new instance of <code>Dialog</code> with the specified,
169 * parent, title, and modality, that is resizable.
171 * @param parent The parent frame of this dialog box.
172 * @param title The title string for this dialog box.
173 * @param modal <code>true</code> if this dialog box is modal,
174 * <code>false</code> otherwise.
176 * @exception IllegalArgumentException If owner is null or
177 * GraphicsEnvironment.isHeadless() returns true.
179 public Dialog(Frame parent
, String title
, boolean modal
)
181 this(parent
, title
, modal
, parent
.getGraphicsConfiguration());
185 * Initializes a new instance of <code>Dialog</code> with the specified,
186 * parent, title, modality and <code>GraphicsConfiguration</code>, that is
189 * @param parent The parent frame of this dialog box.
190 * @param title The title string for this dialog box.
191 * @param modal <code>true</code> if this dialog box is modal,
192 * <code>false</code> otherwise.
193 * @param gc The <code>GraphicsConfiguration</code> object to use. If
194 * <code>null</code> the <code>GraphicsConfiguration</code> of the target
197 * @exception IllegalArgumentException If owner is null, the
198 * GraphicsConfiguration is not a screen device or
199 * GraphicsEnvironment.isHeadless() returns true.
202 public Dialog(Frame parent
, String title
, boolean modal
,
203 GraphicsConfiguration gc
)
205 super(parent
, (gc
== null) ? parent
.getGraphicsConfiguration() : gc
);
207 // A null title is equivalent to an empty title
208 this.title
= (title
!= null) ? title
: "";
212 setLayout(new BorderLayout());
213 setCursor(new Cursor(Cursor
.DEFAULT_CURSOR
));
217 * Initializes a new instance of <code>Dialog</code> with the specified,
218 * parent, that is resizable.
220 * @param owner The parent frame of this dialog box.
222 * @exception IllegalArgumentException If parent is null. This exception is
223 * always thrown when GraphicsEnvironment.isHeadless() returns true.
227 public Dialog(Dialog owner
)
229 this(owner
, "", false, owner
.getGraphicsConfiguration());
233 * Initializes a new instance of <code>Dialog</code> with the specified,
234 * parent and title, that is resizable.
236 * @param owner The parent frame of this dialog box.
237 * @param title The title string for this dialog box.
239 * @exception IllegalArgumentException If parent is null. This exception is
240 * always thrown when GraphicsEnvironment.isHeadless() returns
244 public Dialog(Dialog owner
, String title
)
246 this(owner
, title
, false, owner
.getGraphicsConfiguration());
250 * Initializes a new instance of <code>Dialog</code> with the specified,
251 * parent, title and modality, that is resizable.
253 * @param owner The parent frame of this dialog box.
254 * @param title The title string for this dialog box.
255 * @param modal <code>true</code> if this dialog box is modal,
256 * <code>false</code> otherwise.
258 * @exception IllegalArgumentException If parent is null. This exception is
259 * always thrown when GraphicsEnvironment.isHeadless() returns true.
262 public Dialog(Dialog owner
, String title
, boolean modal
)
264 this(owner
, title
, modal
, owner
.getGraphicsConfiguration());
268 * Initializes a new instance of <code>Dialog</code> with the specified,
269 * parent, title, modality and <code>GraphicsConfiguration</code>, that is
272 * @param parent The parent frame of this dialog box.
273 * @param title The title string for this dialog box.
274 * @param modal <code>true</code> if this dialog box is modal,
275 * <code>false</code> otherwise.
276 * @param gc The <code>GraphicsConfiguration</code> object to use. If
277 * <code>null</code> the <code>GraphicsConfiguration</code> of the target
280 * @exception IllegalArgumentException If parent is null, the
281 * GraphicsConfiguration is not a screen device or
282 * GraphicsEnvironment.isHeadless() returns true.
286 public Dialog(Dialog parent
, String title
, boolean modal
,
287 GraphicsConfiguration gc
)
289 super(parent
, (gc
== null) ? parent
.getGraphicsConfiguration() : gc
);
291 // A null title is equivalent to an empty title
292 this.title
= (title
!= null) ? title
: "";
296 setLayout(new BorderLayout());
297 setCursor(new Cursor(Cursor
.DEFAULT_CURSOR
));
301 * Returns the title of this dialog box.
303 * @return The title of this dialog box.
305 public String
getTitle()
311 * Sets the title of this dialog box to the specified string.
313 * @param title the new title. If <code>null</code> an empty
316 public synchronized void setTitle(String title
)
318 // A null title is equivalent to an empty title
319 this.title
= (title
!= null) ? title
: "";
323 DialogPeer d
= (DialogPeer
) peer
;
329 * Tests whether or not this dialog box is modal.
331 * @return <code>true</code> if this dialog box is modal, <code>false</code>
334 public boolean isModal()
340 * Changes the modality of this dialog box. This can only be done before the
343 * @param modal <code>true</code> to make this dialog box modal,
344 * <code>false</code> to make it non-modal.
346 public void setModal(boolean modal
)
352 * Tests whether or not this dialog box is resizable.
354 * @return <code>true</code> if this dialog is resizable,
355 * <code>false</code> otherwise.
357 public boolean isResizable()
363 * Changes the resizability of this dialog box.
365 * @param resizable <code>true</code> to make this dialog resizable,
366 * <code>false</code> to make it non-resizable.
368 public synchronized void setResizable(boolean resizable
)
370 this.resizable
= resizable
;
373 DialogPeer d
= (DialogPeer
) peer
;
374 d
.setResizable(resizable
);
379 * Creates this object's native peer.
381 public synchronized void addNotify()
384 peer
= getToolkit().createDialog(this);
389 * Makes this dialog visible and brings it to the front. If the dialog is
390 * modal and is not already visible, this call will not return until the
391 * dialog is hidden by someone calling hide or dispose. If this is the event
392 * dispatching thread we must ensure that another event thread runs while the
393 * one which invoked this method is blocked.
395 * @deprecated Use {@link Component#setVisible(boolean)} instead.
397 public synchronized void show()
403 // If already shown (and blocked) just return
408 * If show is called in the dispatch thread for a modal dialog it will
409 * block so we must run another thread so the events keep being
412 if (EventQueue
.isDispatchThread())
414 EventQueue eq
= Toolkit
.getDefaultToolkit().getSystemEventQueue();
415 eq2
= new EventQueue();
425 catch (InterruptedException e
)
439 * Hides the Dialog and then causes show() to return if it is currently
442 * @deprecated Use {@link Component#setVisible(boolean)} instead.
444 public synchronized void hide()
455 * Disposes the Dialog and then causes show() to return if it is currently
458 public synchronized void dispose()
469 * Returns a debugging string for this component.
471 * @return A debugging string for this component.
473 protected String
paramString()
475 return "title+" + title
+ ",modal=" + modal
+ ",resizable=" + resizable
476 + "," + super.paramString();
480 * Returns whether this frame is undecorated or not.
482 * @return <code>true</code> if this dialog is undecorated,
483 * <code>false</code> otherwise.
487 public boolean isUndecorated()
493 * Disables or enables decorations for this frame. This method can only be
494 * called while the frame is not displayable.
496 * @param undecorated <code>true</code> to disable dialog decorations,
497 * <code>false</code> otherwise.
499 * @exception IllegalComponentStateException If this frame is displayable.
502 public void setUndecorated(boolean undecorated
)
505 throw new IllegalComponentStateException();
507 this.undecorated
= undecorated
;
511 * Accessibility support for <code>Dialog</code>.
513 protected class AccessibleAWTDialog
514 extends AccessibleAWTWindow
516 private static final long serialVersionUID
= 4837230331833941201L;
519 * Gets the role of this object.
520 * @return AccessibleRole.DIALOG
522 public AccessibleRole
getAccessibleRole()
524 return AccessibleRole
.DIALOG
;
528 * Gets the state set of this object.
529 * @return The current state of this dialog.
531 public AccessibleStateSet
getAccessibleStateSet()
533 AccessibleStateSet states
= super.getAccessibleStateSet();
535 states
.add(AccessibleState
.RESIZABLE
);
537 states
.add(AccessibleState
.MODAL
);
543 * Gets the AccessibleContext associated with this <code>Dialog</code>. The
544 * context is created, if necessary.
546 * @return the associated context
548 public AccessibleContext
getAccessibleContext()
550 /* Create the context if this is the first request */
551 if (accessibleContext
== null)
552 accessibleContext
= new AccessibleAWTDialog();
553 return accessibleContext
;
557 * Generate a unique name for this <code>Dialog</code>.
559 * @return A unique name for this <code>Dialog</code>.
561 String
generateName()
563 return "dialog" + getUniqueLong();
566 private static synchronized long getUniqueLong()
568 return next_dialog_number
++;