Modified the flash cipboard interface to add html clipboard support.

ppapi/api/private/ppb_flash_clipboard.idl

Index: ppapi/api/private/ppb_flash_clipboard.idl
diff --git a/ppapi/api/private/ppb_flash_clipboard.idl b/ppapi/api/private/ppb_flash_clipboard.idl
index 890a7d481c818042997c409db96bb9db684c43ca..796e4c4d78de258dde40bf14ff7e99f7a80968bb 100644
--- a/ppapi/api/private/ppb_flash_clipboard.idl
+++ b/ppapi/api/private/ppb_flash_clipboard.idl
@@ -9,7 +9,8 @@
  */
 
 label Chrome {
-  M17 = 3.0
+  M17 = 3.0,
+  M19 = 4.0
 };
 
 #inline c
@@ -45,13 +46,16 @@ enum PP_Flash_Clipboard_Format {
   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.
@@ -63,19 +67,38 @@ interface PPB_Flash_Clipboard {
       [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);
 };