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

<behaviour

placedWrong="moveToTrashBox"

noTargetsMatched="returnToStart"

/>

Атрибуты

placedWrong	Необязательный атрибут. Включает случайный порядок при выводе таскаемых объектов на экран. Значение по умолчанию: true (произвольный порядок). Возможные значения: moveToTrashBox – плавно переместить объект в корзину (для этого необходимо корректно задать объект-корзину) returnToStart – плавно вернуть removeFromScreen – спрятать объект (убрать объект с экрана)
noTargetsMatched	Необязательный атрибут. Возможность перебора объектов в режиме вывода по одному. Значение по умолчанию: true (можно перебирать объекты) Возможные значения: true – можно перебирать объекты с помощью кнопок. При этом должны быть корректно заданы кнопки перебора (с идентификаторами btnPreviousDragObject и btnNextDragObject) false – объекты перебирать нельзя

13.2.5 Элемент <dragging><trashbox>

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

Задаёт параметры появления таскаемых объектов на экране. Корзина не имеет визуального представления, она является точкой, куда перемещаются объекты. Поэтому для изображения отдельного значка корзины на экране необходимо задавать изображение (см. пример ниже)

<trashbox

x="950"

y="550"

/>

Атрибуты

x	Необязательный атрибут. Координата объекта-корзины по горизонтальной оси в пикселях относительно родительского контейнера. Значение по умолчанию: 0.
y	Необязательный атрибут. Координата объекта-корзины по вертикальной оси в пикселях относительно родительского контейнера. Значение по умолчанию: 0.

Пример:

Корзина.

<step>

<settings>

...

<trashbox x="950" y="550"/>

...

</settings>

...

<image visible="true">

<param src="/DATA/components/images/trashbox. jpg" x="950"

y="550"/>

</image>

</step>

13.2.6 Элемент <dragging><param><startplaces>

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

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

<startplaces

fillMode="REPLACE"

> 

<place

x="0"

y="0"

width="0"

height="0"

/>

</startplaces>

Атрибуты

fillMode

Необязательный атрибут. Способ заполнения свободных стартовых позиций на экране новыми таскаемыми объектами. Значение по умолчанию: REPLACE (если освобождается стартовая позиция и в наборе есть объекты для перетаскивания, то объект появляется на этой позиции). Возможные значения: REPLACE - если освобождается стартовая позиция и в наборе есть объекты для перетаскивания, то объект появляется на этой позиции AUTO_SHIFT – если освобождается стартовая позиция и в наборе есть объекты для перетаскивания, то объекты плавно подтягиваются, заполняя эту позицию, а на последней появляется новый объект

13.2.7 Элемент <dragging><param><startplaces><place>

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

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

<place

x="0"

y="0"

width="0"

height="0"

/>

Атрибуты

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

13.2.8 Элемент <dragging><class>

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

Задаёт отдельный класс объектов.

<class>

<param.../>

<dragobject>

...

</dragobjects>

</class>

13.2.9 Элемент <dragging><class><param>

Атрибуты

random	Необязательный атрибут. Отбираются случайные объекты из класса в количестве, определённом в атрибуте select Возможные значения: true – выбираются случайные объекты false – объекты выбираются подряд (в порядке, указанном в файле)
select	Необязательный атрибут. Количество отбираемых объектов из данного класса. Значение по умолчанию: -1 (все объекты, указанные в файле)
targets	Обязательный атрибут. Список идентификаторов целей, в которые могут быть определёны объекты данного класса.

13.2.10  Элемент <dragging><class><dragobject>

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

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

<dragobject id="{Строка}">

<attachzoom id="{строка}" x="{число}" y="{число}" />

<aliases>

<alias classId="" objectId="">

</aliases>

</dragobjects>

Атрибуты

id	Необязательный атрибут. Иденификаторобъекта.

13.2.11  Элемент <dragging><class><dragobject><attachzoom>

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

Данный контейнер служит для присоединения к перемещаемому объекту дополнительных графических или текстовых объектов. При перетаскивании данного перемещаемого объекта присоединенный объект остается неподвижен.

<attachzoom id="{строка}" x="{число}" y="{число}" />

Атрибуты

id	Необязательный атрибут. Иденификатор – ссылка присоединяемого объекта.
x	Смещение присоединяемого объекта относительно родительского по оси X.
y	Смещение присоединяемого объекта относительно родительского по оси Y.

13.2.12  Элемент <dragging><class><dragobject><aliases>

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

Задаёт список объектов-двойников. Два объекта, каждый из которых является двойником другого, не могут быть отнесены к одному классу. Эта возможность полезна, когда, например, два визуально одинаковых объекта надо разнести по двум классам, но поставить оба в один класс будет ошибкой (пример приведён ниже)

<aliases>

<alias classId="" objectId="">

</aliases>

Атрибуты элемента <alias>

classId	Обязательный атрибут. Задаёт идентификатор класса объекта-двойника.
objectId	Обязательный атрибут. Задаёт идентификатор объекта-двойника (из указанного в classId класса)

Пример

Строка, описывающая область в стандартном виде:

Строка в формате '[x, y, ширина, высота]' определяет прямоугольную активную зону объекта. Строка в формате '{(x1, y1), (x2, y2), … (xn, yn)}' определяет многоугольную активную зону объекта-кнопки.

Пример:

...

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

<area x="439" y="65" width="288" height="501"

sensitivity="0"/>

<placement>

<placelist>

<place x="490" y="155"/>

<place x="490" y="200"/>

<place x="490" y="244"/>

</placelist>

</placement>

</target>

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

<area x="727" y="64" width="277" height="502" sensitivity="0"/>

<placement>

<placelist>

<place x="742" y="155"/>

<place x="742" y="200"/>

<place x="742" y="244"/>

</placelist>

</placement>

</target>

<class id="cl3">

<param random="false" targets="dt1;dt2"/>

<dragobject id="do01">

<aliases>

<alias classId="cl3" objectId="do02"/>

</aliases>

<param destinationX="0" destinationY="0"

targets="dt1;dt2" regPoint="MOUSE"/>

<image id="">

<param

src="/DATA/components/dragging/PW02_02_01_d03.png"

width="231" height="21" depth="0"/>

</image>

</dragobject>

<dragobject id="do02">

<aliases>

<alias classId="cl3" objectId="do01"/>

</aliases>

<param destinationX="0" destinationY="0"

targets="dt1;dt2" regPoint="MOUSE"/>

<image id="">

<param

src="/DATA/components/dragging/PW02_02_01_d03.png"

width="231" height="21" depth="0"/>

</image>

</dragobject>

<dragobject id="do03">

<aliases>

<alias classId="cl3" objectId="do04"/>

</aliases>

<param destinationX="0" destinationY="0"

targets="dt1;dt2" regPoint="MOUSE"/>

<image id="">

<param

src="/DATA/components/dragging/PW02_02_01_d04.png"

width="231" height="21" depth="0"/>

</image>

</dragobject>

<dragobject id="do04">

<aliases>

<alias classId="cl3" objectId="do03"/>

</aliases>

<param destinationX="0" destinationY="0"

targets="dt1;dt2" regPoint="MOUSE"/>

<image>

<param

src="/DATA/components/dragging/PW02_02_01_d04.png"

width="231" height="21" depth="0"/>

</image>

</dragobject>

</class>

В данном примере заданы 2 пары объектов-двойников.

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

13.2.13  Элемент <dragging><target>

Определяет цель.

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

<target>

<placement>

<table.../> или <placelist>

<place .../>

</placelist>

</placement>

<area.../>

<mask.../>

<activemark.../>

<actions>

<action.../>

</actions>

</target>

13.2.14  Элемент <dragging><target><placement>

Определяет параметры выстраивания перетаскиваемых объектов в данной цели. Существует два варианта выстраивания – табличное и выстраивание с непосредственным указанием мест. При этом элемент <placement> имеет различную структуру.

Общая структура в случае табличного выстраивания

<placement>

<table …/>

</placement>

13.2.15  Элемент <dragging><target><placement><table>

Атрибуты

columns	Обязательный атрибут. Количество колонок в таблице
lines	Обязательный атрибут. Количество столбцов в таблице
x	Обязательный атрибут. Положение таблицы на экране по горизонтальной оси.
y	Обязательный атрибут. Положение таблицы на экране по вертикальной оси.
fillMode	Необязательный атрибут. Вариант заполнения таблицы. Значение по умолчанию: by_column (объекты выстраивается по столбцам). Возможные значения: by_line – все объекты выстраивается по строкам by_column – объекты выстраивается по столбцам

13.2.16  Элемент <dragging><target><placement><placelist>

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

< placelist >

<place

x=""

y=""

…/>

</ placelist >

При таком задании можно произвольно расставлять места по экрану.

Атрибуты

x	Обязательный атрибут. Положение места на экране по горизонтальной оси.
y	Обязательный атрибут. Положение места на экране по вертикальной оси.

13.2.17  Элемент <dragging><target><activemark>

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

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

<activemark

type="border"

src="/DATA/components/images/border. png"

bordercolor="#FF0000"

bordersize="1"

bgcolor="#FF0000"

x="0"

y="0"

width="0"

height="0"

depth="0"

/>

Атрибуты

type	Обязательный атрибут. Тип подсветки. Значение по умолчанию: border (прямоугольная рамка). Возможные значения: border – выводится прямоугольная рамка, с размерами и положением, указанными в атрибутах x, y, width, height image – выводится изображение - подсветка
x	Необязательный атрибут. Координата по горизонтальной оси в пикселях относительно родительского контейнера. Значение по умолчанию: 0.
y	Необязательный атрибут. Координата по горизонтальной оси в пикселях относительно родительского контейнера. Значение по умолчанию: 0.
width	Необязательный атрибут. Ширина прямоугольной рамки (в случае если type="border") на экране. Значение по умолчанию: 0.
height	Необязательный атрибут. Высота прямоугольной рамки (в случае если type="border") на экране. Значение по умолчанию: 0.
depth	Необязательный атрибут. Глубина. Значение по умолчанию: 0.
src	Путь к файлу изображения (в случае если type="image"), выступающего в роли подсветки
borderColor	Цвет рамки (в случае если type="border") Значение по умолчанию: #FFFFFF (черный). Возможные значения: #000000-#FFFFFF или # - #FFFFFFFF Примечание: Значение цвета может задаваться в одном из двух видов: #RRGGBB – в шестнадцатеричной системе в формате RGB, прозрачность при этом не учитывается #AARRGGBB – в шестнадцатеричном формате ARGB, при этом существует возможность указать полупрозрачный цвет фона
borderSize	Толщина рамки (в случае если type="border") Значение по умолчанию: 1
bgColor	Цвет фона (в случае если type="border") Значение по умолчанию: #FFFFFF (черный). Возможные значения: #000000-#FFFFFF или # - #FFFFFFFF Примечание: Значение цвета может задаваться в одном из двух видов: #RRGGBB – в шестнадцатеричной системе в формате RGB, прозрачность при этом не учитывается #AARRGGBB – в шестнадцатеричном формате ARGB, при этом существует возможность указать полупрозрачный цвет фона

Пример

13.2.18  Элемент <dragging><target><area>

Определяет активную зону цели. Если элемент имеет содержимое, то описание области берётся из него, в противном случае с помощью атрибутов x, y, width, height задаётся прямоугольная область. Вариант задания области с помощью атрибутов, не требует обязательного задания ширины и высоты области, что бывает удобно, когда в объект-цель должен помещаться один единственный объект

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

<area

x="0"

y="0"

width="0"

height="0"

sensitivity="0"

/>

Атрибуты

x	Необязательный атрибут. Координата по горизонтальной оси в пикселях относительно родительского контейнера. Значение по умолчанию: 0.
y	Необязательный атрибут. Координата по горизонтальной оси в пикселях относительно родительского контейнера. Значение по умолчанию: 0.
width	Необязательный атрибут. Ширина области на экране. Значение по умолчанию: 0.
height	Необязательный атрибут. Высота области на экране. Значение по умолчанию: 0.
sensitivity	Необязательный атрибут. Чувствительность (погрешность) в пикселях, с которой можно устанавливать перетаскиваемые объекты в цель. Значение по умолчанию: 20

Содержание

Строка, описывающая область в стандартном виде:

Строка в формате '[x, y, ширина, высота]' определяет прямоугольную активную зону объекта. Строка в формате '{(x1, y1), (x2, y2), … (xn, yn)}' определяет многоугольную активную зону объекта-кнопки.

Пример:

<area x="120" y="211" sensitivity="30" />

<area x="727" y="64" width="277" height="502" sensitivity="0"/>

13.2.19  Элемент <dragging><target><mask>

Определяет активную область цели, задаваемую с помощью изображения с учётом прозрачности. Одна цель может содержать произвольное количество элементов <mask>, при этом могут быть заданы области с помощью элементов <area>.

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

<mask

x="0"

y="0"

depth="-10"

src="/DATA/components/images/target_1_mask. png"

/>

Атрибуты

x	Необязательный атрибут. Координата по горизонтальной оси в пикселях относительно родительского контейнера. Значение по умолчанию: 0.
y	Необязательный атрибут. Координата по вертикальной оси в пикселях относительно родительского контейнера. Значение по умолчанию: 0.
depth	Необязательный атрибут. Глубина объекта на экране относительно родительского объекта. Значение по умолчанию: 0.
src	Обязательный атрибут Путь к файлу изображения, которое является маской.

Содержание

Нет

Пример:

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

Задание зоны с помощью маски. Маской выступает в данном случае изображение "01.png"

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

<mask src="/DATA/components/dragging/mask_zone01.png" depth="-11"/>

...

</target>

13.2.20  События (event), инициируемые объектом «Классификация»

Имя	Описание (событие возникает при …)	Параметры
onEnterTarget	При наведении курсора на цель.	…
onLeaveTarget	При выходе курсора из целевой зоны.	…
onPlacedRight	При правильном расположении перетаскиваемого объекта. Применим только для элемента < dragobject>!
onPlacedWrong	При неправильном расположении перетаскиваемого объекта. Применим только для элемента < dragobject>!
onObjectPlacedRight	При правильном расположении перетаскиваемого объекта. Применим только для элемента <target>!	…
onObjectPlacedError	При неправильном расположении перетаскиваемого объекта. Применим только для элемента <target>!	…
onAllObjectPlaced	При расположении всех перетаскиваемых объектов в целевых зонах (независимо от результата).
onAllObjectsPlacedRight	При правильном расположении всех перетаскиваемых объектов.
onAllObjectsPlacedWrong	При неправильном расположении хотя бы одного объекта.
onAllObjectPlacedClass	Если были расставлены перетаскиваемые объекты одного класса (только не для типа классификация <dragging type="classification" …>).

13.2.21  Действия (actions), применимые к объекту «Классификация»

showObject	Показать объект с заданным id	id объекта
hideObject	Спрятать объект данным id	id объекта
showObjectOnly	Показать объект(ы) с заданным id, при этом спрятать объекты с другими id, расположенные на одном уровне (в общем контейнере), например, в общей группе.	id объекта
hideAllObjects	Спрятать все объекты	id объекта
enableObject	Сделать объект активным	id объекта
saveObject	Сохранить объект (при этом на экране отображается окно диалога сохранения файла)	id объекта
copyObject	Скопировать объект в буфер	id объекта
setPosition	Изменить положение объекта на экране	id_объекта, x,y, width, height[,depth]
zoomInObject	Увеличить объект (Выполнить действия, назначенные на событие onZoomIn)	id объекта
zoomOutObject	Уменьшить объект (Выполнить действия, назначенные на событие onZoomIn)	id объекта
resetObject	Сбросить состояние объекта на начальный состояние. Обнуление результатов (ошибки, подсказки…).	id объекта
showObjectClass	Только для dragging: показать класс	id объекта (класса)
showObjectInVisiblleClass	Только для dragging: показать объект. Действие выполнимо, если id класса соответствует активному классу (см. пример ниже).	id класса, id объекта
frozenObject	«Заморозить» (перевести в неактивное состояние) объект (группу).	id объекта
unfrozenObject	«Разморозить» (перевести в активное состояние) объект (группу).	id объекта
disableTarget	«Закрыть» цель	id объекта
enableTarget	«Открыть» цель	id объекта
showDragObject	Показать таскаемый объект	id объекта
hideDragObject	Скрыть таскаемый объект	id объекта
hideAllWrongTargeted	Скрыть неверно расставленные таскаемые объекты.	…