Public Member Functions | |
DataVisualizerManager (JDesktopPane jDesktop, JScrollPane jScroller) | |
Constructor. | |
void | DrawChart (String sFile, String sChartChoice) throws ModelException |
Draws a chart on the desktop. | |
void | CloseFile (String sFileName) |
Closes a detailed output file. | |
void | CleanUp () |
Causes all objects under management to perform any cleanup operations. | |
void | AddFile (String sFileName) throws ModelException |
Notifies this object of a new output file. | |
void | AddCurrentRunFile (String sFileName) throws ModelException |
Notifies this object of a new output file for the current run. | |
boolean | AreCurrentRunChartsOpen () |
Tells whether there are any charts open for the current run (for real- time data visualization). | |
void | UpdateCurrentRunCharts () throws ModelException |
Updates any charts open for the current run. | |
void | CloseCurrentRunCharts (MainWindow oWindow) |
Closes all charts associated with the current run. | |
String[] | GetChartOptionsForFile (String sFileName) throws ModelException |
Gets the list of chart options for an output file, ready to display in a combo box. | |
Package Attributes | |
JDesktopPane | m_jDesktop |
Here's where this class will put windows. | |
DesktopListener | m_oDesktopListener |
Listener to be assigned to all internal frames added by this class. | |
Vector | mp_oDataManagers = new Vector(0) |
Data file managers - one for each open data file. | |
Vector | mp_oCurrentRunDataManagers = new Vector(0) |
Data file managers - one for each output file of the current run - this is a subset of mp_oDataManagers. | |
Private Member Functions | |
DataFileManager | MakeDataManager (String sFileName) throws ModelException |
Creates a new data manager. | |
Private Attributes | |
int | m_iNumOpenPositions = 0 |
The number of positions available in which to put a newly opened window. |
It keeps track of open files and causes their data windows to be placed on the main application window.
A current run may be opened for visualization as well. These files will be kept track of separately and updated on command.
When a new window is opened, if it is the first window open, it is placed at the upper right of the screen, just to the right of its legend, which is in the upper right corner. When the next window is opened, if a window is already in that position, it opens itself 20 pixels down and to the left. Subsequent windows open themselves 20 pixels down and to the left until the middle of the screen is reached, at which point the cycle returns to the upper right. If a window is opened and then moved, the next window open will grab its former spot.
Copyright: Copyright (c) Charles D. Canham 2003
Company: Institute of Ecosystem Studies
javawrapper::DataVisualizerManager::DataVisualizerManager | ( | JDesktopPane | jDesktop, | |
JScrollPane | jScroller | |||
) | [inline] |
Constructor.
jDesktop | Desktop pane. | |
jScroller | Scroll pane enclosing jDesktop. |
void javawrapper::DataVisualizerManager::AddCurrentRunFile | ( | String | sFileName | ) | throws ModelException [inline] |
Notifies this object of a new output file for the current run.
This file is subject to continuous updating.
sFileName | The filename. |
ModelException | if this is not a recognized output file. |
void javawrapper::DataVisualizerManager::AddFile | ( | String | sFileName | ) | throws ModelException [inline] |
Notifies this object of a new output file.
This should be a file not being generated by the current run.
sFileName | The filename. |
ModelException | if this is not a recognized output file. |
boolean javawrapper::DataVisualizerManager::AreCurrentRunChartsOpen | ( | ) | [inline] |
Tells whether there are any charts open for the current run (for real- time data visualization).
void javawrapper::DataVisualizerManager::CleanUp | ( | ) | [inline] |
Causes all objects under management to perform any cleanup operations.
Each should have its own CleanUp function; this will be called for each.
Edit history:
------------------
April 28, 2004: Submitted in beta version (LEM)
void javawrapper::DataVisualizerManager::CloseCurrentRunCharts | ( | MainWindow | oWindow | ) | [inline] |
Closes all charts associated with the current run.
oWindow | Window so we can tell it to get rid of the file names from its options window |
void javawrapper::DataVisualizerManager::CloseFile | ( | String | sFileName | ) | [inline] |
Closes a detailed output file.
If the file doesn't match any files under management, nothing happens.
sFileName | File to close. |
void javawrapper::DataVisualizerManager::DrawChart | ( | String | sFile, | |
String | sChartChoice | |||
) | throws ModelException [inline] |
Draws a chart on the desktop.
sFile | The filename from which to draw the chart. | |
sChartChoice | The chart to draw on the desktop. |
ModelException | If the filename is not valid, or the chart choice cannot be drawn, or wrapping another error. |
String [] javawrapper::DataVisualizerManager::GetChartOptionsForFile | ( | String | sFileName | ) | throws ModelException [inline] |
Gets the list of chart options for an output file, ready to display in a combo box.
sFileName | The filename. |
ModelException | if the file cannot be found. |
DataFileManager javawrapper::DataVisualizerManager::MakeDataManager | ( | String | sFileName | ) | throws ModelException [inline, private] |
Creates a new data manager.
This checks for the prior existence of a manager for the given file; if it already exists, the user is warned and nothing is done.
sFileName | String The file name for which to create a new file manager |
ModelException | if the file type is not recognized, or if there is a problem creating the manager. |
void javawrapper::DataVisualizerManager::UpdateCurrentRunCharts | ( | ) | throws ModelException [inline] |
Updates any charts open for the current run.
If there are no open charts for the current run, this does nothing. This allows the file managers to decide how best to handle this, but the expectation is that they will display the most recent available data.
ModelException | if there is a problem drawing the charts. |