Login Register

Documentation

Limited Check

Description

The Limited Check is a module that allows users to add a button clicking on which will show whether the answers given in the specified modules are correct or wrong.

Note: This module should not be used when a lesson has a defined Score type as first (more about score types can be found in documentation)!

Limited Check module is based on Check module. In addition to its base module, Limited Check has additional rules and functions:

  • when the Check module is selected, all Limited Check modules are selected as well, but they are also disabled in error checking mode
  • selecting one Limited Check module will not select the Check module or any other Limited Check module
  • when the Show Answers module is selected and a user selects the Limited Check module, the Show Answers mode will be disabled and deselected
  • selecting one Limited Check Answer module will deactivate the show answer mode on dependent modules covered by Limited Check Answers and Check Answers modules
  • selecting one Limited Show module will deactivate error checking mode on dependent modules covered by the Limited Check Answer module
Note: The Limited Show Answers module and Limited Check must cover the same modules.

Properties

The list starts with the common properties. Learn more about them by visiting the Modules description section. The other available properties are described below.

Property name Description
Check text Text displayed on the button.
Uncheck text Text displayed on the button when it's selected.
Works with List of modules connected to the Limited Check module. Each line should consist of a separate module ID.
Count mistakes from provided modules With this option checked, mistakes will be counted from modules connected with the Limited Check module.

Supported commands

Command name Params Description
hide --- Hides the module.
show --- Shows the module.
getModulesScore --- Returns JavaScript object with score information (score, errors, and maxScore) that is the sum of all score info for the individual connected module.
getWorksWithModulesList --- Gets a list of modules configured in the "Works With" property.

Advanced Connector integration

Each command supported by the Limited Check module can be used in the Advanced Connector's scripts. The following example shows how it interacts with the Single State Button and Text modules.

EVENTSTART
Name:ValueChanged
Source:SingleStateButton1
SCRIPTSTART
    var limitedCheck= presenter.playerController.getModule('LimitedCheck1');
    var textModule= presenter.playerController.getModule('Text1');
    var scoreInfo = limitedCheck.getModulesScore();

    textModule.setText('Total score: ' + scoreInfo.score);
SCRIPTEND
EVENTEND

Events

Limited Check sends events compatible with Advanced Connector.

It sends the LimitedCheck event when a user selects the button.

Field name Description
Name LimitedCheck
Score Total score of connected modules.
Errors Total number of errors for connected modules.
MaxScore A sum of the maximum score for connected modules.

It sends the LimitedCheck event when a user unselects the button.

Field name Description
Name LimitedCheck
Value "unchecked"

It sends the LimitedHideAnswers event when the user selects the button and the show answer mode is enabled.

Field name Description
Name LimitedHideAnswers
Module1 Module ID of first supported module
Module2 Module ID of second supported module
Module[N] Module ID of nth supported module

CSS Classes

Class name Description
.ic_button_limited_check indicates the look of the Limited Check button.
.ic_button_limited_check-up-hovering indicates the look of the Limited Check button while a mouse cursor is put on it.
.ic_button_limited_check-down-hovering indicates the look of the Limited Check button while clicking on it.
.ic_button_limited_uncheck indicates the look of the Limited Check button when it's pressed.
.ic_button_limited_uncheck.disabled indicates the look of the Limited Check button when it's pressed and disabled (because the Check Answers button was pressed).
.ic_button_limited_uncheck-up-hovering indicates the look of the Limited Check button when it's pressed while putting a mouse cursor on it.
.ic_button_limited_uncheck-down-hovering indicates the look of the Limited Check button when it's pressed while clicking on it.

Default Styling

.ic_button_limited_check {
    background-image: url('images/check.png');
    background-repeat: no-repeat;
    background-position: center;    
    cursor: pointer;
}

.ic_button_limited_uncheck {
    background-image: url('images/uncheck.png');
    background-repeat: no-repeat;
    background-position: center;    
    cursor: pointer;
}

Demo presentation

Demo presentation contains examples of how to use this module.