Introduce WebInputMethodController to blink

third_party/WebKit/public/web/WebInputMethodController.h

+// Copyright 2016 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 WebInputMethodController_h
+#define WebInputMethodController_h
+
+#include "WebCompositionUnderline.h"
+#include "WebWidget.h"
+
+namespace blink {
+
+class WebString;
+template <typename T>
+class WebVector;
+
+class WebInputMethodController {
+
+public:
+    enum ConfirmCompositionBehavior {
+        DoNotKeepSelection,
+        KeepSelection,
+    };
+
+    virtual ~WebInputMethodController() {}
+    // Called to inform the WebInputMethodController of a new composition text.
+    // If selectionStart and selectionEnd has the same value, then it indicates
+    // the input caret position. If the text is empty, then the existing
+    // composition text will be canceled.
+    // Returns true if the composition text was set successfully.
+    virtual bool setComposition(
+        const WebString& text,
+        const WebVector<WebCompositionUnderline>& underlines,
+        int selectionStart,
+        int selectionEnd)
+        = 0;
+
+    // Called to inform the WebWidget that deleting the ongoing composition if
+    // any, inserting the specified text, and moving the caret according to
+    // relativeCaretPosition.
+    virtual bool commitText(const WebString& text, int relativeCaretPosition) = 0;
+
+    // Called to inform the WebWidget to confirm an ongoing composition.
+    virtual bool finishComposingText(ConfirmCompositionBehavior selectionBehavior) = 0;
+};
+
+} // namespace blink
+#endif