Оглавление | Назад | Вперёд | Индекс

event

Объект event содержит свойства, которые описывают JavaScript-событие и передаются в качестве аргументов обработчику события при возникновении события.

Клиентский объект
Реализован в	JavaScript 1.2

При возникновении, например, события mouse-down, объект event содержит тип события (в данном случае - MouseDown), координаты x и y курсора в момент возникновения события и число, представляющее нажатую клавишу мыши, и поле, содержащее ключи-модификаторы (Control, Alt, Meta или Shift), который были нажаты в момент события. Свойства, используемые в объекте event, различаются для разных событий. Эти различия указаны при описании конкретных обработчиков событий.

См. в Главе 3 "Обработчики Событий" полную информацию по обработчикам событий. Дополнительно см. книгу Клиентский JavaScript. Руководство.

Создание

event -объекты создаются Communicator'ом при возникновении события. Сами Вы их не создаёте.

Безопасность

Установка любого свойства этого объекта требует привилегии UniversalBrowserWrite. Помимо этого получение свойства data события DragDrop требует привилегии UniversalBrowserRead. О безопасности см. книгу Клиентский JavaScript. Руководство.

Свойства. Резюме.

Не все свойства относятся к каждому типу события. Для изучения свойств, используемых событиями, см. разделы "События, используемые объектом еvent" конкретных обработчиков событий.

Свойство	Описание
`data`	Возвращает массив строк, содержащий URL'ы отпущенных объектов. Передаётся событием DragDrop.
`height`	Высота окна или фрэйма.
`layerX`	Число, специфицирующее ширину объекта при передаче с событием resize, либо горизонтальную координату курсора в пикселах относительно слоя, в котором событие возникло. Заметьте, что `layerX` является синонимом x.
`layerY`	Число, специфицирующее высоту объекта при передаче с событием resize либо вертикальную координату курсора в пикселах относительно слоя, в котором событие возникло. Заметьте, что `layerY` является синонимом y.
`modifiers`	Строка, специфицирующая ключи-модификаторы, ассоциированные с событием мыши или клавиатуры. Ключи-модификаторы это: ALT_MASK, CONTROL_MASK, SHIFT_MASK и META_MASK.
`pageX`	Число, специфицирующее позицию курсора по горизонтали в пикселах относительно страницы.
`pageY`	Число, специфицирующее позицию курсора по вертикали в пикселах относительно страницы.
`screenX`	Число, специфицирующее позицию курсора по горизонтали в пикселах относительно экрана.
`screenY`	Число, специфицирующее позицию курсора по вертикали в пикселах относительно экрана.
`target`	Строка, представляющая объект, которому событие было первоначально направлено. (Все события.)
`type`	Строка, представляющая тип события. (Все события.)
`which`	Число, специфицирующее нажатую кнопку, или ASCII-значение нажатой клавиши. Для мыши: 1 это левая клавиша, 2 - средняя, а 3 - правая клавиша.
`width`	Ширина окна или фрэйма.
`x`	Синоним для `layerX`.
`y`	Синоним для `layerY`.

Методы. Резюме.

Этот объект наследует методы watch и unwatch из объекта Object.

Примеры

Этот пример использует объект event для предоставления типа события в предупреждающем сообщении.

<A HREF="http://home.netscape.com" onClick='alert("Link got an event: "

+ event.type)'>Click for link event</A>

В следующем примере объект event используется в явно вызываемом обработчике события.

<SCRIPT>
function fun1(evnt) {
   alert ("Document got
an event: " + evnt.type);
   alert ("x position is " + evnt.layerX);

   alert ("y position is " + evnt.layerY);
   if (evnt.modifiers & Event.ALT_MASK)

      alert ("Alt key was down for event.");

   return true;
   }
document.onmousedown = fun1;
</SCRIPT>

data

Для события DragDrop возвращает массив строк, содержащий URL'ы отпускаемых объектов.

Свойство из	`event`
Реализовано в	JavaScript 1.2

Безопасность

Установка этого свойства требует привилегии UniversalBrowserWrite. Кроме того, получение этого свойства для события DragDrop требует привилегии UniversalBrowserRead. О безопасности см. книгу Клиентский JavaScript. Руководство.

height

Высота окна или фрэйма.

Свойство из	`event`
Реализовано в	JavaScript 1.2

Безопасность

Установка этого свойства требует привилегии UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

См. также

event.width

layerX

Число, специфицирующее ширину объекта при передаче с событием resize либо горизонтальную позицию курсора в пикселах относительно слоя, в котором возникло событие.

Свойство из	`event`
Реализовано в	JavaScript 1.2

Безопасность

Описание

Это свойство является синонимом свойства event.x.

См. также

event.layerY

layerY

Число, специфицирующее высоту объекта при передаче с событием resize либо вертикальную позицию курсора в пикселах относительно слоя, в котором возникло событие.

Свойство из	`event`
Реализовано в	JavaScript 1.2

Безопасность

Описание

Это свойство является синонимом свойства event.y.

См. также

event.layerX

modifiers

Строка, специфицирующая ключи-модификаторы, ассоциированные с событием мыши или клавиатуры. Значения ключей-модификаторов: ALT_MASK, CONTROL_MASK, SHIFT_MASK и META_MASK.

Свойство из	`event`
Реализовано в	JavaScript 1.2

Безопасность

См. также

event.which

pageX

Число, специфицирующее горизонтальную позицию курсора в пикселах относительно страницы.

Свойство из	`event`
Реализовано в	JavaScript 1.2

Безопасность

См. также

event.pageY

pageY

Число, специфицирующее вертикальную позицию курсора в пикселах относительно страницы.

Свойство из	`event`
Реализовано в	JavaScript 1.2

Безопасность

См. также

event.pageX

screenX

Число, специфицирующее горизонтальную позицию курсора в пикселах относительно экрана.

Свойство из	`event`
Реализовано в	JavaScript 1.2

Безопасность

См. также

event.screenY

screenY

Число, специфицирующее вертикальную позицию курсора в пикселах относительно экрана.

Свойство из	`event`
Реализовано в	JavaScript 1.2

Безопасность

См. также

event.screenX

target

Строка, представляющая объект, которому событие было первоначально отправлено.

Свойство из	`event`
Реализовано в	JavaScript 1.2

Безопасность

См. также

event.type

type

Строка, представляющая тип события.

Свойство из	`event`
Реализовано в	JavaScript 1.2

Безопасность

См. также

event.target

which

Число, специфицирующее нажатую клавишу мыши или ASCII-значение нажатой клавиши клавиатуры. Для мыши: 1 это левая клавиша, 2 - средняя, а 3 - правая.

Свойство из	`event`
Реализовано в	JavaScript 1.2

Безопасность

См. также

event.modifiers

width

Ширина окна или фрэйма.

Свойство из	`event`
Реализовано в	JavaScript 1.2

Безопасность

См. также

event.height

x

Число, специфицирующее ширину объекта при передаче с событием resize либо горизонтальную позицию курсора в пикселах относительно слоя, в котором событие возникло.

Свойство из	`event`
Реализовано в	JavaScript 1.2

Безопасность

Описание

Это свойство является синонимом свойства event.layerX.

См. также

event.y

y

Синоним layerY.

Свойство из	`event`
Реализовано в	JavaScript 1.2

Безопасность

Описание

Это свойство является синонимом свойства event.layerY.

См. также

event.x

Оглавление | Назад | Вперёд | Индекс

Дата последнего обновления: 28 мая 1999 года.
Copyright (c) 1999 Netscape Communications Corporation