|
|||||||||
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 | +--javax.swing.JComponent | +--javax.swing.JPanel | +--kiwi.ui.KPanel | +--kiwi.ui.WizardPanel
This class represents a single user interface panel for a
WizardView
component. Subclassers should not construct the
panel's user interface in the constructor, but rather, should provide an
implementation for buildUI()
that fills this purpose.
The goal of the Wizard
family of classes was to provide a
framework for creating wizards that was as flexible as possible, without
creating a large amount of classes and interfaces to achieve that goal.
Therefore the APIs for these classes may at first appear counterintuitive
or inelegant. If they are found to be too cumbersome, they will be changed
in a future release of Kiwi.
WizardView
,
WizardPanelSequence
, Serialized FormInner classes inherited from class javax.swing.JPanel |
JPanel.AccessibleJPanel |
Inner classes inherited from class javax.swing.JComponent |
JComponent.AccessibleJComponent |
Field Summary | |
protected Config |
config
The configuration object for the WizardPanelSequence that
owns this WizardPanel . |
Fields inherited from class javax.swing.JComponent |
accessibleContext,
listenerList,
TOOL_TIP_TEXT_KEY,
ui,
UNDEFINED_CONDITION,
WHEN_ANCESTOR_OF_FOCUSED_COMPONENT,
WHEN_FOCUSED,
WHEN_IN_FOCUSED_WINDOW |
Fields inherited from class java.awt.Component |
BOTTOM_ALIGNMENT,
CENTER_ALIGNMENT,
LEFT_ALIGNMENT,
RIGHT_ALIGNMENT,
TOP_ALIGNMENT |
Constructor Summary | |
WizardPanel()
Construct a new WizardPanel . |
Method Summary | |
void |
addChangeListener(ChangeListener listener)
Add a ChangeListener to this object's list of listeners. |
void |
beginFocus()
Begin focus in this component. |
protected abstract Component |
buildUI()
Build the user interface for this WizardPanel . |
protected void |
fireChangeEvent()
Fire a change event. |
void |
removeChangeListener(ChangeListener listener)
Remove a ChangeListener from this object's list of
listeners. |
protected void |
setTitle(String title)
Set the title for this WizardPanel . |
abstract void |
updateUI()
Update this WizardPanel 's user interface. |
Methods inherited from class kiwi.ui.KPanel |
getComponentByName,
paintComponent,
setOpaque,
setTexture |
Methods inherited from class javax.swing.JPanel |
getAccessibleContext,
getUIClassID,
paramString |
Methods inherited from class java.awt.Container |
add,
add,
add,
add,
add,
addContainerListener,
addImpl,
countComponents,
deliverEvent,
doLayout,
findComponentAt,
findComponentAt,
getComponent,
getComponentAt,
getComponentAt,
getComponentCount,
getComponents,
getLayout,
insets,
invalidate,
isAncestorOf,
layout,
list,
list,
locate,
minimumSize,
paintComponents,
preferredSize,
print,
printComponents,
processContainerEvent,
processEvent,
remove,
remove,
removeAll,
removeContainerListener,
setLayout,
validate,
validateTree |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
Field Detail |
protected Config config
WizardPanelSequence
that
owns this WizardPanel
.Constructor Detail |
public WizardPanel()
WizardPanel
.Method Detail |
protected abstract Component buildUI()
WizardPanel
. This method
must build and return the component that will be displayed in this
WizardPanel
. Typically the implementor will instantiate
a container such as KPanel
, add interface components to it,
and then return that container.public abstract void updateUI()
WizardPanel
's user interface. This method is
called by the WizardView
immediately before this panel is
made visible to the user. This allows the implementor to update the
state of the components that make up this panel's interface, perhaps
based on the current values of the WizardPanelSequence
's
Config
properties.protected final void setTitle(String title)
WizardPanel
. The title is displayed
at the top of the panel.title
- The new title, or null if no title is needed.public void beginFocus()
WizardView
immediately after this panel is made visible to
the user. It allows the panel to give input focus to the appropriate
component in its user interface. The default implementation requests
focus for the panel's first child component.public void addChangeListener(ChangeListener listener)
ChangeListener
to this object's list of listeners.listener
- The listener to add.public void removeChangeListener(ChangeListener listener)
ChangeListener
from this object's list of
listeners.listener
- The listener to remove.protected void fireChangeEvent()
WizardPanel
s should fire
ChangeEvent
s whenever a change in their internal state
would affect the appearance of the WizardView
. For example,
the user may complete data entry in a panel, which should undim the
WizardView
's Next button to allow the user to proceed
to the next panel.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |