com.ibm.as400.ui.framework.java
Class DynamicPanelManager

java.lang.Object
  extended by com.ibm.as400.ui.framework.java.PanelManager
      extended by com.ibm.as400.ui.framework.java.DynamicPanelManager
All Implemented Interfaces:
PaneManager, WindowManager

public class DynamicPanelManager
extends PanelManager

Creates a resizable graphical panel defined using the Panel Definition Markup Language (PDML). The panel may be either a standalone window or a modal dialog. See the class description for PanelManager for usage information.

Since:
v4r5m0
Version:
1.0, 05/24/99
Author:
J. Plurad
See Also:
PanelManager

Field Summary
Modifier and Type Field and Description
 
Fields inherited from class com.ibm.as400.ui.framework.java.PanelManager
m_windowMinHeight, m_windowMinWidth
 
Fields inherited from interface com.ibm.as400.ui.framework.java.WindowManager
OFFSET_FROM_OWNER
 
Constructor Summary
Constructor and Description
DynamicPanelManager(String baseName, Locale locale, String panelName)
          Constructs a DynamicPanelManager for the specified panel, and then serializes the panel definition.
DynamicPanelManager(String baseName, Locale locale, String panelName, DataBean[] dataBeans, Container container)
          Constructs a DynamicPanelManager for the specified panel, using the specified container.
DynamicPanelManager(String baseName, Locale locale, String panelName, DataBean[] dataBeans, Dimension panelSize)
          Constructs a DynamicPanelManager for the specified panel.
DynamicPanelManager(String baseName, Locale locale, String panelName, DataBean[] dataBeans, Frame owner)
          Constructs a DynamicPanelManager for the specified panel.
DynamicPanelManager(String baseName, String panelName, DataBean[] dataBeans, Container container)
          Constructs a DynamicPanelManager for the specified panel, using the specified container.
DynamicPanelManager(String baseName, String panelName, DataBean[] dataBeans, Dimension panelSize)
          Constructs a DynamicPanelManager for the specified panel.
DynamicPanelManager(String baseName, String panelName, DataBean[] dataBeans, Dimension panelSize, Point panelLocation)
          Constructs a DynamicPanelManager for the specified panel.
DynamicPanelManager(String baseName, String panelName, DataBean[] dataBeans, Frame owner)
          Constructs a DynamicPanelManager for the specified panel.
DynamicPanelManager(String baseName, String panelName, DataBean[] dataBeans, Frame owner, Dimension panelSize)
          Constructs a DynamicPanelManager for the specified panel.
DynamicPanelManager(String baseName, String panelName, DataBean[] dataBeans, Rectangle panelBounds)
          Constructs a DynamicPanelManager for the specified panel.
 
Method Summary
Modifier and Type Method and Description
 Dimension getCurrentPanelSize()
          Gets the prescaled dimensions of the panel as displayed in the current window.
static void main(String[] args)
          Provides a command line interface to DynamicPanelManager.
 void setMinimumWindowSize(int width, int height)
          Sets the minimum size of the application window owned by this DynamicPanelManager.
 
Methods inherited from class com.ibm.as400.ui.framework.java.PanelManager
activatePanel, addActionListener, addActivationHandler, addCancelListener, addCancelListener, addCommitListener, addCommitListener, addExpansionListener, addHelpListener, applyChanges, applyChanges, commit, displayHelp, displayHelp, dispose, getAggregateManager, getComponent, getComponentDescriptor, getComponentText, getContainer, getDataBeans, getDelegateManager, getExitOnClose, getFormatter, getIconName, getMenuBar, getMenuManager, getName, getNode, getOwnerManager, getPreferredSize, getRootManager, getSaveOnThread, getTableRow, getTitle, getToolBar, getToolBarButton, getWindow, handleDataException, handleDataException, isContainerScrollable, isEnabled, isRequiredField, isVisible, isVisible, loadData, prepareToCommit, refreshComponent, refreshTree, removeActionListener, removeExpansionListener, serialize, setAggregateManager, setButtonText, setComponentText, setEnabled, setExitOnClose, setExpanded, setFocusPolicy, setFormatter, setHelpPath, setIconName, setModalRelativeTo, setName, setRequiredField, setSaveOnThread, setTitle, setToolBarIcon, setVisible, setVisible, setWaitCursor, setWaitPending, showPane, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

DynamicPanelManager

public DynamicPanelManager(String baseName,
                           String panelName,
                           DataBean[] dataBeans,
                           Dimension panelSize)
                    throws DisplayManagerException
Constructs a DynamicPanelManager for the specified panel. The panel will be modeless.

The default locale will be used to load the panel definition.

Parameters:
baseName - the resource name of the PDML document/resource bundle combination which defines the panel specification
panelName - the name of the panel, as specified on the PANEL tag in the PDML document
dataBeans - a list of DataBeans which supply data to the panel (may be null)
panelSize - specifies the size for the panel when it is created
Throws:
DisplayManagerException - if an error was encountered accessing the panel definition
Since:
v4r5m0
See Also:
DisplayManagerException

DynamicPanelManager

public DynamicPanelManager(String baseName,
                           String panelName,
                           DataBean[] dataBeans,
                           Dimension panelSize,
                           Point panelLocation)
                    throws DisplayManagerException
Constructs a DynamicPanelManager for the specified panel. The panel will be modeless.

The default locale will be used to load the panel definition.

Parameters:
baseName - the resource name of the PDML document/resource bundle combination which defines the panel specification
panelName - the name of the panel, as specified on the PANEL tag in the PDML document
dataBeans - a list of DataBeans which supply data to the panel (may be null)
panelSize - specifies the size for the panel when it is created
Throws:
DisplayManagerException - if an error was encountered accessing the panel definition
Since:
v5r1m0
See Also:
DisplayManagerException

DynamicPanelManager

public DynamicPanelManager(String baseName,
                           String panelName,
                           DataBean[] dataBeans,
                           Rectangle panelBounds)
                    throws DisplayManagerException
Constructs a DynamicPanelManager for the specified panel. The panel will be modeless.

The default locale will be used to load the panel definition.

Parameters:
baseName - the resource name of the PDML document/resource bundle combination which defines the panel specification
panelName - the name of the panel, as specified on the PANEL tag in the PDML document
dataBeans - a list of DataBeans which supply data to the panel (may be null)
panelBounds - specifies the size and location for the panel when it is created
Throws:
DisplayManagerException - if an error was encountered accessing the panel definition
Since:
v5r1m0
See Also:
DisplayManagerException

DynamicPanelManager

public DynamicPanelManager(String baseName,
                           Locale locale,
                           String panelName,
                           DataBean[] dataBeans,
                           Dimension panelSize)
                    throws DisplayManagerException
Constructs a DynamicPanelManager for the specified panel. The panel will be modeless.

Parameters:
baseName - the resource name of the PDML document/resource bundle combination which defines the panel specification
locale - the desired locale to be used to load the panel definition
panelName - the name of the panel, as specified on the PANEL tag in the PDML document
dataBeans - a list of DataBeans which supply data to the panel (may be null)
panelSize - specifies the size for the panel when it is created
Throws:
DisplayManagerException - if an error was encountered accessing the panel definition
Since:
v4r5m0
See Also:
DisplayManagerException

DynamicPanelManager

public DynamicPanelManager(String baseName,
                           String panelName,
                           DataBean[] dataBeans,
                           Frame owner)
                    throws DisplayManagerException
Constructs a DynamicPanelManager for the specified panel. The panel will be modal, with the specified Frame as its owner. The application will block on the call to setVisible until the panel has closed.

The default locale will be used to load the panel definition.

Parameters:
baseName - the resource name of the PDML document/resource bundle combination which defines the panel specification
panelName - the name of the panel, as specified on the PANEL tag in the PDML document
dataBeans - a list of DataBeans which supply data to the panel (may be null)
owner - the owning frame
Throws:
DisplayManagerException - if an error was encountered accessing the panel definition
Since:
v4r5m0
See Also:
DisplayManagerException, PanelManager.setVisible(boolean)

DynamicPanelManager

public DynamicPanelManager(String baseName,
                           String panelName,
                           DataBean[] dataBeans,
                           Frame owner,
                           Dimension panelSize)
                    throws DisplayManagerException
Constructs a DynamicPanelManager for the specified panel. The panel will be modal, with the specified Frame as its owner. The application will block on the call to setVisible until the panel has closed.

The default locale will be used to load the panel definition.

Parameters:
baseName - the resource name of the PDML document/resource bundle combination which defines the panel specification
panelName - the name of the panel, as specified on the PANEL tag in the PDML document
dataBeans - a list of DataBeans which supply data to the panel (may be null)
owner - the owning frame
panelSize - specifies the size for the panel when it is created
Throws:
DisplayManagerException - if an error was encountered accessing the panel definition
Since:
v5r1m0
See Also:
DisplayManagerException, PanelManager.setVisible(boolean)

DynamicPanelManager

public DynamicPanelManager(String baseName,
                           Locale locale,
                           String panelName,
                           DataBean[] dataBeans,
                           Frame owner)
                    throws DisplayManagerException
Constructs a DynamicPanelManager for the specified panel. The panel will be modal, with the specified Frame as its owner. The application will block on the call to setVisible until the panel has closed.

Parameters:
baseName - the resource name of the PDML document/resource bundle combination which defines the panel specification
locale - the desired locale to be used to load the panel definition
panelName - the name of the panel, as specified on the PANEL tag in the PDML
dataBeans - a list of DataBeans which supply data to the panel (may be null)
owner - the owning frame
Throws:
DisplayManagerException - if an error was encountered accessing the panel definition
Since:
v4r5m0
See Also:
DisplayManagerException, PanelManager.setVisible(boolean)

DynamicPanelManager

public DynamicPanelManager(String baseName,
                           String panelName,
                           DataBean[] dataBeans,
                           Container container)
                    throws DisplayManagerException
Constructs a DynamicPanelManager for the specified panel, using the specified container. This constructor allows the application to supply its own container, rather than relying on this object to create a container of the appropriate type.

The default locale will be used to load the panel definition.

Parameters:
baseName - the resource name of the PDML document/resource bundle combination which defines the panel specification
panelName - the name of the panel, as specified on the PANEL tag in the PDML
dataBeans - a list of DataBeans which supply data to the panel (may be null)
container - the application's container
Throws:
DisplayManagerException - if an error was encountered accessing the panel definition
Since:
v4r5m0
See Also:
DisplayManagerException

DynamicPanelManager

public DynamicPanelManager(String baseName,
                           Locale locale,
                           String panelName,
                           DataBean[] dataBeans,
                           Container container)
                    throws DisplayManagerException
Constructs a DynamicPanelManager for the specified panel, using the specified container. This constructor allows the application to supply its own container, rather than relying on this object to create a container of the appropriate type.

Parameters:
baseName - the resource name of the PDML document/resource bundle combination which defines the panel specification
locale - the desired locale to be used to load the panel definition
panelName - the name of the panel, as specified on the PANEL tag in the PDML
dataBeans - a list of DataBeans which supply data to the panel (may be null)
container - the application's container
Throws:
DisplayManagerException - if an error was encountered accessing the panel definition
Since:
v4r5m0
See Also:
DisplayManagerException

DynamicPanelManager

public DynamicPanelManager(String baseName,
                           Locale locale,
                           String panelName)
                    throws DisplayManagerException
Constructs a DynamicPanelManager for the specified panel, and then serializes the panel definition. This constructor cannot be used to display the panel.

If a null locale is specified, the default locale will be used to load the panel definition. If resources for the default locale cannot be found, an attempt will be made to use the base resources for the panel.

Parameters:
baseName - the resource name of the PDML document/resource bundle combination which defines the panel specification
locale - the desired locale to be used to load the panel definition (may be null)
panelName - the name of the panel, as specified on the PANEL tag in the PDML
Throws:
DisplayManagerException - if an error was encountered accessing or serializing the panel definition
Since:
v4r5m0
See Also:
PanelManager.serialize()
Method Detail

main

public static void main(String[] args)
Provides a command line interface to DynamicPanelManager. The parameters are the same as those for the parent PanelManager class.

Since:
v4r5m0
See Also:
PanelManager

setMinimumWindowSize

public void setMinimumWindowSize(int width,
                                 int height)
Sets the minimum size of the application window owned by this DynamicPanelManager. Attempts to resize the window smaller than the specified size will fail.

Parameters:
width - The minimum width of the window
height - The minimum height of the window
Since:
v5r1m0

getCurrentPanelSize

public Dimension getCurrentPanelSize()
Gets the prescaled dimensions of the panel as displayed in the current window. Panels are scaled when screen resolution in the PDML is different than the displayed resolution. The prescaled dimensions can be used to save the dimensions of the panel for future initial size.

Returns:
a Dimension object containing the prescaled X and Y size
Since:
v5r1m0