// Copyright (c) 2012 The Chromium Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #ifndef UI_EVENTS_EVENT_CONSTANTS_H_ #define UI_EVENTS_EVENT_CONSTANTS_H_ namespace ui { // Event types. (prefixed because of a conflict with windows headers) enum EventType { ET_UNKNOWN = 0, ET_MOUSE_PRESSED, ET_MOUSE_DRAGGED, ET_MOUSE_RELEASED, ET_MOUSE_MOVED, ET_MOUSE_ENTERED, ET_MOUSE_EXITED, ET_KEY_PRESSED, ET_KEY_RELEASED, ET_MOUSEWHEEL, ET_MOUSE_CAPTURE_CHANGED, // Event has no location. ET_TOUCH_RELEASED, ET_TOUCH_PRESSED, // NOTE: This corresponds to a drag and is always preceeded by an // ET_TOUCH_PRESSED. GestureRecognizers generally ignore ET_TOUCH_MOVED events // without a corresponding ET_TOUCH_PRESSED. ET_TOUCH_MOVED, ET_TOUCH_CANCELLED, ET_DROP_TARGET_EVENT, // PointerEvent types ET_POINTER_DOWN, ET_POINTER_MOVED, ET_POINTER_UP, ET_POINTER_CANCELLED, ET_POINTER_ENTERED, ET_POINTER_EXITED, ET_POINTER_WHEEL_CHANGED, ET_POINTER_CAPTURE_CHANGED, // GestureEvent types ET_GESTURE_SCROLL_BEGIN, ET_GESTURE_TYPE_START = ET_GESTURE_SCROLL_BEGIN, ET_GESTURE_SCROLL_END, ET_GESTURE_SCROLL_UPDATE, ET_GESTURE_TAP, ET_GESTURE_TAP_DOWN, ET_GESTURE_TAP_CANCEL, ET_GESTURE_TAP_UNCONFIRMED, // User tapped, but the tap delay hasn't expired. ET_GESTURE_DOUBLE_TAP, ET_GESTURE_BEGIN, // The first event sent when each finger is pressed. ET_GESTURE_END, // Sent for each released finger. ET_GESTURE_TWO_FINGER_TAP, ET_GESTURE_PINCH_BEGIN, ET_GESTURE_PINCH_END, ET_GESTURE_PINCH_UPDATE, ET_GESTURE_LONG_PRESS, ET_GESTURE_LONG_TAP, // A SWIPE gesture can happen at the end of a touch sequence involving one or // more fingers if the finger velocity was high enough when the first finger // was released. ET_GESTURE_SWIPE, ET_GESTURE_SHOW_PRESS, // Scroll support. // TODO[davemoore] we need to unify these events w/ touch and gestures. ET_SCROLL, ET_SCROLL_FLING_START, ET_SCROLL_FLING_CANCEL, ET_GESTURE_TYPE_END = ET_SCROLL_FLING_CANCEL, // Sent by the system to indicate any modal type operations, such as drag and // drop or menus, should stop. ET_CANCEL_MODE, // Sent by the CrOS gesture library for interesting patterns that we want // to track with the UMA system. ET_UMA_DATA, // Must always be last. User namespace starts above this value. // See ui::RegisterCustomEventType(). ET_LAST }; // Event flags currently supported. It is OK to add values to the middle of // this list and/or reorder it, but make sure you also touch the various other // enums/constants that want to stay in sync with this. enum EventFlags { EF_NONE = 0, // Used to denote no flags explicitly // Universally applicable status bits. EF_IS_SYNTHESIZED = 1 << 0, // Modifier key state. EF_SHIFT_DOWN = 1 << 1, EF_CONTROL_DOWN = 1 << 2, EF_ALT_DOWN = 1 << 3, EF_COMMAND_DOWN = 1 << 4, // GUI Key (e.g. Command on OS X // keyboards, Search on Chromebook // keyboards, Windows on MS-oriented // keyboards) EF_ALTGR_DOWN = 1 << 5, EF_MOD3_DOWN = 1 << 6, // Other keyboard states. EF_NUM_LOCK_ON = 1 << 7, EF_CAPS_LOCK_ON = 1 << 8, EF_SCROLL_LOCK_ON = 1 << 9, // Mouse buttons. EF_LEFT_MOUSE_BUTTON = 1 << 10, EF_MIDDLE_MOUSE_BUTTON = 1 << 11, EF_RIGHT_MOUSE_BUTTON = 1 << 12, EF_BACK_MOUSE_BUTTON = 1 << 13, EF_FORWARD_MOUSE_BUTTON = 1 << 14, }; // Flags specific to key events. enum KeyEventFlags { EF_IME_FABRICATED_KEY = 1 << 15, // Key event fabricated by the underlying // IME without a user action. // (Linux X11 only) EF_IS_REPEAT = 1 << 16, EF_FINAL = 1 << 17, // Do not remap; the event was created with // the desired final values. EF_IS_EXTENDED_KEY = 1 << 18, // Windows extended key (see WM_KEYDOWN doc) }; // Flags specific to mouse events. enum MouseEventFlags { EF_IS_DOUBLE_CLICK = 1 << 15, EF_IS_TRIPLE_CLICK = 1 << 16, EF_IS_NON_CLIENT = 1 << 17, EF_FROM_TOUCH = 1 << 18, // Indicates this mouse event is generated // from an unconsumed touch/gesture event. EF_TOUCH_ACCESSIBILITY = 1 << 19, // Indicates this event was generated from // touch accessibility mode. EF_CURSOR_HIDE = 1 << 20, // Indicates this mouse event is generated // because the cursor was just hidden. This // can be used to update hover state. EF_PRECISION_SCROLLING_DELTA = // Indicates this mouse event is from high 1 << 21, // precision touchpad and will come with a // high precision delta. }; // Result of dispatching an event. enum EventResult { ER_UNHANDLED = 0, // The event hasn't been handled. The event can be // propagated to other handlers. ER_HANDLED = 1 << 0, // The event has already been handled, but it can // still be propagated to other handlers. ER_CONSUMED = 1 << 1, // The event has been handled, and it should not be // propagated to other handlers. ER_DISABLE_SYNC_HANDLING = 1 << 2, // The event shouldn't be handled synchronously. This // happens if the event is being handled // asynchronously, or if the event is invalid and // shouldn't be handled at all. }; // Phase of the event dispatch. enum EventPhase { EP_PREDISPATCH, EP_PRETARGET, EP_TARGET, EP_POSTTARGET, EP_POSTDISPATCH }; // Phase information used for a ScrollEvent. ScrollEventPhase is for scroll // stream from user gesture, EventMomentumPhase is for inertia scroll stream // after user gesture. enum class ScrollEventPhase { // Event has no phase information. eg. the Event is not in a scroll stream. kNone, // Event is the beginning of a scroll event stream. kBegan, // Event is a scroll event with phase information. kUpdate, // Event is the end of the current scroll event stream. kEnd, }; // Momentum phase information used for a ScrollEvent. enum class EventMomentumPhase { // Event is a non-momentum update to an event stream already begun. NONE, // Event is the beginning of an event stream that may result in momentum. // BEGAN vs MAY_BEGIN: // - BEGAN means we already know the inertia scroll stream must happen after // BEGAN event. On Windows touchpad, we sent this when receive the first // inertia scroll event or Direct Manipulation state change to INERTIA. // - MAY_BEGIN means the inertia scroll stream may happen after MAY_BEGIN // event. On Mac, we send this when receive releaseTouches, but we do not // know the inertia scroll stream will happen or not at that time. BEGAN, // Event maybe the beginning of an event stream that may result in momentum. // This state used on Mac. MAY_BEGIN, // Event is an update while in a momentum phase. A "begin" event for the // momentum phase portion of an event stream uses this also, but the scroll // offsets will be zero. INERTIAL_UPDATE, // Event marks the end of the current event stream. Note that this is also set // for events that are not a "stream", but indicate both the start and end of // the event (e.g. a mouse wheel tick). END, }; // Device ID for Touch and Key Events. enum EventDeviceId { ED_UNKNOWN_DEVICE = -1 }; // Pointing device type. enum class EventPointerType : int { POINTER_TYPE_UNKNOWN = 0, POINTER_TYPE_MOUSE, POINTER_TYPE_PEN, POINTER_TYPE_TOUCH, POINTER_TYPE_ERASER, }; // Device type for gesture events. enum class GestureDeviceType : int { DEVICE_UNKNOWN = 0, DEVICE_TOUCHPAD, DEVICE_TOUCHSCREEN, }; } // namespace ui #endif // UI_EVENTS_EVENT_CONSTANTS_H_