|
Eclipse Platform Release 3.3 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.eclipse.jface.window.Window
org.eclipse.jface.dialogs.Dialog
org.eclipse.jface.dialogs.TrayDialog
A TrayDialog
is a specialized Dialog
that can contain
a tray on its side. The tray's content is provided as a DialogTray
.
It is recommended to subclass this class instead of Dialog
in all
cases except where the dialog should never show a tray. For example, dialogs
which are very short, simple, and quick to dismiss (e.g. a message dialog with
an OK button) should subclass Dialog
.
Note: Trays are not supported on dialogs that use a custom layout on the
Shell
by overriding Window#getLayout()
.
DialogTray
,
Window.getLayout()
Nested Class Summary |
---|
Nested classes inherited from class org.eclipse.jface.window.Window |
---|
Window.IExceptionHandler |
Field Summary |
---|
Fields inherited from class org.eclipse.jface.dialogs.Dialog |
---|
blockedHandler, buttonBar, DIALOG_DEFAULT_BOUNDS, DIALOG_PERSISTLOCATION, DIALOG_PERSISTSIZE, dialogArea, DLG_IMG_ERROR, DLG_IMG_HELP, DLG_IMG_INFO, DLG_IMG_MESSAGE_ERROR, DLG_IMG_MESSAGE_INFO, DLG_IMG_MESSAGE_WARNING, DLG_IMG_QUESTION, DLG_IMG_WARNING, ELLIPSIS |
Fields inherited from class org.eclipse.jface.window.Window |
---|
CANCEL, OK |
Constructor Summary | |
---|---|
protected |
TrayDialog(IShellProvider parentShell)
Creates a tray dialog with the given parent. |
protected |
TrayDialog(Shell shell)
Creates a tray dialog instance. |
Method Summary | |
---|---|
boolean |
close()
Closes this window, disposes its shell, and removes this window from its window manager (if it has one). |
void |
closeTray()
Closes this dialog's tray, disposing its widgets. |
protected Control |
createButtonBar(Composite parent)
Creates and returns the contents of this dialog's button bar. |
protected Control |
createHelpControl(Composite parent)
Creates a new help control that provides access to context help. |
protected Layout |
getLayout()
The tray dialog's default layout is a modified version of the default Window layout that can accomodate a tray, however it still
conforms to the description of the Window default layout.
|
DialogTray |
getTray()
Returns the tray currently shown in the dialog, or null
if there is no tray. |
static boolean |
isDialogHelpAvailable()
Tests if dialogs that have help control should show it all the time or only when explicitly requested for each dialog instance. |
boolean |
isHelpAvailable()
Returns whether or not context help is available for this dialog. |
void |
openTray(DialogTray tray)
Constructs the tray's widgets and displays the tray in this dialog. |
static void |
setDialogHelpAvailable(boolean helpAvailable)
Sets whether JFace dialogs that support help control should show the control by default. |
void |
setHelpAvailable(boolean helpAvailable)
Sets whether or not context help is available for this dialog. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
protected TrayDialog(Shell shell)
shell
- the parent shell, or null
to create a top-level shellprotected TrayDialog(IShellProvider parentShell)
parentShell
- the object that returns the current parent shellMethod Detail |
public void closeTray() throws IllegalStateException
IllegalStateException
- if the tray was not openpublic boolean close()
Window
This framework method may be extended (super.close
must
be called).
close
in class Dialog
Window.close()
protected Control createButtonBar(Composite parent)
Dialog
The Dialog
implementation of this framework method lays
out a button bar and calls the createButtonsForButtonBar
framework method to populate it. Subclasses may override.
The returned control's layout data must be an instance of
GridData
.
createButtonBar
in class Dialog
parent
- the parent composite to contain the button bar
protected Control createHelpControl(Composite parent)
The TrayDialog
implementation of this method creates
the control, registers it for selection events including selection,
Note that the parent's layout is assumed to be a GridLayout
and the number of columns in this layout is incremented. Subclasses may
override.
parent
- the parent composite
public boolean isHelpAvailable()
protected Layout getLayout()
Window
layout that can accomodate a tray, however it still
conforms to the description of the Window
default layout.
Note: Trays may not be supported with all custom layouts on the dialog's
Shell. To avoid problems, use a single outer Composite
for
your dialog area, and set your custom layout on that Composite
.
getLayout
in class Window
null
for no layoutWindow.getLayout()
public DialogTray getTray()
null
if there is no tray.
null
if there is nonepublic void openTray(DialogTray tray) throws IllegalStateException, UnsupportedOperationException
tray
- the tray to show in this dialog
IllegalStateException
- if the dialog already has a tray open
UnsupportedOperationException
- if the dialog does not support trays,
for example if it uses a custom layout.public void setHelpAvailable(boolean helpAvailable)
helpAvailable
- whether or not context help is available for the dialogpublic static boolean isDialogHelpAvailable()
true
if dialogs that support help
control should show it by default, false
otherwise.public static void setDialogHelpAvailable(boolean helpAvailable)
false
,
help control can still be shown on a per-dialog basis.
helpAvailable
- true
to show the help
control, false
otherwise.
|
Eclipse Platform Release 3.3 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Guidelines for using Eclipse APIs.
Copyright (c) IBM Corp. and others 2000, 2007. All rights reserved.