15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This file defines the private <code>PPB_Flash_Clipboard</code> API used by 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Pepper Flash for reading and writing to the clipboard. 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)label Chrome { 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) M19 = 4.0, 135d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) M24 = 5.0, 145d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) M34 = 5.1 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This enumeration contains the types of clipboards that can be accessed. 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * These types correspond to clipboard types in WebKit. 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)[assert_size(4)] 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum PP_Flash_Clipboard_Type { 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** The standard clipboard. */ 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_FLASH_CLIPBOARD_TYPE_STANDARD = 0, 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** The selection clipboard (e.g., on Linux). */ 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_FLASH_CLIPBOARD_TYPE_SELECTION = 1 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 30c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) * This enumeration contains the predefined clipboard data formats. 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)[assert_size(4)] 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum PP_Flash_Clipboard_Format { 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** Indicates an invalid or unsupported clipboard data format. */ 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_FLASH_CLIPBOARD_FORMAT_INVALID = 0, 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Indicates plaintext clipboard data. The format expected/returned is a 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * <code>PP_VARTYPE_STRING</code>. 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_FLASH_CLIPBOARD_FORMAT_PLAINTEXT = 1, 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Indicates HTML clipboard data. The format expected/returned is a 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * <code>PP_VARTYPE_STRING</code>. 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_FLASH_CLIPBOARD_FORMAT_HTML = 2, 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Indicates RTF clipboard data. The format expected/returned is a 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * <code>PP_VARTYPE_ARRAY_BUFFER</code>. 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_FLASH_CLIPBOARD_FORMAT_RTF = 3 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The <code>PPB_Flash_Clipboard</code> interface contains pointers to functions 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * used by Pepper Flash to access the clipboard. 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)interface PPB_Flash_Clipboard { 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Deprecated in 5.0. 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [version=4.0, deprecate=5.0] 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Bool IsFormatAvailable( 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_Instance instance_id, 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_Flash_Clipboard_Type clipboard_type, 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_Flash_Clipboard_Format format); 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Deprecated in 5.0. 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [version=4.0, deprecate=5.0] 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Var ReadData([in] PP_Instance instance_id, 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_Flash_Clipboard_Type clipboard_type, 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_Flash_Clipboard_Format format); 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Deprecated in 5.0. 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [version=4.0, deprecate=5.0] 805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int32_t WriteData([in] PP_Instance instance_id, 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_Flash_Clipboard_Type clipboard_type, 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] uint32_t data_item_count, 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in, size_is(data_item_count)] PP_Flash_Clipboard_Format[] formats, 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in, size_is(data_item_count)] PP_Var[] data_items); 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Registers a custom clipboard format. The format is identified by a 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * string. An id identifying the format will be returned if the format is 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * successfully registered, which can be used to read/write data of that 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * format. If the format has already been registered, the id associated with 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * that format will be returned. If the format fails to be registered 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * <code>PP_FLASH_CLIPBOARD_FORMAT_INVALID</code> will be returned. 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * All custom data should be read/written as <code>PP_Var</code> array 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * buffers. The clipboard format is pepper-specific meaning that although the 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * data will be stored on the system clipboard, it can only be accessed in a 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * sensible way by using the pepper API. Data stored in custom formats can 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * be safely shared between different applications that use pepper. 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [version=5.0] 1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint32_t RegisterCustomFormat( 1025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_Instance instance_id, 1035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] str_t format_name); 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Checks whether a given data format is available from the given clipboard. 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Returns true if the given format is available from the given clipboard. 1085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [version=5.0] 1105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Bool IsFormatAvailable( 1115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_Instance instance_id, 1125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_Flash_Clipboard_Type clipboard_type, 1135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] uint32_t format); 1145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Reads data in the given <code>format</code> from the clipboard. An 1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * undefined <code>PP_Var</code> is returned if there is an error in reading 1185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the clipboard data and a null <code>PP_Var</code> is returned if there is 1195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * no data of the specified <code>format</code> to read. 1205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [version=5.0] 1225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Var ReadData([in] PP_Instance instance_id, 1235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_Flash_Clipboard_Type clipboard_type, 1245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] uint32_t format); 1255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 1275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Writes the given array of data items to the clipboard. All existing 1285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * clipboard data in any format is erased before writing this data. Thus, 1295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * passing an array of size 0 has the effect of clearing the clipboard without 1305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * writing any data. Each data item in the array should have a different 1315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * <code>PP_Flash_Clipboard_Format</code>. If multiple data items have the 1325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * same format, only the last item with that format will be written. 1335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * If there is an error writing any of the items in the array to the 1345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * clipboard, none will be written and an error code is returned. 1355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The error code will be <code>PP_ERROR_NOSPACE</code> if the value is 1365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * too large to be written, <code>PP_ERROR_BADARGUMENT</code> if a PP_Var 1375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * cannot be converted into the format supplied or <code>PP_FAILED</code> 1385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * if the format is not supported. 1395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [version=5.0] 1415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int32_t WriteData([in] PP_Instance instance_id, 1425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_Flash_Clipboard_Type clipboard_type, 1435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] uint32_t data_item_count, 1445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in, size_is(data_item_count)] uint32_t[] formats, 1455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in, size_is(data_item_count)] PP_Var[] data_items); 1465d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 1475d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) /** 1485d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) * Gets a sequence number which uniquely identifies clipboard state. This can 1495d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) * be used to version the data on the clipboard and determine whether it has 1505d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) * changed. The sequence number will be placed in |sequence_number| and 1515d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) * PP_TRUE returned if the sequence number was retrieved successfully. 1525d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) */ 1535d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) [version=5.1] 1545d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) PP_Bool GetSequenceNumber([in] PP_Instance instance_id, 1555d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) [in] PP_Flash_Clipboard_Type clipboard_type, 1565d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) [out] uint64_t sequence_number); 1575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 158