Alpha.Community

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

Индикатор прогресса

Компонент Индикатор прогресса используется в проекте Alpha.HMI для визуального отображения процентной доли завершенности процесса.

Компонент Индикатор прогресса отображает текущее значение через свойство Значение и позволяет установить диапазон отображения с помощью свойств Минимальное значение и Максимальное значение.

Компонент Индикатор прогресса поддерживает два варианта ориентации:

  • Горизонтальная — индикатор отображается слева направо с возможностью отображения числового значения рядом со шкалой.
  • Вертикальная — индикатор отображается снизу вверх без отображения числового значения.
Горизонтальная Вертикальная

Пример использования

Далее кратко описан пример использования компонента Индикатор прогресса в проекте Alpha.HMI с использованием языка Alpha.Om.

В примере показано, как:

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

Настройка индикатора прогресса

Добавьте на форму компонент Индикатор прогресса и настройте его свойства:

  • Ориентация: Горизонтальная;
  • Минимальное значение: 0;
  • Максимальное значение: 100;
  • Значение: 0;
  • Показывать текст: true.

После настройки индикатор будет отображать текущий прогресс в процентах от 0 до 100 с числовым значением рядом со шкалой.

Динамическое изменение значения индикатора

Чтобы создать анимацию постепенного заполнения индикатора прогресса с помощью кнопки и таймера:

  1. Добавьте на форму компонент Кнопка для запуска процесса.
  2. Добавьте на форму компонент Таймер и настройте его свойства:

    • Интервал: 500 (срабатывание каждые 0.5 секунды);
    • Активность: false (таймер изначально выключен).
  3. Создайте поле типа int4 для хранения значения прогресса. Для этого:
    1. В Структуре объекта правой кнопкой мыши щелкните на MainForm → Создать. Откроется мастер создания элементов.
    2. В поле Тип элемента выберите Поле.
    3. В поле Базовый тип элемента выберите int4 → Создать.
    4. Назовите поле progressValue.

  4. Настройте обработчик события OnTimer таймера. Пример кода:

    // Увеличиваем значение индикатора на 10
    progressValue += 10;
    ProgressBar_1.Value = progressValue;
    // Останавливаем таймер при достижении 100%
    if (progressValue >= 100)
    {
    ㅤㅤTimer_1.Active = false;
    }
  5. Настройте обработчик события ButtonPressed кнопки. Пример кода:

    // Сброс значений перед запуском
    progressValue = 0;
    ProgressBar_1.Value = 0;
    // Активируем таймер
    Timer_1.Active = true;

Запустите форму в режиме рантайм и нажмите кнопку — индикатор прогресса начнёт постепенно заполняться от 0% до 100%. Каждое срабатывание таймера будет увеличивать значение на 10%, что создаёт эффект анимации. Рядом со шкалой будет отображаться текущее числовое значение.

Настройка вертикальной ориентации

Чтобы отобразить индикатор прогресса вертикально, измените свойство Ориентация на Вертикальная. При вертикальной ориентации индикатор прогресса отображается без числового значения.

Запустите форму в режиме рантайм — индикатор будет отображаться вертикально, заполняясь снизу вверх в зависимости от текущего значения.