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)/* From dev/ppb_file_chooser_dev.idl modified Mon Jun 4 12:44:29 2012. */ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef PPAPI_C_DEV_PPB_FILE_CHOOSER_DEV_H_ 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define PPAPI_C_DEV_PPB_FILE_CHOOSER_DEV_H_ 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/pp_array_output.h" 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/pp_bool.h" 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/pp_completion_callback.h" 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/pp_instance.h" 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/pp_macros.h" 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/pp_resource.h" 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/pp_stdint.h" 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/pp_var.h" 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define PPB_FILECHOOSER_DEV_INTERFACE_0_5 "PPB_FileChooser(Dev);0.5" 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define PPB_FILECHOOSER_DEV_INTERFACE_0_6 "PPB_FileChooser(Dev);0.6" 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define PPB_FILECHOOSER_DEV_INTERFACE PPB_FILECHOOSER_DEV_INTERFACE_0_6 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @file 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This file defines the <code>PPB_FileChooser_Dev</code> interface. 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @addtogroup Enums 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @{ 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This enumeration contains constants to control the behavior of the file 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * chooser dialog. 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum { 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Mode for choosing a single existing file. 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_FILECHOOSERMODE_OPEN = 0, 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Mode for choosing multiple existing files. 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_FILECHOOSERMODE_OPENMULTIPLE = 1 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} PP_FileChooserMode_Dev; 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)PP_COMPILE_ASSERT_SIZE_IN_BYTES(PP_FileChooserMode_Dev, 4); 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @} 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @addtogroup Interfaces 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @{ 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct PPB_FileChooser_Dev_0_6 { 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This function creates a file chooser dialog resource. The chooser is 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * associated with a particular instance, so that it may be positioned on the 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * screen relative to the tab containing the instance. 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @param[in] instance A <code>PP_Instance</code> identifying one instance 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * of a module. 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @param[in] mode A <code>PP_FileChooserMode_Dev</code> value that controls 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the behavior of the file chooser dialog. 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @param[in] accept_types A comma-separated list of MIME types and file 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * extensions such as "audio/ *,text/plain,.html" (note there should be no 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * space between the '/' and the '*', but one is added to avoid confusing C++ 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * comments). The dialog may restrict selectable files to the specified MIME 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * types and file extensions. If a string in the comma-separated list begins 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * with a period (.) then the string is interpreted as a file extension, 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * otherwise it is interpreted as a MIME-type. An empty string or an undefined 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * var may be given to indicate that all types should be accepted. 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @return A <code>PP_Resource</code> containing the file chooser if 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * successful or 0 if it could not be created. 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Resource (*Create)(PP_Instance instance, 805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_FileChooserMode_Dev mode, 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct PP_Var accept_types); 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Determines if the provided resource is a file chooser. 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @param[in] resource A <code>PP_Resource</code> corresponding to a generic 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * resource. 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @return A <code>PP_Bool</code> that is <code>PP_TRUE</code> if the given 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * resource is a file chooser resource, otherwise <code>PP_FALSE</code>. 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Bool (*IsFileChooser)(PP_Resource resource); 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This function displays a previously created file chooser resource as a 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * dialog box, prompting the user to choose a file or files. This function 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * must be called in response to a user gesture, such as a mouse click or 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * touch event. The callback is called with PP_OK on successful completion 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * with a file (or files) selected, PP_ERROR_USERCANCEL if the user selected 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * no file, or another error code from pp_errors.h on failure. 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 1005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * <b>Subtle note:</b> This function will only work when the tab containing 1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the plugin is visible. Show() will fail if the tab is in the background. 1025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Since it's not normally possible to get input events while invisible, this 1035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * is not normally an issue. But there is a race condition because events are 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * processed asynchronously. If the user clicks and switches tabs very 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * quickly, a plugin could believe the tab is visible while Chrome believes 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * it is invisible and the Show() call will fail. This will not generally 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * cause user confusion since the user will have switched tabs and will not 1085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * want to see a file chooser from a different tab. 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 1105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @param[in] chooser The file chooser resource. 1115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 1125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @param[in] output An output array which will receive PP_Resource(s) 1135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * identifying the <code>PPB_FileRef</code> objects that the user selected on 1145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * success. 1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @param[in] callback A <code>CompletionCallback</code> to be called after 1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the user has closed the file chooser dialog. 1185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 1195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @return PP_OK_COMPLETIONPENDING if request to show the dialog was 1205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * successful, another error code from pp_errors.h on failure. 1215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int32_t (*Show)(PP_Resource chooser, 1235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct PP_ArrayOutput output, 1245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct PP_CompletionCallback callback); 1255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 1265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct PPB_FileChooser_Dev_0_6 PPB_FileChooser_Dev; 1285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct PPB_FileChooser_Dev_0_5 { 1305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Resource (*Create)(PP_Instance instance, 1315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_FileChooserMode_Dev mode, 1325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct PP_Var accept_types); 1335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Bool (*IsFileChooser)(PP_Resource resource); 1345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int32_t (*Show)(PP_Resource chooser, struct PP_CompletionCallback callback); 1355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Resource (*GetNextChosenFile)(PP_Resource chooser); 1365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 1375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 1385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @} 1395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif /* PPAPI_C_DEV_PPB_FILE_CHOOSER_DEV_H_ */ 1425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 143