All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class guinea.ui.ABSubjectUI

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.Container
                   |
                   +----java.awt.Window
                           |
                           +----java.awt.Frame
                                   |
                                   +----guinea.ui.ABSubjectUI

public class ABSubjectUI
extends Frame
implements SubjectUI, WarningDisplayer, MCLLControl, WindowListener, AnswerListener, ControlListener, ActionListener, PropertyLoader, Serializable, RemoteObjectInterface
A subject UI terminal that implements the SubjectUI interface.

See Also:
SubjectUI

Variable Index

· exitOnClose

Constructor Index

· ABSubjectUI()
Construct a new subject UI window.
· ABSubjectUI(Properties)
Construct a new subject UI window.
· ABSubjectUI(String)
Construct a new subject UI window.

Method Index

· actionPerformed(ActionEvent)
Process action events sent to this panel.
· addSubjectUIListener(SubjectUIListener)
Adds the specified control listener to receive control events from this component.
· answerGiven(AnswerEvent)
Send an answer event received from a panel's question components to objects that listen to events from this panel.
· close()
Close the UI window.
· controlPerformed(ControlEvent)
Send a control event received from a panel's control components to objects that listen to events from this panel.
· createRemoteObjectClient(RemotePipe, String)
· createRemoteObjectServer(RemotePipe, String)
· dispose()
Dispose of the window.
· getControl(String)
Get a control component.
· getControlNames()
Gets a array of control component names.
· getControlValue(String)
Get the control value of the controller.
· getMonitor(String)
Get a monitor component.
· getMonitorNames()
Gets a array of monitor component names.
· getPreferredSize()
Returns the preferred size of this container.
· getQuestion(String)
Get a question component.
· getQuestionNames()
Gets a array of question component names.
· isEnabled()
Determines whether this component is enabled.
· isTimeoutVisible()
See if warning indicator is visible to the subject.
· main(String[])
· open()
Open the UI window.
· processSubjectUIEvent(SubjectUIEvent)
Send a subject UI event to listeners.
· propertyLoad(Properties, String)
· removeSubjectUIListener(SubjectUIListener)
Removes the specified listener so it no longer receives control motion events from this component.
· reset()
Resets the UI to default state.
· resetTimeout()
Reset the indicator to default state.
· setControlsEnabled(boolean)
Enable or disable all control components.
· setControlValue(String, Object)
Set the (initial) control value of the controller.
· setDoneEnabled(boolean)
Enable or disable the DONE-button that the subject uses to indicate that he/she has completed grading (or whatever) the current test item.
· setEnabled(boolean)
Enable or disable all components on the subject's panel.
· setMCLL(Volume)
Set the MCL Level on the MCLL dialog.
· setMCLLLimits(Volume, Volume)
Set the limits of the level the subject can select.
· setMCLLText(String)
Set the text to show in MCLL controller.
· setMCLLTitle(String)
Set the title of the MCLL dialog window.
· setMCLLVisible(boolean)
Make the MCLL setting dialog visible or hide it.
· setMonitorValue(String, Object)
Set the value of the monitored variable.
· setQuestionAnswer(String, Object)
Set the (initial) answer to the question.
· setQuestionsEnabled(boolean)
Enable or disable all question/answer components.
· setTimeoutTimes(int)
Set the timeout time.
· setTimeoutTimes(int, int)
Set the timeout time and warning time of the indicator.
· setTimeoutVisible(boolean)
Set visibility of warning indicator.
· setTitle()
Set a default title for panel.
· setTitle(String)
Set a title for panel.
· startTimeoutWarning()
Start the countdown display.
· toString(Enumeration)
· toString(Object[])
· windowActivated(WindowEvent)
· windowClosed(WindowEvent)
· windowClosing(WindowEvent)
· windowDeactivated(WindowEvent)
· windowDeiconified(WindowEvent)
· windowIconified(WindowEvent)
· windowOpened(WindowEvent)

Variables

· exitOnClose
 public boolean exitOnClose

Constructors

· ABSubjectUI
 public ABSubjectUI()
Construct a new subject UI window.

· ABSubjectUI
 public ABSubjectUI(String filename) throws IOException
Construct a new subject UI window. Components are created by reading required information from UI configuration file.

Parameters:
filename - File name of the UI configuration file.
Throws: IOException
If an IO exception occurs when loading configuration file.
· ABSubjectUI
 public ABSubjectUI(Properties props)
Construct a new subject UI window. Components are created by reading required information from a properties list.

Parameters:
props - Subject UI properties.

Methods

· open
 public void open()
Open the UI window.

· close
 public void close()
Close the UI window.

· dispose
 public void dispose()
Dispose of the window. Releases resources needed by the window. The window is no longer usable after this has been called.

Overrides:
dispose in class Frame
· getControl
 public ControlInterface getControl(String name)
Get a control component.

Parameters:
name - Name of component (control ID).
Returns:
A control component or null if no such control component is found.
· getQuestion
 public QuestionInterface getQuestion(String name)
Get a question component.

Parameters:
name - Name of component (question ID).
Returns:
A question component or null if no such question component is found.
· getMonitor
 public MonitorInterface getMonitor(String name)
Get a monitor component.

Parameters:
name - Name of component (monitor ID).
Returns:
A monitor component or null if no such monitor component is found.
· setQuestionAnswer
 public void setQuestionAnswer(String questionID,
                               Object answer)
Set the (initial) answer to the question.

Parameters:
questionID - The ID of the question component.
answer - The answer to the question.
· setControlValue
 public void setControlValue(String controlID,
                             Object value)
Set the (initial) control value of the controller.

Parameters:
controlID - The ID of the controller component.
value - The value of the controlled variable.
· getControlValue
 public Object getControlValue(String controlID)
Get the control value of the controller.

Parameters:
controlID - The ID of the controller component.
Returns:
The value of the controlled variable.
· setMonitorValue
 public void setMonitorValue(String monitorID,
                             Object value)
Set the value of the monitored variable.

Parameters:
monitorID - The ID of the monitor component.
value - The value of the monitored variable.
· actionPerformed
 public void actionPerformed(ActionEvent e)
Process action events sent to this panel.

Parameters:
e - An action event.
· controlPerformed
 public void controlPerformed(ControlEvent e)
Send a control event received from a panel's control components to objects that listen to events from this panel.

Parameters:
e - A control event.
· answerGiven
 public void answerGiven(AnswerEvent e)
Send an answer event received from a panel's question components to objects that listen to events from this panel.

Parameters:
e - An answer event.
· getQuestionNames
 public String[] getQuestionNames()
Gets a array of question component names.

· getControlNames
 public String[] getControlNames()
Gets a array of control component names.

· getMonitorNames
 public String[] getMonitorNames()
Gets a array of monitor component names.

· setTitle
 public void setTitle()
Set a default title for panel.

· setTitle
 public void setTitle(String title)
Set a title for panel. If a subject's name has been provided for this panel, it will be added to the title in paranthesis.

Parameters:
title - A title string for panel.
Overrides:
setTitle in class Frame
· addSubjectUIListener
 public synchronized void addSubjectUIListener(SubjectUIListener listener)
Adds the specified control listener to receive control events from this component.

Parameters:
listener - the control listener
· removeSubjectUIListener
 public synchronized void removeSubjectUIListener(SubjectUIListener listener)
Removes the specified listener so it no longer receives control motion events from this component.

Parameters:
listener - the SubjectUI listener
· processSubjectUIEvent
 public void processSubjectUIEvent(SubjectUIEvent evt)
Send a subject UI event to listeners.

Parameters:
e - A subject UI event.
· windowOpened
 public void windowOpened(WindowEvent e)
· windowClosing
 public void windowClosing(WindowEvent e)
· windowClosed
 public void windowClosed(WindowEvent e)
· windowIconified
 public void windowIconified(WindowEvent e)
· windowDeiconified
 public void windowDeiconified(WindowEvent e)
· windowActivated
 public void windowActivated(WindowEvent e)
· windowDeactivated
 public void windowDeactivated(WindowEvent e)
· setEnabled
 public void setEnabled(boolean enabled)
Enable or disable all components on the subject's panel. Questions, controls, and monitors are disabled.

Overrides:
setEnabled in class Component
· setQuestionsEnabled
 public void setQuestionsEnabled(boolean enabled)
Enable or disable all question/answer components.

Parameters:
enabled - Boolean showing whether to enable (true) or disable (false) components.
· setControlsEnabled
 public void setControlsEnabled(boolean enabled)
Enable or disable all control components.

Parameters:
enabled - Boolean showing whether to enable (true) or disable (false) components.
· setDoneEnabled
 public void setDoneEnabled(boolean enabled)
Enable or disable the DONE-button that the subject uses to indicate that he/she has completed grading (or whatever) the current test item.

Parameters:
enabled - Boolean showing whether to enable (true) or disable (false) components.
· isEnabled
 public boolean isEnabled()
Determines whether this component is enabled.

Overrides:
isEnabled in class Component
· reset
 public void reset()
Resets the UI to default state. Resets all controls, questions and other buttons (Done-button).

· setTimeoutVisible
 public void setTimeoutVisible(boolean visible)
Set visibility of warning indicator.

Parameters:
visble - true makes the indicator visible to subject.
· isTimeoutVisible
 public boolean isTimeoutVisible()
See if warning indicator is visible to the subject.

Returns:
true if visible, otherwise false.
· setTimeoutTimes
 public void setTimeoutTimes(int timeoutTime,
                             int warningTime)
Set the timeout time and warning time of the indicator.

Parameters:
timeoutTime - How much time there is to answer before the timeout expires. The timeout is in milliseconds.
warningTime - When to show that time is about to run out. It is the number of milliseconds before the timeout.
See Also:
startTimeoutWarning
· setTimeoutTimes
 public void setTimeoutTimes(int timeoutTime)
Set the timeout time. No warning is shown before going directly to timeout.

Parameters:
timeoutTime - How much time there is to answer before the timeout expires. The timeout is in milliseconds.
· startTimeoutWarning
 public void startTimeoutWarning()
Start the countdown display. Times have to have been initialized before starting.

· resetTimeout
 public void resetTimeout()
Reset the indicator to default state.

· setMCLLLimits
 public void setMCLLLimits(Volume min,
                           Volume max)
Set the limits of the level the subject can select.

Parameters:
min - the minimum level.
max - the maximum level.
· setMCLLText
 public void setMCLLText(String text)
Set the text to show in MCLL controller.

Parameters:
text - the text.
· setMCLLTitle
 public void setMCLLTitle(String title)
Set the title of the MCLL dialog window.

Parameters:
title - the title.
· setMCLLVisible
 public void setMCLLVisible(boolean visible)
Make the MCLL setting dialog visible or hide it.

Parameters:
visible - set to true to pop up the MCL level control, false to hide it.
· setMCLL
 public void setMCLL(Volume level)
Set the MCL Level on the MCLL dialog.

Parameters:
level - the volume level.
· getPreferredSize
 public Dimension getPreferredSize()
Returns the preferred size of this container.

Overrides:
getPreferredSize in class Container
· propertyLoad
 public void propertyLoad(Properties p,
                          String name) throws IllegalArgumentException
· createRemoteObjectClient
 public ProcessRemoteCommand createRemoteObjectClient(RemotePipe pipe,
                                                      String objectName)
· createRemoteObjectServer
 public ProcessRemoteCommand createRemoteObjectServer(RemotePipe pipe,
                                                      String objectName)
· toString
 public static String toString(Object a[])
· toString
 public static String toString(Enumeration e)
· main
 public static void main(String args[])

All Packages  Class Hierarchy  This Package  Previous  Next  Index