UI parameters

Here is a list of basic parameters for the subject UI windows:

Parameter Value Description R/O
class guinea.ui.ABSubjectUI Java class name of the subject UI object. Req.
title text The title of the window. Opt.
questions list A comma-separated list of question component names. Opt.
controls list A comma-separated list of control component names. Opt.
isResizable true of false Is the window resizable? Default is true. Opt.
width number of pixels The width of the window in pixels. If this is non-zero, the window's width is fixed. Default is 0 (window's width is determined automatically). Opt.
height number of pixels The height of the window in pixels. If this is non-zero, the window's height is fixed. Default is 0 (window's height is determined automatically). Opt.
showTestProgress true of false Whether to display a test progress monitor component to the subject that shows how many test items have been done. Opt.

Title of the UI window

The title parameter is used to set the title of the UI window. Example: 
   # Set window title
   title=ABC Test

Questions

The questions parameter lists which question components are used. The list is a comma-separated list of question IDs, for example: 
   # List of question objects to be used  
   questions=gA,gB
Two question components with IDs 'gA' and 'gB' are used (grade for samples A and B). The parametars for those questions must be included in the UI file. If no questions are used, do not define the questions-parameter at all.

Controls

The controls parameter lists which control components are used. The list is a comma-separated list of control IDs, for example: 
   # List of control objects to be used  
   controls=play
One control component with ID 'play'is used (for subject to select which sample to play and to show which sample is playing). The parametars for those controls must be included in the UI file. If no controls are used, do not define the controls-parameter at all.

Size of window

Normally the window's size is determined automatically by Java's window toolkit and its layout managers. The size of the window depends on how many question and control components there are, the length of the text labels and their font sizes.

The window's size can be fixed with the width and height parameters. By default they both are zero which means the size is determined automatically by the Java's layout manager. Example: 

   # Set window's width to 640 pixels
   width=640
This will set the window's width to 640 pixels. The height will be determined automatically. The window's width will also cause all question and control components to that width.

By default the user can resize the subject UI window with the mouse. This can be prevented by setting the isResizable parameter to false. For example: 

   # Do not allow the subject to resize the window.
   isResizable=false
the isResizable parameters works both when window's size is fixed or automatic.
· UI index · Document index ·
Last modified: Fri Nov 13 14:26:41 EET 1998