Оглавление (стр. 14 )

Определяет свойства кнопок управления объектом "Question"/

Общая структура

<button id="[btnCheck|btnReset|...]" visible="[true|false]">
<param.../>

<hint.../>

...

</button>

Атрибуты

id	Обязательный атрибут. Определяет предопределенных кнопок. Возможные значения: btnCheck – кнопка «проверить»; btnReset – кнопка «обновить данные»; btnNextQuestion – кнопка перехода к следующему вопросу; btnPreviousQuestion – кнопка перехода к предыдущему вопросу.
visible	Обязательный атрибут. Определяет видимость кнопки. Возможные значения: true – кнопка отображается при загрузке сцены; false – кнопка не отображается при загрузке сцены;

Примечание. Более подробно о настройке параметров объекта «Кнопка» следует читать в соответствующем разделе данного руководства.

8.7.13 Элемент <actions>

Данный элемент предназначен для автоматизации поведения объекта "Question"

Общая структура

<actions>

<action event="{событие}">{действие}</action>

</actions>

Атрибуты

event

Необязательный атрибут. Перечень возможных событий представлен в следующем разлеле.

8.7.14 События (event), инициируемые шаблоном «Вопрос»

Имя	Описание (событие возникает при …)	Параметры
onAllQuestionAnsweredRight	если на все вопросы были даны правильные ответы;	…
onAllQuestionAnswered	если на все вопросы были даны ответы;	…
onAnsweredRight	если выбран верный ответ;	…
onAnsweredWrong	если выбран неверный ответ;
onShowQuestion	при появлении на сцене вопроса;	…
onHideQuestion	скрыли вопрос;	…
onSelectAllElements	вывод сообщения, что выбраны все элементы.	…
onResultBelow	событие возникает, если текущий результат ниже установленного значения (задается для всего шаблона).	значение (натуральное число), с которым сравнивается текущий результат
onResultAbove	событие возникает, если текущий результат выше установленного значения (задается для всего шаблона).	значение (натуральное число), с которым сравнивается текущий результат
onResultBetween	событие возникает, если текущий результат находится между двумя значениями интервала (задается для всего шаблона)	min;max (натуральные числа) - интервал, с которым сравнивается текущий результат

8.7.15 Примеры:

Текстовый ответ (правильный), положение на экране определяется автоматически ():

<answer id="answ1">

<param right="true"/>

<text>

<value>Зелёный мох</value>

</text>

</answer>

В виде ответа выступает изображение, положение определяется указанными координатами. В данном случае ответ считается неверным (элемент <param> не задан – следовательно, ответ по умолчанию неверный). Важно отметить, что координаты ответа указываются именно в элементе <param>, непосредственно принадлежащему элементу <answer>. При задании ненулевых значений горизонтальной и вертикальной позиции изображения, они будут прибавлены к указанной позиции.

<answer id="answ1">

<param x="165" y="350"/>

<image>

<param src="/DATA/components/img/01.jpg"/>

</image>

</answer>

Варианты задания отдельного вопроса.

1) Вопрос с тремя вариантами ответа, ответы выводятся вертикально, один под другим, в произвольном порядке. Пользователь может выбрать только один вариант ответа (т. е. галочки работают в режиме переключателя)

<question>

<param answerLayout="LAYOUT_VERTICAL" answersRandom="true"

onlyOneSelected="true"/>

<text id="txt01" visible="true">

<param x="20" y="50" width="400"/>

<value>1. К какой группе моховидных относится это

растение?</value>

</text>

<image visible="true">

<param x="20" y="100" src="/DATA/components/img/07_01.jpg"/>

</image>

<answer id="answ1">

<param right="true"/>

<text>

<value>Печёночники.</value>

</text>

</answer>

<answer id="answ2">

<text>

<value>Зелёные мхи.</value>

</text>

</answer>

<answer id="answ3">

<text>

<value>Белые (сфагновые) мхи.</value>

</text>

</answer>

</question>

Элемент <actions> - назначение действия на правильный/неправильный ответ для каждого вопроса. Работает только для режима «проверить сразу».

<answer id="answ1">

<param right="true"/>

<actions>

<action event="onAnsweredRight">hideObject:..answ1;</action>

</actions>

<text>

<value>Зелёный мох</value>

</text>

</answer>

В примере показана реакция на правильный ответ.

На неправильный ответ надо задать: action event="onAnsweredWrong".

Назначение действий на правильный/неправильный ответ, на событие “Отвечено на все вопросы”

Существует возможность назначать произвольные действия на правильный и неправильный ответ пользователя на конкретный вопрос. Также можно создать реакцию на момент, когда пользователь ответил на все вопросы.

Пример, пусть необходимо при правильном ответе отобразить текст “Правильно”, а при неправильном ответе слово “Ошибка”, тогда это можно сделать следующим образом:

<group id="result" visible="true">

<param x="850" y="550" restrictions="exclusive_visible"/>

<text id="error">

<value>ОШИБКА</value>

</text>

<text id="right">

<value>ПРАВИЛЬНО</value>

</text>

</group>

<questions>

<question id="01">

…

<actions>

<action event="onAnsweredWrong">showObject:result. error</action>

</actions>

<answer id="answ1">

…

</answer>

<answer id="answ2">

…

</answer>

</question>

</questions>

Для реакции при ответе на все вопросы необходимо задать обработчик на событие onAllQuestionAnswered:

<actions>

<action event="onAllQuestionAnswered">showObject:theEnd</action>

</actions>

<image visible="false" id="theEnd">

<param x="100" y="100" depth="-1000" src="/DATA/components/question/theEnd. png"/>

</image>

<questions>

…

</questions>

Перебор вопросов.

Перебор включается установкой следующего значения:

<questions allowSelection="false" …/>

Также требуется задать 2 кнопки:

<button id="btnPreviousQuestion">

<param x="800" y="530" type="TEXT" textValue="Предыдущий вопрос" width="190" styleNormal="Verdana_18" styleActive="Verdana_18_Bold" stylePressed="Verdana_18_Bold"/>

</button>

<button id="btnNextQuestion">

<param x="900" y="530" type="TEXT" textValue="Следующий вопрос" width="90" styleNormal="Verdana_18" styleActive="Verdana_18_Bold" stylePressed="Verdana_18_Bold"/>

</button>

Кнопки должны иметь id равные btnPreviousQuestion и btnNextQuestion соответственно для перехода к предыдущему и к следующему вопросу.

Многократный/однократный ответ на вопрос

По умолчанию, пользователь может отвечать на один вопрос многократно. Для отключения необходимо задать значения параметра questions:allowMultiple в false:

<questions allowMultiple="true" excludeStyle="DISABLE" …/>

Если отключен многократный ответ на вопросы, то существует два варианта поведения:

вопрос исключается из набора, если был дан ответ. Для этого задаётся параметр excludeStyle=”EXCLUDE”

вопрос остаётся в наборе, но при этом ответить на него повторно нельзя. Т. е. если пользователь перебирает вопросы, вопрос отображается на экране с вариантом ответа, данным пользователем в последней попытке, но изменить ответы нельзя. Для этого задаётся параметр excludeStyle=” DISABLE”.

8.8  Шаблон «Множественные отношения» (Union)

Возможности шаблона:

Отображение на сцене элементов исследуемых множеств соответствует порядку следования данных элементов в файле Вывод элементов исследуемых множеств в произвольном порядке Возможность ограничения времени, отведенного для выполнения задания Проверка расставленных отношений (соединительных линий между объектами) по требованию пользователя (нажатие кнопки «Проверить»)
пользователь в свободном режиме устанавливает соответствия (сбрасывая все или сбрасывая установленное ранее соответствие); после того как пользователь (ученик) установил необходимое количество соответствий, следует нажать кнопку «Проверить»; по результату проверки связующие линии окрашиваются в определенные (заданные в установочном файле) цвета; реакция программы на различные действия пользователя описывается определенным способом в установочном файле;
Проверка установленного соотношения непосредственно по факту случившегося
пользователь устанавливает соответствие между двумя объектами, принадлежащими разным множествам (группам объектов); после того, как пользователь щелкнет по второму, но не уберет курсор из зоны второго объекта, программа обработает результат выбора и выполнит соответствующие (описанные в установочном файле) действия; после того, как пользователь выведет курсор из активной зоны второго объекта, программа способна выполнить соответствующие (описанные в установочном файле) действия; после того, как все верные отношения будут установлены, программа способна выполнить соответствующие (описанные в установочном файле) действия;

Важно:

В данном шаблоне существуют зарезервированные идентификаторы объектов, использование которых жестко предопределено. Список предопределённых идентификаторов и их назначение указано ниже (имена чувствительны к регистру).

btnPreviousQuestion – кнопка перехода к предыдущему вопросу в наборе (конкретный алгоритм выбора вопроса зависит от настроек) btnNextQuestion – кнопка перехода к следующему вопросу в наборе (конкретный алгоритм выбора вопроса зависит от настроек) btnCheck– кнопка проверки ответов в текущем вопросе (используется при соответствующих настройках шаблона) btnReset– кнопка сброса выбранных ответов в текущем вопросе (если разрешено настройками шаблона)

Не рекомендуется управлять данными объектам самостоятельно с помощью действий.

Общая структура объекта

<union>

<param>

<unionsPropList... />

<units... />

<checkbox... />

<relationLine... />

<resultof... />

</param>

<button>

...

</button>

<unions>

<union>

<param... />

<actions>

</actions>

...

<unit>

<param ... />

<text .../>

</unit>

<unit>

<param ... />

<image .../>

</unit>

...

</union>

</unions>

</union>

Примечание

Элемент < units > в контейнере <param> содержит общие настройки для всей группы учебных задач (как правило, на практике одному учебному объекту <union> соответствует одно задание <union> в составе контейнера <unions>). Контейнер <unions> содержит список учебных задач. Контейнеры <union> описывают общие свойства и состав элементов <unit>.

8.8.1  Элемент <union><param>

<param>

<unionsPropList... />

<units... />

<checkbox... />

<relationLine... />

<resultof... />

</param>

8.8.2  Элемент <union><param><unionsPropList>

Общая структура

<unionsPropList

random="false"

checkMode="CHECK_AFTER"

allowSelection="true"

selectionCycling="false"

allowMultiple="false"

excludeStyle="DISABLE"/>

Атрибуты

random	Необязательный атрибут. Произвольный порядок вывода заданий. Значение по умолчанию: true (произвольный порядок). Возможные значения: true – произвольный порядок вывода заданий; false – порядок соответствует порядку следования заданий в файле. Примечание: Если указан произвольный порядок заданий, то он определяется псевдослучайным образом при загрузке шага. При переходе от задания к заданию порядок не изменяется.
allowMultiple	Необязательный атрибут. Возможность выполнять задания многократно. Значение по умолчанию: true (многократный ответ включен). Возможные значения: true – можно выполнять задания произвольное число раз false – выполнять задания можно только один раз, после этого задание либо исключается из набора, либо становится недоступным для повторного ответа (в зависимости от значения атрибута "excludeStyle") Примечание: Фактически определяет работу шага в режиме практики.
excludeStyle	Необязательный атрибут. Определяет режим исключения ответов из набора. Значение по умолчанию: DISABLE (вопрос остаётся в наборе, но при этом повторный ответ невозможен). Возможные значения: EXCLUDE - задание исключается из набора, переход на него невозможен DISABLE - задание остаётся в наборе, но при этом повторный ответ невозможен
allowSelection	Необязательный атрибут. Возможность перебора заданий кнопками. Значение по умолчанию: true – задания можно перебирать кнопками (должны быть заданы соответствующие кнопки) Возможные значения: true – задания можно перебирать кнопками (должны быть заданы соответствующие кнопки) false – задания нельзя перебирать кнопками (даже если эти кнопки заданы) Примечание: Для выполнения перебора заданий необходимо корректное задание кнопок с идентификаторами btnPreviousQuestion и btnNextQuestion
selectionCycling	Необязательный атрибут. Зацикливание набора заданий. Значение по умолчанию: true (набор зациклен). Возможные значения: true – зацикливание набора заданий включено false – зацикливание набора заданий выключено (для перехода с первого на последнее задание необходимо пройти через весь набор)
checkMode	Необязательный атрибут. Способ проверки. Возможные значения: CHECK_AFTER – проверка осуществляется при нажатии специально определенной кнопки CHECK_IMMEDIATELY – проверка при выборе определенной пары значений

8.8.3  Элемент <union><param><units>

Определяет параметры настройки свойств элементов сравниваемых множеств.

Общая структура

<units

answersRandom="true"

answersLayout="LAYOUT_VERTICAL"

answersInterline="50"

answersX="0"

answersY="0"

/>

Атрибуты

answersRandom	Необязательный атрибут. Произвольный порядок вывода элементов. Значение по умолчанию: true (произвольный порядок). Возможные значения: true – произвольный порядок вывода элементов; false – порядок соответствует порядку следования элементов в контейнере. Примечание: Если указан произвольный порядок элементов, то он определяется псевдослучайным образом при загрузке шага. Данный параметр может быть переопределён для конкретного задания.
answersLayout	Необязательный атрибут. Способ вывода элементов на экран. Значение по умолчанию: берётся из настроек шаблона (см. настройка answers: answersLayout). Возможные значения: LAYOUT_NO – положение отдельных элементов определяется разработчиком (необходимо задавать конкретные значения положения по горизонтали и вертикали) LAYOUT_VERTICAL – выстраивание элементов один под другим LAYOUT_HORIZONTAL – выстраивание элементов слева направо Примечание: Данный параметр может быть переопределён для конкретного задания.
answersInterline	Необязательный атрибут. Задает межстрочное расстояние между элементами множеств при вертикальном выстраивании элементов Значение по умолчанию: "0,0" Примечание: Данный параметр может применим, если параметр answersLayout имеет значение LAYOUT_VERTICAL. Данный параметр может быть переопределён для конкретного задания.
answersX	Необязательный атрибут. Задает горизонтальную позицию начала расположения первых элементов множеств. Значение по умолчанию: 0,0 Примечание: Данный параметр может быть переопределён для конкретного задания.
answersY	Необязательный атрибут. Задает вертикальную позицию начала расположения первых элементов множеств. Значение по умолчанию: 0,0 Примечание: Данный параметр может быть переопределён для конкретного задания.
showCorrectRelations	Необязательный атрибут. Если для данного атрибута установлено значение "true", а значение атрибута checkMode="CHECK_AFTER" , то после того, как пользователь нажмет кнопку проверки результата, будут отображены (установленным цветом) все правильные (не указанные пользователем) отношения между объектами. Значение по умолчанию: "false" Примечание: Данный параметр может быть переопределён для конкретного задания.

8.8.4  Элемент <union><param><checkbox>

Определяет параметры отображения "галки" или точки (т. н. «горячей» зоны), которая соответствует отдельному элементу множества

Может находиться в двух состояниях – нормальном и активном.

Общая структура

<checkbox

normalBorder="DATA/components/question/boxNormal. png"

normalMark="/DATA/components/question/markNormal. png"

disabledBorder="/DATA/components/question/boxNormal. png"

/>

Атрибуты

normalBorder	Обязательный атрибут. Определяет путь к файлу изображения, играющего роль рамки галки в нормальном состоянии.
normalMark	Определяет путь к файлу изображения, играющего роль галки в активном состоянии.
disabledBorder	Определяет путь к файлу изображения, играющего роль рамки галки в неактивном состоянии.

8.8.5  Элемент <union><param><relationLine>

Определяет цвет соединительной линии.

Общая структура

< relationLine

normalColor="#0000FF"

markColor="#00FF00"

disabledColor="#CCCCCC"

correctColor="#FF0000"

/>

Атрибуты

normalColor	Обязательный атрибут. Цвет соединительной линии в нормальном состоянии.
markColor	Цвет соединительной линии в случае, если отношение верно.
disabledColor	Цвет соединительной линии в случае, если отношение не верно.
correctColor	Цвет соединительной линии в случае, если отношение верно, но пользователь его не выбрал

8.8.6  Элемент <union><param><resultof>

Настройка параметров подсчета результатов ответа.

Общая структура

<resultof

type="[ none|discrete|smooth|smooth_err|attempts]"

/>

Данный элемент типичен для всех интерактивных учебных объектов. Более подробно с описанием данного элемента можно познакомиться в разделе «Тип подсчета результатов. <resultof …/>».

8.8.7  Элемент <union><unions>

Элемент задаёт набор учебных задач (набор элементов union), каждая из которых определяет отдельное множественное отношение элементов.

Общая структура

< unions>

<union>

...

</union>

</ unions>

8.8.8  Элемент <union><unions><union>

Контейнер описывает отдельное множество элементов, каждый из которых принадлежит к определенному подмножеству и соотносится с одним или несколькими элементами из иного подмножества.

Общая структура

<union>

<param.../>

<unit>

...

</unit>

</union>

8.8.9  Элемент <union><unions><union><param>

Атрибуты

x	Необязательный атрибут. Координата по горизонтальной оси в пикселях относительно родительского контейнера. Значение по умолчанию: 0.
y	Необязательный атрибут. Координата по вертикальной оси в пикселях относительно родительского контейнера. Значение по умолчанию: 0.
answersLayout	Необязательный атрибут. Способ вывода ответов на экран. Значение по умолчанию: берётся из настроек шаблона (см. настройка answers: answersLayout). Возможные значения: LAYOUT_NO – положение отдельных элементов определяется разработчиком (необходимо задавать конкретные значения положения по горизонтали и вертикали); LAYOUT_VERTICAL – выстраивание элементов один под другим; LAYOUT_HORIZONTAL – выстраивание элементов слева направо.
answersInterline	Необязательный атрибут. Задает межстрочное расстояние между элементами множеств при вертикальном выстраивании элементов Значение по умолчанию: "0,0" Примечание: Данный параметр может применим, если параметр answersLayout имеет значение LAYOUT_VERTICAL.
answersRandom	Необязательный атрибут. Произвольный порядок вывода элементов. Значение по умолчанию: true (произвольный порядок). Возможные значения: true – произвольный порядок вывода всех элементов; false – порядок соответствует порядку следования элементов в контейнере. "true, false" – произвольный порядок вывода элементов для первого множества и предопределенный для второго; "fals, true " – предопределенный порядок вывода элементов для первого множества и произвольный для второго; Примечание: Если указан произвольный порядок элементов, то он определяется псевдослучайным образом при загрузке шага. Данный параметр может быть переопределён для конкретного задания.
allowMultiple	Необязательный атрибут. Определяет, есть ли возможность выполнять данное задание многократно. Значение по умолчанию: берётся из настроек шаблона (см. настройка question: allowMultiple). Возможные значения: true – можно выполнять задание многократно false – нельзя выполнять задание многократно Примечание: Значение, указанное в данном атрибуте имеет больший приоритет, по сравнению с аналогичной настройкой всего шаблона. Т. е. если в настройках шаблона указано отличное значение, оно не учитывается.
answersX	Необязательный атрибут. Задает горизонтальную позицию начала расположения первых элементов множеств. К первому множеству относиться первый элемент списка, ко второму – второй. Значение по умолчанию: берётся из настроек шаблона (см. настройка answers: onlyOneSelected). Примечание: Значение, указанное в данном атрибуте имеет больший приоритет, по сравнению с аналогичной настройкой всего шаблона. Т. е. если в настройках шаблона указано отличное значение, оно не учитывается.
answersY	Необязательный атрибут. Задает вертикальную позицию начала расположения первых элементов множеств. К первому множеству относиться первый элемент списка, ко второму – второй. Примечание: Значение, указанное в данном атрибуте имеет больший приоритет, по сравнению с аналогичной настройкой всего шаблона.
checkMode	Необязательный атрибут. Способ проверки. Возможные значения: CHECK_AFTER – проверка осуществляется при нажатии специально определенной кнопки CHECK_IMMEDIATELY – проверка при выборе определенной пары значений
unionsName	Обязательный атрибут. Задает список имен множеств. К первому множеству относиться первый элемент списка, ко второму – второй. Примечание: Текущая версия объекта Union реализована для обработки двух множеств элементов.
autoAttachStyles	Обязательный атрибут. Задает список местоположения зон, исполняющих роль маркера объекта отношения и точку привязки связующей линии. К первому множеству относиться первый элемент списка, ко второму – второй. Возможные значения: LEFT_CENTER – слева по центру RIGHT_CENTER – справа по центру TOP_ CENTER – сверху центру BOTTOM_CENTER – снизу по центру
autoAttachOffsetsX	Необязательный атрибут. Для некотрых композиций бывает необходимо подкорректировать положение присоедененной зоны-маркера. Данный атрибут определяет смещение зоны-маркера по оси X. Формат записи – список значений. К первому множеству относиться первый элемент списка, ко второму – второй. Значение по умолчанию: "0,0"
autoAttachOffsetsY	Необязательный атрибут. Для некотрых композиций бывает необходимо подкорректировать положение присоедененной зоны-маркера. Данный атрибут определяет смещение зоны-маркера по оси Y. Формат записи – список значений. К первому множеству относиться первый элемент списка, ко второму – второй. Значение по умолчанию: "0,0"
showCorrectRelations	Необязательный атрибут. Если для данного атрибута установлено значение "true", а значение атрибута checkMode="CHECK_AFTER" , то после того, как пользователь нажмет кнопку проверки результата, будут отображены (установленным цветом) все правильные (не указанные пользователем) отношения между объектами. Значение по умолчанию: "false"