Книги-online

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

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="index.php?name=go&url=http%3A%2F%2Fhome.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