Корневая панель

Корневая панель представляет собой особый тип контейнера Панель с дополнительными свойствами и событиями.

Общие свойства

Корневая панель поддерживает следующие общие свойства компонента виджет:

Ширина, Высота, Привязки, Фон, Непрозрачный, Граница, Курсор, Всплывающая посказка, Фокусируемый, Всплывающее меню

И следующие общие свойства контейнера:

Компоновка, Прокрутка, Автоматическое управление прокруткой

Пользовательские свойства

Данный раздел описывает свойства корневой панели виджета.

Игнорировать ошибки привязок

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

Имя свойства: ignoreBindingErrors

Тип свойства: Boolean

Все привязки

Данное свойство содержит список всех доступных привязок в шаблоне виджета. Более подробную информацию о привязках и их параметрах см. в статье Привязки.

Имя свойства: allBindings

Тип свойства: Data Table

Скрипты

Данное свойство содержит таблицу скриптов виджета. Она состоит из двух столбцов: Имя и Код.

Имя - это имя скрипта. Оно используется для ссылки на данный скрипт из привязок виджета.

Код содержит текст класса, реализующего интерфейс WidgetScript , т.е. код скрипта.  

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

Имя свойства: scripts

Тип свойства: Data Table

Обычные одновременно выполняемые привязки

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

Нулевое значение отключает обработку параллельных привязок.

Для более подробной информации см. Производительность привязок.

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

Имя свойства: normalConcurrentBindings

Тип свойства: Integer

Максимальные одновременно выполняемые привязки

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

Нулевое значение отключает обработку параллельных привязок.

Для более подробной информации см. Производительность привязок.

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

Имя свойства: maximumConcurrentBindings

Тип свойства: Integer

Максимальная длина очереди необработанных привязок

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

Для более подробной информации см. Производительность привязок.

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

Имя свойства: maximumBindingQueueLength

Тип свойства: Integer

Параллельные процессы привязок запуска

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

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

Имя свойства: startupBindingsConcurrency

Тип свойства: Boolean

Сенсорный экран

Настройки этой группы относятся к поддержке сенсорной панели.

Размер шрифта встроенной экранной клавиатуры

Определяет, какой шрифт используется для подписи клавиш экранной клавиатуры.

Имя свойства: embeddedOnscreenKeyboardFontSize

Тип свойства: Integer

Команда экранной клавиатуры

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

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

  • Отсутствует (вызывает использование собственной встроенной экранной клавиатуры SberMobile)

  • Экранная клавиатура Windows (C:Windows/system32/osk.exe)

  • Встроенный GNOME (onboard)

  • KDE Kvkbd (kvkbd)

  • Экранная клавиатура Mac OS (open -a KeyboardViewerServer)

Имя свойства: nativeOnscreenKeyboardCommand

Тип свойства: String

Cпециальные функции

Корневая панель имеет следующие специальные функции

Показать всплывающее окно

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

Имя функции: showPopup

Имя поля

Тип поля

Описание поля

widget

String

Полное имя контекста виджета для отображения как всплывающее окно.

defaultContext

String

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

customProperties

Data Table

Таблица дополнительных параметров. Будет применяться как таблица по умолчанию во всплывающем виджете.

Скрыть всплывающее окно

Позволяет скрыть текущее всплывающее окно.

Имя функции: hidePopup

Функция не имеет входных параметров

Выполнить действие

Позволяет выполнять действие из контекста.

Имя функции: executeAction

Имя поля

Тип поля

Описание поля

action

String

Имя вызываемого действия.

context

String

Полное имя контекста, где будет выполняться действие.

properties

Data Table

Таблица параметров действия. Будет передана действию в качестве параметров.

Общие события

Скрытие, Показ, Перемещение, Изменение размеров, Клик мыши, Нажатие кнопки мыши, Отпускание кнопки мыши, Вход мыши, Выход мыши, Перемещение мыши, Вращение колесика мыши, Печать клавиши, Нажатие клавиши, Отпускание клавиши, Получение фокуса, Потеря фокуса

Пользовательские события

Отправка

Данное событие активируется кнопкой действия Отправить в списке действий.

Имя события: submit

Выход

Данное событие активируется кнопкой действия Выход в списке действий.

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

Имя события: logout

Закрытие

Данное событие активируется кнопкой действия Закрыть в списке действий.

Имя события: close