Счётчик

объект Счётчик; CounterReactor

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

../_images/clicks_count.png

Начальное значение

Вводится в Счётчик (CounterReactor)

Note

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

../_images/initial_value.png
Параметр Описание
Начальное значение (initialValue) Начальное значение.
Событие Описание
Значение сброшено (onValueReset) Вызывается при сбросе счётчика на Начальное значение (initialValue) (см. действие Сбросить на начальное значение (resetValue)).
Действие Описание
Сбросить на начальное значение (resetValue) Сброс счётчика на Начальное значение (initialValue).
параметр Начальное значение; initialValue

Параметр задаёт начальное значение счётчика. Данное значение нельзя изменить во время работы приложения. Начальное значение определяет, чему будет равно текущее значение счётчика при старте приложения.

Note

В начале работы приложения текущее значение равно начальному значению. Во время работы приложения текущее значение меняется, а значение параметра Начальное значение (initialValue) остаётся неизменным, чтобы иметь возможноть произвести сброс счётчика.

событие Значение сброшено; onValueReset

Вызывается сбросе таймера (см. действие Сбросить на начальное значение (resetValue)).

действие Сбросить на начальное значение; resetValue()

Сбросить текущее значение счётчика на начальное (см. параметр Начальное значение (initialValue)). Возбуждает событие Значение сброшено (onValueReset).

Работа со счётчиком

../_images/changers.png
Основное событие Описание
Равно (onEqual) Вызывается при равенстве текущего значения заданному.
Не равно (onNotEqual) Вызывается при неравенстве текущего значения заданному.
Больше чем (onGreater) Вызывается, когда текущее значение больше заданного.
Меньше чем (onLess) Вызывается, когда текущее значение меньше заданного.
Принадлежит отрезку (onInsideSegment) Вызывается, когда текущее значение принадлежит заданному сегменту.
Не принадлежит отрезку (onOutsideSegment) Вызывается, когда текущее значение не принадлежит заданному сегменту.
Специальное событие Описание
Прибавлено (onAdd) Вызывается при добавлении заданного числа (см. действие Прибавить (add)).
Вычтено (onSubtract) Вызывается при вычитании заданного числа (см. действие Вычесть (subtract)).
Увеличено (onIncrease) Вызывается при увеличении текущего значение (см. действие Прибавить (add)).
Уменьшено (onDecrease) Вызывается при уменьшении текущего значение (см. действие Вычесть (subtract)).

Note

События разделены на основные и специальные только для наглядности и упрощения документации. Во время разработки и работы с приложением они абсолютно равноправны.

Действие Описание
Прибавить (add) Прибавить заданное значение.
Вычесть (subtract) Вычесть заданное значение.
Установить значение (setValue) Установить заданное значение.
Установить случайное значение (setRandomValue) Установить случайное значение.

Note

Все события могут быть возбуждены только после вызова какого-либо действия.

событие Равно; onEqual

Вызывается, когда текущее значение становится равно заданному в параметрах события. Например, параметр события: 5. Событие будет возбуждено, когда текущее значение счётчика после какого-либо действия станет равным 5.

Param Значение / value – number:
 значение, при котором вызовется событие.
событие Не равно; onNotEqual

Вызывается, когда текущее значение становится неравно заданному в параметрах события. Например, параметр события: 5. Событие будет возбуждено, когда текущее значение счётчика после какого-либо действия будет отлично от 5.

Param Значение / value – number:
 значение, при котором вызовется событие.
событие Больше чем; onGreater

Вызывается, когда текущее значение становится больше заданного в параметрах события.

Param Значение / value – number:
 значение, при котором вызовется событие.
событие Меньше чем; onLess

Вызывается, когда текущее значение становится заданного в параметрах события.

Param Значение / value – number:
 значение, при котором вызовется событие.
событие Принадлежит отрезку; onInsideSegment

Вызывается, когда текущее значение принадлежит заданному сегменту, границы которого определены в параметрах события.

Param От / From – number:
 левая граница отрезка.
Param До / To – number:
 правая граница отрезка.

Note

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

событие Не принадлежит отрезку; onOutsideSegment

Вызывается, когда текущее значение не принадлежит заданному сегменту, границы которого определены в параметрах события.

Param От / From – number:
 левая граница отрезка.
Param До / To – number:
 правая граница отрезка.

Note

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

событие Прибавлено; onAdd

Вызывается, когда к текущему значению прибавляется число, заданное в параметрах события (см. действие Прибавить (add)).

Param Значение / value – number:
 число, при добавлении которого возбуждается событие.

Note

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

событие Вычтено; onSubtract

Вызывается, когда из текущего значения вычитают число заданное в параметре события (см. действие Вычесть (subtract)). Например, параметр события равен 5. При вычитании из текущего значения числа 6 событие вызвано не будет.

Param Значение / value – number:
 число, при вычитании которого возбуждается событие.
событие Увеличено; onIncrease

Вызывается при увеличении текущего значение. Например установлено новое значение, которое больше предыдущего.

событие Уменьшено; onDecrease

Вызывается при уменьшении текущего значение. Например при вызове действии Вычесть (subtract).

действие Прибавить; add(value)

Прибавить заданное значение к текущему значению счётчика. После сложения возбуждаются события: Прибавлено (onAdd) с аргументом, равным параметру value, затем все основные события, соответствующие заданному аргументу, и в конце Увеличено (onIncrease).

Parameters:Значение / value – аргумент арифметической операции.
действие Вычесть; subtract(value)

Вычесть заданное значение из текущего значения счётчика. После вычитания возбуждаются события: Вычтено (onSubtract) с аргументом, равным параметру value, затем все основные события, соответствующие заданному аргументу, и в конце Уменьшено (onDecrease).

Parameters:Значение / value – аргумент арифметической операции.
действие Установить значение; setValue(value)

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

Parameters:Значение / value – новое текущее значение.
действие Установить случайное значение; setRandomValue(from, to)

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

Parameters:
  • От / From – левая граница.
  • До / To – правая граница.