Счётчик

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

Производный от: Reactor

Поддерживаемые интерфейсы:

  • reactor
  • counter

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

../_images/clicks_count.png

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

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

Примечание

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

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

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

Примечание

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

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

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

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

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

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

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

Примечание

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

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

Примечание

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

событие Равно
событие 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 – правая граница.