События компонента
Компоненты виджета могут создавать события во время взаимодействия с пользователем. Например, событие Действие активируется, когда пользователь нажимает на него клавишей мыши.
Событие может определяться как активатор привязки. "Активатор" приводит к тому, что посредством привязки записываются данные с виджета в контекст сервера, затем они считываются из контекста и используются в качестве содержания виджета, возможны также другие формы обработки данных.
Предположим, мы имеем текстовое поле Имя, которое привязано к полю какой-либо переменной контекста (т.е. имя пользователя). Его привязка также определяет событие Активатор -- событие Действие кнопки Сохранить, расположенной рядом. Когда пользователь нажимает на данную кнопку, возникает следующая последовательность действий:
1) Сканируются все привязки виджета в поисках событий определенного для них активатора.
2) Система видит, что привязка текстового поля Имя имеет событие Действие, заданное в качестве "активатора".
3) Далее происходит выполнение привязки совместно с другими привязками, для которых данное событие является активатором (например, Фамилия). Простыми словами, данные в текстовых полях теперь записаны в базу данных.
Общие события компонентов
Данный раздел описывает события, поддерживаемые большинством компонентов виджета. Отдельное описание каждого компонента включает список общих событий.
Скрытие
Данное событие активируется, когда компонент убирается с экрана.
Имя события: hidden
Поля события:
Поле | Имя | Тип | Описание |
идентификатор | id | целое | Идентификатор типа события. |
Показ
Данное событие активируется, когда компонент появляется на экране.
Имя события: shown
Поля события:
Поле | Имя | Тип | Описание |
идентификатор | id | целое | Идентификатор типа события. |
Перемещение
Данное событие активируется при перемещении компонента в контейнере-родителе.
Имя события: moved
Поля события:
Поле | Имя | Тип | Описание |
идентификатор | id | целое | Идентификатор типа события. |
Изменение размеров
Данное событие активируется при изменении размера компонента.
Имя события: resized
Поля события:
Поле | Имя | Тип | Описание |
идентификатор | id | целое | Идентификатор типа события. |
Ширина | width | Integer | Новая ширина компонента. |
Высота | height | Integer | Новая высота компонента. |
Клик мыши
Данное событие активируется при щелчке мыши по компоненту.
 | Событие не активируется, если между нажатием и отпусканием кнопки мыши было движение мыши. |
| Используйте это событие для реагирования на одиночные и тройные щелчки. Для двойных щелчков используйте событие Двойной клик мыши. |
Имя события: mouseClicked
Параметры: см. событие мыши.
Двойной клик мыши
Данное событие активируется при двойном щелчке мыши по компоненту.
Имя события: mouseDoubleClicked
Параметры: см. событие мыши.
Нажатие кнопки мыши
Данное событие активируется при нажатии кнопки мыши по компоненту.
Имя события: mousePressed
Параметры: см. событие мыши.
Отпускание кнопки мыши
Данное событие активируется при отпускании нажатой кнопки мыши.
Имя события: mouseReleased
Параметры: см. событие мыши.
Вход мыши
Данное событие активируется при появлении курсора мыши в области компонента.
Имя события: mouseEntered
Параметры: см. событие мыши.
Выход мыши
Данное событие активируется при выходе курсора мыши из области компонента.
Имя события: mouseExited
Параметры: см. событие мыши.
Перемещение мыши
Данное событие активируется при перемещении курсора мыши по области компонента.
Имя события: mouseMoved
Параметры: см. событие мыши.
Вращение колесика мыши
Данное событие активируется при прокрутке колесика мыши в компоненте.
Имя события: mouseWheelMoved
Поля события: Событие "Вращение колесика мыши" имеет все поля обычного события мыши. К тому же оно определяет следующие поля:
Поле | Имя | Тип | Описание |
Размер прокрутки | scrollAmount | целое | Количество элементов, которые нужно прокрутить за один клик вращения мыши. Действует только если тип прокуртки - это "прокуртка элементов". |
Тип прокрутки | scrollType | целое | Тип прокрутки:
|
Вращение колесика | wheelRotation | целое | Количество "кликов", при которых вращается колесико. Отрицательные значения, если колесико мыши вращается вверх/в сторону от пользователя, и положительные значения, если колесико мыши вращается вниз/в сторону пользователя. |
Печать клавиши
Данное событие активируется при вводе символа кнопкой клавиатуры, когда компонент находится в фокусе.
Имя события: keyTyped
Параметры: см. событие клавиатуры.
Нажатие клавиши
Данное событие активируется при нажатии кнопки клавиатуры, когда компонент находится в фокусе.
Имя события: keyPressed
Параметры: см. событие клавиатуры.
Отпускание клавиши
Данное событие активируется при отпускании кнопки, когда компонент находится в фокусе.
Имя события: keyReleased
Параметры: см. событие клавиатуры.
Получение фокуса
Данное событие активируется, когда компонент получает фокус ввода.
Имя события: focusGained
Поля события:
Поле | Имя | Тип | Описание |
Идентификатор | id | целое | Идентификатор типа события. |
Временный | temporary | логическое | Определяет фокус события как временный или постоянный. |
Потеря фокуса
Данное событие активируется, когда компонент теряет фокус ввода.
Имя события: focusLost
Поля событий:
Поле | Имя | Тип | Описание |
Идентификатор | id | целое | Идентификатор типа события. |
Временный | temporary | логическое | Определяет фокус события как временный или постоянный. |