diff options
author | yusukes@chromium.org <yusukes@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98> | 2011-12-06 02:41:42 +0000 |
---|---|---|
committer | yusukes@chromium.org <yusukes@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98> | 2011-12-06 02:41:42 +0000 |
commit | bd902afab1fc0171ae867f86c1a1a70424135192 (patch) | |
tree | dc24cd9aec604059dac00360167ea7d76ac59a16 | |
parent | 4266fd6e9a0f72268016c50a0d7130a6d721817a (diff) | |
download | chromium_src-bd902afab1fc0171ae867f86c1a1a70424135192.zip chromium_src-bd902afab1fc0171ae867f86c1a1a70424135192.tar.gz chromium_src-bd902afab1fc0171ae867f86c1a1a70424135192.tar.bz2 |
IME (input method editor) support for Aura, part 1 of 3: Add ui/base/ime/ classes.
ui::InputMethod:
- An interface similar to views::InputMethod, but does not have Has neither Views nor Aura dependencies.
ui::InputMethodIBus
- Port of views::InputMethodIBus. Has neither Views nor Aura dependencies.
Original review: http://codereview.chromium.org/8576005/ (PatchSet #1-8, Comment #1-24)
BUG=97261
TEST=see part 3 of 3.
Review URL: http://codereview.chromium.org/8659033
git-svn-id: svn://svn.chromium.org/chrome/trunk/src@113095 0039d316-1c4b-4281-b951-d872f2087c98
-rw-r--r-- | ui/base/ime/input_method.h | 124 | ||||
-rw-r--r-- | ui/base/ime/input_method_base.cc | 91 | ||||
-rw-r--r-- | ui/base/ime/input_method_base.h | 89 | ||||
-rw-r--r-- | ui/base/ime/input_method_delegate.h | 33 | ||||
-rw-r--r-- | ui/base/ime/input_method_ibus.cc | 948 | ||||
-rw-r--r-- | ui/base/ime/input_method_ibus.h | 199 | ||||
-rw-r--r-- | ui/base/ime/mock_input_method.cc | 123 | ||||
-rw-r--r-- | ui/base/ime/mock_input_method.h | 58 | ||||
-rw-r--r-- | ui/base/ime/text_input_client.h | 8 | ||||
-rw-r--r-- | ui/ui.gyp | 27 |
10 files changed, 1699 insertions, 1 deletions
diff --git a/ui/base/ime/input_method.h b/ui/base/ime/input_method.h new file mode 100644 index 0000000..2112660 --- /dev/null +++ b/ui/base/ime/input_method.h @@ -0,0 +1,124 @@ +// 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_BASE_IME_INPUT_METHOD_H_ +#define UI_BASE_IME_INPUT_METHOD_H_ +#pragma once + +#include <string> + +#include "base/basictypes.h" +#include "base/event_types.h" +#include "base/i18n/rtl.h" +#include "ui/base/ime/text_input_type.h" +#include "ui/base/keycodes/keyboard_codes.h" +#include "ui/base/ui_export.h" + +namespace ui { + +namespace internal { +class InputMethodDelegate; +} // namespace internal + +class TextInputClient; + +// An interface implemented by an object that encapsulates a native input method +// service provided by the underlying operating system, and acts as a "system +// wide" input method for all Chrome windows. A class that implements this +// interface should behave as follows: +// - Receives a keyboard event directly from a message dispatcher for the +// system through the InputMethod::DispatchKeyEvent API, and forwards it to +// an underlying input method for the OS. +// - The input method should handle the key event either of the following ways: +// 1) Send the original key down event to the focused window, which is e.g. +// a NativeWidgetAura (NWA) or a RenderWidgetHostViewAura (RWHVA), using +// internal::InputMethodDelegate::DispatchKeyEventPostIME API, then send +// a Char event using TextInputClient::InsertChar API to a text input +// client, which is, again, e.g. NWA or RWHVA, and then send the original +// key up event to the same window. +// 2) Send VKEY_PROCESSKEY event to the window using the DispatchKeyEvent API, +// then update IME status (e.g. composition text) using TextInputClient, +// and then send the original key up event to the window. +// - Keeps track of the focused TextInputClient to see which client can call +// APIs, OnTextInputTypeChanged, OnCaretBoundsChanged, and CancelComposition, +// that change the state of the input method. +// In Aura environment, aura::DesktopHost creates an instance of ui::InputMethod +// and owns it. +class UI_EXPORT InputMethod { + public: + virtual ~InputMethod() {} + + // Sets the delegate used by this InputMethod instance. It should only be + // called by an object which manages the whole UI (e.g. aura::DesktopHost). + virtual void SetDelegate(internal::InputMethodDelegate* delegate) = 0; + + // Initializes the InputMethod object. Pass true if the system toplevel window + // already has keyboard focus. + virtual void Init(bool focused) = 0; + + // Called when the top-level system window gets keyboard focus. + virtual void OnFocus() = 0; + + // Called when the top-level system window loses keyboard focus. + virtual void OnBlur() = 0; + + // Sets the text input client which receives text input events such as + // SetCompositionText(). |client| can be NULL. A gfx::NativeWindow which + // implementes TextInputClient interface, e.g. NWA and RWHVA, should register + // itself by calling the method when it is focused, and unregister itself by + // calling the metho with NULL when it is unfocused. + virtual void SetFocusedTextInputClient(TextInputClient* client) = 0; + + // Gets the current text input client. Returns NULL when no client is set. + virtual TextInputClient* GetTextInputClient() const = 0; + + // Dispatches a key event to the input method. The key event will be + // dispatched back to the caller via + // ui::InputMethodDelegate::DispatchKeyEventPostIME(), once it's processed by + // the input method. It should only be called by a message dispatcher. + virtual void DispatchKeyEvent(const base::NativeEvent& native_key_event) = 0; + + // TODO(yusukes): Add DispatchFabricatedKeyEvent to support virtual keyboards. + + // Called by the focused client whenever its text input type is changed. + // Before calling this method, the focused client must confirm or clear + // existing composition text and call InputMethod::CancelComposition() when + // necessary. Otherwise unexpected behavior may happen. This method has no + // effect if the client is not the focused client. + virtual void OnTextInputTypeChanged(const TextInputClient* client) = 0; + + // Called by the focused client whenever its caret bounds is changed. + // This method has no effect if the client is not the focused client. + virtual void OnCaretBoundsChanged(const TextInputClient* client) = 0; + + // Called by the focused client to ask the input method cancel the ongoing + // composition session. This method has no effect if the client is not the + // focused client. + virtual void CancelComposition(const TextInputClient* client) = 0; + + // Returns the locale of current keyboard layout or input method, as a BCP-47 + // tag, or an empty string if the input method cannot provide it. + virtual std::string GetInputLocale() = 0; + + // Returns the text direction of current keyboard layout or input method, or + // base::i18n::UNKNOWN_DIRECTION if the input method cannot provide it. + virtual base::i18n::TextDirection GetInputTextDirection() = 0; + + // Checks if the input method is active, i.e. if it's ready for processing + // keyboard event and generate composition or text result. + // If the input method is inactive, then it's not necessary to inform it the + // changes of caret bounds and text input type. + // Note: character results may still be generated and sent to the text input + // client by calling TextInputClient::InsertChar(), even if the input method + // is not active. + virtual bool IsActive() = 0; + + // Gets the text input type of the focused text input client. Returns + // ui::TEXT_INPUT_TYPE_NONE if there is no focused client. + virtual TextInputType GetTextInputType() const = 0; +}; + +} // namespace ui + +#endif // UI_BASE_IME_INPUT_METHOD_H_ diff --git a/ui/base/ime/input_method_base.cc b/ui/base/ime/input_method_base.cc new file mode 100644 index 0000000..b691fe8 --- /dev/null +++ b/ui/base/ime/input_method_base.cc @@ -0,0 +1,91 @@ +// 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. + +#include "ui/base/ime/input_method_base.h" + +#include "base/logging.h" +#include "ui/base/ime/input_method_delegate.h" +#include "ui/base/ime/text_input_client.h" + +namespace ui { + +InputMethodBase::InputMethodBase() + : delegate_(NULL), + text_input_client_(NULL), + system_toplevel_window_focused_(false) { +} + +InputMethodBase::~InputMethodBase() { +} + +void InputMethodBase::SetDelegate( + internal::InputMethodDelegate* delegate) { + delegate_ = delegate; +} + +void InputMethodBase::Init(bool focused) { + if (focused) + OnFocus(); +} + +void InputMethodBase::OnFocus() { + DCHECK(!system_toplevel_window_focused_); + system_toplevel_window_focused_ = true; +} + +void InputMethodBase::OnBlur() { + DCHECK(system_toplevel_window_focused_); + system_toplevel_window_focused_ = false; +} + +void InputMethodBase::SetFocusedTextInputClient(TextInputClient* client) { + TextInputClient* old = text_input_client_; + OnWillChangeFocusedClient(old, client); + text_input_client_ = client; // NULL allowed. + OnDidChangeFocusedClient(old, client); +} + +TextInputClient* InputMethodBase::GetTextInputClient() const { + return system_toplevel_window_focused_ ? text_input_client_ : NULL; +} + +void InputMethodBase::OnTextInputTypeChanged(const TextInputClient* client) { + if (!IsTextInputClientFocused(client)) + return; + // TODO(yusukes): Support TextInputTypeTracker for TOUCH_UI. +} + +TextInputType InputMethodBase::GetTextInputType() const { + TextInputClient* client = GetTextInputClient(); + return client ? client->GetTextInputType() : TEXT_INPUT_TYPE_NONE; +} + +bool InputMethodBase::IsTextInputClientFocused(const TextInputClient* client) { + return client && (client == GetTextInputClient()); +} + +bool InputMethodBase::IsTextInputTypeNone() const { + return GetTextInputType() == TEXT_INPUT_TYPE_NONE; +} + +void InputMethodBase::OnInputMethodChanged() const { + TextInputClient* client = GetTextInputClient(); + if (client && client->GetTextInputType() != TEXT_INPUT_TYPE_NONE) + client->OnInputMethodChanged(); +} + +void InputMethodBase::DispatchKeyEventPostIME( + const base::NativeEvent& native_event) const { + if (delegate_) + delegate_->DispatchKeyEventPostIME(native_event); +} + +void InputMethodBase::DispatchFabricatedKeyEventPostIME(EventType type, + KeyboardCode key_code, + int flags) const { + if (delegate_) + delegate_->DispatchFabricatedKeyEventPostIME(type, key_code, flags); +} + +} // namespace ui diff --git a/ui/base/ime/input_method_base.h b/ui/base/ime/input_method_base.h new file mode 100644 index 0000000..1e511b5 --- /dev/null +++ b/ui/base/ime/input_method_base.h @@ -0,0 +1,89 @@ +// 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_BASE_IME_INPUT_METHOD_BASE_H_ +#define UI_BASE_IME_INPUT_METHOD_BASE_H_ +#pragma once + +#include "base/basictypes.h" +#include "base/compiler_specific.h" +#include "ui/base/events.h" +#include "ui/base/ime/input_method.h" +#include "ui/base/ui_export.h" + +namespace gfx { +class Rect; +} // namespace gfx + +namespace ui { + +class TextInputClient; + +// A helper class providing functionalities shared among ui::InputMethod +// implementations. +class UI_EXPORT InputMethodBase : public InputMethod { + public: + InputMethodBase(); + virtual ~InputMethodBase(); + + // Overriden from InputMethod. + virtual void SetDelegate(internal::InputMethodDelegate* delegate) OVERRIDE; + virtual void Init(bool focused) OVERRIDE; + // If a derived class overrides OnFocus()/OnBlur(), it should call parent's + // implementation first, to make sure |system_toplevel_window_focused_| flag + // can be updated correctly. + virtual void OnFocus() OVERRIDE; + virtual void OnBlur() OVERRIDE; + virtual void SetFocusedTextInputClient(TextInputClient* client) OVERRIDE; + virtual TextInputClient* GetTextInputClient() const OVERRIDE; + + // If a derived class overrides this method, it should call parent's + // implementation. + virtual void OnTextInputTypeChanged(const TextInputClient* client) OVERRIDE; + + virtual TextInputType GetTextInputType() const OVERRIDE; + + protected: + virtual void OnWillChangeFocusedClient(TextInputClient* focused_before, + TextInputClient* focused) {} + virtual void OnDidChangeFocusedClient(TextInputClient* focused_before, + TextInputClient* focused) {} + + // Returns true if |client| is currently focused. + bool IsTextInputClientFocused(const TextInputClient* client); + + // Checks if the focused text input client's text input type is + // TEXT_INPUT_TYPE_NONE. Also returns true if there is no focused text + // input client. + bool IsTextInputTypeNone() const; + + // Convenience method to call the focused text input client's + // OnInputMethodChanged() method. It'll only take effect if the current text + // input type is not TEXT_INPUT_TYPE_NONE. + void OnInputMethodChanged() const; + + // Convenience method to call delegate_->DispatchKeyEventPostIME(). + void DispatchKeyEventPostIME(const base::NativeEvent& native_event) const; + + // Convenience method to call delegate_->DispatchFabricatedKeyEventPostIME(). + void DispatchFabricatedKeyEventPostIME(EventType type, + KeyboardCode key_code, + int flags) const; + + bool system_toplevel_window_focused() const { + return system_toplevel_window_focused_; + } + + private: + internal::InputMethodDelegate* delegate_; + TextInputClient* text_input_client_; + + bool system_toplevel_window_focused_; + + DISALLOW_COPY_AND_ASSIGN(InputMethodBase); +}; + +} // namespace ui + +#endif // UI_BASE_IME_INPUT_METHOD_BASE_H_ diff --git a/ui/base/ime/input_method_delegate.h b/ui/base/ime/input_method_delegate.h new file mode 100644 index 0000000..9a84730 --- /dev/null +++ b/ui/base/ime/input_method_delegate.h @@ -0,0 +1,33 @@ +// 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_BASE_IME_INPUT_METHOD_DELEGATE_H_ +#define UI_BASE_IME_INPUT_METHOD_DELEGATE_H_ +#pragma once + +#include "base/event_types.h" +#include "ui/base/events.h" +#include "ui/base/ui_export.h" + +namespace ui { +namespace internal { + +// An interface implemented by the object that handles events sent back from an +// ui::InputMethod implementation. +class UI_EXPORT InputMethodDelegate { + public: + virtual ~InputMethodDelegate() {} + + // Dispatch a key event already processed by the input method. + virtual void DispatchKeyEventPostIME( + const base::NativeEvent& native_key_event) = 0; + virtual void DispatchFabricatedKeyEventPostIME(ui::EventType type, + ui::KeyboardCode key_code, + int flags) = 0; +}; + +} // namespace internal +} // namespace ui + +#endif // UI_BASE_IME_INPUT_METHOD_DELEGATE_H_ diff --git a/ui/base/ime/input_method_ibus.cc b/ui/base/ime/input_method_ibus.cc new file mode 100644 index 0000000..0487519 --- /dev/null +++ b/ui/base/ime/input_method_ibus.cc @@ -0,0 +1,948 @@ +// 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. + +#include "ui/base/ime/input_method_ibus.h" + +#include <ibus.h> + +#include <X11/X.h> +#include <X11/Xlib.h> +#include <X11/Xutil.h> + +#include <algorithm> +#include <cstring> +#include <set> +#include <vector> + +#include "base/basictypes.h" +#include "base/i18n/char_iterator.h" +#include "base/logging.h" +#include "base/string_util.h" +#include "base/third_party/icu/icu_utf.h" +#include "base/utf_string_conversions.h" +#include "ui/base/events.h" +#include "ui/base/ime/text_input_client.h" +#include "ui/base/keycodes/keyboard_codes.h" +#include "ui/base/keycodes/keyboard_code_conversion.h" +#include "ui/base/keycodes/keyboard_code_conversion_x.h" +#include "ui/gfx/rect.h" + +namespace { + +XKeyEvent* GetKeyEvent(XEvent* event) { + DCHECK(event && (event->type == KeyPress || event->type == KeyRelease)); + return &event->xkey; +} + +// Converts ibus key state flags to event flags. +int EventFlagsFromIBusState(guint32 state) { + return (state & IBUS_LOCK_MASK ? ui::EF_CAPS_LOCK_DOWN : 0) | + (state & IBUS_CONTROL_MASK ? ui::EF_CONTROL_DOWN : 0) | + (state & IBUS_SHIFT_MASK ? ui::EF_SHIFT_DOWN : 0) | + (state & IBUS_MOD1_MASK ? ui::EF_ALT_DOWN : 0) | + (state & IBUS_BUTTON1_MASK ? ui::EF_LEFT_BUTTON_DOWN : 0) | + (state & IBUS_BUTTON2_MASK ? ui::EF_MIDDLE_BUTTON_DOWN : 0) | + (state & IBUS_BUTTON3_MASK ? ui::EF_RIGHT_BUTTON_DOWN : 0); +} + +// Converts X flags to ibus key state flags. +guint32 IBusStateFromXFlags(unsigned int flags) { + return (flags & LockMask ? IBUS_LOCK_MASK : 0U) | + (flags & ControlMask ? IBUS_CONTROL_MASK : 0U) | + (flags & ShiftMask ? IBUS_SHIFT_MASK : 0U) | + (flags & Mod1Mask ? IBUS_MOD1_MASK : 0U) | + (flags & Button1Mask ? IBUS_BUTTON1_MASK : 0U) | + (flags & Button2Mask ? IBUS_BUTTON2_MASK : 0U) | + (flags & Button3Mask ? IBUS_BUTTON3_MASK : 0U); +} + +// Converts X flags to event flags. +guint32 EventFlagsFromXFlags(unsigned int flags) { + return EventFlagsFromIBusState(IBusStateFromXFlags(flags)); +} + +void IBusKeyEventFromNativeKeyEvent(const base::NativeEvent& native_event, + guint32* ibus_keyval, + guint32* ibus_keycode, + guint32* ibus_state) { + DCHECK(native_event); // A fabricated event is not supported here. + XKeyEvent* x_key = GetKeyEvent(native_event); + + // Yes, ibus uses X11 keysym. We cannot use XLookupKeysym(), which doesn't + // translate Shift and CapsLock states. + KeySym keysym = NoSymbol; + ::XLookupString(x_key, NULL, 0, &keysym, NULL); + *ibus_keyval = keysym; + *ibus_keycode = x_key->keycode; + *ibus_state = IBusStateFromXFlags(x_key->state); + if (native_event->type == KeyRelease) + *ibus_state |= IBUS_RELEASE_MASK; +} + +void ExtractCompositionTextFromIBusPreedit(IBusText* text, + guint cursor_position, + ui::CompositionText* composition) { + composition->Clear(); + composition->text = UTF8ToUTF16(text->text); + + if (composition->text.empty()) + return; + + // ibus uses character index for cursor position and attribute range, but we + // use char16 offset for them. So we need to do conversion here. + std::vector<size_t> char16_offsets; + size_t length = composition->text.length(); + base::i18n::UTF16CharIterator char_iterator(&composition->text); + do { + char16_offsets.push_back(char_iterator.array_pos()); + } while (char_iterator.Advance()); + + // The text length in Unicode characters. + guint char_length = static_cast<guint>(char16_offsets.size()); + // Make sure we can convert the value of |char_length| as well. + char16_offsets.push_back(length); + + size_t cursor_offset = + char16_offsets[std::min(char_length, cursor_position)]; + + composition->selection = ui::Range(cursor_offset); + if (text->attrs) { + guint i = 0; + while (true) { + IBusAttribute* attr = ibus_attr_list_get(text->attrs, i++); + if (!attr) + break; + if (attr->type != IBUS_ATTR_TYPE_UNDERLINE && + attr->type != IBUS_ATTR_TYPE_BACKGROUND) { + continue; + } + guint start = std::min(char_length, attr->start_index); + guint end = std::min(char_length, attr->end_index); + if (start >= end) + continue; + ui::CompositionUnderline underline( + char16_offsets[start], char16_offsets[end], + SK_ColorBLACK, false /* thick */); + if (attr->type == IBUS_ATTR_TYPE_BACKGROUND) { + underline.thick = true; + // If the cursor is at start or end of this underline, then we treat + // it as the selection range as well, but make sure to set the cursor + // position to the selection end. + if (underline.start_offset == cursor_offset) { + composition->selection.set_start(underline.end_offset); + composition->selection.set_end(cursor_offset); + } else if (underline.end_offset == cursor_offset) { + composition->selection.set_start(underline.start_offset); + composition->selection.set_end(cursor_offset); + } + } else if (attr->type == IBUS_ATTR_TYPE_UNDERLINE) { + if (attr->value == IBUS_ATTR_UNDERLINE_DOUBLE) + underline.thick = true; + else if (attr->value == IBUS_ATTR_UNDERLINE_ERROR) + underline.color = SK_ColorRED; + } + composition->underlines.push_back(underline); + } + } + + // Use a black thin underline by default. + if (composition->underlines.empty()) { + composition->underlines.push_back(ui::CompositionUnderline( + 0, length, SK_ColorBLACK, false /* thick */)); + } +} + +} // namespace + +namespace ui { + +// InputMethodIBus::PendingKeyEvent implementation ------------------------ +class InputMethodIBus::PendingKeyEvent { + public: + PendingKeyEvent(InputMethodIBus* input_method, + const base::NativeEvent& native_event, + guint32 ibus_keyval); + ~PendingKeyEvent(); + + // Abandon this pending key event. Its result will just be discarded. + void Abandon() { input_method_ = NULL; } + + InputMethodIBus* input_method() const { return input_method_; } + + // Process this pending key event after we receive its result from the input + // method. It just call through InputMethodIBus::ProcessKeyEventPostIME(). + void ProcessPostIME(bool handled); + + private: + InputMethodIBus* input_method_; + + // TODO(yusukes): To support a fabricated key event (which is typically from + // a virtual keyboard), we might have to copy event type, event flags, key + // code, 'character_', and 'unmodified_character_'. See views::InputMethodIBus + // for details. + + // corresponding XEvent data of a key event. It's a plain struct so we can do + // bitwise copy. + XKeyEvent x_event_; + + const guint32 ibus_keyval_; + + DISALLOW_COPY_AND_ASSIGN(PendingKeyEvent); +}; + +InputMethodIBus::PendingKeyEvent::PendingKeyEvent( + InputMethodIBus* input_method, + const base::NativeEvent& native_event, + guint32 ibus_keyval) + : input_method_(input_method), + ibus_keyval_(ibus_keyval) { + DCHECK(input_method_); + + // TODO(yusukes): Support non-native event (from e.g. a virtual keyboard). + DCHECK(native_event); + x_event_ = *GetKeyEvent(native_event); +} + +InputMethodIBus::PendingKeyEvent::~PendingKeyEvent() { + if (input_method_) + input_method_->FinishPendingKeyEvent(this); +} + +void InputMethodIBus::PendingKeyEvent::ProcessPostIME(bool handled) { + if (!input_method_) + return; + + if (x_event_.type == KeyPress || x_event_.type == KeyRelease) { + input_method_->ProcessKeyEventPostIME(reinterpret_cast<XEvent*>(&x_event_), + ibus_keyval_, + handled); + return; + } + + // TODO(yusukes): Support non-native event (from e.g. a virtual keyboard). + // See views::InputMethodIBus for details. Never forget to set 'character_' + // and 'unmodified_character_' to support i18n VKs like a French VK! +} + +// InputMethodIBus::PendingCreateICRequest implementation ----------------- +class InputMethodIBus::PendingCreateICRequest { + public: + PendingCreateICRequest(InputMethodIBus* input_method, + PendingCreateICRequest** request_ptr); + ~PendingCreateICRequest(); + + // Abandon this pending key event. Its result will just be discarded. + void Abandon() { + input_method_ = NULL; + request_ptr_ = NULL; + } + + // Stores the result input context to |input_method_|, or abandon it if + // |input_method_| is NULL. + void StoreOrAbandonInputContext(IBusInputContext* ic); + + private: + InputMethodIBus* input_method_; + PendingCreateICRequest** request_ptr_; +}; + +InputMethodIBus::PendingCreateICRequest::PendingCreateICRequest( + InputMethodIBus* input_method, + PendingCreateICRequest** request_ptr) + : input_method_(input_method), + request_ptr_(request_ptr) { +} + +InputMethodIBus::PendingCreateICRequest::~PendingCreateICRequest() { + if (request_ptr_) { + DCHECK_EQ(*request_ptr_, this); + *request_ptr_ = NULL; + } +} + +void InputMethodIBus::PendingCreateICRequest::StoreOrAbandonInputContext( + IBusInputContext* ic) { + if (input_method_) { + input_method_->SetContext(ic); + } else { + // ibus_proxy_destroy() will not really release the object, we still need + // to call g_object_unref() explicitly. + ibus_proxy_destroy(reinterpret_cast<IBusProxy *>(ic)); + g_object_unref(ic); + } +} + +// InputMethodIBus implementation ----------------------------------------- +InputMethodIBus::InputMethodIBus( + internal::InputMethodDelegate* delegate) + : context_(NULL), + pending_create_ic_request_(NULL), + context_focused_(false), + composing_text_(false), + composition_changed_(false), + suppress_next_result_(false) { + SetDelegate(delegate); +} + +InputMethodIBus::~InputMethodIBus() { + AbandonAllPendingKeyEvents(); + DestroyContext(); + + // Disconnect bus signals + g_signal_handlers_disconnect_by_func( + GetIBus(), reinterpret_cast<gpointer>(OnIBusConnectedThunk), this); + g_signal_handlers_disconnect_by_func( + GetIBus(), reinterpret_cast<gpointer>(OnIBusDisconnectedThunk), this); +} + +void InputMethodIBus::OnFocus() { + InputMethodBase::OnFocus(); + UpdateContextFocusState(); +} + +void InputMethodIBus::OnBlur() { + ConfirmCompositionText(); + InputMethodBase::OnBlur(); + UpdateContextFocusState(); +} + +void InputMethodIBus::Init(bool focused) { + // Initializes the connection to ibus daemon. It may happen asynchronously, + // and as soon as the connection is established, the |context_| will be + // created automatically. + IBusBus* bus = GetIBus(); + + // connect bus signals + g_signal_connect(bus, "connected", + G_CALLBACK(OnIBusConnectedThunk), this); + g_signal_connect(bus, "disconnected", + G_CALLBACK(OnIBusDisconnectedThunk), this); + + // Creates the |context_| if the connection is already established. In such + // case, we will not get "connected" signal. + if (ibus_bus_is_connected(bus)) + CreateContext(); + + InputMethodBase::Init(focused); +} + +void InputMethodIBus::DispatchKeyEvent(const base::NativeEvent& native_event) { + DCHECK(native_event && (native_event->type == KeyPress || + native_event->type == KeyRelease)); + DCHECK(system_toplevel_window_focused()); + + guint32 ibus_keyval = 0; + guint32 ibus_keycode = 0; + guint32 ibus_state = 0; + IBusKeyEventFromNativeKeyEvent( + native_event, &ibus_keyval, &ibus_keycode, &ibus_state); + + // If |context_| is not usable, then we can only dispatch the key event as is. + // We also dispatch the key event directly if the current text input type is + // TEXT_INPUT_TYPE_PASSWORD, to bypass the input method. + // Note: We need to send the key event to ibus even if the |context_| is not + // enabled, so that ibus can have a chance to enable the |context_|. + if (!context_focused_ || + GetTextInputType() == TEXT_INPUT_TYPE_PASSWORD) { + if (native_event->type == KeyPress) + ProcessUnfilteredKeyPressEvent(native_event, ibus_keyval); + else + DispatchKeyEventPostIME(native_event); + return; + } + + PendingKeyEvent* pending_key = + new PendingKeyEvent(this, native_event, ibus_keyval); + pending_key_events_.insert(pending_key); + + // Note: + // 1. We currently set timeout to -1, because ibus doesn't have a mechanism to + // associate input method results to corresponding key event, thus there is + // actually no way to abandon results generated by a specific key event. So we + // actually cannot abandon a specific key event and its result but accept + // following key events and their results. So a timeout to abandon a key event + // will not work. + // 2. We set GCancellable to NULL, because the operation of cancelling a async + // request also happens asynchronously, thus it's actually useless to us. + // + // The fundemental problem of ibus' async API is: it uses Glib's GIO API to + // realize async communication, but in fact, GIO API is specially designed for + // concurrent tasks, though it supports async communication as well, the API + // is much more complicated than an ordinary message based async communication + // API (such as Chrome's IPC). + // Thus it's very complicated, if not impossible, to implement a client that + // fully utilize asynchronous communication without potential problem. + ibus_input_context_process_key_event_async( + context_, + ibus_keyval, ibus_keycode, ibus_state, -1, NULL, + reinterpret_cast<GAsyncReadyCallback>(ProcessKeyEventDone), + pending_key); + + // We don't want to suppress the result generated by this key event, but it + // may cause problem. See comment in ResetContext() method. + suppress_next_result_ = false; +} + +void InputMethodIBus::OnTextInputTypeChanged(const TextInputClient* client) { + if (context_ && IsTextInputClientFocused(client)) { + ResetContext(); + UpdateContextFocusState(); + } + InputMethodBase::OnTextInputTypeChanged(client); +} + +void InputMethodIBus::OnCaretBoundsChanged(const TextInputClient* client) { + if (!context_focused_ || !IsTextInputClientFocused(client)) + return; + + // The current text input type should not be NONE if |context_| is focused. + DCHECK(!IsTextInputTypeNone()); + const gfx::Rect rect = GetTextInputClient()->GetCaretBounds(); + + // This function runs asynchronously. + ibus_input_context_set_cursor_location( + context_, rect.x(), rect.y(), rect.width(), rect.height()); +} + +void InputMethodIBus::CancelComposition(const TextInputClient* client) { + if (context_focused_ && IsTextInputClientFocused(client)) + ResetContext(); +} + +std::string InputMethodIBus::GetInputLocale() { + // Not supported. + return ""; +} + +base::i18n::TextDirection InputMethodIBus::GetInputTextDirection() { + // Not supported. + return base::i18n::UNKNOWN_DIRECTION; +} + +bool InputMethodIBus::IsActive() { + return true; +} + +void InputMethodIBus::OnWillChangeFocusedClient(TextInputClient* focused_before, + TextInputClient* focused) { + ConfirmCompositionText(); +} + +void InputMethodIBus::OnDidChangeFocusedClient(TextInputClient* focused_before, + TextInputClient* focused) { + // Force to update the input type since client's TextInputStateChanged() + // function might not be called if text input types before the client loses + // focus and after it acquires focus again are the same. + OnTextInputTypeChanged(focused); + + UpdateContextFocusState(); + // Force to update caret bounds, in case the client thinks that the caret + // bounds has not changed. + if (context_focused_) + OnCaretBoundsChanged(focused); +} + +void InputMethodIBus::CreateContext() { + DCHECK(!context_); + DCHECK(GetIBus()); + DCHECK(ibus_bus_is_connected(GetIBus())); + DCHECK(!pending_create_ic_request_); + + // Creates the input context asynchronously. + pending_create_ic_request_ = new PendingCreateICRequest( + this, &pending_create_ic_request_); + ibus_bus_create_input_context_async( + GetIBus(), "chrome", -1, NULL, + reinterpret_cast<GAsyncReadyCallback>(CreateInputContextDone), + pending_create_ic_request_); +} + +void InputMethodIBus::SetContext(IBusInputContext* ic) { + DCHECK(ic); + DCHECK(!context_); + context_ = ic; + + // connect input context signals + g_signal_connect(ic, "commit-text", + G_CALLBACK(OnCommitTextThunk), this); + g_signal_connect(ic, "forward-key-event", + G_CALLBACK(OnForwardKeyEventThunk), this); + g_signal_connect(ic, "update-preedit-text", + G_CALLBACK(OnUpdatePreeditTextThunk), this); + g_signal_connect(ic, "show-preedit-text", + G_CALLBACK(OnShowPreeditTextThunk), this); + g_signal_connect(ic, "hide-preedit-text", + G_CALLBACK(OnHidePreeditTextThunk), this); + g_signal_connect(ic, "destroy", + G_CALLBACK(OnDestroyThunk), this); + + // TODO(suzhe): support surrounding text. + guint32 caps = IBUS_CAP_PREEDIT_TEXT | IBUS_CAP_FOCUS; + ibus_input_context_set_capabilities(ic, caps); + + UpdateContextFocusState(); + OnInputMethodChanged(); +} + +void InputMethodIBus::DestroyContext() { + if (pending_create_ic_request_) { + DCHECK(!context_); + // |pending_create_ic_request_| will be deleted in CreateInputContextDone(). + pending_create_ic_request_->Abandon(); + pending_create_ic_request_ = NULL; + } else if (context_) { + // ibus_proxy_destroy() will not really release the resource of |context_| + // object. We still need to handle "destroy" signal and call + // g_object_unref() there. + ibus_proxy_destroy(reinterpret_cast<IBusProxy *>(context_)); + DCHECK(!context_); + } +} + +void InputMethodIBus::ConfirmCompositionText() { + TextInputClient* client = GetTextInputClient(); + if (client && client->HasCompositionText()) + client->ConfirmCompositionText(); + + ResetContext(); +} + +void InputMethodIBus::ResetContext() { + if (!context_focused_ || !GetTextInputClient()) + return; + + DCHECK(system_toplevel_window_focused()); + + // Because ibus runs in asynchronous mode, the input method may still send us + // results after sending out the reset request, so we use a flag to discard + // all results generated by previous key events. But because ibus does not + // have a mechanism to identify each key event and corresponding results, this + // approach will not work for some corner cases. For example if the user types + // very fast, then the next key event may come in before the |context_| is + // really reset. Then we actually cannot know whether or not the next + // result should be discard. + suppress_next_result_ = true; + + composition_.Clear(); + result_text_.clear(); + composing_text_ = false; + composition_changed_ = false; + + // We need to abandon all pending key events, but as above comment says, there + // is no reliable way to abandon all results generated by these abandoned key + // events. + AbandonAllPendingKeyEvents(); + + // This function runs asynchronously. + // Note: some input method engines may not support reset method, such as + // ibus-anthy. But as we control all input method engines by ourselves, we can + // make sure that all of the engines we are using support it correctly. + ibus_input_context_reset(context_); + + character_composer_.Reset(); +} + +void InputMethodIBus::UpdateContextFocusState() { + if (!context_) { + context_focused_ = false; + return; + } + + const bool old_context_focused = context_focused_; + // Use switch here in case we are going to add more text input types. + switch (GetTextInputType()) { + case TEXT_INPUT_TYPE_NONE: + case TEXT_INPUT_TYPE_PASSWORD: + context_focused_ = false; + break; + default: + context_focused_ = true; + break; + } + + // We only focus in |context_| when the focus is in a normal textfield. + // ibus_input_context_focus_{in|out}() run asynchronously. + if (old_context_focused && !context_focused_) + ibus_input_context_focus_out(context_); + else if (!old_context_focused && context_focused_) + ibus_input_context_focus_in(context_); +} + +void InputMethodIBus::ProcessKeyEventPostIME( + const base::NativeEvent& native_event, + guint32 ibus_keyval, + bool handled) { + TextInputClient* client = GetTextInputClient(); + + if (!client) { + // As ibus works asynchronously, there is a chance that the focused client + // loses focus before this method gets called. + DispatchKeyEventPostIME(native_event); + return; + } + + if (native_event->type == KeyPress && handled) + ProcessFilteredKeyPressEvent(native_event); + + // In case the focus was changed by the key event. The |context_| should have + // been reset when the focused window changed. + if (client != GetTextInputClient()) + return; + + if (HasInputMethodResult()) + ProcessInputMethodResult(native_event, handled); + + // In case the focus was changed when sending input method results to the + // focused window. + if (client != GetTextInputClient()) + return; + + if (native_event->type == KeyPress && !handled) + ProcessUnfilteredKeyPressEvent(native_event, ibus_keyval); + else if (native_event->type == KeyRelease) + DispatchKeyEventPostIME(native_event); +} + +void InputMethodIBus::ProcessFilteredKeyPressEvent( + const base::NativeEvent& native_event) { + if (NeedInsertChar()) + DispatchKeyEventPostIME(native_event); + else + DispatchFabricatedKeyEventPostIME( + ET_KEY_PRESSED, + VKEY_PROCESSKEY, + EventFlagsFromXFlags(GetKeyEvent(native_event)->state)); +} + +void InputMethodIBus::ProcessUnfilteredKeyPressEvent( + const base::NativeEvent& native_event, + guint32 ibus_keyval) { + // For a fabricated event, ProcessUnfilteredFabricatedKeyPressEvent should be + // called instead. + DCHECK(native_event); + + TextInputClient* client = GetTextInputClient(); + DispatchKeyEventPostIME(native_event); + + // We shouldn't dispatch the character anymore if the key event dispatch + // caused focus change. For example, in the following scenario, + // 1. visit a web page which has a <textarea>. + // 2. click Omnibox. + // 3. enable Korean IME, press A, then press Tab to move the focus to the web + // page. + // We should return here not to send the Tab key event to RWHV. + if (client != GetTextInputClient()) + return; + + // Process compose and dead keys + if (character_composer_.FilterKeyPress(ibus_keyval)) { + string16 composed = character_composer_.composed_character(); + if (!composed.empty()) { + client = GetTextInputClient(); + if (client) + client->InsertText(composed); + } + return; + } + + // If a key event was not filtered by |context_| and |character_composer_|, + // then it means the key event didn't generate any result text. So we need + // to send corresponding character to the focused text input client. + client = GetTextInputClient(); + + const uint32 state = + EventFlagsFromXFlags(GetKeyEvent(native_event)->state); + uint16 ch = ui::DefaultSymbolFromXEvent(native_event); + if (!ch) { + ch = ui::GetCharacterFromKeyCode( + ui::KeyboardCodeFromNative(native_event), state); + } + + if (client && ch) + client->InsertChar(ch, state); +} + +void InputMethodIBus::ProcessUnfilteredFabricatedKeyPressEvent( + EventType type, + KeyboardCode key_code, + int flags, + guint32 ibus_keyval) { + TextInputClient* client = GetTextInputClient(); + DispatchFabricatedKeyEventPostIME(type, key_code, flags); + + if (client != GetTextInputClient()) + return; + + if (character_composer_.FilterKeyPress(ibus_keyval)) { + string16 composed = character_composer_.composed_character(); + if (!composed.empty()) { + client = GetTextInputClient(); + if (client) + client->InsertText(composed); + } + return; + } + + client = GetTextInputClient(); + const uint16 ch = ui::GetCharacterFromKeyCode(key_code, flags); + if (client && ch) + client->InsertChar(ch, flags); +} + +void InputMethodIBus::ProcessInputMethodResult( + const base::NativeEvent& native_event, + bool handled) { + TextInputClient* client = GetTextInputClient(); + DCHECK(client); + + if (result_text_.length()) { + if (handled && NeedInsertChar()) { + const uint32 state = + EventFlagsFromXFlags(GetKeyEvent(native_event)->state); + for (string16::const_iterator i = result_text_.begin(); + i != result_text_.end(); ++i) { + client->InsertChar(*i, state); + } + } else { + client->InsertText(result_text_); + composing_text_ = false; + } + } + + if (composition_changed_ && !IsTextInputTypeNone()) { + if (composition_.text.length()) { + composing_text_ = true; + client->SetCompositionText(composition_); + } else if (result_text_.empty()) { + client->ClearCompositionText(); + } + } + + // We should not clear composition text here, as it may belong to the next + // composition session. + result_text_.clear(); + composition_changed_ = false; +} + +bool InputMethodIBus::NeedInsertChar() const { + return GetTextInputClient() && + (IsTextInputTypeNone() || + (!composing_text_ && result_text_.length() == 1)); +} + +bool InputMethodIBus::HasInputMethodResult() const { + return result_text_.length() || composition_changed_; +} + +void InputMethodIBus::SendFakeProcessKeyEvent(bool pressed) const { + DispatchFabricatedKeyEventPostIME(pressed ? ET_KEY_PRESSED : ET_KEY_RELEASED, + VKEY_PROCESSKEY, + 0); +} + +void InputMethodIBus::FinishPendingKeyEvent(PendingKeyEvent* pending_key) { + DCHECK(pending_key_events_.count(pending_key)); + + // |pending_key| will be deleted in ProcessKeyEventDone(). + pending_key_events_.erase(pending_key); +} + +void InputMethodIBus::AbandonAllPendingKeyEvents() { + for (std::set<PendingKeyEvent*>::iterator i = pending_key_events_.begin(); + i != pending_key_events_.end(); ++i) { + // The object will be deleted in ProcessKeyEventDone(). + (*i)->Abandon(); + } + pending_key_events_.clear(); +} + +void InputMethodIBus::OnCommitText( + IBusInputContext* context, IBusText* text) { + DCHECK_EQ(context_, context); + if (suppress_next_result_ || !text || !text->text) + return; + + // We need to receive input method result even if the text input type is + // TEXT_INPUT_TYPE_NONE, to make sure we can always send correct + // character for each key event to the focused text input client. + if (!GetTextInputClient()) + return; + + string16 utf16_text(UTF8ToUTF16(text->text)); + + // Append the text to the buffer, because commit signal might be fired + // multiple times when processing a key event. + result_text_.append(utf16_text); + + // If we are not handling key event, do not bother sending text result if the + // focused text input client does not support text input. + if (pending_key_events_.empty() && !IsTextInputTypeNone()) { + SendFakeProcessKeyEvent(true); + GetTextInputClient()->InsertText(utf16_text); + SendFakeProcessKeyEvent(false); + result_text_.clear(); + } +} + +void InputMethodIBus::OnForwardKeyEvent(IBusInputContext* context, + guint keyval, + guint keycode, + guint state) { + DCHECK_EQ(context_, context); + + KeyboardCode ui_key_code = KeyboardCodeFromXKeysym(keyval); + if (!ui_key_code) + return; + + const EventType event = + (state & IBUS_RELEASE_MASK) ? ET_KEY_RELEASED : ET_KEY_PRESSED; + const int flags = EventFlagsFromIBusState(state); + + // It is not clear when the input method will forward us a fake key event. + // If there is a pending key event, then we may already received some input + // method results, so we dispatch this fake key event directly rather than + // calling ProcessKeyEventPostIME(), which will clear pending input method + // results. + if (event == ET_KEY_PRESSED) + ProcessUnfilteredFabricatedKeyPressEvent(event, ui_key_code, flags, keyval); + else + DispatchFabricatedKeyEventPostIME(event, ui_key_code, flags); +} + +void InputMethodIBus::OnShowPreeditText(IBusInputContext* context) { + DCHECK_EQ(context_, context); + if (suppress_next_result_ || IsTextInputTypeNone()) + return; + + composing_text_ = true; +} + +void InputMethodIBus::OnUpdatePreeditText(IBusInputContext* context, + IBusText* text, + guint cursor_pos, + gboolean visible) { + DCHECK_EQ(context_, context); + if (suppress_next_result_ || IsTextInputTypeNone()) + return; + + // |visible| argument is very confusing. For example, what's the correct + // behavior when: + // 1. OnUpdatePreeditText() is called with a text and visible == false, then + // 2. OnShowPreeditText() is called afterwards. + // + // If it's only for clearing the current preedit text, then why not just use + // OnHidePreeditText()? + if (!visible) { + OnHidePreeditText(context); + return; + } + + ExtractCompositionTextFromIBusPreedit(text, cursor_pos, &composition_); + + composition_changed_ = true; + + // In case OnShowPreeditText() is not called. + if (composition_.text.length()) + composing_text_ = true; + + // If we receive a composition text without pending key event, then we need to + // send it to the focused text input client directly. + if (pending_key_events_.empty()) { + SendFakeProcessKeyEvent(true); + GetTextInputClient()->SetCompositionText(composition_); + SendFakeProcessKeyEvent(false); + composition_changed_ = false; + composition_.Clear(); + } +} + +void InputMethodIBus::OnHidePreeditText(IBusInputContext* context) { + DCHECK_EQ(context_, context); + if (composition_.text.empty() || IsTextInputTypeNone()) + return; + + // Intentionally leaves |composing_text_| unchanged. + composition_changed_ = true; + composition_.Clear(); + + if (pending_key_events_.empty()) { + TextInputClient* client = GetTextInputClient(); + if (client && client->HasCompositionText()) + client->ClearCompositionText(); + composition_changed_ = false; + } +} + +void InputMethodIBus::OnDestroy(IBusInputContext* context) { + DCHECK_EQ(context_, context); + g_object_unref(context_); + context_ = NULL; + context_focused_ = false; + + ConfirmCompositionText(); + + // We are dead, so we need to ask the client to stop relying on us. + // We cannot do it in DestroyContext(), because OnDestroy() may be called + // automatically. + OnInputMethodChanged(); +} + +void InputMethodIBus::OnIBusConnected(IBusBus* bus) { + DCHECK_EQ(GetIBus(), bus); + DCHECK(ibus_bus_is_connected(bus)); + + DestroyContext(); + CreateContext(); +} + +void InputMethodIBus::OnIBusDisconnected(IBusBus* bus) { + DCHECK_EQ(GetIBus(), bus); + + // TODO(suzhe): Make sure if we really do not need to handle this signal. + // And I'm actually wondering if ibus-daemon will release the resource of the + // |context_| correctly when the connection is lost. +} + +// static +IBusBus* InputMethodIBus::GetIBus() { + // Everything happens in UI thread, so we do not need to care about + // synchronization issue. + static IBusBus* ibus = NULL; + + if (!ibus) { + ibus_init(); + ibus = ibus_bus_new(); + DCHECK(ibus); + } + return ibus; +} + +// static +void InputMethodIBus::ProcessKeyEventDone(IBusInputContext* context, + GAsyncResult* res, + PendingKeyEvent* data) { + DCHECK(data); + DCHECK(!data->input_method() || + data->input_method()->context_ == context); + + gboolean handled = ibus_input_context_process_key_event_async_finish( + context, res, NULL); + data->ProcessPostIME(handled); + delete data; +} + +// static +void InputMethodIBus::CreateInputContextDone(IBusBus* bus, + GAsyncResult* res, + PendingCreateICRequest* data) { + DCHECK_EQ(GetIBus(), bus); + DCHECK(data); + IBusInputContext* ic = + ibus_bus_create_input_context_async_finish(bus, res, NULL); + if (ic) + data->StoreOrAbandonInputContext(ic); + delete data; +} + +} // namespace ui diff --git a/ui/base/ime/input_method_ibus.h b/ui/base/ime/input_method_ibus.h new file mode 100644 index 0000000..624ff38 --- /dev/null +++ b/ui/base/ime/input_method_ibus.h @@ -0,0 +1,199 @@ +// 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_BASE_IME_INPUT_METHOD_IBUS_H_ +#define UI_BASE_IME_INPUT_METHOD_IBUS_H_ +#pragma once + +#include <set> +#include <string> + +#include "base/basictypes.h" +#include "base/compiler_specific.h" +#include "base/memory/scoped_ptr.h" +#include "ui/base/glib/glib_integers.h" +#include "ui/base/glib/glib_signal.h" +#include "ui/base/ime/character_composer.h" +#include "ui/base/ime/composition_text.h" +#include "ui/base/ime/input_method_base.h" + +// Forward declarations, so that we don't need to include ibus.h in this file. +typedef struct _GAsyncResult GAsyncResult; +typedef struct _IBusBus IBusBus; +typedef struct _IBusInputContext IBusInputContext; +typedef struct _IBusText IBusText; + +namespace ui { + +// A ui::InputMethod implementation based on IBus. +class UI_EXPORT InputMethodIBus : public InputMethodBase { + public: + explicit InputMethodIBus(internal::InputMethodDelegate* delegate); + virtual ~InputMethodIBus(); + + // Overridden from InputMethod: + virtual void OnFocus() OVERRIDE; + virtual void OnBlur() OVERRIDE; + virtual void Init(bool focused) OVERRIDE; + virtual void DispatchKeyEvent( + const base::NativeEvent& native_key_event) OVERRIDE; + virtual void OnTextInputTypeChanged(const TextInputClient* client) OVERRIDE; + virtual void OnCaretBoundsChanged(const TextInputClient* client) OVERRIDE; + virtual void CancelComposition(const TextInputClient* client) OVERRIDE; + virtual std::string GetInputLocale() OVERRIDE; + virtual base::i18n::TextDirection GetInputTextDirection() OVERRIDE; + virtual bool IsActive() OVERRIDE; + + private: + // A class to hold all data related to a key event being processed by the + // input method but still has no result back yet. + class PendingKeyEvent; + + // A class to hold information of a pending request for creating an ibus input + // context. + class PendingCreateICRequest; + + // Overridden from InputMethodBase: + virtual void OnWillChangeFocusedClient(TextInputClient* focused_before, + TextInputClient* focused) OVERRIDE; + virtual void OnDidChangeFocusedClient(TextInputClient* focused_before, + TextInputClient* focused) OVERRIDE; + + // Creates |context_| instance asynchronously. + void CreateContext(); + + // Sets |context_| and hooks necessary signals. + void SetContext(IBusInputContext* ic); + + // Destroys |context_| instance. + void DestroyContext(); + + // Asks the client to confirm current composition text. + void ConfirmCompositionText(); + + // Resets |context_| and abandon all pending results and key events. + void ResetContext(); + + // Checks the availability of focused text input client and update focus state + // of |context_|. + void UpdateContextFocusState(); + + // Process a key returned from the input method. + void ProcessKeyEventPostIME(const base::NativeEvent& native_key_event, + guint32 ibus_keycode, + bool handled); + + // Processes a key event that was already filtered by the input method. + // A VKEY_PROCESSKEY may be dispatched to the focused View. + void ProcessFilteredKeyPressEvent(const base::NativeEvent& native_key_event); + + // Processes a key event that was not filtered by the input method. + void ProcessUnfilteredKeyPressEvent(const base::NativeEvent& native_key_event, + guint32 ibus_keycode); + void ProcessUnfilteredFabricatedKeyPressEvent(EventType type, + KeyboardCode key_code, + int flags, + guint32 ibus_keyval); + + // Sends input method result caused by the given key event to the focused text + // input client. + void ProcessInputMethodResult(const base::NativeEvent& native_key_event, + bool filtered); + + // Checks if the pending input method result needs inserting into the focused + // text input client as a single character. + bool NeedInsertChar() const; + + // Checks if there is pending input method result. + bool HasInputMethodResult() const; + + // Fabricates a key event with VKEY_PROCESSKEY key code and dispatches it to + // the focused View. + void SendFakeProcessKeyEvent(bool pressed) const; + + // Called when a pending key event has finished. The event will be removed + // from |pending_key_events_|. + void FinishPendingKeyEvent(PendingKeyEvent* pending_key); + + // Abandons all pending key events. It usually happends when we lose keyboard + // focus, the text input type is changed or we are destroyed. + void AbandonAllPendingKeyEvents(); + + // Event handlers for IBusInputContext: + CHROMEG_CALLBACK_1(InputMethodIBus, void, OnCommitText, + IBusInputContext*, IBusText*); + CHROMEG_CALLBACK_3(InputMethodIBus, void, OnForwardKeyEvent, + IBusInputContext*, guint, guint, guint); + CHROMEG_CALLBACK_0(InputMethodIBus, void, OnShowPreeditText, + IBusInputContext*); + CHROMEG_CALLBACK_3(InputMethodIBus, void, OnUpdatePreeditText, + IBusInputContext*, IBusText*, guint, gboolean); + CHROMEG_CALLBACK_0(InputMethodIBus, void, OnHidePreeditText, + IBusInputContext*); + CHROMEG_CALLBACK_0(InputMethodIBus, void, OnDestroy, IBusInputContext*); + + // Event handlers for IBusBus: + CHROMEG_CALLBACK_0(InputMethodIBus, void, OnIBusConnected, IBusBus*); + CHROMEG_CALLBACK_0(InputMethodIBus, void, OnIBusDisconnected, IBusBus*); + + // Returns the global IBusBus instance. + static IBusBus* GetIBus(); + + // Callback function for ibus_input_context_process_key_event_async(). + static void ProcessKeyEventDone(IBusInputContext* context, + GAsyncResult* res, + PendingKeyEvent* data); + + // Callback function for ibus_bus_create_input_context_async(). + static void CreateInputContextDone(IBusBus* bus, + GAsyncResult* res, + PendingCreateICRequest* data); + + // The input context for actual text input. Note that we don't have to support + // a "fake" IBus input context anymore since the latest Chrome for Chrome OS + // can handle input method hot keys (e.g. Shift+Alt) by itself. + IBusInputContext* context_; + + // All pending key events. Note: we do not own these object, we just save + // pointers to these object so that we can abandon them when necessary. + // They will be deleted in ProcessKeyEventDone(). + std::set<PendingKeyEvent*> pending_key_events_; + + // The pending request for creating the |context_| instance. We need to keep + // this pointer so that we can receive or abandon the result. + PendingCreateICRequest* pending_create_ic_request_; + + // Pending composition text generated by the current pending key event. + // It'll be sent to the focused text input client as soon as we receive the + // processing result of the pending key event. + CompositionText composition_; + + // Pending result text generated by the current pending key event. + // It'll be sent to the focused text input client as soon as we receive the + // processing result of the pending key event. + string16 result_text_; + + // Indicates if |context_| is focused or not. + bool context_focused_; + + // Indicates if there is an ongoing composition text. + bool composing_text_; + + // Indicates if the composition text is changed or deleted. + bool composition_changed_; + + // If it's true then all input method result received before the next key + // event will be discarded. + bool suppress_next_result_; + + // An object to compose a character from a sequence of key presses + // including dead key etc. + CharacterComposer character_composer_; + + DISALLOW_COPY_AND_ASSIGN(InputMethodIBus); +}; + +} // namespace ui + +#endif // UI_BASE_IME_INPUT_METHOD_IBUS_H_ diff --git a/ui/base/ime/mock_input_method.cc b/ui/base/ime/mock_input_method.cc new file mode 100644 index 0000000..0dcc814 --- /dev/null +++ b/ui/base/ime/mock_input_method.cc @@ -0,0 +1,123 @@ +// 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. + +#include "ui/base/ime/mock_input_method.h" + +#include "base/logging.h" +#include "base/string16.h" +#include "ui/base/events.h" +#include "ui/base/glib/glib_integers.h" +#include "ui/base/ime/input_method_delegate.h" +#include "ui/base/ime/text_input_client.h" +#include "ui/base/keycodes/keyboard_code_conversion.h" + +#if defined(USE_X11) +#include <X11/X.h> +#include <X11/Xlib.h> +#include <X11/Xutil.h> +#include "ui/base/keycodes/keyboard_code_conversion_x.h" +#endif + +namespace { + +#if defined(USE_X11) +guint32 EventFlagsFromXFlags(unsigned int flags) { + return (flags & LockMask ? ui::EF_CAPS_LOCK_DOWN : 0U) | + (flags & ControlMask ? ui::EF_CONTROL_DOWN : 0U) | + (flags & ShiftMask ? ui::EF_SHIFT_DOWN : 0U) | + (flags & Mod1Mask ? ui::EF_ALT_DOWN : 0U); +} +#endif + +} // namespace + +namespace ui { + +MockInputMethod::MockInputMethod(internal::InputMethodDelegate* delegate) + : delegate_(NULL), + text_input_client_(NULL), + consume_next_key_(false) { + SetDelegate(delegate); +} + +MockInputMethod::~MockInputMethod() { +} + +void MockInputMethod::SetDelegate(internal::InputMethodDelegate* delegate) { + delegate_ = delegate; +} + +void MockInputMethod::SetFocusedTextInputClient(TextInputClient* client) { + text_input_client_ = client; +} + +TextInputClient* MockInputMethod::GetTextInputClient() const { + return text_input_client_; +} + +void MockInputMethod::DispatchKeyEvent(const base::NativeEvent& native_event) { +#if defined(USE_X11) + if (native_event->type == KeyRelease) { + // On key release, just dispatch it. + delegate_->DispatchKeyEventPostIME(native_event); + } else { + const uint32 state = + EventFlagsFromXFlags(reinterpret_cast<XKeyEvent*>(native_event)->state); + if (consume_next_key_) { + // Send the VKEY_PROCESSKEY RawKeyDown event. + SendFakeProcessKeyEvent(true, state); + } else { + // Send a RawKeyDown event first, + delegate_->DispatchKeyEventPostIME(native_event); + if (text_input_client_) { + // then send a Char event via ui::TextInputClient. + const KeyboardCode key_code = ui::KeyboardCodeFromNative(native_event); + uint16 ch = ui::DefaultSymbolFromXEvent(native_event); + if (!ch) + ch = ui::GetCharacterFromKeyCode(key_code, state); + if (ch) + text_input_client_->InsertChar(ch, state); + } + } + } + consume_next_key_ = false; +#else + // TODO(yusukes): Support Windows. + delegate_->DispatchKeyEventPostIME(native_event); +#endif +} + +void MockInputMethod::Init(bool focused) {} +void MockInputMethod::OnFocus() {} +void MockInputMethod::OnBlur() {} +void MockInputMethod::OnTextInputTypeChanged(const TextInputClient* client) {} +void MockInputMethod::OnCaretBoundsChanged(const TextInputClient* client) {} +void MockInputMethod::CancelComposition(const TextInputClient* client) {} + +std::string MockInputMethod::GetInputLocale() { + return ""; +} + +base::i18n::TextDirection MockInputMethod::GetInputTextDirection() { + return base::i18n::UNKNOWN_DIRECTION; +} + +bool MockInputMethod::IsActive() { + return true; +} + +ui::TextInputType MockInputMethod::GetTextInputType() const { + return ui::TEXT_INPUT_TYPE_NONE; +} + +void MockInputMethod::ConsumeNextKey() { + consume_next_key_ = true; +} + +void MockInputMethod::SendFakeProcessKeyEvent(bool pressed, int flags) const { + delegate_->DispatchFabricatedKeyEventPostIME( + pressed ? ET_KEY_PRESSED : ET_KEY_RELEASED, VKEY_PROCESSKEY, flags); +} + +} // namespace ui diff --git a/ui/base/ime/mock_input_method.h b/ui/base/ime/mock_input_method.h new file mode 100644 index 0000000..eb0c06b --- /dev/null +++ b/ui/base/ime/mock_input_method.h @@ -0,0 +1,58 @@ +// 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_BASE_IME_MOCK_INPUT_METHOD_H_ +#define UI_BASE_IME_MOCK_INPUT_METHOD_H_ +#pragma once + +#include "base/basictypes.h" +#include "base/compiler_specific.h" +#include "ui/base/ime/input_method.h" +#include "ui/base/ui_export.h" + +namespace ui { + +class TextInputClient; + +// A mock InputMethod implementation for testing classes that use the +// ui::InputMethod interface such as aura::DesktopHost. +class UI_EXPORT MockInputMethod : public InputMethod { + public: + explicit MockInputMethod(internal::InputMethodDelegate* delegate); + virtual ~MockInputMethod(); + + // Overriden from InputMethod. + virtual void SetDelegate(internal::InputMethodDelegate* delegate) OVERRIDE; + virtual void Init(bool focused) OVERRIDE; + virtual void OnFocus() OVERRIDE; + virtual void OnBlur() OVERRIDE; + virtual void SetFocusedTextInputClient(TextInputClient* client) OVERRIDE; + virtual TextInputClient* GetTextInputClient() const OVERRIDE; + virtual void DispatchKeyEvent(const base::NativeEvent& native_event) OVERRIDE; + virtual void OnTextInputTypeChanged(const TextInputClient* client) OVERRIDE; + virtual void OnCaretBoundsChanged(const TextInputClient* client) OVERRIDE; + virtual void CancelComposition(const TextInputClient* client) OVERRIDE; + virtual std::string GetInputLocale() OVERRIDE; + virtual base::i18n::TextDirection GetInputTextDirection() OVERRIDE; + virtual bool IsActive() OVERRIDE; + virtual ui::TextInputType GetTextInputType() const OVERRIDE; + + // If called, the next key press will not generate a Char event. Instead, it + // will generate the VKEY_PROCESSKEY RawKeyDown event. + void ConsumeNextKey(); + + // Sends VKEY_PROCESSKEY. + void SendFakeProcessKeyEvent(bool pressed, int flags) const; + + private: + internal::InputMethodDelegate* delegate_; + TextInputClient* text_input_client_; + bool consume_next_key_; + + DISALLOW_COPY_AND_ASSIGN(MockInputMethod); +}; + +} // namespace ui + +#endif // UI_BASE_IME_MOCK_INPUT_METHOD_H_ diff --git a/ui/base/ime/text_input_client.h b/ui/base/ime/text_input_client.h index 01f5152..4d10309 100644 --- a/ui/base/ime/text_input_client.h +++ b/ui/base/ime/text_input_client.h @@ -60,9 +60,15 @@ class UI_EXPORT TextInputClient { // TEXT_INPUT_TYPE_NONE at runtime. virtual ui::TextInputType GetTextInputType() const = 0; - // Returns current caret (insertion point) bounds relative to the View’s + // Returns current caret (insertion point) bounds relative to the screen // coordinates. If there is selection, then the selection bounds will be // returned. + // TODO(yusukes): Currently views::NativeTextfieldViews which implements this + // interface returns its view's coordinates. We should to do the following: + // 1) Modify NativeTextfieldViews so it returns screen coordinates. + // 2) Remove view-to-screen coordinates conversion code in InputMethodBridge. + // 3) Modify InputMethodWin. It requires a rect in toplevel window's + // coordinates instead of screen. virtual gfx::Rect GetCaretBounds() = 0; // Returns true if there is composition text. @@ -133,6 +133,14 @@ 'base/ime/composition_text.cc', 'base/ime/composition_text.h', 'base/ime/composition_underline.h', + 'base/ime/input_method.h', + 'base/ime/input_method_base.cc', + 'base/ime/input_method_base.h', + 'base/ime/input_method_delegate.h', + 'base/ime/input_method_ibus.cc', + 'base/ime/input_method_ibus.h', + 'base/ime/mock_input_method.cc', + 'base/ime/mock_input_method.h', 'base/ime/text_input_client.cc', 'base/ime/text_input_client.h', 'base/ime/text_input_type.h', @@ -358,6 +366,10 @@ ], }, { # use_aura!=1 'sources!': [ + 'base/ime/input_method_ibus.cc', + 'base/ime/input_method_ibus.h', + 'base/ime/mock_input_method.cc', + 'base/ime/mock_input_method.h', 'gfx/native_theme_aura.cc', 'gfx/native_theme_aura.h', ] @@ -371,6 +383,21 @@ ['exclude', 'gfx/path_win.cc'], ], }], + ['use_ibus==1', { + 'dependencies': [ + '../build/linux/system.gyp:ibus', + ], + 'sources/': [ + ['exclude', 'base/ime/mock_input_method.cc'], + ['exclude', 'base/ime/mock_input_method.h'], + ], + }, { # else: use_ibus != 1 + 'sources/': [ + ['exclude', 'base/ime/input_method_ibus.cc'], + ['exclude', 'base/ime/input_method_ibus.h'], + ], + }], + ['use_glib == 1', { 'dependencies': [ # font_gtk.cc uses fontconfig. |