ui/ui/webview.h

Sun, 26 Oct 2025 10:07:31 +0100

author
Olaf Wintermann <olaf.wintermann@gmail.com>
date
Sun, 26 Oct 2025 10:07:31 +0100
changeset 875
0575ca45f1bb
parent 874
33618ae398bd
child 962
7016bcb8d38b
permissions
-rw-r--r--

add cleanup/destroy handler for UiString, UiText and UiGeneric

463
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
1 /*
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
2 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
3 *
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
4 * Copyright 2025 Olaf Wintermann. All rights reserved.
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
5 *
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
6 * Redistribution and use in source and binary forms, with or without
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
7 * modification, are permitted provided that the following conditions are met:
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
8 *
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
9 * 1. Redistributions of source code must retain the above copyright
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
10 * notice, this list of conditions and the following disclaimer.
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
11 *
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
12 * 2. Redistributions in binary form must reproduce the above copyright
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
13 * notice, this list of conditions and the following disclaimer in the
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
14 * documentation and/or other materials provided with the distribution.
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
15 *
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
17 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
20 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
21 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
22 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
23 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
24 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
25 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
26 * POSSIBILITY OF SUCH DAMAGE.
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
27 */
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
28
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
29 #ifndef UI_WEBVIEW_H
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
30 #define UI_WEBVIEW_H
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
31
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
32 #include "toolkit.h"
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
33
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
34
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
35 #ifdef __cplusplus
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
36 extern "C" {
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
37 #endif
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
38
875
0575ca45f1bb add cleanup/destroy handler for UiString, UiText and UiGeneric
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 874
diff changeset
39 /*
0575ca45f1bb add cleanup/destroy handler for UiString, UiText and UiGeneric
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 874
diff changeset
40 * WebView type string used by UiGeneric
0575ca45f1bb add cleanup/destroy handler for UiString, UiText and UiGeneric
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 874
diff changeset
41 */
468
1f251c462f74 use UiGeneric for WebView
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 464
diff changeset
42 #define UI_WEBVIEW_OBJECT_TYPE "webview"
875
0575ca45f1bb add cleanup/destroy handler for UiString, UiText and UiGeneric
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 874
diff changeset
43
0575ca45f1bb add cleanup/destroy handler for UiString, UiText and UiGeneric
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 874
diff changeset
44 /*
0575ca45f1bb add cleanup/destroy handler for UiString, UiText and UiGeneric
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 874
diff changeset
45 * UiWebViewData* is returned by a webviews UiGeneric->get function
0575ca45f1bb add cleanup/destroy handler for UiString, UiText and UiGeneric
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 874
diff changeset
46 */
0575ca45f1bb add cleanup/destroy handler for UiString, UiText and UiGeneric
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 874
diff changeset
47 typedef struct UiWebViewData UiWebViewData;
0575ca45f1bb add cleanup/destroy handler for UiString, UiText and UiGeneric
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 874
diff changeset
48
463
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
49 typedef struct UiWebviewArgs {
800
814d374fb689 add new margin widget args and implement margin in the cocoa gridlayout
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 594
diff changeset
50 UiBool fill;
463
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
51 UiBool hexpand;
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
52 UiBool vexpand;
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
53 UiBool hfill;
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
54 UiBool vfill;
464
e06714e6fa12 add override_defaults layout arg
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 463
diff changeset
55 UiBool override_defaults;
800
814d374fb689 add new margin widget args and implement margin in the cocoa gridlayout
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 594
diff changeset
56 int margin;
814d374fb689 add new margin widget args and implement margin in the cocoa gridlayout
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 594
diff changeset
57 int margin_left;
814d374fb689 add new margin widget args and implement margin in the cocoa gridlayout
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 594
diff changeset
58 int margin_right;
814d374fb689 add new margin widget args and implement margin in the cocoa gridlayout
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 594
diff changeset
59 int margin_top;
814d374fb689 add new margin widget args and implement margin in the cocoa gridlayout
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 594
diff changeset
60 int margin_bottom;
463
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
61 int colspan;
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
62 int rowspan;
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
63 const char *name;
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
64 const char *style_class;
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
65
468
1f251c462f74 use UiGeneric for WebView
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 464
diff changeset
66 UiGeneric *value;
1f251c462f74 use UiGeneric for WebView
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 464
diff changeset
67 const char *varname;
1f251c462f74 use UiGeneric for WebView
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 464
diff changeset
68
463
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
69 const int* groups;
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
70 } UiWebviewArgs;
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
71
594
fc854e0ab924 pass Args structs per pointer (GTK)
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 469
diff changeset
72 #define ui_webview(obj, ...) ui_webview_create(obj, &(UiWebviewArgs){ __VA_ARGS__ } )
463
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
73
874
33618ae398bd add webview (Cocoa)
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 800
diff changeset
74 UIEXPORT UIWIDGET ui_webview_create(UiObject *obj, UiWebviewArgs *args);
463
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
75
874
33618ae398bd add webview (Cocoa)
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 800
diff changeset
76 UIEXPORT void ui_webview_load_url(UiGeneric *g, const char *url);
463
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
77
874
33618ae398bd add webview (Cocoa)
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 800
diff changeset
78 UIEXPORT void ui_webview_load_content(
468
1f251c462f74 use UiGeneric for WebView
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 464
diff changeset
79 UiGeneric *g,
1f251c462f74 use UiGeneric for WebView
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 464
diff changeset
80 const char *uri,
1f251c462f74 use UiGeneric for WebView
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 464
diff changeset
81 const char *content,
1f251c462f74 use UiGeneric for WebView
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 464
diff changeset
82 size_t contentlength,
1f251c462f74 use UiGeneric for WebView
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 464
diff changeset
83 const char *mimetype,
1f251c462f74 use UiGeneric for WebView
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 464
diff changeset
84 const char *encoding);
463
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
85
875
0575ca45f1bb add cleanup/destroy handler for UiString, UiText and UiGeneric
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 874
diff changeset
86 /*
0575ca45f1bb add cleanup/destroy handler for UiString, UiText and UiGeneric
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 874
diff changeset
87 * Frees a UiWebViewData object returned by a webviews UiGeneric->get function
0575ca45f1bb add cleanup/destroy handler for UiString, UiText and UiGeneric
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 874
diff changeset
88 */
0575ca45f1bb add cleanup/destroy handler for UiString, UiText and UiGeneric
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 874
diff changeset
89 UIEXPORT void ui_webview_data_free(UiWebViewData *data);
463
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
90
874
33618ae398bd add webview (Cocoa)
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 800
diff changeset
91 UIEXPORT void ui_webview_reload(UiGeneric *g);
33618ae398bd add webview (Cocoa)
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 800
diff changeset
92 UIEXPORT UiBool ui_webview_can_go_back(UiGeneric *g);
33618ae398bd add webview (Cocoa)
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 800
diff changeset
93 UIEXPORT UiBool ui_webview_can_go_forward(UiGeneric *g);
33618ae398bd add webview (Cocoa)
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 800
diff changeset
94 UIEXPORT void ui_webview_go_back(UiGeneric *g);
33618ae398bd add webview (Cocoa)
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 800
diff changeset
95 UIEXPORT void ui_webview_go_forward(UiGeneric *g);
33618ae398bd add webview (Cocoa)
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 800
diff changeset
96 UIEXPORT const char * ui_webview_get_uri(UiGeneric *g);
33618ae398bd add webview (Cocoa)
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 800
diff changeset
97 UIEXPORT void ui_webview_enable_javascript(UiGeneric *g, UiBool enable);
33618ae398bd add webview (Cocoa)
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 800
diff changeset
98 UIEXPORT void ui_webview_set_zoom(UiGeneric *g, double zoom);
33618ae398bd add webview (Cocoa)
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 800
diff changeset
99 UIEXPORT double ui_webview_get_zoom(UiGeneric *g);
469
3f6142271f58 add more webview API
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 468
diff changeset
100
3f6142271f58 add more webview API
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 468
diff changeset
101
463
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
102 #ifdef __cplusplus
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
103 }
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
104 #endif
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
105
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
106 #endif /* UI_WEBVIEW_H */
e8ee57cc052e prepare webview
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
107

mercurial