Параметры контролов часовой машины
h2. Назначение
Документ содержит описание управляющих параметров контролов часовой машины. Данные параметры используются в XML форматах:
· Файла конфигурации часовой машины
· Параметров команд CCP
Структура описания контрола¶
Каждое описание контрола содержит 3 ветки:
- id - имя контрола, по которому к нему будет осуществляться обращение
- controlType - тип контрола, который определяет его вид и список его параметров
- params - список параметров
id может быть любым набором символов, а controlType - заранее предопределённые типы контролов (имя типа указывается ниже в этом описании в первой строчке после каждого заголовка). Пример контрола типа DATE с имененм DATE_1:
params содержит список всех параметров контрола. Каждый параметр param при этом содержит имя параметра key и его значение value. Тип значения указывается в атрибуте class.
Пример:
конфигурационный файл, в котором в контроле типа CLOCK указывается расположение секунд справа относительно часов и минут.
Общие параметры¶
Данные параметры применимы к любому контролу.
| Имя | Тип (атрибут "class") | Описание |
| x | int | Относительное положение контрола по горизонтали. Задается в процентах от ширины окна ЧМ. |
| y | int | Относительное положение контрола по вертикали. Задается в процентах от высоты окна ЧМ. |
| width | int | Относительная ширина контрола. Задается в процентах от ширины окна ЧМ. |
| height | int | Относительная высота контрола. Задается в процентах от высоты окна ЧМ. |
| visible | boolean | Флаг отображения контрола |
Дата¶
Дополнительные параметры, специфичные для контрола типа DATE.
| Имя | Тип (атрибут "class") | Описание |
| textColor | awt-color | Цвет текста |
| textFontDigit | string | Имя шрифта для вывода цифровых значений |
| textFontDot | string | Имя шрифта для вывода разделителей |
| textSize | int | Размер шрифта |
Сетевой индикатор¶
Дополнительные параметры, специфичные для контрола типа NETINDICATOR.
| Имя | Тип (атрибут "class") | Описание |
| bgColorOn | awt-color | Цвет индикатора при наличии сети |
| bgColorOff | awt-color | Цвет индикатора при отсутствии сети |
| bgTransparency | float | Прозрачность заливки подложки контрола (от 0 до 1) |
| borderColor | awt-color | Цвет рамки |
| state | boolean | Флаг наличия/отсутствия сети |
Лого¶
Дополнительные параметры, специфичные для контрола типа LOGO.
| Имя | Тип (атрибут "class") | Описание |
| pictureName | string | Имя файла изображения |
Транспарант¶
Дополнительные параметры, специфичные для контрола типа TRANSPARENCY.
|Имя|Тип (атрибут "class")|Описание|
|transparensyViewType|viewType|Форма транспаранта:
· RECTANGLE - прямоугольник
· ROUND_RECTANGLE – загругленный прямоугольник
· ELLIPSE - овал
· PARALLELORGRAM – трапеция|
|pictureOn|boolean|Показывать пиктограмму (true) или текст (false)|
|bgColor|awt-color|Цвет заливки подложки контрола|
|bgTransparency|float|Прозрачность заливки подложки контрола (от 0 до 1)|
|text|string|Текст транспаранта|
|textColor|awt-color|Цвет текста транспаранта|
|textFont|string|Имя шрифта текста транспаранта|
|textSize|int|Размер шрифта текста транспаранта|
|blinkOn|boolean|Режим мигания|
|borderColor|awt-color|Цвет рамки|
Часы¶
Дополнительные параметры, специфичные для контрола типа CLOCK.
| Имя | Тип (атрибут "class") | Описание |
| currentColor | awt-color | Цвет обычного сектора |
| finalizeColor | awt-color | Цвет сектора в состоянии finalize |
| criticalColor | awt-color | Цвет сектора в состоянии critical |
| bgColor | awt-color | Цвет заливки подложки контрола |
| sectorTransparency | float | Прозрачность сектора (от 0 до 1) |
| bgTransparency | float | Прозрачность заливки подложки контрола (от 0 до 1) |
| sectorNumber | int | Количество секторов |
| finalizeThresh | int | Порог finalize (в минутах до окончания сектора) |
| criticalThresh | int | Порог critical (в минутах до окончания сектора) |
| arrowsOn | boolean | Флаг показа аналоговых часов (стрелки и аналоговый циферблат) |
| labelsOn | boolean | Флаг показа мнемонических часов (бегущие метки) |
| digitsOn | boolean | Флаг показа цифровых часов |
| arrowColor | awt-color | Зарезервировано |
| labelColor | awt-color | Цвет пассивных мнемонических меток и цвет меток аналогового циферблата |
| digitsColor | awt-color | Цвет текста цифровых часов |
| digitsFont | string | Имя шрифта текста цифровых часов |
| digitsSize | int | Размер шрифта текста цифровых часов |
| criticalBlinkingOn | boolean | Флаг режима мигания сектора в критическом состоянии |
| digitsPlace | int | Относительное положение цифровых часов (в процентах от диаметра циферблата) |
| labelColorActive | awt-color | Цвет активных мнемонических меток |
| labelColorFinal | awt-color | Цвет мнемонических меток в состоянии finalize |
| labelColorCritical | awt-color | Цвет мнемонических меток в состоянии critical |
| arrowShapeHour | shape | Описание часовой стрелки |
| arrowShapeMinute | shape | Описание минутной стрелки |
| arrowShapeSec | shape | Описание секундной стрелки |
| labelSizeLarge | int | Относительная длина больших меток аналогового циферблата (в процентах от радиуса циферблата) |
| labelSizeMed | int | Относительная длина средних меток аналогового циферблата (в процентах от радиуса циферблата) |
| labelSizeSmall | int | Относительная длина малых меток аналогового циферблата (в процентах от радиуса циферблата) |
| labelDiamLarge | int | Относительный диаметр больших мнемонических меток (в процентах от 1/60 длины окружности циферблата) |
| labelDiamSmall | int | Относительный диаметр малых мнемонических меток (в процентах от 1/60 длины окружности циферблата) |
| secondsPlace | int | Место расположения секунд: 0 - не показываются, 1 - снизу, 2 - справа |
| secondsDistance | float | Межстрочный интервал, для secondsPlace=2. По умолчанию - 1.0 (целый интервал) |
| timeShift | int | Сдвиг времени относительно системного таймера в секундах. Например, сдвиг на 2 часа назад: –7200, перёд на час: 3600 |
Круглый таймер¶
Дополнительные параметры, специфичные для контрола типа PROGRESSCIRCLE.
|Имя|Тип (атрибут "class")|Описание|
|minValue|int|Минимальное значение таймера (в секундах)|
|maxValue|int|Максимальное значение таймера (в секундах)|
|value|int|Текущее значение таймера (в секундах)|
|color2|awt-color|Цвет заливки пройденного сектора|
|color1|awt-color|Цвет заливки оставшегося сектора|
|timerOn|boolean|Флаг режима работы:
· true - постоянный по внутреннему таймеру
· false – только по внешним командам|
|textOn|boolean|Флаг отображения текстовой информации|
|textReminderOn|boolean|Флаг режима отображения текстовой информации:
· true – отображать остаток
· false – отображать текущее значение|
|textFormat|boolean|Флаг формата отображения текстовой информации:
· true – формат ММ:СС
· false – значение в секундах|
|textColor|awt-color|Цвет текста|
|textFont|string|Имя шрифта текста|
|textSize|int|Размер шрифта текста|
|finalizeThresh|int|Порог finalize (в секундах до окончания)|
|criticalThresh|int|Порог critical (в секундах до окончания)|
|finalizeColor|awt-color|Цвет заливки пройденного сектора в состоянии finalize|
|criticalColor|awt-color|Цвет заливки пройденного сектора в состоянии critical|
|criticalBlinkingOn|boolean|Флаг режима мигания сектора в критическом состоянии|
Прямоугольный таймер¶
Дополнительные параметры, специфичные для контрола типа PROGRESSRECT.
|Имя|Тип (атрибут "class")|Описание|
|minValue|int|Минимальное значение таймера (в секундах)|
|maxValue|int|Максимальное значение таймера (в секундах)|
|value|int|Текущее значение таймера (в секундах)|
|color2|awt-color|Цвет заливки пройденной области|
|color1|awt-color|Цвет заливки оставшейся области|
|timerOn|boolean|Флаг режима работы:
· true - постоянный по внутреннему таймеру
· false – только по внешним командам|
|textOn|boolean|Флаг отображения текстовой информации|
|textReminderOn|boolean|Флаг режима отображения текстовой информации:
· true – отображать остаток
· false – отображать текущее значение|
|textFormat|boolean|Флаг формата отображения текстовой информации:
· true – формат ММ:СС
· false – значение в секундах|
|textColor|awt-color|Цвет текста|
|textFont|string|Имя шрифта текста|
|textSize|int|Размер шрифта текста|
|finalizeThresh|int|Порог finalize (в секундах до окончания)|
|criticalThresh|int|Порог critical (в секундах до окончания)|
|finalizeColor|awt-color|Цвет заливки пройденной области в состоянии finalize|
|criticalBlinkingOn|boolean|Флаг режима мигания в критическом состоянии|
|horizontalOn|boolean|Режим отображения:
· true – горизонтальный
· false – вертикальный|
|borderColor|awt-color|Цвет рамки|
|brickColorActive|awt-color|Цвет пройденного критического блока|
|brickColorPassive|awt-color|Цвет оставшегося критического блока|
|brickBorderColorActive|awt-color|Цвет рамки пройденного критического блока|
|brickBorderColorPassive|awt-color|Цвет рамки оставшегося критического блока|
|brickTranspActive|float|Прозрачность пройденного критического блока (от 0 до 1)|
|brickTranspPassive|float|Прозрачность оставшегося критического блока (от 0 до 1)|
Бегущая строка¶
Дополнительные параметры, специфичные для контрола типа CREEPINGLINE.
| Имя | Тип (атрибут "class") | Описание |
| bgColor | awt-color | Цвет заливки подложки контрола |
| bgTransparency | float | Прозрачность заливки подложки контрола (от 0 до 1) |
| text | string | Текст |
| textColor | awt-color | Цвет текста |
| textFont | string | Имя шрифта текста |
| textSize | int | Размер шрифта текста |
| scrollOn | boolean | Флаг режима прокрутки |
Текст с прокруткой¶
Дополнительные параметры, специфичные для контрола типа SCROLLINGPANE.
|Имя|Тип (атрибут "class")|Описание|
|bgColor|awt-color|Цвет заливки подложки контрола|
|bgTransparency|float|Прозрачность заливки подложки контрола (от 0 до 1)|
|text|string|Текст|
|textColor|awt-color|Цвет текста|
|textFont|string|Имя шрифта текста|
|textSize|int|Размер шрифта текста|
|scrollOn|boolean|Флаг режима прокрутки|
|scrollDirection|boolean|Направление прокрутки:
· true – вниз
· false – вверх|
|scrollSpeed|int|Скорость прокрутки|
