Счётчик¶
Содержание
Производный от: Reactor
Поддерживаемые интерфейсы:
reactor
counter
Объект счётчик необходим для подсчёта различных событий, происходящих в приложении. Например, с его помощью можно рассчитывать количество меток, распознаваемых в данный момент, или число нажатий пользователя на кнопку:

Начальное значение¶
Вводится в Счётчик (CounterReactor)
Примечание
Состояние счётчика определяется текущим значением - числом, результатом выполнения арифметических операций, определённых действиями объекта. Это внутренний параметр объекта, к которому нет прямого доступа.

Параметр |
Описание |
---|---|
Начальное значение. |
Событие |
Описание |
---|---|
Вызывается при сбросе счётчика на Начальное значение (initialValue) (см. действие Сбросить на начальное значение (resetValue)). |
Действие |
Описание |
---|---|
Сброс счётчика на Начальное значение (initialValue). |
-
параметр
Начальное значение
¶ -
параметр
initialValue
¶ Параметр задаёт начальное значение счётчика. Данное значение нельзя изменить во время работы приложения. Начальное значение определяет, чему будет равно текущее значение счётчика при старте приложения.
Примечание
В начале работы приложения текущее значение равно начальному значению. Во время работы приложения текущее значение меняется, а значение параметра Начальное значение (initialValue) остаётся неизменным, чтобы иметь возможноть произвести сброс счётчика.
-
событие
Значение сброшено
¶ -
событие
onValueReset
()¶ Вызывается сбросе таймера (см. действие Сбросить на начальное значение (resetValue)).
-
действие
Сбросить на начальное значение
¶ -
действие
resetValue
()¶ Сбросить текущее значение счётчика на начальное (см. параметр Начальное значение (initialValue)). Возбуждает событие Значение сброшено (onValueReset).
Работа со счётчиком¶

Основное событие |
Описание |
---|---|
Вызывается при равенстве текущего значения заданному. |
|
Вызывается при неравенстве текущего значения заданному. |
|
Вызывается, когда текущее значение больше заданного. |
|
Вызывается, когда текущее значение меньше заданного. |
|
Вызывается, когда текущее значение принадлежит заданному сегменту. |
|
Вызывается, когда текущее значение не принадлежит заданному сегменту. |
Специальное событие |
Описание |
---|---|
Вызывается при добавлении заданного числа (см. действие Прибавить (add)). |
|
Вызывается при вычитании заданного числа (см. действие Вычесть (subtract)). |
|
Вызывается при увеличении текущего значение (см. действие Прибавить (add)). |
|
Вызывается при уменьшении текущего значение (см. действие Вычесть (subtract)). |
Примечание
События разделены на основные и специальные только для наглядности и упрощения документации. Во время разработки и работы с приложением они абсолютно равноправны.
Действие |
Описание |
---|---|
Прибавить заданное значение. |
|
Вычесть заданное значение. |
|
Установить заданное значение. |
|
Установить случайное значение. |
Примечание
Все события могут быть возбуждены только после вызова какого-либо действия.
-
событие
Равно
¶ -
событие
onEqual
()¶ Вызывается, когда текущее значение становится равно заданному в параметрах события. Например, параметр события: 5. Событие будет возбуждено, когда текущее значение счётчика после какого-либо действия станет равным 5.
- Параметры
Значение / value – значение, при котором вызовется событие.
-
событие
Не равно
¶ -
событие
onNotEqual
()¶ Вызывается, когда текущее значение становится неравно заданному в параметрах события. Например, параметр события: 5. Событие будет возбуждено, когда текущее значение счётчика после какого-либо действия будет отлично от 5.
- Параметры
Значение / value – значение, при котором вызовется событие.
-
событие
Больше чем
¶ -
событие
onGreater
()¶ Вызывается, когда текущее значение становится больше заданного в параметрах события.
- Параметры
Значение / value – значение, при котором вызовется событие.
-
событие
Меньше чем
¶ -
событие
onLess
()¶ Вызывается, когда текущее значение становится заданного в параметрах события.
- Параметры
Значение / value – значение, при котором вызовется событие.
-
событие
Принадлежит отрезку
¶ -
событие
onInsideSegment
()¶ Вызывается, когда текущее значение принадлежит заданному сегменту, границы которого определены в параметрах события.
- Параметры
От / From – левая граница отрезка.
До / To – правая граница отрезка.
Примечание
Если текущее значение равно какому-либо граничному значению отрезка (то есть равно левой или правой границе), событие возбуждается.
-
событие
Не принадлежит отрезку
¶ -
событие
onOutsideSegment
()¶ Вызывается, когда текущее значение не принадлежит заданному сегменту, границы которого определены в параметрах события.
- Параметры
От / From – левая граница отрезка.
До / To – правая граница отрезка.
Примечание
Если текущее значение равно какому-либо граничному значению отрезка (то есть равно левой или правой границе), событие не возбуждается.
-
событие
Прибавлено
¶ -
событие
onAdd
()¶ Вызывается, когда к текущему значению прибавляется число, заданное в параметрах события (см. действие Прибавить (add)).
- Параметры
Значение / value – число, при добавлении которого возбуждается событие.
Примечание
При прибавлении числа, отличного от заданного в параметрах действия, данное событие вызвано не будет. Например, параметр события равен 5. При добавлении к текущему значению числа 6 событие вызвано не будет.
-
событие
Вычтено
¶ -
событие
onSubtract
()¶ Вызывается, когда из текущего значения вычитают число заданное в параметре события (см. действие Вычесть (subtract)). Например, параметр события равен 5. При вычитании из текущего значения числа 6 событие вызвано не будет.
- Параметры
Значение / value – число, при вычитании которого возбуждается событие.
-
событие
Увеличено
¶ -
событие
onIncrease
()¶ Вызывается при увеличении текущего значение. Например установлено новое значение, которое больше предыдущего.
-
событие
Уменьшено
¶ -
событие
onDecrease
()¶ Вызывается при уменьшении текущего значение. Например при вызове действии Вычесть (subtract).
-
действие
Прибавить
¶ -
действие
add
(value)¶ Прибавить заданное значение к текущему значению счётчика. После сложения возбуждаются события: Прибавлено (onAdd) с аргументом, равным параметру
value
, затем все основные события, соответствующие заданному аргументу, и в конце Увеличено (onIncrease).- Параметры
Значение / value – аргумент арифметической операции.
-
действие
Вычесть
¶ -
действие
subtract
(value)¶ Вычесть заданное значение из текущего значения счётчика. После вычитания возбуждаются события: Вычтено (onSubtract) с аргументом, равным параметру
value
, затем все основные события, соответствующие заданному аргументу, и в конце Уменьшено (onDecrease).- Параметры
Значение / value – аргумент арифметической операции.
-
действие
Установить значение
¶ -
действие
setValue
(value)¶ Установить текущее значение счётчика равным параметру
value
. После установки значения возбуждаются все основные события, соответствующие заданному аргументу, и в конце Уменьшено (onDecrease) или Увеличено (onIncrease), в зависимости от установленного аргумента.- Параметры
Значение / value – новое текущее значение.
-
действие
Установить случайное значение
¶ -
действие
setRandomValue
(from, to)¶ Установить текущее значение счётчика равным случайному число, принадлежащему указанному сегменту. Параметры действия задают границы сегмента. После установки значения возбуждаются все основные события, соответствующие заданному аргументу, и в конце Уменьшено (onDecrease) или Увеличено (onIncrease), в зависимости от установленного аргумента.
- Параметры
От / From – левая граница.
До / To – правая граница.