HumanInputEvent abstract class
Abstract class representing position events such as mouse or touch events.
@param <H> handler type
abstract class HumanInputEvent extends DomEvent { /** * Cast native event to [KeyboardEvent]. */ dart_html.KeyboardEvent getKeyboardEvent() { if (getNativeEvent() is dart_html.KeyboardEvent) { return getNativeEvent() as dart_html.KeyboardEvent; } throw new Exception("Native event is not subtype of KeyboardEvent"); } /** * Is <code>alt</code> key down. * * @return whether the alt key is down */ bool isAltKeyDown() { return getKeyboardEvent().altKey; } /** * Is <code>control</code> key down. * * @return whether the control key is down */ bool isControlKeyDown() { return getKeyboardEvent().ctrlKey; } /** * Is <code>meta</code> key down. * * @return whether the meta key is down */ bool isMetaKeyDown() { return getKeyboardEvent().metaKey; } /** * Is <code>shift</code> key down. * * @return whether the shift key is down */ bool isShiftKeyDown() { return getKeyboardEvent().shiftKey; } }
Extends
IEvent<H> > DwtEvent > DomEvent > HumanInputEvent
Methods
void assertLive() #
Asserts that the event still should be accessed. All events are considered to be "dead" after their original handler manager finishes firing them. An event can be revived by calling {@link GwtEvent#revive()}.
void assertLive() { assert (!_dead) ; //: "This event has already finished being processed by its original handler manager, so you can no longer access it"; }
abstract void dispatch(H handler) #
Implemented by subclasses to invoke their handlers in a type safe
manner. Intended to be called by EventBus#fireEvent(Event)
or
EventBus#fireEventFromSource(Event, Object)
.
@param handler handler @see EventBus#dispatchEvent(Event, Object)
EventType<EventHandler> getAssociatedType() #
KeyboardEvent getKeyboardEvent() #
Cast native event to KeyboardEvent
.
dart_html.KeyboardEvent getKeyboardEvent() { if (getNativeEvent() is dart_html.KeyboardEvent) { return getNativeEvent() as dart_html.KeyboardEvent; } throw new Exception("Native event is not subtype of KeyboardEvent"); }
Event getNativeEvent() #
dart_html.Event getNativeEvent() { assertLive(); return _nativeEvent; }
Element getRelativeElement() #
Gets the element relative to which event coordinates will be measured. If this element is <code>null</code>, event coordinates will be measured relative to the window's client area.
@return the event's relative element
dart_html.Element getRelativeElement() { assertLive(); return _relativeElem; }
Object getSource() #
Returns the source for this event. The type and meaning of the source is
arbitrary, and is most useful as a secondary key for handler registration.
(See EventBus#addHandlerToSource
, which allows a handler to
register for events of a particular type, tied to a particular source.)
Note that the source is actually set at dispatch time, e.g. via
EventBus#fireEventFromSource(Event, Object)
.
@return object representing the source of this event
Object getSource() { assertLive(); return super.getSource(); }
bool isAltKeyDown() #
Is <code>alt</code> key down.
@return whether the alt key is down
bool isAltKeyDown() { return getKeyboardEvent().altKey; }
bool isControlKeyDown() #
Is <code>control</code> key down.
@return whether the control key is down
bool isControlKeyDown() { return getKeyboardEvent().ctrlKey; }
bool isLive() #
Is the event current live?
@return whether the event is live
bool isLive() { return !_dead; }
bool isMetaKeyDown() #
Is <code>meta</code> key down.
@return whether the meta key is down
bool isMetaKeyDown() { return getKeyboardEvent().metaKey; }
bool isShiftKeyDown() #
Is <code>shift</code> key down.
@return whether the shift key is down
bool isShiftKeyDown() { return getKeyboardEvent().shiftKey; }
void kill() #
Kill the event. After the event has been killed, users cannot really on its values or functions being available.
void kill() { _dead = true; setSource(null); }
void overrideSource(Object source) #
void overrideSource(Object source) { super.setSource(source); }
void preventDefault() #
Prevents the wrapped native event's default action.
void preventDefault() { assertLive(); _nativeEvent.preventDefault(); }
void revive() #
Revives the event. Used when recycling event instances.
void revive() { _dead = false; setSource(null); }
void setSource(source) #
Set the source that triggered this event. Intended to be called by the EventBus during dispatch.
@param source the source of this event. @see EventBus#fireEventFromSource(Event, Object) @see EventBus#setSourceOfEvent(Event, Object)
void setSource(dynamic source) { this._source = source; }