Add a native handle (like webui_win32_get_hwnd) to get a handle

to the native window on a platform, in order to be able to
implement integrations like modal dialogs (open file, save file,
choose dir, and dialogs (by opening a new WebView window on top of
another, and making it transient or modal for the 'parent').

Signed-off-by: Hans Dijkema <[email protected]>

Author: hdijkema

include/webui.h

@@ -901,6 +901,24 @@ WEBUI_EXPORT size_t webui_get_child_process_id(size_t window);
  */
 WEBUI_EXPORT void* webui_win32_get_hwnd(size_t window);
 
+/**
+ * @brief Gets the handle to the native window of the specific WebUI implementation
+ * `GtkWindow *` for the Gtk WebView on Linux, HWND for win32.
+ * Won't work with a web browser window on Linux, see also webui_win32_gt_hwnd.
+ *
+ * @param window The window number
+ *
+ * @return Returns the native window handle (`GtkWindow *`, `hwnd`) as `void*`
+ *
+ * @example
+ * #if __linux__
+ * GtkWindow *w = static_cast<GtkWindow *>(webui_get_native_window_handle_wv(myWindow);
+ * #elif _WIN32
+ * HWND h = webui_get_native_window_handle_wv(myWindow);
+ * #endif
+ */
+WEBUI_EXPORT void* webui_get_native_window_handle_wv(size_t window);
+
 /**
  * @brief Get the network port of a running window.
  * This can be useful to determine the HTTP link of `webui.js`

src/webui.c

@@ -2800,6 +2800,35 @@ void* webui_win32_get_hwnd(size_t window) {
     return NULL;
 }
 
+void* webui_get_native_window_handle_wv(size_t window)
+{
+#ifdef _WIN32
+    return webui_win32_get_hwnd(size_t window);
+#elif __linux__
+    #ifdef WEBUI_LOG
+    _webui_log_info("[User] webui_gtk_get_window_wv([%zu])\n", window);
+    #endif
+
+    // Initialization
+    _webui_init();
+
+    // Dereference
+    if (_webui_mutex_app_is_exit_now(WEBUI_MUTEX_GET_STATUS) || _webui.wins[window] == NULL)
+        return NULL;
+
+    _webui_window_t* win = _webui.wins[window];
+
+    if (_webui.is_webview) {
+        return win->webView->gtk_win;
+    }
+
+    return NULL;
+
+#else // MACOS
+    return NULL;    // Don't know how to support on MacOS (yet).
+#endif
+}
+
 void webui_set_hide(size_t window, bool status) {
 
     #ifdef WEBUI_LOG