Корневая панель
Корневая панель представляет собой особый тип контейнера Панель с дополнительными свойствами и событиями.
Общие свойства
Корневая панель поддерживает следующие общие свойства компонента виджет:
Ширина, Высота, Привязки, Фон, Непрозрачный, Граница, Курсор, Всплывающая посказка, Фокусируемый, Всплывающее меню
И следующие общие свойства контейнера:
Компоновка, Прокрутка, Автоматическое управление прокруткой
Пользовательские свойства
Данный раздел описывает свойства корневой панели виджета.
Игнорировать ошибки привязок
Если данная опция включена, любые ошибки привязок, возникающие во время выполнения виджета, не показываются пользователю в диалоговом окне сообщения об ошибке. Вместо этого они записываются в файл журнала или консоль оператора (см. тему Ведение журнала для получения более подробной информации). Если данная опция отключена (значение по умолчанию), ошибки привязки показываются пользователю и записываются в журнал.
Имя свойства: 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