ui/events/event_constants.h - chromium/src - Git at Google

 // 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_

 #include "build/build_config.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,

   // 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,

 // An artificial value used to bridge platform differences.
 // Many commands on Mac as Cmd+Key are the counterparts of
 // Ctrl+Key on other platforms.
 #if defined(OS_MACOSX)
   EF_PLATFORM_ACCELERATOR = EF_COMMAND_DOWN,
 #else
   EF_PLATFORM_ACCELERATOR = EF_CONTROL_DOWN,
 #endif
 };

 // Flags specific to key events.
 // WARNING: If you add or remove values make sure traits for serializing these
 // values are updated.
 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)
   EF_MAX_KEY_EVENT_FLAGS_VALUE = (1 << 19) - 1,
 };

 // 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.
   EF_SCROLL_BY_PAGE = 1 << 22,       // Indicates this mouse event is generated
                                      // when users is requesting to scroll by
                                      // pages.
 };

 // 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_
	// 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_

	#include "build/build_config.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,

	// 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,

	// An artificial value used to bridge platform differences.
	// Many commands on Mac as Cmd+Key are the counterparts of
	// Ctrl+Key on other platforms.
	#if defined(OS_MACOSX)
	EF_PLATFORM_ACCELERATOR = EF_COMMAND_DOWN,
	#else
	EF_PLATFORM_ACCELERATOR = EF_CONTROL_DOWN,
	#endif
	};

	// Flags specific to key events.
	// WARNING: If you add or remove values make sure traits for serializing these
	// values are updated.
	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)
	EF_MAX_KEY_EVENT_FLAGS_VALUE = (1 << 19) - 1,
	};

	// 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.
	EF_SCROLL_BY_PAGE = 1 << 22, // Indicates this mouse event is generated
	// when users is requesting to scroll by
	// pages.
	};

	// 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_