Alpha.Community

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

История изменений

3.0

Улучшения

  • Типу Тема оформления добавлено новое свойство Масштаб. У форм, к которым применена тема оформления, масштаб изменяется в соответствии со значением этого свойства.
  • Типу Утилиты для работы с окном добавлены новые функции:
    • GetViewSettings() – возвращает JSON-строку с описанием положения, размеров и состояния окна;
    • UpdateView() – применяет к окну настройки положения, размера и состояния, заданные в виде JSON-строки.

Исправление

Исправлено отображение кнопок у компонента Редактор целого числа.

3.0.1

Улучшение

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

  • свойство pValidate – ссылка на обработчик события возникновения ошибки;
  • функция CheckInterval(), возвращающая текст ошибки при ее возникновении.

Исправления

Изменения документации

Редакция 1

В справочном руководстве описаны новые:

Редакция 2

В справочном руководстве актуализированы перечни свойств и функций для компонентов:

2.4

Новая возможность

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

Улучшения

  • В Редактируемой таблице теперь:
    • При выделении ячеек можно скопировать их текст в буфер обмена или выполнить пользовательский сценарий, используя свойство Копировать (pCopyToClipboard) или сочетание горячих клавиш Ctrl + C.
    • По нажатию сочетания "горячих" клавиш Ctrl + "Вверх" или Ctrl + "Вниз" можно переместить строку выше или ниже, либо выполнить пользовательский сценарий. При этом следует активировать возможность перемещения строк, указав в свойстве Возможность перемещения строк (CanMoveRows) значение true.
    • Можно переопределить обработку нажатия клавиш в редактируемой таблице, указав в свойстве Событие нажатия клавиши (pKeyPress) ссылку на пользовательский обработчик события. В этом обработчике можно использовать аргументы возникшего события. Эти аргументы содержат код нажатой клавиши и код клавиш-модификаторов.
    • Можно удалять выделенные строки по нажатию клавиши Delete при условии, что свойство Поведение выделения (SelectionBehavior) принимает значение Выделять строки.
    • Расширен набор встроенных редакторов значений ячейки таблицы – теперь можно использовать редактор целого числа, редакторы даты и времени, редактор даты и редактор времени.
  • В Редактор целого числа, Редактор даты, Редактор времени, Редактор даты и времени добавлено свойство Событие нажатия клавиши (pKeyPress), в котором можно указать ссылку на пользовательский обработчик события. В этом обработчике события можно использовать аргументы возникшего события. Эти аргументы содержат код нажатой клавиши, код клавиш-модификаторов, флаг удержания клавиши или сочетания любых клавиш, текст клавиши.
  • В Журнал сообщений:
    • Добавлено контекстное меню журнала сообщений, в котором можно скопировать выделенные сообщения, скопировать описание сообщения, сохранить журнал сообщений в файл, очистить список сообщений.
    • Можно скопировать сообщения в буфер обмена. По команде контекстного меню Копировать выделенные сообщения в буфер обмена будет помещен текст выделенных ячеек таблицы, разделенный символом табуляции. По команде контекстного меню Копировать описание или нажатию сочетания клавиш Ctrl + C в буфер обмена будет помещено только описание текущего сообщения.
    • Добавлено свойство Внешний вид изменен (pViewChanged), в котором можно сослаться на экземпляр типа Команда. Эта команда будет активироваться при: изменении ширины столбцов; включении и отключении отображения какого-либо типа сообщения; включении и отключении автоматического прокручивания списка сообщений; выборе пути и типа файла в диалоге экспорта в файл; поиске в описании сообщения. Получить измененные настройки внешнего вида журнала сообщений можно в обработчике события Invoked экземпляра типа Команда.
  • В рантайме теперь можно настраивать высоту и ширину элементов Кнопка панели инструментов, Кнопка выпадающего списка и Разделитель панели инструментов. Для этого можно использовать в функции или обработчике события значения свойств ButtonWidth и ButtonHeight компонентов Кнопка панели инструментов и Кнопка выпадающего списка, а также свойство ButtonHeight компонента Разделитель панели инструментов.
  • В Дереве сигналов теперь с помощью свойства Фильтр можно настроить отображение сигналов – с историей значений и те, которые являются источниками событий.

Исправления

2.4.1

Улучшение

При выполнении поиска в Дереве сигналов по значению уведомляющего поля OperationInProgress можно определить статус поиска (завершен или еще выполняется).

Исправление

Устранена причина, по которой некорректно выполнялось перемещение строк таблицы при использовании клавиш клавиатуры.

2.4.2

Улучшение

Формат иконок компонентов расширения изменен на SVG. Ранее использовался формат PNG.

Изменения документации

Редакция 1

Актуализировано справочное руководство:

Редакция 2

В справочном руководстве:

  • Актуализировано описание компонента Редактор ячейки таблицы: добавлен пример его использования в проектах Alpha.HMI, также описано новое свойство PossibleValues.
  • Для компонента Дерево сигналов описано новое свойство Выполняется операция.

2.3

Улучшения

  • В Журнале сообщений теперь можно увеличить количество отображаемых строк, указав нужное значение в свойстве Максимальное количество строк (MaxRowCount). При превышении указанного здесь количества строк устаревшие сообщения будут автоматически удалены.
  • Типу Редактируемая таблица добавлены новые свойства и функции для настройки сохранения и восстановления ширины столбцов: GetViewSettings(), UpdateView(), pViewChanged, pColumnWidthChanged.

Изменения документации

Редакция 1

В справочном руководстве:

2.2

Новая возможность

Разработан новый тип – Редактируемая таблица с возможностью редактирования значений ячеек. В экземпляре типа можно:

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

Улучшения

  • Теперь можно настраивать открытие диалогового окна по центру родительского компонента. Для этого компонентам-диалогам добавлено свойство-ссылка на родительский компонент pParent.
  • Положение Диалог смены пароля теперь зависит от положения Диалог авторизации пользователя, из которого оно открывается.
  • Высоту окна Редактор колонтитула теперь можно менять.
  • Добавлена возможность проверять и устанавливать фокус в Редактор целого числа. Для этого добавлены свойство IsFocused (В фокусе ввода) и функция SetFocus().
  • Типу Утилиты для работы с окном добавлена функция FitToRect(), которая размещает форму в центре заданного прямоугольника.
  • Типу Конвертер значений добавлена функция GetVariantDataType(), которая возвращает тип данных переменной variant в строковом виде.

Изменения документации

Редакция 1

В справочном руководстве:

Редакция 2

  • В справочное руководство добавлено описание типа Рамка с ошибкой.
  • В прикладываемых к документации проектах-примерах обновлена версия подключенного модуля CommonLib.

2.1

Новые возможности

  • Добавлены новые компоненты:
    • Редактор даты и времени, предназначенный для ввода даты и времени в виде день:месяц:год и часы:минуты:секунды.
    • Тип Нажата клавиша CapsLock, предназначенный для отображения предупреждения о включенном CapsLock, например, в диалоговых окнах.
  • В Редактор даты и Редактор времени добавлены:
    • свойство pGotFocus – ссылка на команду, которая должна вызываться при получении фокуса у поля ввода редактора;
    • функция SetFocus(), устанавливающая фокус на поле ввода редактора;
    • свойство LastFocused, хранящее информацию о поле, в котором находится фокус (или находился в последний раз).

Исправление

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

2.1.1

Новые возможности

  • Создан новый компонент Утилиты для работы с файлами. С помощью функций компонента ReadFromFile() / WriteToFile() можно быстро прочитать/записать указанный во входных параметрах текстовый файл.
  • Функция GetCurrentItemInfo() компонента Дерево сигналов теперь может предоставлять данные не только о сигналах, но и о папках. Информация о папках также доступна в аргументах обработчиков событий pDragStarted и pDoubleClicked.
  • Функция GetCurrentItemInfo() компонента Дерево сигналов теперь предоставляет больше данных о выделенном сигнале:
    • доступна ли запись значений (атрибут isWritable);
    • ведется ли запись истории значений (атрибут isHistorized);
    • является ли сигнал источником событий (атрибут isEventSource).

    Эта информация также доступна в аргументах обработчиков событий pDragStarted и pDoubleClicked дерева.

  • В Дерево сигналов добавлено новое свойство – Показывать столбец атрибутов (ShowAttributesColumn). Если выставить для него значение "true", то справа от названия каждого сигнала в дереве будет отображен столбец с иконками атрибутов сигнала. По иконкам можно будет понять, является ли сигнал источником событий, и ведется ли для него запись истории значений.
  • В Панель поиска добавлены:
    • свойство pGotFocus – ссылка на команду, которая должна вызываться при получении фокуса у панели поиска;
    • функция SetFocus(), устанавливающая фокус на панели поиска.
  • Типу Конвертер значений добавлена функция QualityCodeToString(), предоставляющая описание качества сигнала на основе его числового кода.

Исправления

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

2.1.2

Улучшения

  • В типе Дерево сигналов теперь:
    • При наведении курсора на узел всплывает подсказка с названием и описанием узла.
    • В результатах поиска по дереву отображаются теги вместо имен для найденных сигналов.
    • Сигналы-массивы помечены специальной иконкой.
  • В типе Диалог подключения к серверу для удобства переставлены поля ввода: теперь сначала указывается порт, затем – порт истории.
  • Компоненту Утилиты для работы с файлами добавлены ссылка на обработчик события pErrorOccurred и свойство LastError. С помощью них можно получить описание ошибки, возникшей в результате работы с файлами.

Исправления

  • Для типа Дерево сигналов устранена причина моргания иконок атрибутов сигнала (наличие истории, источник событий), возникавшего в Alpha.HMI.WebViewer.
  • Устранена причина, по которой кнопки, добавленные на Панель инструментов, отображались некорректно после нескольких переключений у них значения свойства Enabled.

2.1.3

Улучшения

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

  • В Диалоге авторизации пользователя кнопка смены пароля стала недоступной для пользователей, импортированных из домена, так как менять пароли для таких пользователей следует средствами ОС.

Изменения документации

Редакция 1

Описаны ранее не описанные функции Light(), Gray() и Dark() компонента Тема оформления.

Редакция 2

Редакция 3

В справочном руководстве:

Редакция 4

В справочном руководстве для типа Утилиты для работы с файлами описаны новые свойства pErrorOccurred и LastError.

Редакция 5

2.0

Изменения

  • Англоязычные названия компонентов заменены русскоязычными.
  • Для корректной работы компонента Дерево сигналов (ItemTree) в свойствах pDragStarted и pDoubleClicked вместо ссылок на экземпляр типа Команда необходимо указывать ссылки на экземпляр нового типа Обработчик события, описанный в блоке "Новые возможности".
  • У компонентов Редактор времени (TimeEditor), Редактор даты (DateEditor) и Редактор интервала времени (IntervalEditor) удалено свойство IsVisible. Вместо него достаточно использовать стандартное свойство Visible.
  • Компонент Редактор интервала времени (IntervalEditor) теперь использует шрифт и цвет фона из указанного экземпляра типа Тема.

Новые возможности

  • Созданы новые компоненты библиотеки:
    • Обработчик события, позволяющий создать пользовательское событие с возможностью передачи его аргументов;
    • Редактор колонтитула, позволяющий создавать колонтитулы, например, для таблиц, при сохранении в файл или при печати на принтере;
    • Тип Текстовые шаблоны, представляющий собой набор текстовых шаблонов, которые могут быть подставлены, например, в текст колонтитула;
    • Компоненты Горизонтальный сплиттер и Вертикальный сплиттер, предназначенные для разделения области пользовательского интерфейса на две части с возможностью изменять размеры этих частей с помощью мышки.
  • Расширены возможности применения компонента Тема оформления:
    • Добавлены свойства для цветового оформления панели инструментов;
    • Добавлены свойства для цветового оформления меню.
  • Добавлен вспомогательный тип Тема оформления панели инструментов, позволяющий менять тему оформления визуальных компонентов, добавленных на панель инструментов.

Исправления

  • Добавлена проверка существования папки в диалогах открытия и сохранения файлов. Ранее при указании пустого пути или несуществующей папки была доступна кнопка Сохранить, а при ее нажатии в разных случаях появлялись сообщения об успешном сохранении файла или об ошибке.
  • Устранена причина, по которой экранная клавиатура в AstraLinux открывалась только при первом нажатии Кнопка вызова экранной клавиатуры.

2.0.1

Новые возможности

  • Для компонента Дерево сигналов реализованы функции Find(pattern: string) и CancelFind(). Первая предназначена для поиска сигналов в дереве по шаблону названия, вторая - для отмены поиска.
  • Компоненту Редактор интервала времени добавлено свойство-ссылка на событие pShiftCompleted. Указанное событие активируется только при смещении интервала времени с помощью кнопок "Перейти к предыдущем интервалу времени" и "Перейти к следующему интервалу времени".

Улучшения

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

Исправления

  • Дерево сигналов теперь очищается в процессе подключения к новому серверу.
  • Пустое Меню теперь не открывается. Ранее меню, не содержавшее элементов, открывалось в виде короткой полосы толщиной в один пиксель.

2.0.2

Новая возможность

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

Улучшение

Улучшено выполнение функции FitToMonitor() компонента Утилиты для работы с окном: при размещении окна на указанном мониторе теперь учитываются примерные толщина границ и высота заголовка окна.

Исправление

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

Изменения документации

Редакция 1

В руководстве пользователя обновлена иллюстрация юнита внешнего модуля CommonLib.

В справочном руководстве:

Редакция 2

В справочном руководстве:

Редакция 3

  • В справочном руководстве для компонента Утилиты для работы с окном добавлены описания новой функции GetMonitorForRect() и ранее не описанной функции FitFormSize().
  • Обновлен проект-пример, прикладываемый к разделу Выбор цвета на панели инструментов из палитры или из меню руководства пользователя. В проекте устранена ошибка, возникавшая в журнале времени исполнения, но не влиявшая на работоспособность проекта.
  • Бывший раздел "Приложения" переименован в "Примеры использования компонентов расширения".

1.7

Новая возможность

Создан новый компонент - кнопка вызова экранной клавиатуры Кнопка вызова экранной клавиатуры. Экземпляр кнопки следует использовать совместно с новым типом - Параметры вызова экранной клавиатуры. Кнопка добавлена в:

  • диалоги авторизации (LoginDialog, ChangePasswordDialog);
  • диалог подключения к серверу (ConnectDialog, CredentialsDialog);
  • диалог ввода значения (InputDialog);
  • диалоги открытия и сохранения файла (OpenFileDialog, SaveFileDialog).

Чтобы кнопка отобразилась в указанных диалоговых окнах, сошлитесь на экземпляр типа Параметры вызова экранной клавиатуры, где в свойстве Enabled (Включено) укажите значение true.

Улучшение

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

  • в диалоге ввода значения (InputDialog);
  • в диалоге подключения к серверу (ConnectDialog);
  • в диалоге смены пароля (ChangePasswordDialog);
  • в редакторе интервала времени (IntervalEditor);
  • у индикатора подключения (ConnectionIndicator).

При этом для индикации ошибок ввода используется новый компонент – ErrorFrame. Он используется для отображения всплывающей подсказки под полем ввода без наведения мыши.

1.7.1

Исправления

  • Календарь в редакторе даты Редактор даты не окрашивался в цвета выбранной темы оформления.
  • Всплывающая подсказка с текстом ошибки не всегда отображалась при изменении текста ошибки.
  • Исключена вероятность сохранения файла с пустым именем в окне Диалог сохранения файла, когда в поле ввода имени указана только часть пути к файлу.
  • Устранена причина повторного входа в подсистему безопасности при использовании клавиши Enter в окне авторизации пользователя Диалог авторизации пользователя.

1.7.2

Внутренние изменения. Функциональность компонента не изменилась.

1.7.3

Улучшение

Теперь при авторизации пользователя после изменения парольных политик в окне Диалог авторизации пользователя предлагается сменить пароль, если старый пароль не подходит новым парольным политикам. Ранее в таком случае возникала ошибка.

Изменения документации

Редакция 1

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

В справочном руководстве:

  • Описаны новые компоненты Кнопка вызова экранной клавиатуры и Параметры вызова экранной клавиатуры.
  • Для компонентов, предполагающих ввод значений, описано новое свойство init_ScreenKeyboard (Вызов экранной клавиатуры), позволяющее отобразить кнопку вызова экранной клавиатуры. Это:
    • диалоги авторизации (LoginDialog, ChangePasswordDialog);
    • диалог подключения к серверу (ConnectDialog, CredentialsDialog);
    • диалог ввода значения (InputDialog);
    • диалоги открытия и сохранения файла (OpenFileDialog, SaveFileDialog).
  • Обновлено описание компонента Результат выбора цвета. Ранее писалось, что компонент сам сохраняет пользовательскую палитру в файл colors.json в папке проекта. Это не так, пользовательская палитра сохраняется только в значении свойства CustomColors. Как сохранить пользовательскую палитру в файл теперь описано в Выбор цвета на панели инструментов из палитры или из меню.
  • Порядок разделов с описаниями компонентов изменился. Ранее разделы были расположены в порядке алфавита, теперь порядок соответствует интерфейсу библиотеки, подключенной к проекту Alpha.HMI.

Редакция 2

В справочном руководстве:

1.6

Важно. Текущая версия предназначена для использования c Alpha.HMI 2.0.

Новые возможности

  • Разработан новый компонент – диалог указания учетных данных Диалог ввода учетных данных. Диалог используется для указания учетных данных при подключении к защищенному паролем серверу.
  • Теперь элемент меню можно настроить так, чтобы в его правой части отображалось текстовое описание сочетания "горячих" клавиш (например, "Сохранить Ctrl+S").
  • В диалоге открытия файлов Диалог открытия файла появилась кнопка Параметры. Видимость кнопки можно изменить в значении свойства Отображать кнопку Параметры (EditSettingsAllowed). Команда, выполняемая в результате нажатия кнопки, указывается в свойстве OnEditSettings.

Исправления

  • Дата в календаре, размещенном на форме, теперь отображается корректно.
  • Устранено предупреждение об устаревшем элементе DataSource.Browser.GetChildren. Вместо метода GetChildren теперь используется GetChildrenWithRequestId, который стал доступен в Alpha.HMI 2.0.

1.6.1

Исправления

  • Ширина контекстного меню теперь лучше подстраивается под длину текста в элементах меню.
  • При использовании Диалог ввода учетных данных для подключения к серверу, не требующему пароля, в журнале сообщений больше не возникает ненужное предупреждение "Неизвестный ответ сервера на попытку авторизации (возможно, сервер не требует авторизации)".
  • Исправлена ошибка, из-за которой в дереве сигналов Дерево сигналов не работало перетаскивание сигнала или двойной клик по нему, если в названии сигнала присутствовали кавычки.
  • Устранена причина, по которой в ОС Linux перемещение по элементам контекстного меню Меню с помощью клавиатуры сбивалось при использовании клавиши "Влево".

Изменения документации

Редакция 1

В справочном руководстве:

  • Описан новый компонент – окно для ввода учетных данных при подключении к серверу Диалог ввода учетных данных и его свойства. Также обновлено описание и скриншоты окна подключения к серверу – Диалог подключения к серверу.
  • Для элемента меню Элемент меню описано новое свойство – KeyGesture. Свойство позволяет добавить в правую часть элемента меню текстовое описание сочетания "горячих" клавиш. Также обновлено описание свойства Items компонента Меню – здесь текст для правой части элемента меню указывается в JSON-параметре keyGesture.
  • Описано новое свойство компонента Диалог открытия файла – Отображать кнопку Параметры (EditSettingsAllowed).
  • Для компонента Дерево сигналов пример использования функции GetCurrentItemInfo() переписан на язык JavaScript. Так как функция возвращает JSON-строку, то для ее обработки требуется разбор.

Редакция 2

Внутренние изменения. Содержимое документа не изменилось.

1.5

Новые возможности

  • Разработаны новые компоненты:
    • IntervalEditor – редактор интервала времени;
    • ConnectDialog – диалог подключения к серверу;
    • EventArgs – буфер аргументов событий.
  • Реализованы новые функции компонента Converter:
    • Convert(), конвертирующая значение внутри типа variant в значение указанного типа;
    • VariantToLocalizedString(), преобразовывающая значение типа variant в строку с учетом региональных настроек.

Улучшение

Иконка индикатора подключения к серверу ConnectionIndicator теперь меняется при подключении к резервному серверу.

Исправленная ошибка

В окне календаря даты больше не сбиваются при переключении месяца.

1.5.2

Новая возможность

Разработан вспомогательный тип Информация о продукте.

Улучшение

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

Исправления

  • В окне ввода значений Диалог ввода значения числа, содержащие единицу ("1"), отображались некорректно.
  • В окне подключения к серверу Диалог подключения к серверу номер порта теперь отображается корректно - без учета знака разделителя групп разрядов, указанного в региональных настройках.

Изменения документации

Редакция 1

В справочном руководстве:

  • описаны новые компоненты IntervalEditor и ConnectDialog;
  • описаны новые функции компонента Converter: Convert() и VariantToLocalizedString().

Во всем документе актуализированы скриншоты.

Редакция 2

В разделе Подготовка к работе исправлены команды удаления расширения на ОС Linux.

В справочном руководстве описаны:

1.4

Новые возможности

  • Стал доступен для использования компонент Список файлов, отображающий список файлов из указанной папки. Компонент можно применить, например, при разработке собственных файловых диалогов.
  • Файловым диалогам Диалог открытия файла и Диалог сохранения файла добавлено свойство DefaultFileName. Значение свойства используется в поле ввода имени файла при открытии диалога.
  • В типе Результат выбора меню реализовано уведомляющее поле UpdateItems, которое позволяет обновлять элементы меню после его открытия. Используется, например, если выбор одного пункта меню должен приводить к изменению других пунктов меню: их заголовков, иконок, доступности.
  • В тип Тема оформления добавлены свойства Font (Шрифт) и TitleFont (Шрифт заголовков). Это позволяет менять шрифты заголовков и основного текста в компонентах LogView, ItemTree, OpenFileDialog, SaveFileDialog и SelectFolderDialog.
  • Появился компонент для преобразований строковых значений – Утилиты для работы со строками.

Улучшение

В окне Диалог авторизации пользователя, если нажата клавиша CapsLock, теперь появляется соответствующее предупреждение.

Исправленные ошибки

  • При использовании сенсорного экрана контекстное меню открывалось сразу в нескольких экземплярах, а при клике мышью вне его границ - не закрывалось.
  • Если контекстное меню открывалось рядом с панелью задач, то перекрывалось ею. Теперь контекстное меню открывается в зоне видимости.
  • При увеличении размера диалога Диалог ввода значения красная рамка, указывающая на ошибку ввода, не увеличивалась вместе с полем ввода.

1.4.1

Исправления

  • Ранее в окнах Список файлов Диалог открытия файла и Диалог сохранения файла отображались файлы только тех типов, которые были указаны в свойстве FileTypeFilter (Фильтр типа файлов), а если значение не было указано, файлы не отображались вовсе. Теперь, если оставить значение свойства пустым, в указанных диалогах будут отображаться файлы всех типов.
  • Исправлена ошибка, из-за которой при закрытии подменю клавишей "Влево" меню закрывалось полностью.
  • Устранена причина, по которой при работе в Alpha.HMI.WebViewer меню не закрывалось, если с ним не взаимодействовать.

Изменения документации

Редакция 1

В руководстве пользователя описан процесс обновления расширения в проекте Alpha.HMI.

В справочнике API:

  • описаны:
  • приведены описания неописанных ранее свойств для компонентов:
    • ChangePasswordDialog (UserId и UserDisplayName);
    • ColorDialogResult (Color и CustomColors);
    • FileDialogResult (FolderPath, FileName, FilePath, FileType);
    • LoginButton (ShowDialogOnTop);
    • LoginDialogResult (UserId и UserDisplayName);
    • OpenFileDialog и SaveFileDialog (OnPathChosen).
  • актуализированы типы значений для всех свойств всех компонентов.

Во всем документе актуализированы скриншоты.

Редакция 2

Актуализировано описание свойства FileTypeFilter (Фильтр типа файлов) компонентов Список файлов Диалог открытия файла и Диалог сохранения файла.

1.3

Реализованы новые компоненты:

В дереве сигналов Дерево сигналов:

1.3.1

Улучшения:

  • Реализована возможность перемещения по контекстному меню с помощью клавиатуры.
  • Улучшена корректировка положения окна с помощью вспомогательного типа Утилиты для работы с окном.

Исправленные ошибки:

  • Исправлено невыполнение команд подменю в Linux.
  • Панель поиска больше не очищается при щелчке по кнопке с лупой.
  • В файловых диалогах исправлено некорректное формирование пути до папки.

1.3.2

Новые возможности:

  • В файловых диалогах доступ пользователя к файловой системе теперь можно ограничить одной папкой. Компонентам Диалог открытия файла и Диалог сохранения файла добавлено свойство ChangeFolderAllowed (Разрешена смена папки), определяющее возможность смены папки, открываемой по умолчанию.

Исправленные ошибки:

  • Новая папка, создаваемая в диалоговом окне выбора папки, стала отображаться в дереве сразу после её создания.
  • Устранена причина, по которой при работе в Alpha.HMI.WebViewer двойной клик в дереве сигналов не приводил к выбору сигнала.
  • Перемещение по контекстному меню с помощью клавиатуры теперь работает корректно:
    • контекстное меню больше не закрывается при нажатии стрелки влево - а только при нажатии Esc;
    • пункт контекстного меню больше не выполняется при нажатии стрелки вправо - а только при нажатии Enter;
    • если у выбранного клавишами пункта меню есть подменю, то теперь оно открывается при нажатии стрелки вправо с выделением первого пункта подменю.

1.3.3

Улучшения:

  • При проверке числа на соответствие типу данных с помощью Конвертер значений дробные числа теперь можно вводить как с точкой, так и с запятой.
  • Для дерева сигналов Дерево сигналов реализована новая ссылка на команду pMouseRightClicked, с помощью которой можно вызывать контекстное меню по щелчку ПКМ.
  • В окнах Диалог открытия файла и Диалог сохранения файла теперь можно настроить отображение даты изменения и размера файлов. Для этого реализовано новое свойство ShowFileProperties (Показывать свойства файлов).

Исправленные ошибки:

  • Исправлена ошибка, из-за которой в Alpha.HMI.WebViewer не выполнялись команды контекстного меню.
  • Устранена причина, по которой при навигации по контекстному меню с помощью клавиатуры в журнале времени исполнения возникала ошибка.

Изменения документации

Редакция 1

Справочник API:

  • добавлено описание новых компонентов расширения;
  • описаны новые свойства и функция компонента Дерево сигналов.

Редакция 2

Руководство пользователя:

Справочник API:

Редакция 3

Справочник API:

1.2

Реализованы новые компоненты:

Изменения документации

Редакция 1

Справочник API:

  • добавлено описание новых компонентов расширения;
  • описано общее свойство всех компонентов расширения Тема оформления.