Alpha.Community

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

Добавление текста на форму

Компоненты для работы с текстом в Alpha.HMI позволяют добавлять текстовые элементы на экранную форму для различных целей: пояснения, отображения информации или ввода данных.

В юните Визуальные доступны следующие компоненты для работы с текстом:

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

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

Простой текст

Компонент Текст предназначен для отображения нередактируемого текста в одну строку. Применяется для пояснений, обозначений элементов интерфейса или вывода информации.

При запуске проекта через Alpha.HMI.WebViewer свойства Ширина текста и Высота текста компонента Текст не работают и всегда возвращают значение 0.

Как добавить простой текст на форму

  1. Добавьте на форму компонент Текст.
  2. Укажите содержимое текстового блока через свойство Текст.

  3. Настройте параметры отображения:

  4. Запустите форму в рантайме, и текст отобразится на ней с учетом заданных параметров.

Простой текст с возможностью копирования и выделения

Если требуется включить возможность выделения и копирования текста, используйте компонент Расширенный текст. Единственное отличие от компонента Текст— возможность включить выделение и копирование.

При запуске проекта через Alpha.HMI.WebViewer свойства Ширина текста и Высота текста компонента Расширенный текст не работают и всегда возвращают значение 0.

Как включить возможность выделения и копирования текста

  1. Добавьте на форму компонент Расширенный текст.
  2. Укажите содержимое текстового блока через свойство Текст.

  3. Включите возможность выделения текста, установив свойство Текст выделяемый в значение true.

  4. Настройте параметры отображения:

  5. Запустите форму в рантайме, и текст станет доступен для выделения мышкой и копирования.

Поле ввода для одной строки

Компонент Поле ввода предназначен для ввода редактируемых текстовых данных в одну строку. Применяется для ввода таких значений, как имя, логин, пароль или другие текстовые данные.

Для настройки ввода пароля используйте свойство Скрывать ввод, чтобы скрыть вводимые символы.

Как настроить проверку пустого поля и запись данных в журнал

Далее описан пример использования компонента Поле ввода в проекте Alpha.HMI с использованием языка Alpha.Om. В примере показано, как:

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

Чтобы настроить проверку пустого поля и запись данных в журнал:

  1. Добавьте на форму компонент Поле ввода.
  2. Укажите текст по умолчанию в свойстве Текст, чтобы поле содержало начальное значение.

  3. Настройте свойство Текст заполнителя, чтобы в пустом поле отображалась подсказка.

  4. Добавьте на форму компонент Средство отладки, чтобы выводить информацию в журнал времени исполнения.
  5. Настройте обработчик события EditFinished компонента Поле ввода, чтобы выполнить необходимые действия после завершения ввода текста. Пример кода:

    if (LineEdit_1.Text == "") 
    {
    ㅤ // Если поле пустое, показываем сообщение об ошибке
    ㅤ LineEdit_1.Tooltip = "Поле ввода не должно быть пустым";
    }
    else
    {
    ㅤ// Очищаем подсказку и записываем данные в журнал
    ㅤ LineEdit_1.Tooltip = "";
    ㅤ DebugTool_1.Log("Введенные данные: " + LineEdit_1.Text);
    }

Поле ввода для нескольких строк

Компонент Редактор текста предназначен для ввода и редактирования многострочных текстовых данных, например, комментариев, заметок или описаний.

Как отобразить содержимое редактора текста во всплывающей подсказке

Далее описан пример использования компонента Редактора текста в проекте Alpha.HMI с использованием языка Alpha.Om. В примере показано, как отобразить содержимое редактора текста во всплывающей подсказке и динамически обновлять её при изменении текста.

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

  1. Добавьте на форму компонент Редактор текста.
  2. Укажите текст по умолчанию в свойстве Текст, чтобы редактор содержал начальное значение.

  3. Настройте параметры отображения:

  4. Настройте обработчик события TextChanged, чтобы обновлять содержимое всплывающей подсказки при изменении текста в редакторе. Пример кода:

    // Обновление всплывающей подсказки с текущим текстом
    TextEdit_1.Tooltip = "Текущий текст: " + TextEdit_1.Text;