Alpha.Community

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

Запуск экранной клавиатуры из проекта

Экранная клавиатура HMI.Keyboard — это внешнее приложение, которое можно запускать из проектов Alpha.HMI для ввода данных на устройствах без физической клавиатуры или в ситуациях, когда использование экранной клавиатуры более удобно. Запускается из проектов Alpha.HMI через компонент Окружение: процесс.

Клавиатура Alpha.HMI.Keyboard доступна только в Alpha.HMI для Windows. В Alpha.HMI для Linux отдельного приложения Alpha.HMI.Keyboard нет — используется экранная клавиатура, встроенная в операционную систему. Инструкции ниже с указанием исполняемого файла и путей относятся к версии Alpha.HMI для Windows.

Клавиатура поддерживает два режима работы:

  • Базовый режим — все пользователи имеют полный доступ к настройкам.
  • Защищённый режим — доступ к настройкам ограничен правами пользователя через Alpha.Security (право Настройка клавиатуры EditSettings).

Базовый запуск

Для простого запуска клавиатуры с параметрами по умолчанию:

  1. Добавьте на форму проекта Alpha.HMI компонент Окружение: процесс.

  2. В обработчике события (например, ButtonPressed) укажите путь к исполняемому файлу и запустите процесс:

    Process_1.Path = "C:\\Program Files\\Automiq\\Alpha.HMI\\alpha.hmi.keyboard.exe";
    Process_1.Run();

    Исполняемый файл alpha.hmi.keyboard.exe устанавливается автоматически вместе с Alpha.HMI и располагается в каталоге установки программы.

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

Запуск с ограничением доступа (защищённый режим)

По умолчанию окно Настройки экранной клавиатуры доступно всем пользователям. Чтобы ограничить доступ и включить проверку прав, добавьте аргумент --use-security в свойство Аргументы запуска компонента Окружение: процесс.

В защищённом режиме контроль прав выполняется через подсистему Alpha.Security. Проверка осуществляется по праву Настройка клавиатуры (EditSettings).

Экранная клавиатура не содержит встроенного механизма авторизации. При запуске с аргументом --use-security используется текущая авторизованная сессия Alpha.Security.

Право Описание
Настройка клавиатуры (EditSettings) Определяет, может ли пользователь открывать окно Настройки и изменять параметры клавиатуры. При наличии права кнопка Настройки активна, при отсутствии — заблокирована.

Настройка прав доступа

Для управления доступом к настройкам клавиатуры используется подсистема Alpha.Security. Права можно назначить в приложениях:

  • Alpha.HMI.SecurityConfigurator – новый конфигуратор, рекомендованный к использованию;
  • SecurityConfigurator – классическая версия конфигуратора.

Права для клавиатуры входят в шаблон приложения Alpha.HMI.Keyboard, поставляемый вместе с дистрибутивом Alpha.HMI.SecurityConfigurator.

Расположение шаблона:

  • ОС Windows: C:\ProgramData\Automiq\HMI.SecurityConfigurator\AppTemplates
  • OC Linux: /usr/local/share/Automiq/HMI.SecurityConfigurator/AppTemplates

Чтобы назначить пользователям права:

  1. Откройте Alpha.HMI.SecurityConfigurator.
  2. Импортируйте шаблон приложения Alpha.HMI.Keyboard.

  3. Назначьте права из шаблона нужным пользователям или группам.

Подробная инструкция по импорту шаблона, созданию групп пользователей и назначению прав описана в документации Alpha.Security.

Запуск клавиатуры с контролем доступа

После настройки прав в Alpha.HMI.SecurityConfigurator запустите клавиатуру с аргументом --use-security:

  1. Добавьте на форму компонент Окружение: процесс.
  2. В обработчике события (например, ButtonPressed) укажите путь к исполняемому файлу клавиатуры:

    Process_1.Path = "C:\\Program Files\\Automiq\\Alpha.HMI\\alpha.hmi.keyboard.exe";
    Process_1.Arguments = "--use-security";
    Process_1.Run();

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

Определение расположения и размеров окна клавиатуры при запуске

Для настройки позиции и размеров окна укажите соответствующие аргументы в свойстве Аргументы запуска компонента Окружение: процесс.

Аргумент Описание Пример значения
--window-pos-x VALUE Координата X верхнего левого угла окна (в пикселях). --window-pos-x 100
--window-pos-y VALUE Координата Y верхнего левого угла окна (в пикселях). --window-pos-y 200
--window-width VALUE Ширина окна (в пикселях). --window-width 800
--window-height VALUE Высота окна (в пикселях). --window-height 300

Примеры запуска с аргументами

Установить начальную позицию окна (X: 100, Y: 200):

Process_1.Path = "C:\\Program Files\\Automiq\\Alpha.HMI\\alpha.hmi.keyboard.exe";
Process_1.Arguments = "--window-pos-x 100 --window-pos-y 200";
Process_1.Run();

Установить размеры окна (ширина: 800, высота: 300):

Process_1.Path = "C:\\Program Files\\Automiq\\Alpha.HMI\\alpha.hmi.keyboard.exe";
Process_1.Arguments = "--window-width 800 --window-height 300";
Process_1.Run();

Установить позицию и размеры окна одновременно:

Process_1.Path = "C:\\Program Files\\Automiq\\Alpha.HMI\\alpha.hmi.keyboard.exe";
Process_1.Arguments = "--window-pos-x 100 --window-pos-y 200 --window-width 800 --window-height 300";
Process_1.Run();

Настройка интерфейса клавиатуры

Для открытия настроек нажмите кнопку Настройки на клавиатуре.

В базовом режиме (без аргумента --use-security) кнопка Настройки доступна всем пользователям. Если требуется ограничить доступ к настройкам только для определённых пользователей (например, администраторов), см. раздел Запуск с ограничением доступа.

Основные настройки

Параметры окна:

Параметр Описание Значение по умолчанию
Показывать заголовок окна Отображает верхнюю панель окна с его названием. Да
Показывать кнопку "свернуть" Добавляет в окно кнопку для сворачивания. Да
Показывать кнопку "развернуть" Добавляет кнопку для разворачивания окна на весь экран. Да
Показывать кнопку "закрыть" Отображает кнопку закрытия окна. Да
Разрешить изменение размеров окна Позволяет изменять размеры окна вручную. Да
Разрешить перемещение окна Включает возможность перемещения окна по экрану. Да

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

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

Настройки клавиатуры:

Параметр Описание Значение по умолчанию
Шрифт Задаёт тип шрифта, используемый для отображения символов на клавиатуре. Arial
Скорость ввода Определяет задержку между вводом символов (значение в миллисекундах). 50
Подсвечивать клавиши ввода При активации выделяет визуально клавиши при нажатии. Да

Настройки палитры

В этой вкладке настраивается цветовая схема элементов клавиатуры. Можно изменить цвет для каждого элемента интерфейса:

Роль цвета Назначение
Главный фон Определяет цвет фона клавиатуры.
Нажатая клавиша Цвет клавиши в момент нажатия.
Дополнительный текст Цвет дополнительного текста на клавишах.
Основной текст Цвет основного текста на клавишах.
Отпущенная клавиша Цвет клавиши в неактивном состоянии.
Наведение на клавишу Цвет подсветки клавиши при наведении курсора.