1 // Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. 2 // 3 // Redistribution and use in source and binary forms, with or without 4 // modification, are permitted provided that the following conditions are 5 // met: 6 // 7 // * Redistributions of source code must retain the above copyright 8 // notice, this list of conditions and the following disclaimer. 9 // * Redistributions in binary form must reproduce the above 10 // copyright notice, this list of conditions and the following disclaimer 11 // in the documentation and/or other materials provided with the 12 // distribution. 13 // * Neither the name of Google Inc. nor the name Chromium Embedded 14 // Framework nor the names of its contributors may be used to endorse 15 // or promote products derived from this software without specific prior 16 // written permission. 17 // 18 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 19 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 20 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 21 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 22 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 23 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 24 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 25 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 26 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 27 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 28 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 29 // 30 // --------------------------------------------------------------------------- 31 // 32 // This file was generated by the CEF translator tool and should not edited 33 // by hand. See the translator.README.txt file in the tools directory for 34 // more information. 35 // 36 // $hash=d991e2a7d1a58a013e4d3a963361fed6918f4ec3$ 37 // 38 39 #ifndef CEF_INCLUDE_CAPI_CEF_JSDIALOG_HANDLER_CAPI_H_ 40 #define CEF_INCLUDE_CAPI_CEF_JSDIALOG_HANDLER_CAPI_H_ 41 #pragma once 42 43 #include "include/capi/cef_base_capi.h" 44 #include "include/capi/cef_browser_capi.h" 45 46 #ifdef __cplusplus 47 extern "C" { 48 #endif 49 50 /// 51 // Callback structure used for asynchronous continuation of JavaScript dialog 52 // requests. 53 /// 54 typedef struct _cef_jsdialog_callback_t { 55 /// 56 // Base structure. 57 /// 58 cef_base_ref_counted_t base; 59 60 /// 61 // Continue the JS dialog request. Set |success| to true (1) if the OK button 62 // was pressed. The |user_input| value should be specified for prompt dialogs. 63 /// 64 void(CEF_CALLBACK* cont)(struct _cef_jsdialog_callback_t* self, 65 int success, 66 const cef_string_t* user_input); 67 } cef_jsdialog_callback_t; 68 69 /// 70 // Implement this structure to handle events related to JavaScript dialogs. The 71 // functions of this structure will be called on the UI thread. 72 /// 73 typedef struct _cef_jsdialog_handler_t { 74 /// 75 // Base structure. 76 /// 77 cef_base_ref_counted_t base; 78 79 /// 80 // Called to run a JavaScript dialog. If |origin_url| is non-NULL it can be 81 // passed to the CefFormatUrlForSecurityDisplay function to retrieve a secure 82 // and user-friendly display string. The |default_prompt_text| value will be 83 // specified for prompt dialogs only. Set |suppress_message| to true (1) and 84 // return false (0) to suppress the message (suppressing messages is 85 // preferable to immediately executing the callback as this is used to detect 86 // presumably malicious behavior like spamming alert messages in 87 // onbeforeunload). Set |suppress_message| to false (0) and return false (0) 88 // to use the default implementation (the default implementation will show one 89 // modal dialog at a time and suppress any additional dialog requests until 90 // the displayed dialog is dismissed). Return true (1) if the application will 91 // use a custom dialog or if the callback has been executed immediately. 92 // Custom dialogs may be either modal or modeless. If a custom dialog is used 93 // the application must execute |callback| once the custom dialog is 94 // dismissed. 95 /// 96 int(CEF_CALLBACK* on_jsdialog)(struct _cef_jsdialog_handler_t* self, 97 struct _cef_browser_t* browser, 98 const cef_string_t* origin_url, 99 cef_jsdialog_type_t dialog_type, 100 const cef_string_t* message_text, 101 const cef_string_t* default_prompt_text, 102 struct _cef_jsdialog_callback_t* callback, 103 int* suppress_message); 104 105 /// 106 // Called to run a dialog asking the user if they want to leave a page. Return 107 // false (0) to use the default dialog implementation. Return true (1) if the 108 // application will use a custom dialog or if the callback has been executed 109 // immediately. Custom dialogs may be either modal or modeless. If a custom 110 // dialog is used the application must execute |callback| once the custom 111 // dialog is dismissed. 112 /// 113 int(CEF_CALLBACK* on_before_unload_dialog)( 114 struct _cef_jsdialog_handler_t* self, 115 struct _cef_browser_t* browser, 116 const cef_string_t* message_text, 117 int is_reload, 118 struct _cef_jsdialog_callback_t* callback); 119 120 /// 121 // Called to cancel any pending dialogs and reset any saved dialog state. Will 122 // be called due to events like page navigation irregardless of whether any 123 // dialogs are currently pending. 124 /// 125 void(CEF_CALLBACK* on_reset_dialog_state)( 126 struct _cef_jsdialog_handler_t* self, 127 struct _cef_browser_t* browser); 128 129 /// 130 // Called when the default implementation dialog is closed. 131 /// 132 void(CEF_CALLBACK* on_dialog_closed)(struct _cef_jsdialog_handler_t* self, 133 struct _cef_browser_t* browser); 134 } cef_jsdialog_handler_t; 135 136 #ifdef __cplusplus 137 } 138 #endif 139 140 #endif // CEF_INCLUDE_CAPI_CEF_JSDIALOG_HANDLER_CAPI_H_ 141