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

<tr><td></td><td></td><td></td><td></td><td>А</td></tr> <!-- 11 -->

</data>

<actions>

<action event="onWordComplete" eventParam="all">showObject:t_a10;showObject:btn10</action>

<action event="onWordComplete" eventParam="1">showObject:t_a1;showObject:btn1</action>

<action event="onWordComplete" eventParam="2">showObject:t_a2;showObject:btn2</action>

<action event="onWordComplete" eventParam="3">showObject:t_a3;showObject:btn3</action>

<action event="onWordCompleteWrong" eventParam="all">showObject:t_a11;showObject:btn11</action>

<action event="onWordCompleteWrong" eventParam="1">showObject:t_a4;showObject:btn4</action>

<action event="onWordCompleteWrong" eventParam="2">showObject:t_a5;showObject:btn5</action>

<action event="onWordCompleteWrong" eventParam="3">showObject:t_a6;showObject:btn6</action>

<action event="onCrosswordComplete">showObject:t_a7;showObject:btn7</action>

<!-- <action event="onCrosswordWrong">showObject:t_a8;showObject:btn8</action> -->

<action event="onShow">showObject:t_a9</action>

</actions>

</crossword>

8.3  Шаблон «Интеграция» (integration)

Объект позволяет создавать произвольные композиции в определенной области из произвольного набора таскаемых объектов любого типа.

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

·  произвольное расположение целевого объекта (фона будущей композиции)

·  неограниченное количество таскаемых объектов любого типа

·  произвольное количество одновременно показываемых таскаемых объектов из набора

·  произвольное, либо последовательное расположения таскаемых объектов в стартовых позициях

·  возможность выбора показываемых на стартовых позициях таскаемых объектов из набора во время выполнения задания с помощью специальных actions (команд)

·  возврат на стартовую позицию или исчезновение таскаемого объекта при попытке поставить его за пределы целевой зоны

·  реакция при наведении таскаемого объекта на целевую зону и отведении от нее

·  реакция на постановку таскаемого объекта внутри целевого объекта, либо за его пределами (неправильная постановка)

·  задание точки регистрации таскаемого объекта, по которой будут срабатывать actions (курсор мыши, левый верхний угол объекта, центр объекта)

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

<integration id="" visible="">

<param regPoint="" random="" return=""/>

<actions.../>

<startplaces...>

<place...>

</startplaces>

<target...>

<image.../>...

<rollovermenu.../>

</target>

<button.../>

<image...>...

<actions.../>

</image>

</integration >

Атрибуты:

id	Необязательный атрибут. Задаёт идентификатор объекта. Необходим, если нужно выполнять некоторые действия в отношении данного объекта.
visible	Необязательный атрибут. Задаёт видимость объекта на экране. Значение по умолчанию: false (объект не виден на экране). В дальнейшем видимость объекта может быть изменена с помощью действий (actions): showObject, hideObject и т. д.

8.3.1  Элемент <image...>...</image>...

Задается любой объект в качестве таскаемого.

8.3.2  Элемент <button.../>

Задается объект кнопка, которая не являются таскаемым объектом по определению.

8.3.3  Элемент <param>

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

Задаёт основные характеристики вывода объекта на экран.

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

<param

regPoint="MOUSE"

random="true"

return="true"/>

Атрибуты

regPoint	Необязательный атрибут. Точка регистрации таскаемого объекта. Значение по умолчанию: MOUSE. Возможные значения: MOUSE – отслеживаются координаты курсора мыши при перетаскивании объектов (для выполнения actions) LEFT_TOP – отслеживаются координаты левого верхнего угла таскаемого объекта при перетаскивании (для выполнения actions) CENTER – отслеживаются координаты центра таскаемого объекта при перетаскивании (для выполнения actions)
random	Необязательный атрибут. Произвольная расстановка таскаемых объектов на стартовых позициях. Значение по умолчанию: false. Возможные значения: true – случайная расстановка false – последовательная расстановка
return	Необязательный атрибут. Возврат на стартовую позицию либо исчезновение таскаемого объекта после попытки постановки его вне целевой зоны. Значение по умолчанию: true Возможные значения: true – возврат на стартовую позицию false – исчезновение таскаемого объекта

8.3.4  Элемент <startplaces>

Задаёт параметры появления таскаемых объектов на экране.

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

<startplaces>

<place

x="0"

y="0"

width="0"

height="0"

quantity="1"/>

</startplaces>

8.3.5  Элемент <place>

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

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

<place

x="0"

y="0"

width="0"

height="0"

quantity="1"

/>

Атрибуты

x	Необязательный атрибут. Координата по горизонтальной оси в пикселях относительно родительского контейнера. Значение по умолчанию: 0.
y	Необязательный атрибут. Координата по горизонтальной оси в пикселях относительно родительского контейнера. Значение по умолчанию: 0.
width	Необязательный параметр Ширина стартовой позиции на экране
height	Необязательный элемент. Высота стартовой позиции на экране.
quantity	Необязательный элемент. Количество одинаковых стартовых позиций. Значение по умолчанию: 1.

8.3.6  Элемент <target>

Задаёт целевую область для создания композиции.

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

<target

id=""

enabled="true">

<{Любой визуальный объект}.../>...

</target>

Атрибуты

id	Необязательный атрибут. Задаёт идентификатор объекта. Необходим, если нужно выполнять некоторые действия в отношении данного объекта.
enabled	Необязательный атрибут. Делает целевой объект активным (т. е. целевой объект задает область, куда необходимо поставить таскаемые объекты). Значение по умолчанию: true. Возможные значения: true – целевой объект – активен false – целевой объект –неактивен

8.3.7  Элемент <target><{Объект}.../>...

Целевая область может быть задана любым визуальным объеком (границы объекта будут пределять границы целевой области).

8.3.8  Элемент < rollovermenu.../>

Задается всплывающее меню для сохранения или копирования в буфер получившейся композиции (вместе с целевым объектом).

8.3.9  События, порождаемые шаблоном «Интеграция»

Событие	Описание	Параметры
onEnterTarget	возникает при введении таскаемого объекта в целевую зону (может задаваться как для объекта «Интеграция», так и для конкретного таскаемого объекта)	-
onLeaveTarget	возникает при отведении таскаемого объекта от целевой зоны (может задаваться как для объекта «Интеграция», так и для конкретного таскаемого объекта)	-
onPlacedRight	возникает при правильной постановке таскаемого объекта (может задаваться как для объекта «Интеграция», так и для конкретного таскаемого объекта)	-
onPlacedWrong	возникает при постановке таскаемого объекта за пределами целевой зоны (может задаваться как для объекта «Интеграция», так и для конкретного таскаемого объекта)	-
onAllObjectsPlaced	возникает при правильной постановке всех таскаемых объектов из набора	-

8.3.10 Действия, применимые к шаблону «Интеграция»

hideDragObject	Спрятать таскаемый объект с данным id	id объекта
showDragObject	Показать таскаемый объект с данным id	id объекта
previousObject	Показать предыдущий таскаемый объект из набора на стартовой позиции (объекты уже находящиеся на стартовых позициях сдвигаются на следующую стартовую позицию, если таковая имеется, иначе – скрываются)	-
nextObject	Показать следующий таскаемый объект из набора на стартовой позиции (объекты уже находящиеся на стартовых позициях сдвигаются на предыдущую стартовую позицию, если таковая имеется, иначе – скрываются)	-
resetObject	Сброс композиции с постановкой таскаемых объектов в стартовые позиции. Обнуление результатов (ошибки, подсказки…)	-

Пример

Показ кнопки сброс после правильной расстановки всех таскаемых объектов из набора

Пример:

<integration id="int" visible="true">

<param regPoint="MOUSE" random="true" return="true"/>

<startplaces>

<place x="20" y="450"/>

<place x="220" y="450"/>

</startplaces>

<target id="trg1" enabled="true">

<image id="1" visible="true">

<param src="/DATA/components/dragging/theend. jpg" x="30" y="20" depth="100"/>

</image>

<rollovermenu point="TOP_LEFT" options="copy, save"/> </target>

<actions>

<action event="onAllObjectsPlaced">

showObject:int. btnR

</action>

</actions>

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

<param type="IMAGE" x="900" y="500" srcNormal="norm. png" srcActive="over. png" srcPressed="down. png"/>

<hint type="text">Сброс</hint>

<actions>

<action event="onPress">resetObject</action>

</actions>

</button>

<image visible="true" id="1235">

<param src="/DATA/components/dragging/23.jpg"/>

</image>

<video visible="true" playing="true" id="video1">

<param src="/DATA/components/dragging/08.avi" width="480" height="360" depth="-600"/>

<rollovermenu point="TOP_LEFT" options="copy, save"/>

<control attachPoint="TOP_LEFT" countdown="false"

x="-10" y="100" style="Video"/>

</video>

</integration>

8.4  Шаблон «Поле ввода» (input)

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

Поддерживает:

-  ограничение на количество вводимых символов

-  проверка введенной фразы по заданному образцу, или проверка введенной фразы по регулярному выражению.

-  проверка сразу

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

<input id="InputBoxEx" visible="true">

<param x=""

y=""

width=""

height=""

depth=""

maxChars="2"

checkMode="[after|immediately]"

regex="[true|false]"

check_text="{сирока|регулярное выражение}"

bgcolor=""

bgcolor_active=""

bgcolor_disable="">

</param>

</input_ex>

8.4.1  <param>

Задает параметры поля ввода.

Атрибуты

x	Необязательный атрибут. Отступ по горизонтальной оси Значение по умолчанию: 0.
y	Необязательный атрибут. Отступ по вертикальной оси Значение по умолчанию: 0.
width	Необязательный атрибут. Ширина изображения на экране. Значение по умолчанию: 0.
height	Необязательный атрибут. Высота изображения на экране. Значение по умолчанию: 0.
depth	Необязательный атрибут. Глубина объекта на экране относительно родительского объекта. Значение по умолчанию: 0. Примечание: Все видимые двухмерные объекты упорядочены на экране по глубине. Чем больше значение свойства depth, тем «дальше» от наблюдателя находится объект.
maxChars checkMode	Необязательный атрибут. Задается максимальное количество вводимых символов. Значение по умолчанию: – 1. Если атрибут не задан или равен – 1, то количество символов не ограниченно. Необязательный атрибут. Определяет режим проверки. Занчение по умолчанию: after – проверка по нажатию кнопки. Возможные значения: ·  after – проверка по нажатию кнопки. immediately – проверка сразу, если введенные символы не являются верными, дается 2 секунды на исправление.
range	Необязательный атрибут. Определяет возможность проверки по интервалам. Значение по умолчанию: false – проверка по образцу (предопределенной фразе). Возможные значения: ·  false – проверка по образцу (предопределенной фразе). true – проверка по интервалам.
regex	Необязательный атрибут. Определяет возможность проверки по регулярным выражениям. Значение по умолчанию: false – проверка по образцу (предопределенной фразе). Возможные значения: ·  false – проверка по образцу (предопределенной фразе). true – проверка по регулярному выражению.
check_text	Необязательный атрибут. Возможные значения: ·  Если regex="false" – задается текст, который будет сравниваться с содержимым поля. ·  Если regex="true" – задается регулярное выражение, по которому будет проверяться содержимое поля.
bgcolor	Необязательный атрибут. Задается цвет фона поля ввода в нормальном состоянии. Значение по умолчанию: #FFFFFF.
bgcolor_active	Необязательный атрибут. Задается цвет фона поля ввода в активном состоянии. Значение по умолчанию: #FFFFFF.
bgcolor_disable	Необязательный атрибут. Задается цвет фона поля ввода в неактивном состоянии. Значение по умолчанию: #FFFFFF.

8.4.2  События, порождаемые шаблоном «Поле ввода»

Событие	Описание	Параметры
onInputBoxComplete	возникает при проверке верно введенных в поле символов	-
onInputBoxWrong onKeyDown onKeyUp	возникает при проверке неверно введенных в поле символов возникает при нажатии клавиши возникает про отпускании нажатой клавиши	- - -
onAllInputBoxComplete	Возникает, если во все поля группы введены верные данные. Данное сообщение следует ставить на группу, в составе которой находится шаблон «Поле ввода».	-
onAllInputBoxWrong	Возникает, если хотя бы в одном поле содержатся неверные данные. Данное сообщение следует ставить на группу, в составе которой находится шаблон «Поле ввода».	-
onInputBoxCompareRight	Возниакет, если после ввода очередного символа в поле ввода, введенные символы соответствую проверочным в eventParam	i: или r: или t: перед проверочным интервалом, регулярным выражением или текстом соответственно

8.4.3  Действия, применимые к шаблону «Поле ввода»

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

8.4.4  Принудительная проверка шаблона «Поле ввода»

В случае необходимости проверки состояния шаблона в принудительном порядке по действию пользователя (нажатию кнопки, например), следует воспользоваться вызовом действия (action) – checkObject.

Пример:

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

<param x="710" y="10" type="TEXT" textValue="Проверить ввод" width="200" styleNormal="Verdana_18" styleActive="Verdana_18_Bold"

stylePressed="Verdana_18_Bold"/>

<actions>

<action event="onPress">checkObject:InputBoxEx</action>

</actions>

</button>

8.4.5  Контроль (синхронная проверка) нескольких полей ввода

В процессе работы с реальным учебным модулем часто требуется синхронно контролировать правильность заполнения нескольких полей ввода, принадлежащих одной группе. Для объединения полей ввода в группу следует использовать стандартный объект «Группа» (group).

Внимание! Общие свойства (атрибуты) контейнера <param…/> объекта «Группа» прописаны в соответствующем разделе данного руководства. В данном варианте использования, когда объект «Группа» объединяет несколько шаблонов «Поле ввода», контейнер <param…/> объекта «Группа» имеет – исключительный вариант использования – атрибут checkMode.

<group><param …/>

Атрибуты

checkMode

Необязательный атрибут. Путь к файлу с изображением каретки (курсором ввода). Значение по умолчанию: нет. Возможные значения: ·  Если checkMode ="AFTER_READ_ONLY" – после проверки все поля будут заблокированы. ·  Если checkMode ="AFTER_WRITE" – после проверки в тех полях, где была допущена ошибка, можно будет менять содержимое, а в тех, где не было ошибок - заблокируются для ввода.

Если шаблоны «Поле ввода» собраны в группу, то родительский объект «Группа» способен «отследить» возникновение таких событий, как onAllInputBoxComplete и onAllInputBoxWrong.

Пример.

Если требуется проверять несколько полей ввода в одной группе, то их следует объединить в одну группу:

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

<param depth="-1" checkMode="AFTER_READ_ONLY"/>

<actions>

<action event="onAllInputBoxComplete">showObject:tao01;showObject:next</action>

<action event="onAllInputBoxWrong">showObject:tao02</action>

</actions>

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

<param x="10" y="360" style="Verdana_14_Black"/>

<value>Рычаг обратного хода</value>

</text>

<element id="ib_01" style="InputBox" visible="true">

<param x="400" y="360" check_text="1"/>

</element>

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

<param x="10" y="390" style="Verdana_14_Black"/>

<value>Винт-разъединитель</value>

</text>

<element id="ib_02" style="InputBox" visible="true">

<param x="400" y="390" check_text="2"/>

</element>

</group>

Комментарии к примеру.

Элемент <element >

Элемент – ссылка на входящий в состав контейнера <controls> именованный контейнер, описывающий свойства некоторого (в данном случае –поля ввода input_ex) визуального объекта.

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

<element id="ib_01" style="InputBox" visible="true">

<param x="400" y="360" check_text="1"/>

</element>

Атрибуты

id	Необязательный атрибут. Имя данного контейнера. Значение по умолчанию: нет.
style	Обязательный атрибут. Ссылка на именованный контейнер. Значение по умолчанию: нет.

За подробной информацией о правилах использования данного элемента следует обоатиться в раздел «Настройка элементов управления (<setting element="controls">)».

Так же есть два типа проверки группы:

Если в <param> группы указать checkMode="AFTER_READ_ONLY", то после проверки все поля будут заблокированы. Если в <param> группы указать checkMode="AFTER_WRITE", то после проверки в тех полях, где была допущена ошибка, можно будет менять содержимое, а в тех, где не было ошибок - заблокируются для ввода.

Проверка группы происходит по вызову действия:

<action event="onPress">checkObject:grp_01</action>

8.4.6  Пример обработки событий шаблона «Поле ввода» и таймера

Пример: Объект input_ex получит сообщение onTimeOut от любого сработавшего таймера.

<input id="IBE_1" visible="true">

<param x="190" y="170" width="100" height="30" depth="-200"

check_text="проверка"

bgcolor="#FFFFFF" bgcolor_active="#FFFFFF"

bgcolor_disable="#FFFFFF" multi_line="true">

<resultof type="smooth_err"/>

</param>

<actions>

<action event="onInputBoxComplete">

showObject:ibe1_eror</action>

<action event="onInputBoxWrong">

showObject:ibe1_eror_1</action>

<action event="onTimeOut">showObject:to;goToSummary</action>

</actions>

</input >

8.4.7  Использование регулярных выражений

Основное функциональное назначение данного шаблона – автоматизированная оценка введенной пользователем символьной строки. Оценка, введенных пользователем символов, происходит посредством сравнения с эталонной символьной строкой, зафиксированной в сценарии. В большинстве случаев истинность соответствия значений введенной пользователем и эталонной сток не должна зависеть от различия в написании отдельных символов. Например, смысловое значение введенной строки может соответствовать истине вне зависимости от того, используются ли прописные или строчные буквы; также смысл введенного высказывания может быть тождественен смыслу эталонной фразы вне зависимости от измененных окончаний слов или использования синонимов. Очевидно, что посимвольное сравнение введенной и эталонной строк не всегда правильно. Решению подобных смысловых противоречий способствует использование регулярных выражений.

Регуля́рные выраже́ния (англ. regular expressions) — система синтаксического разбора текстовых фрагментов по формализованному шаблону, основанная на системе записи образцов для поиска. [http://ru. wikipedia. org/wiki/Регулярные_выражения]

Документация по использованию регулярных выражений достаточно объемна, формат данного руководства позволяет лишь привести некоторые примеры с комментариями

Пример:

<input id="InputBoxEx" visible="true">

<param x="1" y="1" width="150" height="30" depth="-300" maxChars="7" regex="true" check_text="/тест/,i" bgcolor="#FFFFFF" bgcolor_active="#F0FFFF" bgcolor_disable="#FFFFFF" multi_line="false">

***

</input>

Комментарии:

·  Наличие символа i (ignore case – не различать строчные и прописные буквы) в эталонной строке check_text="/тест/,i", позволяет оценить (программному анализатору) ввод пользователем слов «тест», «ТЕСТ», или «Тест», как истинно верный;