net.sf.cuf.fw2

Interface DialogDc

All Superinterfaces:

AppEventSupport, Dc, Disposable, SimpleLifeCycle

All Known Implementing Classes:

AbstractDialogDc

public interface DialogDc
extends Dc, AppEventSupport, SimpleLifeCycle, Disposable

A DialogDc enhances the basic Dc interface with a more powerful dialog lifecycle and support for AppEvent's.
A DialogDc object is in one of the following five states:

• not exist (before new was called)
• created (new was called and an object exists)
• initialized (after the call to init())
• active (after a call to doActivate())
• passive (after a call to doPassivate())

The life cycle is typical for top level dialogs, that can be activated by the user through some menu/toobar/... mechanism. A dialog should refresh its data completly in the doActivate() call and save (and forget) its data in the doPassivate() call. Depending on the application design, there might be more than one active DialogDc object. Whenever a DialogDc is no longer needed, dispose() can be called when the dialog is in the passive state. init() [not exist] -> [created] -----> [initialized] doActivate() doPassivate() [initialized] -----------> [active] ------------> [passive] <------------ doActivate() dispose() [passive] --------> [destroyed]
The parent of a DialogDc is never null and always implements the AppEventSupport interface.

Method Summary

Methods

Modifier and Type	Method and Description
Object	getVisualPresentation() Called from the dialog coordinater in the initialized, active or passive state to get the visual representation for this dialog.

Methods inherited from interface net.sf.cuf.fw.Dc

init

Methods inherited from interface net.sf.cuf.appevent.AppEventSupport

postAppEvent

Methods inherited from interface net.sf.cuf.fw2.SimpleLifeCycle

canPassivate, doActivate, doPassivate

Methods inherited from interface net.sf.cuf.fw2.Disposable

dispose

Method Detail

getVisualPresentation

Object getVisualPresentation()

Called from the dialog coordinater in the initialized, active or passive state to get the visual representation for this dialog.

Returns:

an object that represents the visual representation of this dialog