browser-window-c 0.3.2

Browser framework functionality for BrowserWindow written in C/C++.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

#ifndef BW_BROWSER_WINDOW_H
#define BW_BROWSER_WINDOW_H

#ifdef __cplusplus
extern "C" {
#endif

#ifdef BW_CEF
#include "browser_window/cef.h"
#elif defined(BW_EDGE2)
#include "browser_window/edge2.h"
#else
typedef struct {} bw_BrowserWindowImpl;
#endif

#include "application.h"
#include "event.h"
#include "err.h"
#include "string.h"
#include "window.h"

#include <stdint.h>



typedef struct bw_BrowserWindow bw_BrowserWindow;


typedef void (*bw_BrowserWindowCreationCallbackFn)( bw_BrowserWindow* window, void* data );
typedef void (*bw_BrowserWindowHandlerFn)( bw_BrowserWindow* window, bw_CStrSlice cmd, bw_CStrSlice* args, size_t arg_count );
typedef void (*bw_BrowserWindowJsCallbackFn)( bw_BrowserWindow* window, void* user_data, const char* result, const bw_Err* err );


typedef struct {
	bw_Event on_address_changed;
	bw_Event on_console_message;
	bw_Event on_favicon_changed;
	bw_Event on_fullscreen_mode_changed;
	bw_Event on_loading_progress_changed;
	bw_Event on_message;
	bw_Event on_navigation_start;
	bw_Event on_navigation_end;
	bw_Event on_page_title_changed;
	bw_Event on_status_message;
	bw_Event on_tooltip;
} bw_BrowserWindowEvents;

/// `cmd` is always a string. The arguments are JS values in the form of a string.
typedef struct {
	bw_CStrSlice cmd;
	size_t arg_count;
	bw_CStrSlice* args;
} bw_BrowserWindowMessageArgs;

typedef struct bw_BrowserWindowOptions {
	BOOL dev_tools;
	bw_CStrSlice resource_path;
} bw_BrowserWindowOptions;

typedef struct bw_BrowserWindowSource {
	bw_CStrSlice data;
	BOOL is_html;
} bw_BrowserWindowSource;



struct bw_BrowserWindow {
	bw_Window* window;
	bw_BrowserWindowImpl impl;
	bw_BrowserWindowEvents events;
};


/// Executes the given JavaScript and calls the given callback (on the GUI thread) to provide the result.
void bw_BrowserWindow_evalJs( bw_BrowserWindow* bw, bw_CStrSlice js, bw_BrowserWindowJsCallbackFn callback, void* cb_data );
void bw_BrowserWindow_evalJsThreaded( bw_BrowserWindow* bw, bw_CStrSlice js, bw_BrowserWindowJsCallbackFn callback, void* cb_data );

void bw_BrowserWindow_free(bw_BrowserWindow* bw);

bw_Application* bw_BrowserWindow_getApp( bw_BrowserWindow* bw );
void* bw_BrowserWindow_getUserData( bw_BrowserWindow* bw );
BOOL bw_BrowserWindow_getUrl(bw_BrowserWindow* bw, bw_StrSlice* url);
bw_Window* bw_BrowserWindow_getWindow( bw_BrowserWindow* bw );

bw_Err bw_BrowserWindow_navigate( bw_BrowserWindow* bw, bw_CStrSlice url );

/// Allocates a browser window and creates the window for it.
/// Call `bw_BrowserWindow_create` on it to add the actual browser framework to this window.
bw_BrowserWindow* bw_BrowserWindow_new(
	bw_Application* app,
	const bw_Window* parent,
	bw_CStrSlice title,
	int width, int height,
	const bw_WindowOptions* window_options
);

/// Adds the browser framework to the browser window.
/// Should be called right after `bw_BrowserWindow_new`.
void bw_BrowserWindow_create(
	bw_BrowserWindow* bw,
	int width, int height,
	bw_BrowserWindowSource source,
	const bw_BrowserWindowOptions* browser_window_options,
	bw_BrowserWindowCreationCallbackFn callback,	// A function that gets invoked when the browser window has been created.
	void* callback_data	// Data that will be passed to the creation callback
);


#ifdef __cplusplus
} // extern "C"
#endif

#endif//BW_BROWSER_WINDOW_H