wxdragon-sys 0.9.16

Raw FFI bindings to libwxdragon (which statically links wxWidgets).
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

#ifndef WXD_APP_H
#define WXD_APP_H

#include "../wxd_types.h" // Adjust path as necessary if wxd_types.h is at the root of include/

// --- App Functions ---
WXD_EXPORTED wxd_App_t*
wxd_GetApp();
WXD_EXPORTED int
wxd_Main(int argc, char** argv, wxd_OnInitCallback on_init, void* userData);
WXD_EXPORTED void
wxd_App_SetTopWindow(wxd_App_t* app, wxd_Window_t* window);
WXD_EXPORTED wxd_Window_t*
wxd_App_GetTopWindow(wxd_App_t* app);
WXD_EXPORTED bool
wxd_App_IsMainLoopRunning(wxd_App_t* app);
WXD_EXPORTED void
wxd_App_ExitMainLoop(wxd_App_t* app);
WXD_EXPORTED bool
wxd_App_GetExitOnFrameDelete(wxd_App_t* app);
WXD_EXPORTED void
wxd_App_SetExitOnFrameDelete(wxd_App_t* app, bool exitOnFrameDelete);

// App identity helpers
WXD_EXPORTED void
wxd_App_SetAppName(wxd_App_t* app, const char* name);
WXD_EXPORTED int
wxd_App_GetAppName(const wxd_App_t* app, char* out, size_t out_len);
WXD_EXPORTED void
wxd_App_SetAppDisplayName(wxd_App_t* app, const char* name);
WXD_EXPORTED int
wxd_App_GetAppDisplayName(const wxd_App_t* app, char* out, size_t out_len);
WXD_EXPORTED void
wxd_App_SetVendorName(wxd_App_t* app, const char* name);
WXD_EXPORTED int
wxd_App_GetVendorName(const wxd_App_t* app, char* out, size_t out_len);
WXD_EXPORTED void
wxd_App_SetVendorDisplayName(wxd_App_t* app, const char* name);
WXD_EXPORTED int
wxd_App_GetVendorDisplayName(const wxd_App_t* app, char* out, size_t out_len);

// Process callback queue
WXD_EXPORTED void
wxd_App_ProcessCallbacks();

// New function to free an array of integers allocated by C++
WXD_EXPORTED void
wxd_free_int_array(int* ptr);

// --- Appearance Support (wxWidgets 3.3.0+) ---

// Set the application appearance mode (requires wxWidgets 3.3.0+)
WXD_EXPORTED wxd_AppearanceResult
wxd_App_SetAppearance(wxd_App_t* app, wxd_Appearance appearance);

// Get system appearance information
WXD_EXPORTED wxd_SystemAppearance_t*
wxd_SystemSettings_GetAppearance();

// Check if the system is using dark mode
WXD_EXPORTED bool
wxd_SystemAppearance_IsDark(wxd_SystemAppearance_t* appearance);

// Check if the system background is dark
WXD_EXPORTED bool
wxd_SystemAppearance_IsUsingDarkBackground(wxd_SystemAppearance_t* appearance);

/**
 * @brief Get the system appearance name (mainly for macOS)
 * Returns the required UTF-8 byte length (excluding null terminator).
 * If out is not null and out_len > 0, copies up to out_len - 1 bytes and null-terminates.
 * If out is null or out_len == 0, nothing is written.
 * @return Required UTF-8 byte length (excluding null terminator)
 */
WXD_EXPORTED int
wxd_SystemAppearance_GetName(const wxd_SystemAppearance_t* appearance, char* out, size_t out_len);

// Free system appearance object
WXD_EXPORTED void
wxd_SystemAppearance_Destroy(wxd_SystemAppearance_t* appearance);

// --- End of Appearance Support ---

// --- macOS-specific App Event Handlers ---

// Register handlers for macOS application events (supports multiple handlers per event)
WXD_EXPORTED void
wxd_App_AddMacOpenFilesHandler(wxd_App_t* app, wxd_MacOpenFilesCallback callback, void* userData);
WXD_EXPORTED void
wxd_App_AddMacOpenURLHandler(wxd_App_t* app, wxd_MacOpenURLCallback callback, void* userData);
WXD_EXPORTED void
wxd_App_AddMacNewFileHandler(wxd_App_t* app, wxd_MacNewFileCallback callback, void* userData);
WXD_EXPORTED void
wxd_App_AddMacReopenAppHandler(wxd_App_t* app, wxd_MacReopenAppCallback callback, void* userData);
WXD_EXPORTED void
wxd_App_AddMacPrintFilesHandler(wxd_App_t* app, wxd_MacPrintFilesCallback callback, void* userData);

// --- End of macOS-specific App Event Handlers ---

#endif // WXD_APP_H