diff options
Diffstat (limited to 'chromium/ash/wm/sticky_keys.h')
-rw-r--r-- | chromium/ash/wm/sticky_keys.h | 240 |
1 files changed, 0 insertions, 240 deletions
diff --git a/chromium/ash/wm/sticky_keys.h b/chromium/ash/wm/sticky_keys.h deleted file mode 100644 index 1a2789214bb..00000000000 --- a/chromium/ash/wm/sticky_keys.h +++ /dev/null @@ -1,240 +0,0 @@ -// Copyright 2013 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 ASH_WM_STICKY_KEYS_H_ -#define ASH_WM_STICKY_KEYS_H_ - -#include "ash/ash_export.h" -#include "base/memory/scoped_ptr.h" -#include "ui/events/event_constants.h" -#include "ui/events/event_handler.h" - -namespace ui { -class Event; -class KeyEvent; -class MouseEvent; -} // namespace ui - -namespace aura { -class Window; -} // namespace aura - -namespace ash { - -class StickyKeysHandler; - -// StickyKeys is an accessibility feature for users to be able to compose key -// and mouse event with modifier keys without simultaneous key press event. -// Instead they can compose events separately pressing each of the modifier -// keys involved. -// e.g. Composing Ctrl + T -// User Action : The KeyEvent widget will receives -// ---------------------------------------------------------- -// 1. Press Ctrl key : Ctrl Keydown. -// 2. Release Ctrl key : No event -// 3. Press T key : T keydown event with ctrl modifier. -// 4. : Ctrl Keyup -// 5. Release T key : T keyup without ctrl modifier (Windows behavior) -// -// By typing same modifier keys twice, users can generate bunch of modified key -// events. -// e.g. To focus tabs consistently by Ctrl + 1, Ctrl + 2 ... -// User Action : The KeyEvent widget will receives -// ---------------------------------------------------------- -// 1. Press Ctrl key : Ctrl Keydown -// 2. Release Ctrl key : No event -// 3. Press Ctrl key : No event -// 4. Release Ctrl key : No event -// 5. Press 1 key : 1 Keydown event with Ctrl modifier. -// 6. Release 1 key : 1 Keyup event with Ctrl modifier. -// 7. Press 2 key : 2 Keydown event with Ctrl modifier. -// 8. Release 2 key : 2 Keyup event with Ctrl modifier. -// 9. Press Ctrl key : No event -// 10. Release Ctrl key: Ctrl Keyup -// -// In the case of Chrome OS, StickyKeys supports Shift,Alt,Ctrl modifiers. Each -// handling or state is performed independently. -// -// StickyKeys is disabled by default. -class ASH_EXPORT StickyKeys : public ui::EventHandler { - public: - StickyKeys(); - virtual ~StickyKeys(); - - // Activate sticky keys to intercept and modify incoming events. - void Enable(bool enabled); - - private: - // Handles keyboard event. Returns true if Sticky key consumes keyboard event. - bool HandleKeyEvent(ui::KeyEvent* event); - - // Handles mouse event. Returns true if sticky key consumes mouse event. - bool HandleMouseEvent(ui::MouseEvent* event); - - // Handles scroll event. Returns true if sticky key consumes scroll event. - bool HandleScrollEvent(ui::ScrollEvent* event); - - // Overridden from ui::EventHandler: - virtual void OnKeyEvent(ui::KeyEvent* event) OVERRIDE; - virtual void OnMouseEvent(ui::MouseEvent* event) OVERRIDE; - virtual void OnScrollEvent(ui::ScrollEvent* event) OVERRIDE; - - // Whether sticky keys is activated and modifying events. - bool enabled_; - - // Sticky key handlers. - scoped_ptr<StickyKeysHandler> shift_sticky_key_; - scoped_ptr<StickyKeysHandler> alt_sticky_key_; - scoped_ptr<StickyKeysHandler> ctrl_sticky_key_; - - DISALLOW_COPY_AND_ASSIGN(StickyKeys); -}; - -// StickyKeysHandler handles key event and performs StickyKeys for specific -// modifier keys. If monitored keyboard events are recieved, StickyKeysHandler -// changes internal state. If non modifier keyboard events or mouse events are -// received, StickyKeysHandler will append modifier based on internal state. -// For other events, StickyKeysHandler does nothing. -// -// The DISABLED state is default state and any incoming non modifier keyboard -// events will not be modified. The ENABLED state is one shot modification -// state. Only next keyboard event will be modified. After that, internal state -// will be back to DISABLED state with sending modifier keyup event. In the case -// of LOCKED state, all incomming keyboard events will be modified. The LOCKED -// state will be back to DISABLED state by next monitoring modifier key. -// -// The detailed state flow as follows: -// Current state -// | DISABLED | ENABLED | LOCKED | -// ----------------------------------------------------------------| -// Modifier KeyDown | noop | noop(*) | noop(*) | -// Modifier KeyUp | To ENABLED(*) | To LOCKED(*) | To DISABLED | -// Normal KeyDown | noop | To DISABLED(#) | noop(#) | -// Normal KeyUp | noop | noop | noop(#) | -// Other KeyUp/Down | noop | noop | noop | -// Mouse Press | noop | noop(#) | noop(#) | -// Mouse Release | noop | To DISABLED(#) | noop(#) | -// Mouse Wheel | noop | To DISABLED(#) | noop(#) | -// Other Mouse Event| noop | noop | noop | -// -// Here, (*) means key event will be consumed by StickyKeys, and (#) means event -// is modified. -class ASH_EXPORT StickyKeysHandler { - public: - class StickyKeysHandlerDelegate { - public: - StickyKeysHandlerDelegate(); - virtual ~StickyKeysHandlerDelegate(); - - // Dispatches keyboard event synchronously. - virtual void DispatchKeyEvent(ui::KeyEvent* event, - aura::Window* target) = 0; - - // Dispatches mouse event synchronously. - virtual void DispatchMouseEvent(ui::MouseEvent* event, - aura::Window* target) = 0; - - // Dispatches scroll event synchronously. - virtual void DispatchScrollEvent(ui::ScrollEvent* event, - aura::Window* target) = 0; - }; - // Represents Sticky Key state. - enum StickyKeyState { - // The sticky key is disabled. Incomming non modifier key events are not - // affected. - DISABLED, - // The sticky key is enabled. Incomming non modifier key down events are - // modified with |modifier_flag_|. After that, sticky key state become - // DISABLED. - ENABLED, - // The sticky key is locked. Incomming non modifier key down events are - // modified with |modifier_flag_|. - LOCKED, - }; - - // This class takes an ownership of |delegate|. - StickyKeysHandler(ui::EventFlags modifier_flag, - StickyKeysHandlerDelegate* delegate); - ~StickyKeysHandler(); - - // Handles key event. Returns true if key is consumed. - bool HandleKeyEvent(ui::KeyEvent* event); - - // Handles a mouse event. Returns true if mouse event is consumed. - bool HandleMouseEvent(ui::MouseEvent* event); - - // Handles a scroll event. Returns true if scroll event is consumed. - bool HandleScrollEvent(ui::ScrollEvent* event); - - // Returns current internal state. - StickyKeyState current_state() const { return current_state_; } - - private: - // Represents event type in Sticky Key context. - enum KeyEventType { - TARGET_MODIFIER_DOWN, // The monitoring modifier key is down. - TARGET_MODIFIER_UP, // The monitoring modifier key is up. - NORMAL_KEY_DOWN, // The non modifier key is down. - NORMAL_KEY_UP, // The non modifier key is up. - OTHER_MODIFIER_DOWN, // The modifier key but not monitored key is down. - OTHER_MODIFIER_UP, // The modifier key but not monitored key is up. - }; - - // Translates |event| to sticky keys event type. - KeyEventType TranslateKeyEvent(ui::KeyEvent* event); - - // Handles key event in DISABLED state. - bool HandleDisabledState(ui::KeyEvent* event); - - // Handles key event in ENABLED state. - bool HandleEnabledState(ui::KeyEvent* event); - - // Handles key event in LOCKED state. - bool HandleLockedState(ui::KeyEvent* event); - - // Dispatches |event| to its target and then dispatch a key released event - // for the modifier key. This function is required to ensure that the events - // are sent in the correct order when disabling sticky key after a key/mouse - // button press. - void DispatchEventAndReleaseModifier(ui::Event* event); - - // Adds |modifier_flags_| to a native X11 event state mask. - void AppendNativeEventMask(unsigned int* state); - - // Adds |modifier_flags_| into |event|. - void AppendModifier(ui::KeyEvent* event); - void AppendModifier(ui::MouseEvent* event); - void AppendModifier(ui::ScrollEvent* event); - - // The modifier flag to be monitored and appended. - const ui::EventFlags modifier_flag_; - - // The current sticky key status. - StickyKeyState current_state_; - - // True if the received key event is sent by StickyKeyHandler. - bool event_from_myself_; - - // True if we received the TARGET_MODIFIER_DOWN event while in the DISABLED - // state but before we receive the TARGET_MODIFIER_UP event. Normal - // shortcuts (eg. ctrl + t) during this time will prevent a transition to - // the ENABLED state. - bool preparing_to_enable_; - - // Tracks the scroll direction of the current scroll sequence. Sticky keys - // stops modifying the scroll events of the sequence when the direction - // changes. If no sequence is tracked, the value is 0. - int scroll_delta_; - - // The modifier up key event to be sent on non modifier key on ENABLED state. - scoped_ptr<ui::KeyEvent> modifier_up_event_; - - scoped_ptr<StickyKeysHandlerDelegate> delegate_; - - DISALLOW_COPY_AND_ASSIGN(StickyKeysHandler); -}; - -} // namespace ash - -#endif // ASH_WM_STICKY_KEYS_H_ |