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

<param type="image"

srcNormal="/DATA/components/close. jpg"

srcActive="/DATA/components/close_h. jpg"

x="814" y="572"/>

<actions>

<action event="onPress">

showObject:..button_1;

hideObject:..button_2

</action>

</actions>

</button>

</group>

</group>

</step>

В данном примере при нажатии на кнопку с идентификатором button_1 будет показана кнопка с идентификатором button_2, а сама кнопка button_1 будет убрана с экрана.

Действие на нажатие кнопки

<button visible="true">

<param.../>

<actions>

<action event="onPress">showObject:ObjectId

</action>

</actions>

</button>

В данном примере событие (event="onPress") назначено некоторой кнопке и «ожидает, прослушивает» момент, когда пользователь нажмет на данный объект. Если пользователь нажмет на объект (button), происходит запланированное действие (showObject:ObjectId).

Действие на появление изображения

<image visible="false">

<param.../>

<actions>

<action event="onShow">showObject:ObjectId

</action>

</actions>

</button>

В данном примере событие (event="onShow") назначено некоторой иллюстрации и «ожидает, прослушивает» момент, когда иллюстрация (изначально скрытая) станет видимой. Если такое событие произойдет, будет вызвано запланированное действие (showObject:ObjectId).

Далее в руководстве представлены события и действия, применимые к объектам сцены.

Следует отметить, что часть действий применима для всех видимых объектов, часть действий применима к отдельным видам объектов.

Некоторые типы сложных объектов - ШАБЛОНОВ («Кроссворд» и др.) имеют, присущие только им, обработчики «действий»; для таких объектов справочная информация будет предоставляться в контексте документации по данным объектам.

5.1  События (event), порождаемые объектами сцены

Событие	Описание	Параметры
onShow	возникает в момент появления изображения	-
onHide	возникает в момент скрытия изображения	-
onRollOver	возникает при наезде на изображение курсором мыши	-
onRollOut	возникает при съезде курсора мыши с изображения	-
onPress	возникает при нажатии мышью на изображении	-
onRelease	возникает при отпускании кнопки мыши над изображением	-
onStartEffect	возникает при старте некоторого назначенного эффекта (если эффекты назначены)	id эффекта
onCompleteEffect	возникает при завершении некоторого визуального эффекта (если эффекты назначены)	id эффекта
onZoomIn	возникает при увеличении объекта (при выполнении соответствующего действия над объектом)	-
onZoomOut	возникает при уменьшении объекта (при выполнении соответствующего действия над объектом)	-
onStartTimer	возникает при запуске таймера	может быть указан идентификатор таймера
onTimeOut	возникает при истечении времени таймера	может быть указан идентификатор таймера

5.2  Действия (action), применимые ко всем видимым объектам сцены

Действие	Описание	Параметры
showObject	Показать объект с заданным id	id объекта
showObjectOnly	Показать объект(ы) с заданным id, при этом спрятать объекты с другими id, расположенные на одном уровне (в общем контейнере), например, в общей группе.	id объекта
hideObject	Спрятать объект с заданным id	id объекта
hideAllObjects	Спрятать все объекты	--
enableObject	Сделать объект активным (восприимчивость к командам, передаваемым посредством действий - actions)	id объекта
enableAllObjects	Сделать все объекты активными (восприимчивость к командам, передаваемым посредством действий - actions)	--
disableObject	Сделать объект неактивным (невосприимчивость к командам, передаваемым посредством действий - actions)	id объекта
disableAllObjects	Сделать все объекты неактивными (невосприимчивость к командам, передаваемым посредством действий - actions)	--
frozenObject	«Заморозить» (перевести в неактивное состояние) объект (группу) (невосприимчивость к клику и клавиатурному вводу).	id объекта
unfrozenObject	«Разморозить» (перевести в активное состояние) объект (группу) (восприимчивость к клику и клавиатурному вводу).	id объекта
saveObject	Сохранить объект (при этом на экране отображается окно диалога сохранения файла)	id объекта
copyObject	Скопировать объект в буфер	id объекта
setPosition	Изменить положение объекта на экране	id_объекта, x,y, width, height[,depth]
resetPosition	Вернуть положение объекта на экране к исходным значениям	id объекта
zoomInObject	Увеличить объект (Выполнить действия, назначенные на событие onZoomIn)	id объекта
zoomOutObject	Уменьшить объект (Выполнить действия, назначенные на событие onZoomIn)	id объекта
resetObject	Сброс композиции с постановкой таскаемых объектов в стартовые позиции. Обнуление результатов (ошибки, подсказки…)	--
setFocus	Перевести фокус (сделать активным) на объект	id объекта
copyRegion	Скопировать область (все визуальные объекты, находящиеся в этой области) в буфер обмена	(x, y,width, height)
saveRegion	Сохранить область (все визуальные объекты, находящиеся в этой области) в файл (в формате png)	(x, y,width, height)
setProperty	Задать свойство для объекта (если указан id) либо для шага (когда id не указан). Свойства объекта могут быть как его реальными параметрами (например visible, width, x… изменяют видимость объекта, его ширину, положение по горизонтали…), так и обычными свойствами с произвольными названиями, не влияющими на реальные параметры объекта. Кроме того для шага могут задаваться такие св-ва как результат выполнения (result), кол-во ошибок (errors), кол-во подсказок (helps) для текущей попытки, а также SCORM-параметры работы с шагом (CMI_completion_status, CMI_success_status, CMI_progress_measure, CMI_completion_threshold, CMI_scaled_passing_score)	id, св-во, значение или св-во, значение

5.3  Действия (action), используемые для управления состоянием кнопок.

Действие	Описание	Параметры
pressButton	Программная имитация нажатия на кнопку с заданным id	id объекта
unpressButton	Программная имитация отпускания кнопки с заданным id	id объекта
releaseButton	Программное приведение свойств кнопки с заданным id в исходное состояние	id объекта
releaseAllButtons	Программное приведение свойств всех кнопок в исходное состояние	--
enableButton	Сделать кнопку активной	id объекта
enableAllButtons	Сделать все кнопки активными	--
disableButton	Сделать кнопку неактивной	id объекта
disableAllButtons	Сделать все кнопки неактивными	--
fireLink	Программная имитация щелчка по гиперссылке.	id объекта

5.4  События(event), инициализируемые протяженными во времени объектами (аудио, видео, flash...).

Список возможных событий:

Действие	Описание	Параметры
onPlay	возникает при начале воспроизведения объекта;	-
onStop	возникает при останове объекта;	-
onPlayed	возникает при окончании воспроизведения объекта (не использовать для Flash и Qt);	-

5.5  Действия (action), применимые к протяженным во времени объектам (аудио, видео, flash...).

Действие	Описание	Параметры
playObject	Начать воспроизведение объекта с заданным id	id объекта
playObjectOnly	Начать воспроизведение объекта с заданным id, при этом приостановить (пауза) объекты с другими id	id объекта
stopObject	Остановить воспроизведение объекта с заданным id (вернуть запись вначало)	id объекта
pauseObject	Приостановить воспроизведение объекта с заданным id	id объекта

5.6  Действия (action), используемые для реализации переходов между сценами.

Переход к другому шагу…

Как было сказано ранее, электронный учебный модуль состоит из набора шагов (учебных сцен). Для реализации автоматизированного перехода от одного шага к другому, существуют предопределенные действия (action).

Список возможных действий:

Действие	Описание	Параметры
goToStep	Переход к указанному шагу	№ шага
goToStepWithId	Переход к указанному шагу	id шага
goPreviousStep	Переход к предыдущему шагу
goNextStep	Переход к следующему шагу
goFirstStep	Переход к первому шагу
goLastStep	Переход к последнему шагу
goToSummary	Переход к шагу (сцене) отображения результатов работы

Пример:

<!-- кнопка перехода к сцене первого задания -->

<button visible="true">

<param textValue="Задание 1" type="TEXT" x="120" y="440" depth="0"/>

<actions>

<action event="onPress">goToStepWithId:z_1</action>

</actions>

</button>

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

5.7  Действия (action), выполняемые для организации вывода результатов работы.

Действие	Описание	Параметры
displayStepResult	Выводится результат выполнения шага (в процентах)	id текстового поля
displayTotalResult	Выводится среднеарифметическое значение результата выполнения модуля (в процентах)	id текстового поля, id шага

5.8  Действия, выполняемые для организации подсчета подсказок (action; increaseHelps).

Любая сцена учебного модуля может (при необходимости) содержать определенное количество подсказок. Подсказка может быть представлена в виде кнопки или некоторой активной зоны, вызывающей (при обращении к ней пользователя) текстовое или иллюстративное сообщение, содержащее сопроводительную информацию (совет, пояснение, альтернативный вариант вопроса…). Для организации подсчета количества вызванных подсказок следует воспользоваться действием (action) с названием increaseHelps. Так как подсказка вызывается посредством действия (action), то варианты её вызова могут быть определены любым событием, которому может соответствовать указанное действие. Опыт использования данного функционала показал, что значим сам факт вызова определенной подсказки, но не количество ее вызовов. Сцена может содержать несколько подсказок, следовательно, для их учета необходимо каждой подсказке конкретной учебной сцены назначить уникальный идентификатор. Если несколько подсказок будут содержать одно имя или будут вовсе безымянны, программный счетчик определит их как одну подсказку. Идентификатор подсказки отделен запятой и следует после инструкции (команды) increaseHelps. Идентификатор подсказки может начинаться только с буквы или символа подчеркивания «_».

Пример:

<button id="btn_helps" visible="true">

<param textValue="Подсказка"

type="TEXT" x="400" y="530" height="30" depth="3"

styleNormal="Verdana_17_grey"

styleActive="Verdana_17_grey"

stylePressed="Verdana_17_grey"/>

<actions>

<action event="onPress">increaseHelps, help_1</action>

</actions>

</button>

5.9  Элемент «Условие» (condition)

Часто в процессе обучения возникает необходимость представления той или иной информации учащемуся, в определенной зависимости от действий которые он совершил в результате интерактивного заимодействия с учебными материалами электронного модуля. Данный сервис обуславливается логикой построения динамической функциональной модели учебного модуля и соответствует логической форме: если – то.

Программа – интерпретатор учебного сценария должна проверять, согласно заданным логическим условиям, параметры (свойства) объектов (медиа-объектов, шаблонов). Параметры объктов могут меняться в процессе работы модуля. При соответствии объектных параметров заданным условиям, следует некоторое предустановленное действие.

Элемент <conditions> задает условие, которое проверяется по событию testCondition:id_условия.

Возможности:

·  проверка любых реальных свойств объекта с заданным id_объекта (id_объекта задается внутри квадратных скобок [id_объекта], если не задан никакой id_объекта, то проверяются параметры данног шага [ ])

·  проверка любых переменных, заданных с помощью элемента <property> или дейсвия "setProperty"

·  выполнение заданных actions в случае успешной проверки, а также любых операций над переменными

·  возможность передавать в action значение любых парметров через [id_объекта].св-во или [].св-во для св-ва, заданного для шага

·  возможность выполнения операций и передачи их результата в action с помощью функции eval()

·  выполнгение различных функций и операций JavaScript над переменными (параметрами объектов либо текущего шага (для проверки какого-либо параметра используется оператор if))

·  условия могут находится как в корне шага, так и внути групп либо некоторых шаблонов и объектов

Элемент имеет следующую общую структуру

<conditions>

<condition id="id_условия"><![CDATA[

if([id_объекта].параметр){

action1:действие1; action2:действие2;

}

]]></condition>

<condition id="id_условия"><![CDATA[

if([].параметр){

action3:действие3; action4:действие4;

}

]]></condition>

</conditions>

5.9.1  Атрибуты:

id	Обязательный атрибут. Задаёт идентификатор условия. Необходим для того, чтобы выполнить данное условие по action "testCondition". При написании имени идентификатора недопустимы точки!

5.9.2  Элемент <![CDATA[ само_условие ]]>

Обязательный элемент

В данном элементе происходит выполнение JavaScript-функций и операций с различными переменными (свойствами оъектов либо текущего шага). Для проверки какого-либо параметра (сравнения с каким-либо значением) используется оператор if.

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

<condition id=""><![CDATA[

if([id_объекта].параметр){

action1:действие1; action2:действие2;

}

]]></condition>

Атрибуты

[id_объекта]	Необязательный атрибут. Задает id объекта, параметр которого будет проверяться. Если id_объекта не указан и квадратные скобки оставлены пустыми [ ], то будет проверяться параметр текущего шага.
параметр	Обязательный атрибут. Задает параметр объекта, который будет проверяться. Этот параметр может быть как реальным свойством объекта (visible, width, x… (видимость, ширина, смещение по горизонтали)), так и св-вом заданным с помощью элемента <property> или дейсвия "setProperty".

5.9.3  Действия, применяемые к элементу «Условие» (condition)

testCondition

Выполнить проверку условия

id_условия

Пример

В данном примере после щелчка по картинке ("img") происходит проверка (testCondition:Complete) условия if([.img].width == 243) (равна ли ширина картинки 243) и в случае успешной проверки (в этом примере она будет успешной) св-ву x= eval([.img].x + 23), т. е. картинка изменяет свое положение по горизонтали (было x="322", а станет x="345"). При этом и картинка и условие (condition) находятся внутри группы "gruppa".