Class Dialog
- All Implemented Interfaces:
- Adaptable
- Direct Known Subclasses:
- ColorDialog,- FileDialog,- FontDialog,- MessageBox
Dialog typically contains other widgets
 that are not accessible. A Dialog is not
 a Widget.
 This class can also be used as the abstract superclass for user-designed dialogs. Such dialogs usually consist of a Shell with child widgets.
 Note: The modality styles supported by this class
 are treated as HINTs, because not all are supported
 by every subclass on every platform. If a modality style is
 not supported, it is "upgraded" to a more restrictive modality
 style that is supported.  For example, if PRIMARY_MODAL
 is not supported by a particular dialog, it would be upgraded to
 APPLICATION_MODAL. In addition, as is the case
 for shells, the window manager for the desktop on which the
 instance is visible has ultimate control over the appearance
 and behavior of the instance, including its modality.
 
- Styles:
- APPLICATION_MODAL, PRIMARY_MODAL, SYSTEM_MODAL
- Events:
- (none)
Note: Only one of the styles APPLICATION_MODAL, PRIMARY_MODAL, and SYSTEM_MODAL may be specified.
- See Also:
- 
Field SummaryFields
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionprotected voidprotected void<T> TgetAdapter(Class<T> adapter) Implementation of theAdaptableinterface.Returns the receiver's parent, which must be aShellor null.intgetStyle()Returns the receiver's style information.getText()Returns the receiver's text, which is the string that the window manager will typically display as the receiver's title.voidopen(DialogCallback dialogCallback) Opens this dialog in a non-blocking way and brings it to the front of the display.protected voidprotected voidrunEventLoop(Shell shell) voidSets the receiver's text, which is the string that the window manager will typically display as the receiver's title, to the argument, which must not be null.
- 
Field Details- 
shell
- 
returnCodeprotected int returnCode
 
- 
- 
Constructor Details- 
DialogConstructs a new instance of this class given only its parent.- Parameters:
- parent- a shell which will be the parent of the new instance
- Throws:
- IllegalArgumentException-- ERROR_NULL_ARGUMENT - if the parent is null
 
- SWTException-- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent
 
 
- 
DialogConstructs a new instance of this class given its parent and a style value describing its behavior and appearance.The style value is either one of the style constants defined in class SWTwhich is applicable to instances of this class, or must be built by bitwise OR'ing together (that is, using theint"|" operator) two or more of thoseSWTstyle constants. The class description lists the style constants that are applicable to the class. Style bits are also inherited from superclasses.- Parameters:
- parent- a shell which will be the parent of the new instance
- style- the style of dialog to construct
- Throws:
- IllegalArgumentException-- ERROR_NULL_ARGUMENT - if the parent is null
 
- SWTException-- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent
 
- See Also:
 
 
- 
- 
Method Details- 
getParentReturns the receiver's parent, which must be aShellor null.- Returns:
- the receiver's parent
- Throws:
- SWTException-- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
 
 
- 
getStylepublic int getStyle()Returns the receiver's style information.Note that, the value which is returned by this method may not match the value which was provided to the constructor when the receiver was created. - Returns:
- the style bits
- Throws:
- SWTException-- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
 
 
- 
getTextReturns the receiver's text, which is the string that the window manager will typically display as the receiver's title. If the text has not previously been set, returns an empty string.- Returns:
- the text
- Throws:
- SWTException-- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
 
 
- 
setTextSets the receiver's text, which is the string that the window manager will typically display as the receiver's title, to the argument, which must not be null.- Parameters:
- string- the new text
- Throws:
- IllegalArgumentException-- ERROR_NULL_ARGUMENT - if the text is null
 
- SWTException-- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
 
 
- 
openOpens this dialog in a non-blocking way and brings it to the front of the display. If given, thedialogCallbackis notified when the dialog is closed.Use this method instead of the open()method from the respectiveDialogimplementation when running in JEE_COMPATIBILTY mode.- Parameters:
- dialogCallback- the callback to be notified when the dialog was closed or- nullif no callback should be notified.
- Since:
- 3.1
- See Also:
 
- 
getAdapterImplementation of theAdaptableinterface.IMPORTANT: This method is not part of the RWT public API. It is marked public only so that it can be shared within the packages provided by RWT. It should never be accessed from application code. - Specified by:
- getAdapterin interface- Adaptable
- Parameters:
- adapter- the lookup class
- Returns:
- an object that can be cast to the given class or nullif there is no adapter associated with the given class.
 
- 
prepareOpenprotected void prepareOpen()
- 
checkSubclassprotected void checkSubclass()
- 
checkOperationModeprotected void checkOperationMode()
- 
runEventLoop
 
-