Alpha.Community

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

Взаимодействие с оборудованием

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

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

Примеры использования компонентов Оборудование: клавиатура и Оборудование: монитор представлены в демонстрационных проектах: настройка получения информации о раскладке клавиатуры и настройка получения информации о мониторах.

Сетевое окружение

Чтобы взаимодействовать с сетевым окружением, добавьте на экранную форму компонент Окружение: сеть. Компонент позволяет получить имя сетевого компьютера через свойство Имя компьютера и Полное имя компьютера.

При запуске проекта через Alpha.HMI.WebViewer компонент Окружение: сеть возвращает сетевую информацию о сервере, на котором работает Alpha.HMI.WebViewer, а не о компьютере пользователя, открывшего проект в браузере.

Компонент Окружение: сеть расположен в юните Окружениебиблиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

Клавиатура

Чтобы взаимодействовать с клавиатурой, добавьте на экранную форму компонент Оборудование: клавиатура.

При запуске проекта через Alpha.HMI.WebViewer компонент Оборудование:клавиатура недоступен. Все методы возвращают значения по умолчанию или пустые строки.

Компонент Оборудование: клавиатура расположен в юните Окружениебиблиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

С помощью этого компонента можно получить информацию о текущей раскладке клавиатуры (свойство Язык ввода), отслеживать нажатие клавиш с помощью функции KeyState(), переключать раскладку клавиатуры (функции NextLocale(), PrevLocale()).

Подробнее о свойствах, методах и событиях компонента Оборудование:клавиатура

Как настроить получение информации о раскладке клавиатуры (Демо-проект)

Ниже приведён пример (скачать его можно здесь) использования компонента Оборудование: клавиатура в проекте Alpha.HMI с использованием языка Alpha.Om.

В результате выполнения примера будет подготовлена форма, при открытии которой:

  • В текстовом поле отображается текущая раскладка клавиатуры (например, en-US).
  • В выпадающем списке доступны локализованные названия языков (Английский (США) и Русский (Россия)).
  • При выборе языка из выпадающего списка раскладка клавиатуры автоматически переключается.

Вывод текущей раскладки клавиатуры

  1. Добавьте на форму компонент Оборудование: клавиатура.

  2. Добавьте текстовое поле для отображения текущего кода раскладки.
  3. Чтобы получить текущий код раскладки клавиатуры и автоматически обновлять его при изменении, настройте обработчик события LocaleChanged для компонента Оборудование: клавиатура. Пример кода:

    // Получаем текущую раскладку клавиатуры
    Text_1.Text = Keyboard_1.Locale;

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

  1. Разместите на форме компонент Выпадающий список для отображения списка языков.

  2. Чтобы при открытии формы заполнить выпадающий список доступными языками, настройте обработчик события Opened. Пример кода:

    // Очищаем выпадающий список
    ComboBox_1.Clear();
    // Заполняем выпадающий список доступными языками
    // Здесь список языковых кодов задаётся вручную
    ComboBox_1.AddItem( Keyboard_1.LocalizedLanguageName("en-US") );
    ComboBox_1.AddItem( Keyboard_1.LocalizedLanguageName("ru-RU") );
    // Устанавливаем текущий язык в выпадающем списке
    currentLocale: string = Keyboard_1.Locale;
    currentLanguage: string = Keyboard_1.LocalizedLanguageName(currentLocale);
    // Находим индекс текущего языка в выпадающем списке ComboBox_1
    index: int4 = ComboBox_1.IndexOf(currentLanguage);
    // Если текущий язык найден в списке, устанавливаем его как выбранный
    if (index >= 0)
    {
    ㅤㅤComboBox_1.SelectedIndex = index;
    }

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

Чтобы при выборе языка из списка раскладка клавиатуры автоматически менялась, настройте обработчик события Activated для компонента Выпадающий список. Пример кода:

// Задаем доступные языки вручную
LocaleEn: string = "en-US";
LocaleRu: string = "ru-RU";
// Объявляем переменную для выбора нового языка
targetLocale: string = "";
// Получаем текущую раскладку клавиатуры
currentLocale: string = Keyboard_1.Locale;
// Определяем целевую раскладку по индексу
if (index == 0)
{
ㅤㅤtargetLocale = LocaleEn;
}
if (index == 1)
{
ㅤㅤtargetLocale = LocaleRu;
}
// Переключаем раскладку, если она отличается от текущей
if (targetLocale != "" && currentLocale != targetLocale)
{
ㅤwhile (currentLocale != targetLocale)
ㅤ{
ㅤㅤㅤKeyboard_1.NextLocale();
ㅤㅤㅤcurrentLocale = Keyboard_1.Locale;
ㅤ}
}
// Обновляем отображение текущей раскладки
Text_1.Text = currentLocale;

Монитор

Чтобы взаимодействовать с монитором (или группой мониторов многомониторной системы отображения), добавьте на экранную форму компонент Оборудование: монитор. Компонент невизуальный и виден только в области Структура объекта.

С помощью компонента можно получить информацию о доступных мониторах, их характеристиках (разрешение экрана, ширина и высота доступной рабочей области и др.), а также отслеживать изменения в их конфигурации.

При запуске проекта через Alpha.HMI.WebViewer компонент Оборудование: монитор работает с виртуальным монитором, соответствующим окну браузера.

Подробнее о методах и событиях компонента Оборудование: монитор

Как настроить получение информации о мониторах (Демо-проект)

Далее кратко описан небольшой пример (скачать его можно здесь) использования компонента Оборудование: монитор в проекте Alpha.HMI с использованием языка Alpha.Om.

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

В результате будет подготовлен проект, который позволит открывать формы MainForm и Form_1 на разных экранах, автоматически отображать информацию о подключенных мониторах и обновлять эти данные при изменении конфигурации мониторов.

Получить количество подключенных мониторов и вывести их характеристики

  1. Добавьте на форму текстовое поле, в которое будет выводиться информация о мониторах.

  2. Добавьте на форму компонент Оборудование: монитор.

  3. Создайте собственную функцию для получения информации о мониторах. Для этого вызовите контекстное меню в области Структура объекта и выберите Создать функцию. Эта функция будет использоваться для получения информации обо всех подключенных мониторах и отображения этой информации в текстовом поле. Ниже показан пример кода обработчика для функции Function_1()

    // Получение количества доступных мониторов
    monitorCount : int4 = MonitorList_1.Count();
    // Инициализация строки с информацией о мониторах
    monitorInfo: string = "Количество мониторов: " + String.ToString(monitorCount) + "\n";
    // Перебор всех мониторов и сбор их характеристик
    for ( i: int4 = 0; i < monitorCount; i += 1)
    {
    // Получение характеристик текущего монитора
    width: int4 = MonitorList_1.GetResolutionX(i);
    height: int4 = MonitorList_1.GetResolutionY(i);
    x: int4 = MonitorList_1.GetAvailableWidth(i);
    y: int4 = MonitorList_1.GetAvailableHeight(i);
    // Добавление информации о каждом мониторе к общей строке
    monitorInfo = monitorInfo + "Монитор " + String.ToString(i + 1) + ":\n"
    + " Разрешение: " + String.ToString(width) + "x" + String.ToString (height) + "\n"
    + " Рабочая область: (" + String.ToString(x) + ", " + String.ToString (y) + ")\n";
    }
    // Вывод информации в текстовое поле
    Text_1.Text = monitorInfo;
  4. Чтобы информация о мониторах выводилась сразу после открытия формы, в обработчике события Opened вызовите созданную функцию Function_1().

Настроить отслеживание изменений в конфигурации мониторов

Для отслеживания изменений в конфигурации мониторов используйте событие MonitorListChanged компонента Оборудование: монитор. В обработчике этого события вызовите ранее созданную функцию Function_1(), чтобы информация на форме автоматически обновлялась при изменении конфигурации мониторов.

Открыть экранную форму без перекрытия панелью задач

Чтобы открыть экранную форму без перекрытия системной областью (например, панелью задач), нужно знать координаты доступного верхнего левого угла экрана. Например, если панель задач расположена слева, следует учесть её отступы. Для этого выполните следующие шаги:

  1. Добавьте два объекта типа Уведомляющий int4 на экранную форму. Эти объекты будут использоваться для хранения значений координат доступного верхнего левого угла экрана. Для этого в Структуре объекта правой кнопкой мыши щелкните на MainForm → Создать. Откроется мастер создания элементов.
  2. В поле Тип элемента выберите Уведомляющее поле, Базовый тип элемента→ Уведомляющий int4→ Создать.

  3. Создайте новую форму. Для этого в Библиотеке компонентов во вкладке Проект щёлкните правым кликом мыши на Экранные формы → Создать форму.

  4. Добавьте компонент Команда на форму MainForm.

  5. В обработчике события Invoked компонента Команда настройте тип обработчика на Открыть в новом окне и укажите Form_1.

    1. Задайте начальное значение свойств X окна и Y окна формы Form_1, ссылаясь на созданные ранее объекты типа Уведомляющий int4. Для этого нажмите правой кнопкой мыши на начальное значение свойства X окна → Сослаться → notifying_int4_1. Аналогичным образом для свойства Y окна укажите ссылку на объект notifying_int4_2.

  6. В обработчике события MouseClick формы MainForm пропишите следующий код:

    notifying_int4_1 = MonitorList_1.GetAvailableX(0); // получаем координату по оси X верхнего левого угла доступной области экрана
    notifying_int4_2 = MonitorList_1.GetAvailableY(0); // получаем координату по оси Y верхнего левого угла доступной области экрана
    OpenForm.Invoke() // Вызов команды для открытия формы Form_1

Открыть две экранные формы на разных мониторах

Если у вас два монитора и требуется открыть две экранные формы на разных экранах, выполните следующие шаги:

  1. В обработчике события Invoked компонента Команда укажите в свойстве Монитор для формы Form_1 значение 1, чтобы вывести форму на первый монитор. Также убедитесь, что свойство Положение окна установлено в значение Вручную относительно монитора или По центру монитора, так как в иных случаях свойство Монитор будет игнорироваться.

  2. Убедитесь, что у формы MainForm в свойстве Монитор установлено значение 2. Это гарантирует, что главная форма будет отображаться на втором мониторе. Также установите свойство Положение окна на Вручную относительно монитора или По центру монитора, иначе форма не откроется на указанном мониторе.

  3. В обработчике события MouseClick формы MainForm измените код:

    notifying_int4_1 = MonitorList_1.GetAvailableX(1); // Получаем координату по оси X верхнего левого угла доступной области экрана для второго монитора
    notifying_int4_2 = MonitorList_1.GetAvailableY(1); // Получаем координату по оси Y верхнего левого угла доступной области экрана для второго монитора
    OpenForm.Invoke() // Вызов команды для открытия формы Form_1

    В этом коде индекс 1 у функций GetAvailableX() и GetAvailableY() указывает на второй монитор. В системах с несколькими мониторами мониторы нумеруются начиная с 0, где 0 — это первый монитор, 1 — второй монитор и так далее. Поэтому, чтобы получить координаты для второго монитора, используйте индекс 1.