# Timer ## Шаблон Timer Перечень всех возможных тэгов объекта: ```xml ``` ## Описание Timer ```xml ``` #### Атрибуты Timer
Name

Название объекта.

Обязательный атрибут.

Type

Название типа объекта в сборке.

Обязательный атрибут.

Assembly

Название сборки (библиотека).

Обязательный атрибут.

### Получение значения Значением Timer считается значение, равное количеству совершенных запусков таймера. ```xml ``` ### Задание значения Значение объекта: любое значение. ```xml ``` ## Тэги, специфичные для Timer ### Change Настройки изменения проперти [`ValueChanged`](#get_value_changed) объекта. Необязательный тэг. Если тэг `` отсутствует, то для атрибутов `User`, `Source` и `ValueSet` используются значения True, True, и True соответственно. ```xml ``` #### Атрибуты тэга \
User

Признак, будет ли ValueChanged иметь значение True, если пользователь в графическом интерфейсе изменит значение объекта.

Обязательный атрибут. Ожидается логическое значение.

Source

Признак, будет ли ValueChanged иметь значение True, если значение объекта перезагрузится из источника.

Если атрибут Source имеет значение False, и при этом значение из источника перезагрузилось, то ValueChanged будет иметь значение False.

Обязательный атрибут. Ожидается логическое значение.

ValueSet

Признак, будет ли ValueChanged иметь значение True, если значение объекта будет присвоено из команды ValueSetCommand.

Если атрибут ValueSet имеет значение False, и при этом значение было присвоено из команды ValueSetCommand, то ValueChanged будет иметь значение False.

Обязательный атрибут. Ожидается логическое значение.

### ManualStart Признак, определяющий, должен ли таймер запускаться вручную, а не сразу же после загрузки формы. Необязательный тэг. Ожидается логическое значение. По умолчанию используется значение False. ```xml False ``` ### StartTime Дата и время начала работы таймера. Необязательный тэг. Ожидается значение даты/времени. Если значение тэга будет пустым, то таймер никогда не будет запущен. Если тэг `` отсутствует, то ограничение на начало работы таймера не устанавливается. Время, заданное в тэге `` не должно превышать текущее время работы программы больше чем на 2 147 483 647 миллисекунд (\~24 дня и 20 часов). ```xml 19.09.2014 13:57 ``` ### Interval Интервал (в миллисекундах) между запусками цикла таймера. Обязательный тэг. Ожидается положительное целочисленное значение. ```xml 1000 ``` ### StopCount Количество выполненных циклов, требуемых для завершения работы таймера. Необязательный тэг. Ожидается положительное целочисленное значение. Если тэг `` отсутствует, то время работы таймера не ограничивается по количеству запусков. ```xml 5 ``` ### StopTime Дата и время окончания работы таймера. Необязательный тэг. Ожидается значение даты/времени. Если тэг `` отсутствует, то время работы таймера не ограничивается по времени. ```xml 19.09.2014 14:04 ``` ### StopCondition Прочее условие окончания работы таймера. Необязательный тэг. Ожидается логическое значение. Если тэг `` отсутствует, то время работы таймера не ограничивается другими условиями. ```xml True ``` ### Commands Список команд, которые будут выполнены в одном цикле таймера. Необязательный тэг. В качестве значения тэга ожидается список тэгов [``](#command) и/или конструкций [``](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/values/if). ```xml input 1 input 2 ``` #### Атрибуты тэга ``
StopOnError

Признак, определяющий, будет ли остановлено выполнение команд, если при выполнении очередной произойдет ошибка.

Необязательный атрибут. Ожидается логическое значение.

По умолчанию используется значение True.

Lock

Признак, определяющий, будет ли блокироваться форма при выполнении команд.

Необязательный атрибут. Ожидается логическое значение.

По умолчанию используется значение False.

#### Тэг `` Обращение к команде по имени для ее выполнения. Необязательный тэг. В качестве значения тэга ожидается список тэгов [``](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/values/input). ```xml input 1 input 2 ``` ## Get-проперти для получения свойств ### Value Возвращает количество совершенных запусков таймера. ```xml ``` ### ValueChanged Возвращает признак изменения количества совершенных запусков таймера. Есть 3 способа изменить значение объекта: 1. Изменить значение прямым образом в графическом интерфейсе формы, с помощью set-проперти [`ValueChanged`](#set_value_changed). 2. Указать источник значения (ссылка на любые данные на форме). В случае изменения значения в источнике, автоматически изменится значение и самого объекта. 3. Присвоить значение объекту посредством команды [`ValueSetCommand`](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/commands/value_set_command). ```xml ``` ### StartTime Возвращает дату и время начала работы таймера. ```xml ``` ### Interval Возвращает интервал (в миллисекундах) между запусками цикла таймера. ```xml ``` ### StopCount Возвращает количество выполненных циклов, требуемых для завершения работы таймера. ```xml ``` ### StopTime Возвращает дату и время окончания работы таймера. ```xml ``` ### StopCondition Возвращает прочее условие окончания работы таймера. ```xml ``` ### Count Возвращает количество совершенных запусков таймера. ```xml ``` ## Set-проперти для динамического задания свойств ### Value Задает количество совершенных запусков таймера. Ожидается целочисленное значение. ```xml 0 ``` ### ValueChanged Задает признак изменения значения количества совершенных запусков таймера. Ожидается логическое значение. ```xml False ``` ### StartTime Задает дату и время начала работы таймера. Ожидается значение даты/времени. ```xml 19.09.2014 14:09 ``` ### Interval Задает интервал (в миллисекундах) между запусками цикла таймера. Ожидается положительное целочисленное значение. ```xml 1000 ``` ### StopCount Задает количество выполненных циклов, требуемых для завершения работы таймера. Ожидается положительное целочисленное значение. ```xml 5 ``` ### StopTime Задает дату и время окончания работы таймера. Ожидается значение даты/времени. ```xml 19.09.2014 14:09 ``` ### Count Задает количество совершенных запусков таймера. Ожидается целочисленное значение. ```xml 0 ``` ### Start Запускает таймер (при условии, что дата и время, соответствующие свойству [``](#start_time), меньше текущего времени) и немедленно начинает выполнение его команд в соответствии с признаком ExecuteAfterStart. ```xml True ``` ### Stop Останавливает выполнение команд таймера. Значение тэга Property: не ожидается. ```xml ```