Modified the flash cipboard interface to add html clipboard support.

ppapi/api/private/ppb_flash_clipboard.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 private <code>PPB_Flash_Clipboard</code> API used by
  * Pepper Flash for reading and writing to the clipboard.
  */
 
 label Chrome {
-  M17 = 3.0
+  M17 = 3.0,
+  M19 = 4.0
 };
 
 #inline c
 /**
  * The old version string for this interface, equivalent to version 3.0.
  * TODO(viettrungluu): Remove this when enough time has passed. crbug.com/104184
  */
 #define PPB_FLASH_CLIPBOARD_INTERFACE_3_LEGACY "PPB_Flash_Clipboard;3"
 #endinl
 
@@ skipping 15 matching lines @@
 [assert_size(4)]
 enum PP_Flash_Clipboard_Format {
   /** Indicates an invalid or unsupported clipboard data format. */
   PP_FLASH_CLIPBOARD_FORMAT_INVALID = 0,
   /** Indicates plain text clipboard data. */
   PP_FLASH_CLIPBOARD_FORMAT_PLAINTEXT = 1,
   /** Indicates HTML clipboard data. */
   PP_FLASH_CLIPBOARD_FORMAT_HTML = 2
 };
 
+struct PP_Flash_Clipboard_Data_Item {
+  PP_Flash_Clipboard_Format format;
+  PP_Var data;
+};
+
 /**
  * The <code>PPB_Flash_Clipboard</code> interface contains pointers to functions
  * used by Pepper Flash to access the clipboard.
  *
- * TODO(viettrungluu): Support more formats (e.g., HTML)....
  */
-[version=3.0]
 interface PPB_Flash_Clipboard {
   /**
    * Checks whether a given data format is available from the given clipboard.
    * Returns true if the given format is available from the given clipboard.
    */
   PP_Bool IsFormatAvailable(
       [in] PP_Instance instance_id,
       [in] PP_Flash_Clipboard_Type clipboard_type,
       [in] PP_Flash_Clipboard_Format format);
 
   /**
-   * Reads plain text data from the clipboard.
+   * Deprecated in 4.0.
    */
+  [version=3.0, deprecate=4.0]
   PP_Var ReadPlainText(
       [in] PP_Instance instance_id,
       [in] PP_Flash_Clipboard_Type clipboard_type);
 
   /**
-   * Writes plain text data to the clipboard. If <code>text</code> is too large,
-   * it will return <code>PP_ERROR_NOSPACE</code> and not write to the
-   * clipboard.
+   * Deprecated in 4.0.
    */
+  [version=3.0, deprecate=4.0]
   int32_t WritePlainText(
       [in] PP_Instance instance_id,
       [in] PP_Flash_Clipboard_Type clipboard_type,
       [in] PP_Var text);
+
+  /**
+   * Reads data in the given <code>format</code> from the clipboard.
+   */

[viettrungluu, 2012/01/26 18:26:18]

Probably you should add that it returns a null PP_Var on error (e.g., if the
given format is not available from the given clipboard).

+  [version=4.0]
+  PP_Var ReadData([in] PP_Instance instance_id,
+      [in] PP_Flash_Clipboard_Type clipboard_type,
+      [in] PP_Flash_Clipboard_Format format);
+  
+  /**
+   * Writes the given array of data items to the clipboard. Each data item
+   * should have a different <code>PP_Flash_Clipboard_Format</code>.
+   * Any existing clipboard data is erased before writing this data.

[viettrungluu, 2012/01/26 18:26:18]

Any existing clipboard data in any format, I presume?

+   */

[viettrungluu, 2012/01/26 18:26:18]

You should probably clarify what happens on error. If one of the items is too
big, will it write the others? What would it return in that case?

(Also, what if two items have the same type?)

+  [version=4.0]
+  int32_t WriteData([in] PP_Instance instance_id,
+      [in] PP_Flash_Clipboard_Type clipboard_type,
+      [in] uint32_t data_item_count,
+      [in, size_is(data_item_count)] PP_Flash_Clipboard_Data_Item[] data_items);
 };