WebKitWindowProperties: WebKitGTK Reference Manual

WebKitWindowProperties

WebKitWindowProperties — Window properties of a WebKitWebView

Functions

void	webkit_window_properties_get_geometry ()
gboolean	webkit_window_properties_get_toolbar_visible ()
gboolean	webkit_window_properties_get_statusbar_visible ()
gboolean	webkit_window_properties_get_scrollbars_visible ()
gboolean	webkit_window_properties_get_menubar_visible ()
gboolean	webkit_window_properties_get_locationbar_visible ()
gboolean	webkit_window_properties_get_resizable ()
gboolean	webkit_window_properties_get_fullscreen ()

Properties

gboolean	fullscreen	Read / Write / Construct Only
GdkRectangle *	geometry	Read / Write / Construct Only
gboolean	locationbar-visible	Read / Write / Construct Only
gboolean	menubar-visible	Read / Write / Construct Only
gboolean	resizable	Read / Write / Construct Only
gboolean	scrollbars-visible	Read / Write / Construct Only
gboolean	statusbar-visible	Read / Write / Construct Only
gboolean	toolbar-visible	Read / Write / Construct Only

Types and Values

struct

WebKitWindowProperties

Object Hierarchy

    GObject
    ╰── WebKitWindowProperties

Description

The content of a WebKitWebView can request to change certain properties of the window containing the view. This can include the x, y position of the window, the width and height but also if a toolbar, scrollbar, statusbar, locationbar should be visible to the user, and the request to show the WebKitWebView fullscreen.

The “ready-to-show” signal handler is the proper place to apply the initial window properties. Then you can monitor the WebKitWindowProperties by connecting to ::notify signal.

static void ready_to_show_cb (WebKitWebView *web_view, gpointer user_data)
{
    GtkWidget *window;
    WebKitWindowProperties *window_properties;
    gboolean visible;

    /* Create the window to contain the WebKitWebView */
    window = browser_window_new ();
    gtk_container_add (GTK_CONTAINER (window), GTK_WIDGET (web_view));
    gtk_widget_show (GTK_WIDGET (web_view));

    /* Get the WebKitWindowProperties of the web view and monitor it */
    window_properties = webkit_web_view_get_window_properties (web_view);
    g_signal_connect (window_properties, "notify::geometry",
                      G_CALLBACK (window_geometry_changed), window);
    g_signal_connect (window_properties, "notify::toolbar-visible",
                      G_CALLBACK (window_toolbar_visibility_changed), window);
    g_signal_connect (window_properties, "notify::menubar-visible",
                      G_CALLBACK (window_menubar_visibility_changed), window);
    ....

    /* Apply the window properties before showing the window */
    visible = webkit_window_properties_get_toolbar_visible (window_properties);
    browser_window_set_toolbar_visible (BROWSER_WINDOW (window), visible);
    visible = webkit_window_properties_get_menubar_visible (window_properties);
    browser_window_set_menubar_visible (BROWSER_WINDOW (window), visible);
    ....

    if (webkit_window_properties_get_fullscreen (window_properties)) {
        gtk_window_fullscreen (GTK_WINDOW (window));
    } else {
        GdkRectangle geometry;

        gtk_window_set_resizable (GTK_WINDOW (window),
                                  webkit_window_properties_get_resizable (window_properties));
        webkit_window_properties_get_geometry (window_properties, &geometry);
        gtk_window_move (GTK_WINDOW (window), geometry.x, geometry.y);
        gtk_window_resize (GTK_WINDOW (window), geometry.width, geometry.height);
    }

    gtk_widget_show (window);
}

Functions

webkit_window_properties_get_geometry ()

void
webkit_window_properties_get_geometry (WebKitWindowProperties *window_properties,
                                       GdkRectangle *geometry);

Get the geometry the window should have on the screen when shown.

Parameters

window_properties	a WebKitWindowProperties
geometry	return location for the window geometry.	[out]

webkit_window_properties_get_toolbar_visible ()

gboolean
webkit_window_properties_get_toolbar_visible
                               (WebKitWindowProperties *window_properties);

Get whether the window should have the toolbar visible or not.

Parameters

window_properties

a WebKitWindowProperties

Returns

TRUE if toolbar should be visible or FALSE otherwise.

webkit_window_properties_get_statusbar_visible ()

gboolean
webkit_window_properties_get_statusbar_visible
                               (WebKitWindowProperties *window_properties);

Get whether the window should have the statusbar visible or not.

Parameters

window_properties

a WebKitWindowProperties

Returns

TRUE if statusbar should be visible or FALSE otherwise.

webkit_window_properties_get_scrollbars_visible ()

gboolean
webkit_window_properties_get_scrollbars_visible
                               (WebKitWindowProperties *window_properties);

Get whether the window should have the scrollbars visible or not.

Parameters

window_properties

a WebKitWindowProperties

Returns

TRUE if scrollbars should be visible or FALSE otherwise.

webkit_window_properties_get_menubar_visible ()

gboolean
webkit_window_properties_get_menubar_visible
                               (WebKitWindowProperties *window_properties);

Get whether the window should have the menubar visible or not.

Parameters

window_properties

a WebKitWindowProperties

Returns

TRUE if menubar should be visible or FALSE otherwise.

webkit_window_properties_get_locationbar_visible ()

gboolean
webkit_window_properties_get_locationbar_visible
                               (WebKitWindowProperties *window_properties);

Get whether the window should have the locationbar visible or not.

Parameters

window_properties

a WebKitWindowProperties

Returns

TRUE if locationbar should be visible or FALSE otherwise.

webkit_window_properties_get_resizable ()

gboolean
webkit_window_properties_get_resizable
                               (WebKitWindowProperties *window_properties);

Get whether the window should be resizable by the user or not.

Parameters

window_properties

a WebKitWindowProperties

Returns

TRUE if the window should be resizable or FALSE otherwise.

webkit_window_properties_get_fullscreen ()

gboolean
webkit_window_properties_get_fullscreen
                               (WebKitWindowProperties *window_properties);

Get whether the window should be shown in fullscreen state or not.

Parameters

window_properties

a WebKitWindowProperties

Returns

TRUE if the window should be fullscreen or FALSE otherwise.

Types and Values

struct WebKitWindowProperties

struct WebKitWindowProperties;

Property Details