Test for Pepper IME events.

ppapi/api/dev/ppb_ime_input_event_dev.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_IMEInputEvent_Dev</code> interface.
  */
 
 label Chrome {
-  M16 = 0.1
+  M16 = 0.1,
+  M21 = 0.2
 };
 
-[version=0.1, macro="PPB_IME_INPUT_EVENT_DEV_INTERFACE"]
+[macro="PPB_IME_INPUT_EVENT_DEV_INTERFACE"]
 interface PPB_IMEInputEvent_Dev {
   /**
    * IsIMEInputEvent() determines if a resource is an IME event.
    *
    * @param[in] resource A <code>PP_Resource</code> corresponding to an event.
    *
    * @return <code>PP_TRUE</code> if the given resource is a valid input event.
    */
   PP_Bool IsIMEInputEvent([in] PP_Resource resource);
 
   /**
+   * Create() creates an IME input event with the given parameters. Normally
+   * you will get a mouse event passed through the

[yzshen1, 2012/05/15 18:03:48]

This is not a mouse event.

[kinaba, 2012/05/16 10:13:57]

Done. Copy&pasting is always harmful..:(

+   * <code>HandleInputEvent</code> and will not need to create them, but some
+   * applications may want to create their own for internal use.
+   *
+   * @param[in] instance The instance for which this event occurred.
+   *
+   * @param[in] type A <code>PP_InputEvent_Type</code> identifying the type of
+   * input event. The type must be one of the ime event types.

[yzshen1, 2012/05/15 18:03:48]

nit: Please use 'IME' instead of 'ime' to be consistent. (and line 60).

[kinaba, 2012/05/16 10:13:57]

Done.

+   *
+   * @param[in] time_stamp A <code>PP_TimeTicks</code> indicating the time
+   * when the event occurred.
+   *
+   * @param[in] text The string returned by <code>GetText</code>.
+   *
+   * @param[in] segment_number The number returned by
+   * <code>GetSegmentNumber</code>.
+   *
+   * @param[in] segment_offsets The array of numbers returned by
+   * <code>GetSegmentOffset</code>. If <code>segment_number</code> is zero,
+   * the number of elements of the array should be zero. If
+   * <code>segment_number</code> is non-zero, the length of the array must be
+   * <code>segment_number</code> + 1.
+   *
+   * @param[in] target_segment The number returned by
+   * <code>GetTargetSegment</code>.
+   *
+   * @param[in] selection_start The start index returned by
+   * <code>GetSelection</code>.
+   *
+   * @param[in] selection_start The end index returned by

[yzshen1, 2012/05/15 18:03:48]

selection_start -> selection_end

[kinaba, 2012/05/16 10:13:57]

Done.

+   * <code>GetSelection</code>.
+   *
+   * @return A <code>PP_Resource</code> containing the new ime input event.
+   */
+  [version=0.2]
+  PP_Resource Create([in] PP_Instance instance,

[yzshen1, 2012/05/15 18:03:48]

Nit: Usually Create() is placed at the top, before Is*().

[kinaba, 2012/05/16 10:13:57]

Done.

+                     [in] PP_InputEvent_Type type,
+                     [in] PP_TimeTicks time_stamp,
+                     [in] PP_Var text,
+                     [in] uint32_t segment_number,
+                     [in] uint32_t[] segment_offsets,
+                     [in] int32_t target_segment,
+                     [in] uint32_t selection_start,
+                     [in] uint32_t selection_end);
+
+  /**
    * GetText() returns the composition text as a UTF-8 string for the given IME
    * event.
    *
    * @param[in] ime_event A <code>PP_Resource</code> corresponding to an IME
    * event.
    *
    * @return A string var representing the composition text. For non-IME input
    * events the return value will be an undefined var.
    */
   PP_Var GetText([in] PP_Resource ime_event);
@@ skipping 50 matching lines @@
    * event.
    *
    * @param[out] start The start position of the current selection.
    *
    * @param[out] end The end position of the current selection.
    */
   void GetSelection([in] PP_Resource ime_event,
                     [out] uint32_t start,
                     [out] uint32_t end);
 };