IME (input method editor) support for Aura, part 3 of 3: Use ui::InputMethod in ash.

ui/aura/event_filter.h

 // Copyright (c) 2011 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_AURA_EVENT_FILTER_H_
 #define UI_AURA_EVENT_FILTER_H_
 #pragma once
 
 #include "base/basictypes.h"
 #include "ui/aura/aura_export.h"
 #include "ui/base/events.h"
 
 namespace aura {
 
 class KeyEvent;
 class MouseEvent;
 class TouchEvent;
+class TranslatedKeyEvent;
 class Window;
 
 // An object that filters events sent to an owner window. The filter can stop
 // further processing of events.
 //
 // When the Desktop receives an event, it determines the "target window" for
 // the event, this is typically the visible window whose bounds most tightly
 // enclose the event coordinates, in the case of mouse events, or the focused
 // window, in the case of key events.
 //
@@ skipping 10 matching lines @@
   // window the event was targeted at. If |event| is a LocatedEvent, its
   // coordinates are relative to |target|.
 
   // For all PreHandle*() functions that return a bool, return true if the
   // filter consumes the event and further processing (by the target, for
   // example) is not performed. Return false if the filter does not consume the
   // event and further processing is performed. Note that in this case the
   // filter may still perform some action, the return value simply indicates
   // that further processing can occur.
 
+  // All filters except the one bound to a system IME (input method) should NOT
+  // consume a KeyEvent. Instead, they should handle a TranslatedKeyEvent.
   virtual bool PreHandleKeyEvent(Window* target, KeyEvent* event) = 0;
+  virtual bool PreHandleTranslatedKeyEvent(Window* target,
+                                           TranslatedKeyEvent* event) = 0;
+
   virtual bool PreHandleMouseEvent(Window* target, MouseEvent* event) = 0;
 
   // Returns a value other than ui::TOUCH_STATUS_UNKNOWN if the event is
   // consumed.
   virtual ui::TouchStatus PreHandleTouchEvent(Window* target,
                                               TouchEvent* event) = 0;
 
  protected:
   Window* owner() { return owner_; }
 
  private:
   Window* owner_;
 
   DISALLOW_COPY_AND_ASSIGN(EventFilter);
 };
 
 }  // namespace aura
 
 #endif  // UI_AURA_EVENT_FILTER_H_