Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Пользовательские поля объектов

Поле (переменная) — это пользовательское свойство объекта, которое создаётся пользователем для хранения данных.

В Alpha.HMI существует два типа полей:

  • Поле – хранит значение указанного базового типа. Базовый тип задаётся при создании поля в Мастере создания элементов и определяет тип данных, которые могут храниться в поле (например, int4, string, bool).
  • Уведомляющее поле – также хранит значение базового типа, но при его изменении автоматически генерирует событие ValueChanged.

Создание пользовательских полей

Чтобы создать пользовательское поле:

  1. В Структуре объекта щёлкните правой кнопкой мыши на объекте, которому будет принадлежать поле, и выберите Создать.

  2. В открывшемся мастере создания элементов:
    1. В поле Тип элемента выберите Поле или Уведомляющее поле. 
    2. В поле Базовый тип элемента выберите тип данных (int4, bool, string и т.д.) → Создать.

  3. Переименуйте созданное поле.

После создания поле появляется в двух местах:

  • В разделе Данные в Структуре объекта.

  • В Редакторе свойств родительского объекта.

Установка значений по умолчанию

Значение, с которым поле будет инициализировано при запуске (начальное значение), можно задать в Редакторе свойств двумя способами:

  • В свойствах поля.

  • В свойствах родительского объекта.

Достаточно указать значение в одном месте — оно автоматически отобразится в другом.

Как настроить таймер обратного отсчёта с заданным начальным значением

В этом примере (скачать его можно здесь) создаётся таймер, который отсчитывает время от 10 секунд до нуля и отображает оставшееся время в компоненте Текст. Таймер запускается кнопкой Старт и останавливается кнопкой Сброс.

Для хранения данных используются два пользовательских поля:

  • currentTime (уведомляющее) — хранит текущее значение секунд. При его изменении автоматически обновляется текст на форме через событие ValueChanged.
  • isRunning — хранит состояние таймера (запущен/остановлен).

Начальные значения полей (10 секунд для таймера и состояние "остановлен") задаются в свойствах полей currentTime и isRunning.

Чтобы создать такой таймер:

  1. На форму добавьте:
    • Компонент Текст для отображения оставшегося времени.

    • Компонент Кнопка и в свойстве Текст укажите Старт.

    • Компонент Кнопка и в свойстве Текст укажите Сброс.

    • Компонент Таймер со свойством Активность = true.

  2. Создайте два поля.
    1. Поле currentTime (уведомляющее):
      1. В Структуре объекта правой кнопкой мыши щёлкните на MainForm → Создать. Откроется мастер создания элементов.
      2. В поле Тип элемента выберите Уведомляющее поле.

      3. Базовый тип элемента → Уведомляющий int4 → Создать

      4. Переименуйте поле в currentTime.

      5. В свойствах поля установите значение = 10.

    2. Поле isRunning:
      1. В поле Тип элемента выберите Поле.
      2. Базовый тип элемента → bool → Создать

      3. Переименуйте поле в isRunning.

      4. В свойствах поля установите значение = false.

  3. Чтобы обновлять текст на форме при каждом изменении значения таймера и автоматически останавливать отсчёт при достижении нуля, настройте обработчик события ValueChanged для поля currentTime. Пример кода:

    Text_1.Text = "Осталось: " + String.ToString(currentTime.Value) + " сек";
    if (currentTime.Value <= 0 && isRunning)
    {
      isRunning = false;
      Text_1.Text = "Время вышло!";
    }
  4. Чтобы запускать обратный отсчёт при нажатии кнопки, настройте обработчик события ButtonPressed для кнопки Старт. Пример кода:

    if (!isRunning && currentTime.Value > 0)
    {
      isRunning = true;
    }
  5. Чтобы остановить таймер и вернуть счетчик к начальному значению (10 секунд), настройте обработчик события ButtonPressed для кнопки Сброс. Пример кода:

    isRunning = false;
    currentTime.Value = 10; // Возврат к начальному значению
  6. Чтобы реализовать механизм отсчёта (уменьшение значения currentTime на 1), настройте обработчик OnTimer для таймера. Пример кода:

    if (isRunning && currentTime.Value > 0)
    {
      currentTime.Value = currentTime.Value - 1;
    }

После запуска формы в рантайме:

  • Поле currentTime инициализируется значением 10 секунд.
  • При нажатии Старт начинается обратный отсчёт.
  • При достижении нуля отображается сообщение Время вышло!.
  • Кнопка Сброс возвращает значение таймера к начальному и останавливает отсчёт.