org.qtitools.qti.node.item.interaction
Class GraphicOrderInteraction

java.lang.Object
  org.qtitools.qti.node.AbstractNode
      org.qtitools.qti.node.AbstractObject
          org.qtitools.qti.node.content.BodyElement
              org.qtitools.qti.node.item.interaction.Interaction
                  org.qtitools.qti.node.item.interaction.BlockInteraction
                      org.qtitools.qti.node.item.interaction.GraphicInteraction
                          org.qtitools.qti.node.item.interaction.GraphicOrderInteraction

All Implemented Interfaces:

java.io.Serializable, Block, Flow, ObjectFlow, ChoiceContainer, HotspotChoiceContainer, XmlNode, XmlObject, Validatable

public class GraphicOrderInteraction
extends GraphicInteraction
implements HotspotChoiceContainer

A graphic order interaction is a graphic interaction with a corresponding set of choices that are defined as areas of the graphic image. The candidate's task is to impose an ordering on the areas (hotspots). The order hotspot interaction should only be used when the spacial relationship of the choices with respect to each other (as represented by the graphic image) is important to the needs of the item. Otherwise, orderInteraction should be used instead with separate material for each option. The delivery engine must clearly indicate all defined area(s) of the image. The order hotspot interaction must be bound to a response variable with a baseType of identifier and ordered cardinality. Contains : hotspotChoice [1..*] The hotspots that define the choices that are to be ordered by the candidate. If the delivery system does not support pointer-based selection then the order in which the choices are given must be the order in which they are offered to the candidate for selection. For example, the 'tab order' in hotspot keyboard navigation. Attribute : minChoices [0..1]: integer The minimum number of choices that the candidate must select and order to form a valid response to the interaction. If specified, minChoices must be 1 or greater but must not exceed the number of choices available. If unspecified, all of the choices must be ordered and maxChoices is ignored. Attribute : maxChoices [0..1]: integer The maximum number of choices that the candidate may select and order when responding to the interaction. Used in conjunction with minChoices, if specified, maxChoices must be greater than or equal to minChoices and must not exceed the number of choices available. If unspecified, all of the choices may be ordered.

Author:

Jonathon Hare

See Also:

Serialized Form

Field Summary

static java.lang.String	ATTR_MAX_CHOICES_NAME Name of maxChoices attribute in xml schema.
static java.lang.String	ATTR_MIN_CHOICES_NAME Name of minChoices attribute in xml schema.
static java.lang.String	CLASS_TAG Name of this class in xml schema.

Fields inherited from class org.qtitools.qti.node.item.interaction.Interaction

ATTR_RESPONSE_IDENTIFIER_NAME, CLASS_TAG_SUFFIX, DISPLAY_NAME

Fields inherited from class org.qtitools.qti.node.content.BodyElement

ATTR_CLASS_NAME, ATTR_ID_NAME, ATTR_LABEL_NAME, ATTR_LANG_NAME

Fields inherited from interface org.qtitools.qti.node.XmlNode

INDENT, NEW_LINE, SIMPLE_NAME_INNER_SEPARATOR, SIMPLE_NAMES_SEPARATOR

Fields inherited from interface org.qtitools.qti.node.content.basic.Block

DISPLAY_NAME

Fields inherited from interface org.qtitools.qti.node.content.basic.Flow

DISPLAY_NAME

Constructor Summary

GraphicOrderInteraction(XmlObject parent)
Construct new interaction.

Method Summary

java.util.List<? extends XmlNode>	getChildren() Gets an unmodifiable list of the child elements.
java.lang.String	getClassTag() Gets QTI class name of this node.
HotspotChoice	getHotspotChoice(java.lang.String identifier) Gets hotspotChoice child with given identifier or null.
java.util.List<HotspotChoice>	getHotspotChoices() Gets hotspotChoice children.
java.lang.Integer	getMaxChoices() Gets value of maxChoices attribute.
java.lang.Integer	getMinChoices() Gets value of minChoices attribute.
void	setMaxChoices(java.lang.Integer maxChoices) Sets new value of maxChoices attribute.
void	setMinChoices(java.lang.Integer minChoices) Sets new value of minChoices attribute.
ValidationResult	validate() Validates this object.

Methods inherited from class org.qtitools.qti.node.item.interaction.GraphicInteraction

getObject, setObject

Methods inherited from class org.qtitools.qti.node.item.interaction.BlockInteraction

getPrompt, setPrompt

Methods inherited from class org.qtitools.qti.node.item.interaction.Interaction

beforeProcessResponse, getResponseDeclaration, getResponseIdentifier, getShuffledOrder, initialize, processResponse, processResponse, processResponse, setResponseIdentifier, validateResponse

Methods inherited from class org.qtitools.qti.node.content.BodyElement

appendChild, evaluate, getClassAttr, getFirstChild, getId, getLabel, getLang, getLastChild, insertBefore, removeChild, replaceChild, search, search, search, setId, setLabel, setLang

Methods inherited from class org.qtitools.qti.node.AbstractObject

getParent, getParentItem, getParentResult, getParentTest, setParent

Methods inherited from class org.qtitools.qti.node.AbstractNode

attrToXmlString, bodyToXmlString, getAttributes, getFullName, getIndent, getNode, getNode, getNode, getNodeGroups, getParentRoot, getSimpleName, getSourceFile, getSourceNode, getSourceString, getSourceUrl, hasChildNodes, load, load, load, load, loadAttributes, readChild, readChildren, setParent, setSourceFile, setSourceNode, setSourceString, setSourceUrl, toXmlString, toXmlString, validateAttributes, validateChildren

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.qtitools.qti.node.XmlNode

getAttributes, getFullName, getNodeGroups, getParent, getParentRoot, getSimpleName, getSourceFile, getSourceNode, getSourceString, getSourceUrl, hasChildNodes, load, load, load, load, setSourceFile, setSourceNode, setSourceString, setSourceUrl, toXmlString, toXmlString

Field Detail

CLASS_TAG

public static java.lang.String CLASS_TAG

Name of this class in xml schema.

ATTR_MAX_CHOICES_NAME

public static java.lang.String ATTR_MAX_CHOICES_NAME

Name of maxChoices attribute in xml schema.

ATTR_MIN_CHOICES_NAME

public static java.lang.String ATTR_MIN_CHOICES_NAME

Name of minChoices attribute in xml schema.

Constructor Detail

GraphicOrderInteraction

public GraphicOrderInteraction(XmlObject parent)

Construct new interaction.

Parameters:

parent - Parent node

Method Detail

setMaxChoices

public void setMaxChoices(java.lang.Integer maxChoices)

Sets new value of maxChoices attribute.

Parameters:

maxChoices - new value of maxChoices attribute

See Also:

getMaxChoices()

getMaxChoices

public java.lang.Integer getMaxChoices()

Gets value of maxChoices attribute.

Returns:

value of maxChoices attribute

See Also:

setMaxChoices(java.lang.Integer)

setMinChoices

public void setMinChoices(java.lang.Integer minChoices)

Sets new value of minChoices attribute.

Parameters:

minChoices - new value of minChoices attribute

See Also:

getMinChoices()

getMinChoices

public java.lang.Integer getMinChoices()

Gets value of minChoices attribute.

Returns:

value of minChoices attribute

See Also:

setMinChoices(java.lang.Integer)

getHotspotChoices

public java.util.List<HotspotChoice> getHotspotChoices()

Gets hotspotChoice children.

Returns:

hotspotChoice children

getHotspotChoice

public HotspotChoice getHotspotChoice(java.lang.String identifier)

Gets hotspotChoice child with given identifier or null.

Parameters:

identifier - given identifier

Returns:

hotspotChoice with given identifier or null

validate

public ValidationResult validate()

Description copied from interface: Validatable

Validates this object.

Specified by:

validate in interface Validatable

Overrides:

validate in class GraphicInteraction

Returns:

validation result

getClassTag

public java.lang.String getClassTag()

Description copied from interface: XmlNode

Gets QTI class name of this node.

QTI class name has very important role during loading/saving nodes.

For example: Java class name is AssessmentTest; QTI class name is assessmentTest.

Specified by:

getClassTag in interface XmlNode

Specified by:

getClassTag in class AbstractNode

Returns:

QTI class name of this node

getChildren

public java.util.List<? extends XmlNode> getChildren()

Gets an unmodifiable list of the child elements. Use the other methods on GraphicOrderInteraction to add children to the correct group.

Overrides:

getChildren in class GraphicInteraction

Returns:

List of child nodes