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

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

 public boolean exitOnClose

Constructors

 public 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.

 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

 public void open()

Open the UI window.

 public void close()

Close the UI window.

 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

 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.

 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.

 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.

 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.

 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.

 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.

 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.

 public void actionPerformed(ActionEvent e)

Process action events sent to this panel.

Parameters:

e - An action event.

 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.

 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.

 public String[] getQuestionNames()

Gets a array of question component names.

 public String[] getControlNames()

Gets a array of control component names.

 public String[] getMonitorNames()

Gets a array of monitor component names.

 public void setTitle()

Set a default title for panel.

 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

 public synchronized void addSubjectUIListener(SubjectUIListener listener)

Adds the specified control listener to receive control events from this component.

Parameters:

listener - the control listener

 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

 public void processSubjectUIEvent(SubjectUIEvent evt)

Send a subject UI event to listeners.

Parameters:

e - A subject UI event.

 public void windowOpened(WindowEvent e)

 public void windowClosing(WindowEvent e)

 public void windowClosed(WindowEvent e)

 public void windowIconified(WindowEvent e)

 public void windowDeiconified(WindowEvent e)

 public void windowActivated(WindowEvent e)

 public void windowDeactivated(WindowEvent e)

 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

 public void setQuestionsEnabled(boolean enabled)

Enable or disable all question/answer components.

Parameters:

enabled - Boolean showing whether to enable (true) or disable (false) components.

 public void setControlsEnabled(boolean enabled)

Enable or disable all control components.

Parameters:

enabled - Boolean showing whether to enable (true) or disable (false) components.

 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.

 public boolean isEnabled()

Determines whether this component is enabled.

Overrides:

isEnabled in class Component

 public void reset()

Resets the UI to default state. Resets all controls, questions and other buttons (Done-button).

 public void setTimeoutVisible(boolean visible)

Set visibility of warning indicator.

Parameters:

visble - true makes the indicator visible to subject.

 public boolean isTimeoutVisible()

See if warning indicator is visible to the subject.

Returns:

true if visible, otherwise false.

 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

 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.

 public void startTimeoutWarning()

Start the countdown display. Times have to have been initialized before starting.

 public void resetTimeout()

Reset the indicator to default state.

 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.

 public void setMCLLText(String text)

Set the text to show in MCLL controller.

Parameters:

text - the text.

 public void setMCLLTitle(String title)

Set the title of the MCLL dialog window.

Parameters:

title - the title.

 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.

 public void setMCLL(Volume level)

Set the MCL Level on the MCLL dialog.

Parameters:

level - the volume level.

 public Dimension getPreferredSize()

Returns the preferred size of this container.

Overrides:

getPreferredSize in class Container

 public void propertyLoad(Properties p,
                          String name) throws IllegalArgumentException

 public ProcessRemoteCommand createRemoteObjectClient(RemotePipe pipe,
                                                      String objectName)

 public ProcessRemoteCommand createRemoteObjectServer(RemotePipe pipe,
                                                      String objectName)

 public static String toString(Object a[])

 public static String toString(Enumeration e)

 public static void main(String args[])

All Packages  Class Hierarchy  This Package  Previous  Next  Index