1/* Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 * Use of this source code is governed by a BSD-style license that can be
3 * found in the LICENSE file.
4 */
5
6
7/**
8 * This file defines the <code>PPB_FileChooser_Trusted</code> interface.
9 */
10
11[generate_thunk]
12
13label Chrome {
14  M16 = 0.5,
15  M20 = 0.6
16};
17
18[macro="PPB_FILECHOOSER_TRUSTED_INTERFACE"]
19interface PPB_FileChooserTrusted {
20 /**
21  * This function displays a previously created file chooser resource as a
22  * dialog box, prompting the user to choose a file or files to open, or a
23  * single file for saving. The callback is called with PP_OK on successful
24  * completion with a file (or files) selected or PP_ERROR_USERCANCEL if the
25  * user selected no file.
26  *
27  * @param[in] chooser The file chooser resource.
28  * @param[in] save_as A <code>PP_Bool</code> value indicating if this dialog
29  * is choosing a file for saving.
30  * @param[in] suggested_file_name If saving, the suggested name for the
31  * file, otherwise, null or undefined.
32  * @param[in] callback A <code>CompletionCallback</code> to be called after
33  * the user has closed the file chooser dialog.
34  *
35  * @return PP_OK_COMPLETIONPENDING if request to show the dialog was
36  * successful, another error code from pp_errors.h on failure.
37  */
38  [deprecate=0.6]
39  int32_t ShowWithoutUserGesture(
40      [in] PP_Resource chooser,
41      [in] PP_Bool save_as,
42      [in] PP_Var suggested_file_name,
43      [in] PP_CompletionCallback callback);
44
45 /**
46  * This function displays a previously created file chooser resource as a
47  * dialog box, prompting the user to choose a file or files to open, or a
48  * single file for saving. The callback is called with PP_OK on successful
49  * completion with a file (or files) selected or PP_ERROR_USERCANCEL if the
50  * user selected no file.
51  *
52  * @param[in] chooser The file chooser resource.
53  * @param[in] save_as A <code>PP_Bool</code> value indicating if this dialog
54  * is choosing a file for saving.
55  * @param[in] suggested_file_name If saving, the suggested name for the
56  * file, otherwise, null or undefined.
57  * @param[in] callback A <code>CompletionCallback</code> to be called after
58  * the user has closed the file chooser dialog.
59  *
60  * @return PP_OK_COMPLETIONPENDING if request to show the dialog was
61  * successful, another error code from pp_errors.h on failure.
62  */
63  [version=0.6]
64  int32_t ShowWithoutUserGesture(
65      [in] PP_Resource chooser,
66      [in] PP_Bool save_as,
67      [in] PP_Var suggested_file_name,
68      [in] PP_ArrayOutput output,
69      [in] PP_CompletionCallback callback);
70};
71
72