WebKit2GTK+ Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
struct WebKitWebViewGroup; WebKitWebViewGroup * webkit_web_view_group_new (const gchar *name
); const gchar * webkit_web_view_group_get_name (WebKitWebViewGroup *group
); WebKitSettings * webkit_web_view_group_get_settings (WebKitWebViewGroup *group
); void webkit_web_view_group_set_settings (WebKitWebViewGroup *group
,WebKitSettings *settings
);
A WebKitWebViewGroup represents a group of WebKitWebViews that
share things like settings. There's a default WebKitWebViewGroup where
all WebKitWebViews of the same WebKitWebContext are added by default.
To create a WebKitWebView in a different WebKitWebViewGroup you can use
webkit_web_view_new_with_group()
.
WebKitWebViewGroups are identified by a unique name given when the group is
created with webkit_web_view_group_new()
.
WebKitWebViewGroups have a WebKitSettings to control the settings of all
WebKitWebViews of the group. You can get the settings with
webkit_web_view_group_get_settings()
to handle the settings, or you can set
your own WebKitSettings with webkit_web_view_group_set_settings()
. When
the WebKitSettings of a WebKitWebViewGroup changes, the signal notify::settings
is emitted on the group.
WebKitWebViewGroup * webkit_web_view_group_new (const gchar *name
);
Creates a new WebKitWebViewGroup with the given name
.
If name
is NULL
a unique identifier name will be created
automatically.
The newly created WebKitWebViewGroup doesn't contain any
WebKitWebView, web views are added to the new group when created
with webkit_web_view_new_with_group()
passing the group.
|
the name of the group. [allow-none] |
Returns : |
a new WebKitWebViewGroup. [transfer full] |
const gchar * webkit_web_view_group_get_name (WebKitWebViewGroup *group
);
Gets the name that uniquely identifies the WebKitWebViewGroup.
|
a WebKitWebViewGroup |
Returns : |
the name of group
|
WebKitSettings * webkit_web_view_group_get_settings (WebKitWebViewGroup *group
);
Gets the WebKitSettings of the WebKitWebViewGroup.
|
a WebKitWebViewGroup |
Returns : |
the settings of group . [transfer none]
|
void webkit_web_view_group_set_settings (WebKitWebViewGroup *group
,WebKitSettings *settings
);
Sets a new WebKitSettings for the WebKitWebViewGroup. The settings will
affect to all the WebKitWebViews of the group.
WebKitWebViewGroups always have a WebKitSettings so if you just want to
modify a setting you can use webkit_web_view_group_get_settings()
and modify the
returned WebKitSettings instead.
Setting the same WebKitSettings multiple times doesn't have any effect.
You can monitor the settings of a WebKitWebViewGroup by connecting to the
notify::settings signal of group
.
|
a WebKitWebViewGroup |
|
a WebKitSettings |
"settings"
property"settings" WebKitSettings* : Read / Write
The WebKitSettings of the web view group.