Общие события компонентов

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

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

Щелчок мыши

Данное событие возникает, когда пользователь кликает левой кнопкой мыши по компоненту. генерируется только при возникновении событий Кнопка мыши нажата и Кнопка мыши отпущена в том же компоненте. Свойство компонента Генерировать событие "Щелчок мыши" должно быть установлено в значение True для генерации данного события.

Имя события:

mouseClicked

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

altDown

Boolean

Определяет была ли нажата клавиша Alt в момент возникновения события.

controlDown

Boolean

Определяет была ли нажата клавиша Control в момент возникновения события.

shiftDown

Boolean

Определяет была ли нажата клавиша Shift в момент возникновения события.

metaDown

Boolean

Определяет была ли нажата “Meta” клавиша в момент возникновения события. По умолчанию “Meta” клавиша - это клавиша “Windows” в операционной системе Windows и клавиша “Command” в MacOS. Так как в операционной системе обычно есть привязка к этой клавише, поле может иметь значение false даже когда пользователь нажал клавишу.

x

Integer

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

y

Integer

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

xOnScreen

Integer

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

yOnScreen

Integer

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

button

Integer

Целое число, указывающее какая кнопка мыши была нажата.

width

Integer

Ширина компонента в пикселях в момент возникновения события

height

Integer

Высота компонента в пикселях в момент возникновения события

top

Integer

Значение вертикальной координаты верхней части компонента относительно видимой области инструментальной панели.

bottom

Integer

Значение вертикальной координаты нижней части компонента относительно видимой области инструментальной панели.

right

Integer

Значение горизонтальной координаты правой части компонента относительно видимой области инструментальной панели.

left

Integer

Значение горизонтальной координаты левой части компонента относительно видимой области инструментальной панели.

name

String

Имя узла модели DOM, на который был наведен указатель в момент возникновения события.

textContent

String

Текстовое содержимое узла модели DOM, на который был наведен указатель в момент возникновения события.

attributesList

String

Список атрибутов JSON узла модели DOM, на который был наведен указатель в момент возникновения события.

value

String

Значение узла модели DOM, на который был наведен указатель в момент возникновения события.

Двойной щелчок мыши

Данное событие генерируется когда пользователь дважды кликает левой кнопкой мыши по компоненту. Свойство компонента Генерировать событие "Двойной щелчок мыши" должно быть установлено в значениеTrue для того чтобы событие генерировалось.

Имя события:

mouseDoubleClicked

Записи:

1

Формат записи:

Тот же, что и для "Щелчок мыши".

Кнопка мыши отпущена

Данное событие генерируется когда пользователь отпускает любую кнопку мыши в области компонента. Свойство компонента Генерировать событие "Кнопка мыши отпущена" должно быть установлено в значениеTrue для того чтобы событие генерировалось.

Имя события:

mouseReleased

Записи:

1

Формат записи:

Тот же, что и для "Щелчок мыши".

Кнопка мыши нажата

Данное событие генерируется когда пользователь зажимает любую кнопку мыши в области компонента. Свойство компонента Генерировать событие "Кнопка мыши нажата" должно быть установлено в значениеTrue для того чтобы событие генерировалось.

Имя события:

mousePressed

Записи:

1

Формат записи:

Тот же, что и для "Щелчок мыши".

Данное событие генерируется когда указатель наведен на область компонента. Свойство компонента Генерировать событие "Наведение указателя мыши" должно быть установлено в значениеTrue для того чтобы событие генерировалось.

Имя события:

mouseEntered

Записи:

1

Формат записи:

Тот же, что и для "Щелчок мыши".

Вывод указателя мыши

Данное событие генерируется когда указатель выведен из области компонента. Свойство компонента Генерировать событие "Вывод указателя мыши" должно быть установлено в значениеTrue для того чтобы событие генерировалось.

Имя события:

mouseExited

Записи:

1

Формат записи:

Тот же, что и для "Щелчок мыши".

Изменение входного значения

Данное событие возникает, когда пользователь вводит данные в поле области ввода.

Имя события:

inputChanged

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

value

String

Значение. Новый текст, введенный в поле ввода.

Клавиша нажата

Свойство Генерировать событие “Клавиша нажата“ группы свойств События должно быть включено для компонента, чтобы вызвать это событие.

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

Имя события:

keyPressed

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

id

Integer

Уникальный идентификатор события нажатия клавиши.

when

Date

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

modifiers

Integer

Указывает количество клавиш-модификаторов, которые были нажаты во время события нажатия клавиши. Клавиша-модификатор — это любая из следующих клавиш:

  • Alt

  • Shift

  • Control

  • Meta-клавиша (клавиша «Windows» в Windows, клавиша «Command» на Mac)

altDown

Boolean

Указывает, была ли нажата клавиша alt во время события.

altGraphDown

Boolean

Указывает, была ли нажата клавиша alt graph во время события.

controlDown

Boolean

Указывает, была ли нажата клавиша управления во время события.

shiftDown

Boolean

Указывает, была ли нажата клавиша Shift во время события.

metaDown

Boolean

Указывает, была ли нажата Meta-клавиша во время события.

actionKey

Boolean

Указывает, была ли нажата клавиша действия во время события. Клавиша действия является псевдонимом для основной клавиши действия операционной системы пользователя:

  • В Windows/Linux: клавиша действия эквивалентна клавише control

  • В Mac: клавиша действия эквивалентна Meta-клавише, например клавише command

keyChar

String

Символ, связанный с клавишей, которая была нажата во время события нажатия клавиши.

keyCode

Integer

Код, связанный с клавишей, которая была нажата во время события нажатия клавиши.

keyLocation

Integer

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

  • 0 указывает, что нажатая клавиша находится в стандартном месте

  • 1 указывает, что была нажата левая клавиша, например, левый control, левый shift, левый alt.

  • 2 указывает, что была нажата правая клавиша, например, правый control, правый shift, правый alt.

  • 3 указывает, что была нажата клавиша на цифровой клавиатуре, например, ввод на цифровой клавиатуре, 0-9 на цифровой клавиатуре и т. д.

Клавиша отпущена

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

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

Имя события:

keyReleased

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

id

Integer

Уникальный идентификатор события отпускания клавиши.

when

Date

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

modifiers

Integer

Указывает количество клавиш-модификаторов, которые были нажаты во время события отпускания клавиши. Подробности см. в описании события Клавиша нажата.

altDown

Boolean

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

altGraphDown

Boolean

Указывает, была ли отпущена клавиша alt graph во время события.

controlDown

Boolean

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

shiftDown

Boolean

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

metaDown

Boolean

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

actionKey

Boolean

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

keyChar

String

Символ, связанный с клавишей, которая была отпущена во время события Клавиша отпущена.

keyCode

Integer

Код, связанный с клавишей, которая была отпущена во время события Клавиша отпущена.

keyLocation

Integer

Местоположение клавиши, которая была отпущена во время события Клавиша отпущена. Подробности см. в описании события Клавиша нажата.

 

Was this page helpful?