PPAPI: Move IMEInputEvent and TextInput to stable.

ppapi/api/ppb_text_input.idl

 /* 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.
  */
 
 /**
- * This file defines the <code>PPB_TextInput_Dev</code> interface.
+ * This file defines the <code>PPB_TextInput</code> interface.
  */
 
 label Chrome {
-  M16 = 0.1,
-  M19 = 0.2
+  M30 = 1.0
 };
 
 /**
  * PP_TextInput_Type is used to indicate the status of a plugin in regard to
  * text input.
  */
 [assert_size(4)]
 enum PP_TextInput_Type {
   /**
    * Input caret is not in an editable mode, no input method shall be used.
    */
   PP_TEXTINPUT_TYPE_NONE = 0,
   /**
    * Input caret is in a normal editable mode, any input method can be used.
    */
   PP_TEXTINPUT_TYPE_TEXT = 1,
   /**
    * Input caret is in a password box, an input method may be used only if
    * it's suitable for password input.
    */
   PP_TEXTINPUT_TYPE_PASSWORD = 2,
   PP_TEXTINPUT_TYPE_SEARCH = 3,
   PP_TEXTINPUT_TYPE_EMAIL = 4,
   PP_TEXTINPUT_TYPE_NUMBER = 5,
   PP_TEXTINPUT_TYPE_TELEPHONE = 6,
   PP_TEXTINPUT_TYPE_URL = 7
 };
 
 /**
- * <code>PPB_TextInput_Dev</code> provides a set of functions for giving hints
+ * <code>PPB_TextInput</code> provides a set of functions for giving hints
  * to the browser about the text input status of plugins, and functions for
  * controlling input method editors (IMEs).
  */
-interface PPB_TextInput_Dev {
+interface PPB_TextInput {
   /**
    * Informs the browser about the current text input mode of the plugin.
    * Typical use of this information in the browser is to properly
    * display/suppress tools for supporting text inputs (such as virtual
    * keyboards in touch screen based devices, or input method editors often
    * used for composing East Asian characters).
    */
   void SetTextInputType([in] PP_Instance instance,
                         [in] PP_TextInput_Type type);
 
   /**
    * Informs the browser about the coordinates of the text input caret and the
    * bounding box of the text input area. Typical use of this information in
    * the browser is to layout IME windows etc.
    */
   void UpdateCaretPosition([in] PP_Instance instance,
                            [in] PP_Rect caret,
                            [in] PP_Rect bounding_box);
 
   /**
    * Cancels the current composition in IME.
    */
   void CancelCompositionText([in] PP_Instance instance);
 
   /**
-   * In response to the <code>PPP_TextInput_Dev::RequestSurroundingText</code>
+   * In response to the <code>PPP_TextInput::RequestSurroundingText</code>
    * call, informs the browser about the current text selection and surrounding
    * text. <code>text</code> is a UTF-8 string that contains the current range
    * of text selection in the plugin. <code>caret</code> is the byte-index of
    * the caret position within <code>text</code>. <code>anchor</code> is the
    * byte-index of the anchor position (i.e., if a range of text is selected,
    * it is the other edge of selection different from <code>caret</code>. If
    * there are no selection, <code>anchor</code> is equal to <code>caret</code>.
    *
    * Typical use of this information in the browser is to enable "reconversion"
    * features of IME that puts back the already committed text into the
@@ skipping 10 matching lines @@
    */
   [version=0.2]
   void UpdateSurroundingText([in] PP_Instance instance,
                              [in] str_t text,
                              [in] uint32_t caret,
                              [in] uint32_t anchor);
 
   /**
    * Informs the browser when a range of text selection is changed in a plugin.
    * When the browser needs to know the content of the updated selection, it
-   * pings back by <code>PPP_TextInput_Dev::RequestSurroundingText</code>. The
+   * pings back by <code>PPP_TextInput::RequestSurroundingText</code>. The
    * plugin then should send the information with
    * <code>UpdateSurroundingText</code>.
    */
   [version=0.2]
   void SelectionChanged([in] PP_Instance instance);

[dmichael (off chromium), 2013/07/18 03:50:20]

As Darin mentioned, it would be better to use a PP_CompletionCallback for this.
You can also add an out-param if necessary.

[Seigo Nonaka, 2013/07/23 11:49:54]

I looked into the details of this function and it turned out that this function
is no longer necessary.
So just removing for stable is fine.
Thank you for your comment :)

On 2013/07/18 03:50:20, dmichael wrote:

 };