|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.ibm.as400.ui.framework.java.TabbedPaneManager
Creates a subpanel containing a group of windows which lets the user switch between windows by clicking on a tab. Each window consists of a panel defined using the Panel Definition Markup Language (PDML).
TabbedPaneManager
does not implement the WindowManager
interface, and thus
cannot be used to create a standalone window or dialog. It is designed
to be incorporated in the definition of an existing panel, property sheet
or wizard. Applications normally do not construct TabbedPaneManager
s
directly. Instead, a reference to the TabbedPaneManager
for a particular subpanel is obtained by calling getDelegateManager
on the PaneManager
for the containing panel.
TabbedPaneManager
performs the following processing on behalf
of the application:
PanelManager
instance for each of the panels
specified in the PDML, and attaches them to the tabbed pane.
DataBean
accessor methods
identified in the PDML.
EventHandler
s
specified in the PDML with the appropriate UI components.
The total size of the tabbed pane is a function of the size of the largest panel.
PaneManager.getDelegateManager(java.lang.String)
,
PanelManager
Constructor Summary | |
TabbedPaneManager(java.lang.String baseName,
java.util.Locale locale,
java.lang.String tabbedPaneName)
Constructs a TabbedPaneManager object for the specified tabbed pane,
and then serializes the tabbed pane definition. |
|
TabbedPaneManager(java.lang.String baseName,
java.util.Locale locale,
java.lang.String tabbedPaneName,
DataBean[] dataBeans,
java.awt.Container container)
Constructs a TabbedPaneManager for the specified tabbed pane,
using the specified container. |
|
TabbedPaneManager(java.lang.String baseName,
java.lang.String tabbedPaneName,
DataBean[] dataBeans,
java.awt.Container container)
Constructs a TabbedPaneManager for the specified tabbed pane,
using the specified container. |
Method Summary | |
void |
activatePanel()
Runs the activation handlers for the currently selected pane. |
void |
addPane(PanelManager pm,
int index)
Adds a panel to the tabbed pane. |
void |
applyChanges()
Transmits changes to user data to the DataBean s
which manage the data. |
void |
commit(java.util.Vector committedDataBeans)
Commits the changes to data displayed on the pane. |
PaneManager |
getAggregateManager()
Returns the owning PaneManager for the receiver. |
java.awt.Component |
getComponent(java.lang.String componentName)
Returns the requested user interface component. |
com.ibm.as400.ui.framework.java.JavaComponentDescriptor |
getComponentDescriptor(java.lang.String componentName)
Returns the JavaComponentDescriptor for the specified user interface component. |
PaneManager |
getDelegateManager(java.lang.String paneName)
Returns the PaneManager to which the receiver is delegating
management of the specified subpane. |
DataFormatter |
getFormatter(java.lang.String componentName)
Returns the data formatter associated with the specified user interface component. |
java.awt.Dimension |
getPreferredSize()
Gets the preferred size of this tabbed pane. |
PaneManager |
getRootManager()
Returns the root PaneManager for the receiver. |
javax.swing.JTabbedPane |
getTabbedPane()
Gets the tabbed pane object of this tabbed pane. |
java.lang.String |
getTitle()
Returns the tabbed pane's title. |
void |
loadData()
Called during initialization to load data into the pane. |
static void |
main(java.lang.String[] args)
Provides a command line interface to TabbedPaneManager . |
void |
prepareToCommit(java.util.Vector preparedDataBeans)
Request the DataBean s which manage data for the
panel to verify that their data is in a consistent state. |
void |
removePane(int index)
Removes a panel from the Tabbed Pane. |
void |
removePane(java.lang.String name)
Removes a panel from the Tabbed Pane. |
void |
serialize()
Serializes the tabbed pane definition. |
void |
setAggregateManager(PaneManager mgr)
Sets the owning PaneManager for the receiver. |
void |
setFormatter(java.lang.String componentName,
DataFormatter formatter,
boolean required)
Sets the data formatter associated with the specified user interface component. |
void |
setHelpPath(java.lang.String path)
Base location for help files. |
void |
showPane(java.lang.String paneName)
Displays the specified tab. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public TabbedPaneManager(java.lang.String baseName, java.lang.String tabbedPaneName, DataBean[] dataBeans, java.awt.Container container) throws DisplayManagerException
TabbedPaneManager
for the specified tabbed pane,
using the specified container.
The default locale will be used to load the tabbed pane definition.
baseName
- the resource name of the PDML document/resource bundle combination which defines the tabbed pane specificationpaneName
- the name of the tabbed pane, as specified on the TABBEDPANE
tag in the PDMLdataBeans
- a list of DataBean
s which supply data to the tabbed pane (may be null)container
- the caller's containerDisplayManagerException
- if an error was encountered accessing the tabbed pane definitionDisplayManagerException
public TabbedPaneManager(java.lang.String baseName, java.util.Locale locale, java.lang.String tabbedPaneName, DataBean[] dataBeans, java.awt.Container container) throws DisplayManagerException
TabbedPaneManager
for the specified tabbed pane,
using the specified container.baseName
- the resource name of the PDML document/resource bundle combination which defines the tabbed pane specificationlocale
- the desired locale to be used to load the tabbed pane definitiontabbedPaneName
- the name of the tabbed pane, as specified on the TABBEDPANE
tag in the PDMLdataBeans
- a list of DataBean
s which supply data to the tabbed pane (may be null)container
- the caller's containerDisplayManagerException
- if an error was encountered accessing the tabbed pane definitionDisplayManagerException
public TabbedPaneManager(java.lang.String baseName, java.util.Locale locale, java.lang.String tabbedPaneName) throws DisplayManagerException
TabbedPaneManager
object for the specified tabbed pane,
and then serializes the tabbed pane definition.
This constructor cannot be used to display the tabbed pane.
If a null locale is specified, the default locale will be used to load the tabbed pane definition. If resources for the default locale cannot be found, an attempt will be made to use the base resources for the tabbed pane.
baseName
- the resource name of the PDML document/resource bundle combination which define the tabbed pane specificationlocale
- the desired locale to be used to load the tabbed pane definition (may be null)tabbedPaneName
- the name of the tabbed pane, as specified on the TABBEDPANE
tag in the PDMLDisplayManagerException
- if an error was encountered accessing or serializing the tabbed pane definitionserialize()
Method Detail |
public static void main(java.lang.String[] args)
TabbedPaneManager
. See the class description.public void serialize() throws java.io.IOException
<tabbed pane name>_<locale string>.pdml.serwhere
<tabbed pane name>
is the name of the tabbed pane as specified on the TABBEDPANE
tag in the PDML, and <locale string>
consists of the ISO Language Code,
ISO Country Code, and optional variant codes, each delimited by an underscore ("_") character.java.io.IOException
- if serialized file cannot be writtenpublic java.awt.Dimension getPreferredSize()
public javax.swing.JTabbedPane getTabbedPane()
public java.lang.String getTitle()
getTitle
in interface PaneManager
public void loadData()
loadData
in interface PaneManager
PaneManager
public void activatePanel()
activatePanel
in interface PaneManager
PaneManager
public void showPane(java.lang.String paneName)
showPane
in interface PaneManager
paneName
- the name of the pane to be displayedPaneManager
public java.awt.Component getComponent(java.lang.String componentName)
<panel_name>.<component_name>
where panel_name
is the name of the panel containing
the desired component, and component_name
is the
name of the component, as defined in the PDML for the panel definition.getComponent
in interface PaneManager
componentName
- the fully-qualified name of the user interface componentComponent
, or null
if the component cannot be foundPaneManager
public com.ibm.as400.ui.framework.java.JavaComponentDescriptor getComponentDescriptor(java.lang.String componentName)
JavaComponentDescriptor
for the specified user interface component.
The name of the component must be of the form
<panel_name>.<component_name>
where panel_name
is the name of the panel containing
the desired component, and component_name
is the
name of the component, as defined in the PDML for the panel definition.getComponentDescriptor
in interface PaneManager
componentName
- the fully-qualified name of the user interface componentJavaComponentDescriptor
, or null
if the descriptor cannot be foundPaneManager
public PaneManager getDelegateManager(java.lang.String paneName)
PaneManager
to which the receiver is delegating
management of the specified subpane.getDelegateManager
in interface PaneManager
paneName
- the name of the pane as specified in the PDML definitionPaneManager
, or null
if the object cannot be foundPaneManager
public void setAggregateManager(PaneManager mgr)
PaneManager
for the receiver.
The specified object identifies the PaneManager
to which certain requests should be delegated when this TabbedPaneManager
is participating in an aggregate user interface.setAggregateManager
in interface PaneManager
mgr
- the PaneManager
with which the receiver is to be associatedPaneManager
public PaneManager getAggregateManager()
PaneManager
for the receiver.getAggregateManager
in interface PaneManager
PaneManager
with which the receiver is associated
when this object is participating in an aggregate user interface, or null
if this PaneManager
is not part of an aggregate.PaneManager
public PaneManager getRootManager()
PaneManager
for the receiver.getRootManager
in interface PaneManager
PaneManager
for the main panel that is
managing the aggregate user interface, or null if this PaneManager
is not part of an aggregate.PaneManager
public void applyChanges() throws IllegalUserDataException
DataBean
s
which manage the data.
Calls the settor methods for all UI components that have
accessor methods associated with them.
This method is called when the pane is about to be closed.
applyChanges
in interface PaneManager
PaneManager
public void prepareToCommit(java.util.Vector preparedDataBeans)
DataBean
s which manage data for the
panel to verify that their data is in a consistent state.
Calls the verifyChanges
method for all DataBean
s
associated with the pane.
This method is called when the pane is about to be closed.
prepareToCommit
in interface PaneManager
preparedDataBeans
- a list of DataBean
s which have already
been prepared on the current commit operationPaneManager
public void commit(java.util.Vector committedDataBeans)
commit
method on all DataBean
s
which manage data for the pane.
This method is called when the user indicates a desire to permanently save changes to the data, by clicking an OK button for example.
commit
in interface PaneManager
committedDataBeans
- a list of DataBean
s which have already
been saved on the current commit operationPaneManager
public void setFormatter(java.lang.String componentName, DataFormatter formatter, boolean required)
<panel_name>.<component_name>
where panel_name
is the name of the panel containing
the desired component, and component_name
is the
name of the component, as defined in the PDML for the panel definition.setFormatter
in interface PaneManager
componentName
- the fully-qualified name of the user interface componentformatter
- a reference to the data formatter to be associated with the componentrequired
- whether a value is required to be enteredDataFormatter
public DataFormatter getFormatter(java.lang.String componentName)
<panel_name>.<component_name>
where panel_name
is the name of the panel containing
the desired component, and component_name
is the
name of the component, as defined in the PDML for the panel definition.getFormatter
in interface PaneManager
componentName
- the fully-qualified name of the user interface componentDataFormatter
, or null
if the component cannot be foundDataFormatter
public void setHelpPath(java.lang.String path)
PaneManager
setHelpPath("http://www.ibm.com/help/")
will
cause the PanelManager to load http://www.ibm.com/help/MyPanel.html as
the help file.setHelpPath
in interface PaneManager
public void addPane(PanelManager pm, int index)
pm
- the PanelManager
for the new panelindex
- the position at which the new page will be insertedjava.lang.ArrayIndexOutOfBoundsException
- if the value of the specified index
exceeds the current page countpublic void removePane(java.lang.String name)
name
- the name of the panel as specified in the PDMLpublic void removePane(int index)
index
- the index of the panel to be removedjava.lang.ArrayIndexOutOfBoundsException
- if the value of the specified index
exceeds the current page count minus 1
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |