From 0a9017482faf3996d2d50bd711022973ae804f71 Mon Sep 17 00:00:00 2001 From: Michael Webster Date: Thu, 17 Apr 2025 10:19:44 -0400 Subject: [PATCH 1/2] Remove XAppKbdLayoutController class. --- debian/control | 3 - debian/libxapp1.symbols | 18 - docs/reference/XAppKbdLayoutController.html | 745 ------------------- docs/xapp-docs.xml | 1 - libxapp/meson.build | 9 +- libxapp/xapp-kbd-layout-controller.c | 752 -------------------- libxapp/xapp-kbd-layout-controller.h | 70 -- 7 files changed, 1 insertion(+), 1597 deletions(-) delete mode 100644 docs/reference/XAppKbdLayoutController.html delete mode 100644 libxapp/xapp-kbd-layout-controller.c delete mode 100644 libxapp/xapp-kbd-layout-controller.h diff --git a/debian/control b/debian/control index dd342c7c..e88bcdef 100644 --- a/debian/control +++ b/debian/control @@ -15,10 +15,8 @@ Build-Depends: libgdk-pixbuf-2.0-dev, libgirepository1.0-dev (>= 0.10.2-1~), libglib2.0-dev (>= 2.44), - libgnomekbd-dev, libgtk-3-dev (>= 3.16), libx11-dev, - libxkbfile-dev, meson, python-gi-dev, python3, @@ -59,7 +57,6 @@ Depends: libgnomekbd-dev, libgtk-3-dev (>= 3.16), libxapp1 (= ${binary:Version}), - libxkbfile-dev, ${misc:Depends}, Description: XApp library - development files This package provides the include files and static library for the XApp diff --git a/debian/libxapp1.symbols b/debian/libxapp1.symbols index 58ef70a7..e258f8cb 100644 --- a/debian/libxapp1.symbols +++ b/debian/libxapp1.symbols @@ -91,24 +91,6 @@ libxapp.so.1 libxapp1 #MINVER# xapp_icon_chooser_dialog_set_default_icon@Base 1.6.9 xapp_icon_chooser_dialog_set_property@Base 1.4.9 xapp_icon_size_get_type@Base 1.4.9 - xapp_kbd_layout_controller_get_all_names@Base 1.4.9 - xapp_kbd_layout_controller_get_current_flag_id@Base 1.4.9 - xapp_kbd_layout_controller_get_current_group@Base 1.4.9 - xapp_kbd_layout_controller_get_current_icon_name@Base 1.4.9 - xapp_kbd_layout_controller_get_current_name@Base 1.4.9 - xapp_kbd_layout_controller_get_current_short_group_label@Base 1.4.9 - xapp_kbd_layout_controller_get_current_variant_label@Base 1.4.9 - xapp_kbd_layout_controller_get_enabled@Base 1.4.9 - xapp_kbd_layout_controller_get_flag_id_for_group@Base 1.4.9 - xapp_kbd_layout_controller_get_icon_name_for_group@Base 1.4.9 - xapp_kbd_layout_controller_get_short_group_label_for_group@Base 1.4.9 - xapp_kbd_layout_controller_get_type@Base 1.4.9 - xapp_kbd_layout_controller_get_variant_label_for_group@Base 1.4.9 - xapp_kbd_layout_controller_new@Base 1.4.9 - xapp_kbd_layout_controller_next_group@Base 1.4.9 - xapp_kbd_layout_controller_previous_group@Base 1.4.9 - xapp_kbd_layout_controller_render_cairo_subscript@Base 1.4.9 - xapp_kbd_layout_controller_set_current_group@Base 1.4.9 xapp_monitor_blanker_are_monitors_blanked@Base 1.4.9 xapp_monitor_blanker_blank_other_monitors@Base 1.4.9 xapp_monitor_blanker_get_type@Base 1.4.9 diff --git a/docs/reference/XAppKbdLayoutController.html b/docs/reference/XAppKbdLayoutController.html deleted file mode 100644 index 9424fbf4..00000000 --- a/docs/reference/XAppKbdLayoutController.html +++ /dev/null @@ -1,745 +0,0 @@ - - - - -XAppKbdLayoutController: XApp Reference Manual - - - - - - - - - - - - - - - - -
-
-
- - -
-

XAppKbdLayoutController

-

XAppKbdLayoutController — Keyboard layout selection UI element provider.

-
- -
-

Properties

-
----- - - - - - -
gbooleanenabledRead
-
-
-

Signals

-
----- - - - - - - - - - - - - -
voidconfig-changedRun Last
voidlayout-changedRun Last
-
-
-

Object Hierarchy

-
    GObject
-    ╰── XAppKbdLayoutController
-
-
-
-

Description

-

A GObject wrapper for Gkbd that provides additional UI element -support for keyboard layout flags and abbreviations, as well as -Wfacilities to distinguish regional and hardware-based variants -which might otherwise appear identical in a layout list.

-
-
-

Functions

-
-

xapp_kbd_layout_controller_new ()

-
XAppKbdLayoutController *
-xapp_kbd_layout_controller_new (void);
-

Creates a new XAppKbdLayoutController instance.

-
-

Returns

-

a new XAppKbdLayoutController instance.

-

[transfer full]

-
-
-
-
-

xapp_kbd_layout_controller_get_enabled ()

-
gboolean
-xapp_kbd_layout_controller_get_enabled
-                               (XAppKbdLayoutController *controller);
-

Returns whether or not the layout controller is enabled

-
-

Parameters

-
----- - - - - - -

controller

the XAppKbdLayoutController

 
-
-
-
-
-

xapp_kbd_layout_controller_get_current_group ()

-
guint
-xapp_kbd_layout_controller_get_current_group
-                               (XAppKbdLayoutController *controller);
-

Selects the previous group in the group list.

-
-

Parameters

-
----- - - - - - -

controller

the XAppKbdLayoutController

 
-
-
-
-
-

xapp_kbd_layout_controller_set_current_group ()

-
void
-xapp_kbd_layout_controller_set_current_group
-                               (XAppKbdLayoutController *controller,
-                                guint group);
-

Selects the given group number as active.

-
-

Parameters

-
----- - - - - - - - - - - - - -

controller

the XAppKbdLayoutController

 

group

the group number to make active

 
-
-
-
-
-

xapp_kbd_layout_controller_next_group ()

-
void
-xapp_kbd_layout_controller_next_group (XAppKbdLayoutController *controller);
-

Selects the next group in the group list.

-
-

Parameters

-
----- - - - - - -

controller

the XAppKbdLayoutController

 
-
-
-
-
-

xapp_kbd_layout_controller_previous_group ()

-
void
-xapp_kbd_layout_controller_previous_group
-                               (XAppKbdLayoutController *controller);
-

Selects the previous group in the group list.

-
-

Parameters

-
----- - - - - - -

controller

the XAppKbdLayoutController

 
-
-
-
-
-

xapp_kbd_layout_controller_get_current_name ()

-
gchar *
-xapp_kbd_layout_controller_get_current_name
-                               (XAppKbdLayoutController *controller);
-

Returns the full name of the current keyboard layout.

-
-

Parameters

-
----- - - - - - -

controller

the XAppKbdLayoutController

 
-
-
-

Returns

-

the newly created string or NULL -if something went wrong.

-

[transfer full]

-
-
-
-
-

xapp_kbd_layout_controller_get_all_names ()

-
gchar **
-xapp_kbd_layout_controller_get_all_names
-                               (XAppKbdLayoutController *controller);
-

Returns an array of all full layout names

-
-

Parameters

-
----- - - - - - -

controller

the XAppKbdLayoutController

 
-
-
-

Returns

-

array of names.

-

[transfer none][array zero-terminated=1]

-
-
-
-
-

xapp_kbd_layout_controller_get_current_icon_name ()

-
gchar *
-xapp_kbd_layout_controller_get_current_icon_name
-                               (XAppKbdLayoutController *controller);
-

Returns the icon file name (no path or extension) to use for the current layout

-
-

Parameters

-
----- - - - - - -

controller

the XAppKbdLayoutController

 
-
-
-

Returns

-

a new string with the icon name.

-

[transfer full]

-
-
-
-
-

xapp_kbd_layout_controller_get_icon_name_for_group ()

-
gchar *
-xapp_kbd_layout_controller_get_icon_name_for_group
-                               (XAppKbdLayoutController *controller,
-                                guint group);
-

Returns the icon file name (no path or extension) to use for the specified layout.

-
-

Parameters

-
----- - - - - - - - - - - - - -

controller

the XAppKbdLayoutController

 

group

a group number

 
-
-
-

Returns

-

a new string with the icon name.

-

[transfer full]

-
-
-
-
-

xapp_kbd_layout_controller_get_current_flag_id ()

-
gint
-xapp_kbd_layout_controller_get_current_flag_id
-                               (XAppKbdLayoutController *controller);
-

Returns the duplicate id for the current layout

-
-

Parameters

-
----- - - - - - -

controller

the XAppKbdLayoutController

 
-
-
-

Returns

-

the id

-
-
-
-
-

xapp_kbd_layout_controller_get_flag_id_for_group ()

-
gint
-xapp_kbd_layout_controller_get_flag_id_for_group
-                               (XAppKbdLayoutController *controller,
-                                guint group);
-
-
-
-

xapp_kbd_layout_controller_get_current_short_group_label ()

-
gchar *
-xapp_kbd_layout_controller_get_current_short_group_label
-                               (XAppKbdLayoutController *controller);
-

Returns the short group label (and subscript, if any) of the current layout

-
-

Parameters

-
----- - - - - - -

controller

the XAppKbdLayoutController

 
-
-
-

Returns

-

a new string or NULL.

-

[transfer full]

-
-
-
-
-

xapp_kbd_layout_controller_get_short_group_label_for_group ()

-
gchar *
-xapp_kbd_layout_controller_get_short_group_label_for_group
-                               (XAppKbdLayoutController *controller,
-                                guint group);
-

Returns the short group label and subscript of the specified layout.

-
-

Parameters

-
----- - - - - - - - - - - - - -

controller

the XAppKbdLayoutController

 

group

a group number

 
-
-
-

Returns

-

a new string or NULL.

-

[transfer full]

-
-
-
-
-

xapp_kbd_layout_controller_get_current_variant_label ()

-
gchar *
-xapp_kbd_layout_controller_get_current_variant_label
-                               (XAppKbdLayoutController *controller);
-

Returns the variant label (and subscript, if any) of the current layout

-
-

Parameters

-
----- - - - - - -

controller

the XAppKbdLayoutController

 
-
-
-

Returns

-

a new string or NULL.

-

[transfer full]

-
-
-
-
-

xapp_kbd_layout_controller_get_variant_label_for_group ()

-
gchar *
-xapp_kbd_layout_controller_get_variant_label_for_group
-                               (XAppKbdLayoutController *controller,
-                                guint group);
-

Returns the variant label and subscript of the specified layout.

-
-

Parameters

-
----- - - - - - - - - - - - - -

controller

the XAppKbdLayoutController

 

group

a group number

 
-
-
-

Returns

-

a new string or NULL.

-

[transfer full]

-
-
-
-
-

xapp_kbd_layout_controller_render_cairo_subscript ()

-
void
-xapp_kbd_layout_controller_render_cairo_subscript
-                               (cairo_t *cr,
-                                gdouble x,
-                                gdouble y,
-                                gdouble width,
-                                gdouble height,
-                                gint subscript);
-

Renders a subscript number in the given work area. This should -be called from within a "draw" or "paint" widget/actor function, -where a valid cairo_t is provided to draw with.

-
-

Parameters

-
----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

cr

a cairo_t

 

x

the x position of the drawing area

 

y

the y position of the drawing area

 

width

the width of the drawing area

 

height

the height of the drawing area

 

subscript

the number to render

 
-
-
-
-
-

Property Details

-
-

The “enabled” property

-
  “enabled”                  gboolean
-

Whether we're enabled (more than one keyboard layout is installed).

-

Owner: XAppKbdLayoutController

-

Flags: Read

-

Default value: FALSE

-
-
-
-

Signal Details

-
-

The “config-changed” signal

-
void
-user_function (XAppKbdLayoutController *xappkbdlayoutcontroller,
-               gpointer                 user_data)
-

Flags: Run Last

-
-
-
-

The “layout-changed” signal

-
void
-user_function (XAppKbdLayoutController *xappkbdlayoutcontroller,
-               guint                    arg1,
-               gpointer                 user_data)
-

Flags: Run Last

-
-
-
- - - \ No newline at end of file diff --git a/docs/xapp-docs.xml b/docs/xapp-docs.xml index 3976835b..b03cb5bc 100644 --- a/docs/xapp-docs.xml +++ b/docs/xapp-docs.xml @@ -22,7 +22,6 @@ - diff --git a/libxapp/meson.build b/libxapp/meson.build index c419b8fc..77e7d838 100644 --- a/libxapp/meson.build +++ b/libxapp/meson.build @@ -71,12 +71,6 @@ switcheroo_sources = gnome.gdbus_codegen( xapp_sources += switcheroo_sources -if not app_lib_only - libdeps += dependency('libgnomekbdui', required: true) - xapp_headers += 'xapp-kbd-layout-controller.h' - xapp_sources += 'xapp-kbd-layout-controller.c' -endif - xapp_statusicon_interface_sources = gnome.gdbus_codegen( 'xapp-statusicon-interface', sources: 'org.x.StatusIcon.xml', @@ -138,8 +132,7 @@ pkg.generate( subdirs: 'xapp', description: 'Utility library', version: meson.project_version(), - requires: ['gtk+-3.0', 'gobject-2.0', 'cairo'], - requires_private: 'xkbfile', + requires: ['gtk+-3.0', 'gobject-2.0', 'cairo'] ) install_data(['xapp-glade-catalog.xml'], diff --git a/libxapp/xapp-kbd-layout-controller.c b/libxapp/xapp-kbd-layout-controller.c deleted file mode 100644 index 49ade0ea..00000000 --- a/libxapp/xapp-kbd-layout-controller.c +++ /dev/null @@ -1,752 +0,0 @@ - -#include - -#include -#include -#include -#include - -#include -#include -#include - -#include - -#include "xapp-kbd-layout-controller.h" - -/** - * SECTION:xapp-kbd-layout-controller - * @Short_description: Keyboard layout selection UI element provider. - * @Title: XAppKbdLayoutController - * - * A GObject wrapper for Gkbd that provides additional UI element - * support for keyboard layout flags and abbreviations, as well as - * Wfacilities to distinguish regional and hardware-based variants - * which might otherwise appear identical in a layout list. - */ - -enum -{ - PROP_0, - - PROP_ENABLED -}; - -enum -{ - KBD_LAYOUT_CHANGED, - KBD_CONFIG_CHANGED, - - LAST_SIGNAL -}; - -static guint signals[LAST_SIGNAL] = { 0, }; - -typedef struct -{ - gchar *group_name; - gchar *variant_name; - - gchar *group_label; - gint group_dupe_id; - - gchar *variant_label; - gint variant_dupe_id; -} GroupData; - -#define GROUP_DATA(ptr, idx) ((GroupData *) g_ptr_array_index (ptr, idx)) - -static void -group_data_free (GroupData *data) -{ - g_clear_pointer (&data->group_name, g_free); - g_clear_pointer (&data->group_label, g_free); - g_clear_pointer (&data->variant_label, g_free); - data->group_dupe_id = 0; - data->variant_dupe_id = 0; - - g_slice_free (GroupData, data); -} - -struct _XAppKbdLayoutControllerPrivate -{ - GkbdConfiguration *config; - - guint num_groups; - - GPtrArray *group_data; - - gulong changed_id; - gulong group_changed_id; - guint idle_changed_id; - - gboolean enabled; -}; - -G_DEFINE_TYPE_WITH_PRIVATE (XAppKbdLayoutController, xapp_kbd_layout_controller, G_TYPE_OBJECT); - -static void -clear_stores (XAppKbdLayoutController *controller) -{ - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - g_clear_pointer (&priv->group_data, g_ptr_array_unref); -} - -static gchar * -create_label (XAppKbdLayoutController *controller, - const gchar *name, - gint dupe_id) -{ - if (g_utf8_validate (name, -1, NULL)) - { - gchar utf8[20]; - gchar *utf8_cased = NULL; - - g_utf8_strncpy (utf8, name, 3); - - utf8_cased = g_utf8_strdown (utf8, -1); - - GString *string = g_string_new (utf8_cased); - - g_free (utf8_cased); - - if (dupe_id > 0) - { - string = g_string_append_unichar (string, 0x2080 + dupe_id); - } - - return g_string_free (string, FALSE); - } - - return NULL; -} - -static void -load_stores (XAppKbdLayoutController *controller) -{ - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - gchar **group_names = gkbd_configuration_get_group_names (priv->config); - priv->num_groups = g_strv_length (group_names); - - /* We do nothing if there's only one keyboard layout enabled */ - if (priv->num_groups == 1) - { - priv->enabled = FALSE; - return; - } - - priv->enabled = TRUE; - - /* Populate the GroupData pointer array */ - - gint group_dupe_id, variant_dupe_id; - guint i, j; - - GPtrArray *list = g_ptr_array_new_with_free_func ((GDestroyNotify) group_data_free); - - for (i = 0; i < priv->num_groups; i++) - { - GroupData *data = g_slice_new0 (GroupData); - - /* Iterate through group names, figure out subscript values for duplicates */ - - gchar *group_name = gkbd_configuration_get_group_name (priv->config, i); - group_dupe_id = 0; - - for (j = 0; j < list->len; j++) - { - GroupData *iter = g_ptr_array_index (list, j); - - if (g_strcmp0 (group_name, iter->group_name) == 0) - { - group_dupe_id++; - iter->group_dupe_id = group_dupe_id; - } - } - - if (group_dupe_id > 0) - { - group_dupe_id++; - } - - data->group_name = group_name; - data->group_dupe_id = group_dupe_id; - - /* Iterate through layout/variant names, figure out subscript values for duplicates */ - - gchar *variant_name = gkbd_configuration_extract_layout_name (priv->config, i); - variant_dupe_id = 0; - - for (j = 0; j < list->len; j++) - { - GroupData *iter = g_ptr_array_index (list, j); - - if (g_strcmp0 (variant_name, iter->variant_name) == 0) - { - variant_dupe_id++; - iter->variant_dupe_id = variant_dupe_id; - } - } - - if (variant_dupe_id > 0) - { - variant_dupe_id++; - } - - data->variant_name = variant_name; - data->variant_dupe_id = variant_dupe_id; - - /* Finally, add the GroupData slice to the array */ - g_ptr_array_add (list, data); - } - - for (i = 0; i < priv->num_groups; i++) - { - GroupData *data = g_ptr_array_index (list, i); - - /* Now generate labels for group names and for variant names. This is done - * in its own loop after the initial run, because previous dupe ids could have - * changed later in the loop. - */ - - data->group_label = create_label (controller, data->group_name, data->group_dupe_id); - data->variant_label = create_label (controller, data->variant_name, data->variant_dupe_id); - } - - priv->group_data = list; -} - -static gboolean -idle_config_changed (XAppKbdLayoutController *controller) -{ - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - clear_stores (controller); - load_stores (controller); - - if (gkbd_configuration_get_current_group (priv->config) >= priv->num_groups) - { - xapp_kbd_layout_controller_set_current_group (controller, 0); - } - - g_signal_emit (controller, signals[KBD_CONFIG_CHANGED], 0); - - priv->idle_changed_id = 0; - return FALSE; -} - -static void -on_configuration_changed (GkbdConfiguration *config, - XAppKbdLayoutController *controller) -{ - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - if (priv->idle_changed_id != 0) - { - g_source_remove (priv->idle_changed_id); - priv->idle_changed_id = 0; - } - - priv->idle_changed_id = g_idle_add ((GSourceFunc) idle_config_changed, controller); -} - - -static void -on_configuration_group_changed (GkbdConfiguration *config, - gint group, - XAppKbdLayoutController *controller) -{ - g_signal_emit (controller, signals[KBD_LAYOUT_CHANGED], 0, (guint) group); -} - -static void -xapp_kbd_layout_controller_init (XAppKbdLayoutController *controller) -{ - controller->priv = xapp_kbd_layout_controller_get_instance_private (controller); - - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - priv->config = gkbd_configuration_get (); - priv->enabled = FALSE; - priv->idle_changed_id = 0; - - priv->group_data = NULL; -} - -static void -xapp_kbd_layout_controller_constructed (GObject *object) -{ - G_OBJECT_CLASS (xapp_kbd_layout_controller_parent_class)->constructed (object); - - XAppKbdLayoutController *controller = XAPP_KBD_LAYOUT_CONTROLLER (object); - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - gkbd_configuration_start_listen (priv->config); - - priv->changed_id = g_signal_connect_object (priv->config, - "changed", - G_CALLBACK (on_configuration_changed), - controller, 0); - - priv->group_changed_id = g_signal_connect_object (priv->config, - "group-changed", - G_CALLBACK (on_configuration_group_changed), - controller, 0); - clear_stores (controller); - load_stores (controller); -} - -static void -xapp_kbd_layout_controller_get_property (GObject *gobject, - guint prop_id, - GValue *value, - GParamSpec *pspec) -{ - XAppKbdLayoutController *controller = XAPP_KBD_LAYOUT_CONTROLLER (gobject); - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - switch (prop_id) - { - case PROP_ENABLED: - g_value_set_boolean (value, priv->enabled); - break; - default: - G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec); - break; - } -} - -static void -xapp_kbd_layout_controller_dispose (GObject *object) -{ - XAppKbdLayoutController *controller = XAPP_KBD_LAYOUT_CONTROLLER (object); - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - gkbd_configuration_stop_listen (priv->config); - - clear_stores (controller); - - if (priv->changed_id > 0) - { - g_signal_handler_disconnect (priv->config, priv->changed_id); - priv->changed_id = 0; - } - - if (priv->group_changed_id > 0) - { - g_signal_handler_disconnect (priv->config, priv->group_changed_id); - priv->group_changed_id = 0; - } - - if (priv->idle_changed_id != 0) - { - g_source_remove (priv->idle_changed_id); - priv->idle_changed_id = 0; - } - - G_OBJECT_CLASS (xapp_kbd_layout_controller_parent_class)->dispose (object); -} - -static void -xapp_kbd_layout_controller_finalize (GObject *object) -{ - XAppKbdLayoutController *controller = XAPP_KBD_LAYOUT_CONTROLLER (object); - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - g_clear_object (&priv->config); - - G_OBJECT_CLASS (xapp_kbd_layout_controller_parent_class)->finalize (object); -} - -static void -xapp_kbd_layout_controller_class_init (XAppKbdLayoutControllerClass *klass) -{ - GObjectClass *gobject_class = G_OBJECT_CLASS (klass); - - gobject_class->dispose = xapp_kbd_layout_controller_dispose; - gobject_class->finalize = xapp_kbd_layout_controller_finalize; - gobject_class->get_property = xapp_kbd_layout_controller_get_property; - gobject_class->constructed = xapp_kbd_layout_controller_constructed; - - g_object_class_install_property (gobject_class, PROP_ENABLED, - g_param_spec_boolean ("enabled", - "Enabled", - "Whether we're enabled (more than one keyboard layout is installed)", - FALSE, - G_PARAM_READABLE) - ); - - signals[KBD_LAYOUT_CHANGED] = g_signal_new ("layout-changed", - G_TYPE_FROM_CLASS (gobject_class), - G_SIGNAL_RUN_LAST, - 0, - NULL, NULL, - g_cclosure_marshal_VOID__UINT, - G_TYPE_NONE, - 1, G_TYPE_UINT); - - signals[KBD_CONFIG_CHANGED] = g_signal_new ("config-changed", - G_TYPE_FROM_CLASS (gobject_class), - G_SIGNAL_RUN_LAST, - 0, - NULL, NULL, - g_cclosure_marshal_VOID__VOID, - G_TYPE_NONE, - 0, G_TYPE_NONE); -} - -/** - * xapp_kbd_layout_controller_new - * - * Creates a new XAppKbdLayoutController instance. - * - * Returns: (transfer full): a new #XAppKbdLayoutController instance - */ -XAppKbdLayoutController * -xapp_kbd_layout_controller_new (void) -{ - return g_object_new (XAPP_TYPE_KBD_LAYOUT_CONTROLLER, NULL); -} - -/** - * xapp_kbd_layout_controller_get_enabled: - * @controller: the #XAppKbdLayoutController - * - * Returns whether or not the layout controller is enabled - */ -gboolean -xapp_kbd_layout_controller_get_enabled (XAppKbdLayoutController *controller) -{ - return controller->priv->enabled; -} - -/** - * xapp_kbd_layout_controller_get_current_group: - * @controller: the #XAppKbdLayoutController - * - * Selects the previous group in the group list. - */ -guint -xapp_kbd_layout_controller_get_current_group (XAppKbdLayoutController *controller) -{ - g_return_val_if_fail (controller->priv->enabled, 0); - - return gkbd_configuration_get_current_group (controller->priv->config); -} - -/** - * xapp_kbd_layout_controller_set_current_group - * @controller: the #XAppKbdLayoutController - * @group: the group number to make active - * - * Selects the given group number as active. - */ -void -xapp_kbd_layout_controller_set_current_group (XAppKbdLayoutController *controller, - guint group) -{ - g_return_if_fail (controller->priv->enabled); - g_return_if_fail (group <= controller->priv->num_groups); - - guint current = gkbd_configuration_get_current_group (controller->priv->config); - - if (current != group) - { - gkbd_configuration_lock_group (controller->priv->config, group); - } -} - -/** - * xapp_kbd_layout_controller_next_group - * @controller: the #XAppKbdLayoutController - * - * Selects the next group in the group list. - */ -void -xapp_kbd_layout_controller_next_group (XAppKbdLayoutController *controller) -{ - g_return_if_fail (controller->priv->enabled); - - gkbd_configuration_lock_next_group (controller->priv->config); -} - -/** - * xapp_kbd_layout_controller_previous_group - * @controller: the #XAppKbdLayoutController - * - * Selects the previous group in the group list. - */ -void -xapp_kbd_layout_controller_previous_group (XAppKbdLayoutController *controller) -{ - g_return_if_fail (controller->priv->enabled); - - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - gint current = gkbd_configuration_get_current_group (priv->config); - - if (current > 0) - { - current--; - } - else - { - current = priv->num_groups - 1; - } - - gkbd_configuration_lock_group (controller->priv->config, current); -} - -/** - * xapp_kbd_layout_controller_get_current_name: - * @controller: the #XAppKbdLayoutController - * - * Returns the full name of the current keyboard layout. - * - * Returns: (transfer full): the newly created string or NULL - * if something went wrong. - */ -gchar * -xapp_kbd_layout_controller_get_current_name (XAppKbdLayoutController *controller) -{ - g_return_val_if_fail (controller->priv->enabled, NULL); - - return gkbd_configuration_get_current_tooltip (controller->priv->config); -} - -/** - * xapp_kbd_layout_controller_get_all_names: - * @controller: the #XAppKbdLayoutController - * - * Returns an array of all full layout names - * - * Returns: (transfer none) (array zero-terminated=1): array of names - */ -gchar ** -xapp_kbd_layout_controller_get_all_names (XAppKbdLayoutController *controller) -{ - g_return_val_if_fail (controller->priv->enabled, NULL); - - return gkbd_configuration_get_group_names (controller->priv->config); -} - -/** - * xapp_kbd_layout_controller_get_current_icon_name: - * @controller: the #XAppKbdLayoutController - * - * Returns the icon file name (no path or extension) to use for the current layout - * - * Returns: (transfer full): a new string with the icon name. - */ -gchar * -xapp_kbd_layout_controller_get_current_icon_name (XAppKbdLayoutController *controller) -{ - g_return_val_if_fail (controller->priv->enabled, NULL); - - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - guint current = gkbd_configuration_get_current_group (priv->config); - - return g_strdup (GROUP_DATA (priv->group_data, current)->group_name); -} - -/** - * xapp_kbd_layout_controller_get_icon_name_for_group: - * @controller: the #XAppKbdLayoutController - * @group: a group number - * - * Returns the icon file name (no path or extension) to use for the specified layout. - * - * Returns: (transfer full): a new string with the icon name. - */ -gchar * -xapp_kbd_layout_controller_get_icon_name_for_group (XAppKbdLayoutController *controller, - guint group) -{ - g_return_val_if_fail (controller->priv->enabled, NULL); - g_return_val_if_fail (group <= controller->priv->num_groups, NULL); - - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - return g_strdup (GROUP_DATA (priv->group_data, group)->group_name); -} - -/** - * xapp_kbd_layout_controller_get_current_flag_id: - * @controller: the #XAppKbdLayoutController - * - * Returns the duplicate id for the current layout - * - * Returns: the id - */ -gint -xapp_kbd_layout_controller_get_current_flag_id (XAppKbdLayoutController *controller) -{ - g_return_val_if_fail (controller->priv->enabled, 0); - - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - guint current = gkbd_configuration_get_current_group (priv->config); - - return GROUP_DATA (priv->group_data, current)->group_dupe_id; -} - - -/** - * xapp_kbd_layout_controller_flag_id_for_group: - * @controller: the #XAppKbdLayoutController - * @group: a group number - * - * Returns the duplicate id for the specified layout - * - * Returns: the id - */ -gint -xapp_kbd_layout_controller_get_flag_id_for_group (XAppKbdLayoutController *controller, - guint group) -{ - g_return_val_if_fail (controller->priv->enabled, 0); - g_return_val_if_fail (group < controller->priv->num_groups, 0); - - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - return GROUP_DATA (priv->group_data, group)->group_dupe_id; -} - -/** - * xapp_kbd_layout_controller_get_current_short_group_label: - * @controller: the #XAppKbdLayoutController - * - * Returns the short group label (and subscript, if any) of the current layout - * - * Returns: (transfer full): a new string or NULL. - */ -gchar * -xapp_kbd_layout_controller_get_current_short_group_label (XAppKbdLayoutController *controller) -{ - g_return_val_if_fail (controller->priv->enabled, NULL); - - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - guint current = gkbd_configuration_get_current_group (priv->config); - - return g_strdup (GROUP_DATA (priv->group_data, current)->group_label); -} - -/** - * xapp_kbd_layout_controller_get_short_group_label_for_group: - * @controller: the #XAppKbdLayoutController - * @group: a group number - * - * Returns the short group label and subscript of the specified layout. - * - * Returns: (transfer full): a new string or NULL. - */ -gchar * -xapp_kbd_layout_controller_get_short_group_label_for_group (XAppKbdLayoutController *controller, - guint group) -{ - g_return_val_if_fail (controller->priv->enabled, NULL); - g_return_val_if_fail (group < controller->priv->num_groups, NULL); - - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - - return g_strdup (GROUP_DATA (priv->group_data, group)->group_label); -} - -/** - * xapp_kbd_layout_controller_get_current_variant_label: - * @controller: the #XAppKbdLayoutController - * - * Returns the variant label (and subscript, if any) of the current layout - * - * Returns: (transfer full): a new string or NULL. - */ -gchar * -xapp_kbd_layout_controller_get_current_variant_label (XAppKbdLayoutController *controller) -{ - g_return_val_if_fail (controller->priv->enabled, NULL); - - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - guint current = gkbd_configuration_get_current_group (priv->config); - - return g_strdup (GROUP_DATA (priv->group_data, current)->variant_label); -} - -/** - * xapp_kbd_layout_controller_get_variant_label_for_group: - * @controller: the #XAppKbdLayoutController - * @group: a group number - * - * Returns the variant label and subscript of the specified layout. - * - * Returns: (transfer full): a new string or NULL. - */ -gchar * -xapp_kbd_layout_controller_get_variant_label_for_group (XAppKbdLayoutController *controller, - guint group) -{ - g_return_val_if_fail (controller->priv->enabled, NULL); - - XAppKbdLayoutControllerPrivate *priv = controller->priv; - - g_return_val_if_fail (group < controller->priv->num_groups, NULL); - - return g_strdup (GROUP_DATA (priv->group_data, group)->variant_label); -} - -/** - * xapp_kbd_layout_controller_render_cairo_subscript: - * @cr: a #cairo_t - * @x: the x position of the drawing area - * @y: the y position of the drawing area - * @width: the width of the drawing area - * @height: the height of the drawing area - * @subscript: the number to render - * - * Renders a subscript number in the given work area. This should - * be called from within a "draw" or "paint" widget/actor function, - * where a valid cairo_t is provided to draw with. - */ -void -xapp_kbd_layout_controller_render_cairo_subscript (cairo_t *cr, - gdouble x, - gdouble y, - gdouble width, - gdouble height, - gint subscript) -{ - if (subscript == 0) - { - return; - } - - cairo_set_source_rgba (cr, 0.0, 0.0, 0.0, .5); - cairo_rectangle (cr, x, y, width, height); - cairo_fill (cr); - - cairo_set_source_rgba (cr, 1.0, 1.0, 1.0, .8); - cairo_rectangle (cr, x + 1, y + 1, width - 2, height - 2); - cairo_fill (cr); - - cairo_set_source_rgba (cr, 0.0, 0.0, 0.0, 1.0); - - gchar *num_string = g_strdup_printf ("%d", subscript); - cairo_select_font_face (cr, "sans", CAIRO_FONT_SLANT_NORMAL, CAIRO_FONT_WEIGHT_BOLD); - cairo_set_font_size (cr, height - 2.0); - - cairo_text_extents_t ext; - cairo_text_extents (cr, num_string, &ext); - - cairo_move_to (cr, - (x + (width / 2.0) - (ext.width / 2.0)), - (y + (height / 2.0) + (ext.height / 2.0))); - - cairo_show_text (cr, num_string); - g_free (num_string); -} - diff --git a/libxapp/xapp-kbd-layout-controller.h b/libxapp/xapp-kbd-layout-controller.h deleted file mode 100644 index e40ebf81..00000000 --- a/libxapp/xapp-kbd-layout-controller.h +++ /dev/null @@ -1,70 +0,0 @@ -#ifndef __XAPP_KBD_LAYOUT_CONTROLLER_H__ -#define __XAPP_KBD_LAYOUT_CONTROLLER_H__ - -#include -#include - -#include -#include - -G_BEGIN_DECLS - -#define XAPP_TYPE_KBD_LAYOUT_CONTROLLER (xapp_kbd_layout_controller_get_type ()) -#define XAPP_KBD_LAYOUT_CONTROLLER(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), XAPP_TYPE_KBD_LAYOUT_CONTROLLER, XAppKbdLayoutController)) -#define XAPP_KBD_LAYOUT_CONTROLLER_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), XAPP_TYPE_KBD_LAYOUT_CONTROLLER, XAppKbdLayoutControllerClass)) -#define XAPP_IS_KBD_LAYOUT_CONTROLLER(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), XAPP_TYPE_KBD_LAYOUT_CONTROLLER)) -#define XAPP_IS_KBD_LAYOUT_CONTROLLER_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), XAPP_TYPE_KBD_LAYOUT_CONTROLLER)) -#define XAPP_KBD_LAYOUT_CONTROLLER_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), XAPP_TYPE_KBD_LAYOUT_CONTROLLER, XAppKbdLayoutControllerClass)) - -typedef struct _XAppKbdLayoutControllerPrivate XAppKbdLayoutControllerPrivate; -typedef struct _XAppKbdLayoutController XAppKbdLayoutController; -typedef struct _XAppKbdLayoutControllerClass XAppKbdLayoutControllerClass; - -struct _XAppKbdLayoutController -{ - GObject parent_object; - - XAppKbdLayoutControllerPrivate *priv; -}; - -struct _XAppKbdLayoutControllerClass -{ - GObjectClass parent_class; -}; - -GType xapp_kbd_layout_controller_get_type (void); -XAppKbdLayoutController *xapp_kbd_layout_controller_new (void); -gboolean xapp_kbd_layout_controller_get_enabled (XAppKbdLayoutController *controller); -guint xapp_kbd_layout_controller_get_current_group (XAppKbdLayoutController *controller); -void xapp_kbd_layout_controller_set_current_group (XAppKbdLayoutController *controller, - guint group); -void xapp_kbd_layout_controller_next_group (XAppKbdLayoutController *controller); -void xapp_kbd_layout_controller_previous_group (XAppKbdLayoutController *controller); -gchar *xapp_kbd_layout_controller_get_current_name (XAppKbdLayoutController *controller); -gchar **xapp_kbd_layout_controller_get_all_names (XAppKbdLayoutController *controller); - -gchar *xapp_kbd_layout_controller_get_current_icon_name (XAppKbdLayoutController *controller); -gchar *xapp_kbd_layout_controller_get_icon_name_for_group (XAppKbdLayoutController *controller, - guint group); -gint xapp_kbd_layout_controller_get_current_flag_id (XAppKbdLayoutController *controller); -gint xapp_kbd_layout_controller_get_flag_id_for_group (XAppKbdLayoutController *controller, - guint group); -gchar *xapp_kbd_layout_controller_get_current_short_group_label (XAppKbdLayoutController *controller); -gchar *xapp_kbd_layout_controller_get_short_group_label_for_group (XAppKbdLayoutController *controller, - guint group); -gchar *xapp_kbd_layout_controller_get_current_variant_label (XAppKbdLayoutController *controller); - -gchar *xapp_kbd_layout_controller_get_variant_label_for_group (XAppKbdLayoutController *controller, - guint group); - -/* Class function */ -void xapp_kbd_layout_controller_render_cairo_subscript (cairo_t *cr, - gdouble x, - gdouble y, - gdouble width, - gdouble height, - gint subscript); - -G_END_DECLS - -#endif /* __XAPP_KBD_LAYOUT_CONTROLLER_H__ */ From dc6cc5a86ad32fc99cfd631b1330833fb4bdbcf1 Mon Sep 17 00:00:00 2001 From: Michael Webster Date: Thu, 17 Apr 2025 10:22:39 -0400 Subject: [PATCH 2/2] Update docs. --- docs/reference/XAppDarkModeManager.html | 8 +- docs/reference/XAppFavorites.html | 70 +- docs/reference/XAppGpuOffloadHelper.html | 54 +- docs/reference/XAppGtkWindow.html | 68 +- docs/reference/XAppIconChooserButton.html | 16 +- docs/reference/XAppIconChooserDialog.html | 58 +- docs/reference/XAppMonitorBlanker.html | 16 +- docs/reference/XAppObjectManagerClient.html | 724 ++++++++++---------- docs/reference/XAppPreferencesWindow.html | 18 +- docs/reference/XAppStackSidebar.html | 12 +- docs/reference/XAppStatusIcon.html | 108 +-- docs/reference/XAppStatusIconMonitor.html | 24 +- docs/reference/XAppVisibilityGroup.html | 69 +- docs/reference/annotation-glossary.html | 9 +- docs/reference/api-index-full.html | 91 +-- docs/reference/ch01.html | 7 +- docs/reference/index.html | 9 +- docs/reference/libxapp-xapp-util.html | 28 +- docs/reference/libxapp.devhelp2 | 22 +- docs/reference/object-tree.html | 19 +- docs/reference/style.css | 3 +- 21 files changed, 677 insertions(+), 756 deletions(-) diff --git a/docs/reference/XAppDarkModeManager.html b/docs/reference/XAppDarkModeManager.html index c01650dc..45886ee3 100644 --- a/docs/reference/XAppDarkModeManager.html +++ b/docs/reference/XAppDarkModeManager.html @@ -8,7 +8,7 @@ - + @@ -70,7 +70,7 @@

XA

Object Hierarchy

-
    GObject
+
    GObject
     ╰── XAppDarkModeManager
 
@@ -86,7 +86,7 @@

XA

xapp_dark_mode_manager_new ()

XAppDarkModeManager *
-xapp_dark_mode_manager_new (gboolean prefer_dark_mode);
+xapp_dark_mode_manager_new (gboolean prefer_dark_mode);

Parameters

@@ -125,6 +125,6 @@

XA +
Generated by GTK-Doc V1.34.0 \ No newline at end of file diff --git a/docs/reference/XAppFavorites.html b/docs/reference/XAppFavorites.html index 67f4bed0..d8833fe8 100644 --- a/docs/reference/XAppFavorites.html +++ b/docs/reference/XAppFavorites.html @@ -8,7 +8,7 @@ - + @@ -51,7 +51,7 @@

XAppFavo

- +
-GList * +GList * xapp_favorites_get_favorites () @@ -59,7 +59,7 @@

XAppFavo

-gint +gint xapp_favorites_get_n_favorites () @@ -147,7 +147,7 @@

XAppFavo

-GList * +GList * xapp_favorites_create_actions () @@ -167,7 +167,7 @@

XAppFavo

void changedActionAction
@@ -198,7 +198,7 @@

XAppFavo

Object Hierarchy

    GBoxed
     ╰── XAppFavoriteInfo
-    GObject
+    GObject
     ╰── XAppFavorites
 

@@ -228,10 +228,10 @@

XAppFavo

xapp_favorites_get_favorites ()

-
GList *
+
GList *
 xapp_favorites_get_favorites (XAppFavorites *favorites,
-                              const gchar * const *mimetypes);
-

Gets a list of all favorites. If mimetype is not NULL, the list will + const gchar * const *mimetypes);

+

Gets a list of all favorites. If mimetype is not NULL, the list will contain only favorites with that mimetype.

Parameters

@@ -258,7 +258,7 @@

XAppFavo

Returns

a list of XAppFavoriteInfos. -Free the list with g_list_free, free elements with xapp_favorite_info_free.

+Free the list with g_list_free, free elements with xapp_favorite_info_free.

[element-type XAppFavoriteInfo][transfer full]

Since: 2.0

@@ -266,7 +266,7 @@

XAppFavo

xapp_favorites_get_n_favorites ()

-
gint
+
gint
 xapp_favorites_get_n_favorites (XAppFavorites *favorites);

Parameters

@@ -294,7 +294,7 @@

XAppFavo

xapp_favorites_find_by_display_name ()

XAppFavoriteInfo *
 xapp_favorites_find_by_display_name (XAppFavorites *favorites,
-                                     const gchar *display_name);
+ const gchar *display_name);

Looks for an XAppFavoriteInfo that corresponds to display_name .

@@ -332,7 +332,7 @@

XAppFavo

xapp_favorites_find_by_uri ()

XAppFavoriteInfo *
 xapp_favorites_find_by_uri (XAppFavorites *favorites,
-                            const gchar *uri);
+ const gchar *uri);

Looks for an XAppFavoriteInfo that corresponds to uri .

@@ -370,7 +370,7 @@

XAppFavo

xapp_favorites_add ()

void
 xapp_favorites_add (XAppFavorites *favorites,
-                    const gchar *uri);
+ const gchar *uri);

Adds a new favorite. If the uri already exists, this does nothing.

Parameters

@@ -401,7 +401,7 @@

XAppFavo

xapp_favorites_remove ()

void
 xapp_favorites_remove (XAppFavorites *favorites,
-                       const gchar *uri);
+ const gchar *uri);

Removes a favorite from the list.

Parameters

@@ -432,8 +432,8 @@

XAppFavo

xapp_favorites_launch ()

void
 xapp_favorites_launch (XAppFavorites *favorites,
-                       const gchar *uri,
-                       guint32 timestamp);
+ const gchar *uri, + guint32 timestamp);

Opens a favorite in its default app.

Parameters

@@ -469,8 +469,8 @@

XAppFavo

xapp_favorites_rename ()

void
 xapp_favorites_rename (XAppFavorites *favorites,
-                       const gchar *old_uri,
-                       const gchar *new_uri);
+ const gchar *old_uri, + const gchar *new_uri);

Removes old_uri and adds new_uri. This is mainly for file managers to use as a convenience instead of add/remove, and guarantees the result, without having to worry about multiple dbus calls (gsettings).

@@ -554,18 +554,18 @@

XAppFavo

XAppFavoritesItemSelectedCallback ()

void
 (*XAppFavoritesItemSelectedCallback) (XAppFavorites *favorites,
-                                      const gchar *uri,
-                                      gpointer user_data);
+ const gchar *uri, + gpointer user_data);


xapp_favorites_create_menu ()

GtkWidget *
 xapp_favorites_create_menu (XAppFavorites *favorites,
-                            const gchar **mimetypes,
+                            const gchar **mimetypes,
                             XAppFavoritesItemSelectedCallback callback,
-                            gpointer user_data,
-                            GDestroyNotify func);
+ gpointer user_data, + GDestroyNotify func);

Generates a GtkMenu widget populated with favorites. The callback will be called when a menu item has been activated, and will include the uri of the respective item.

@@ -594,12 +594,12 @@

XAppFavo

user_data

-

The data to pass to the callback.

-[closure] +

The data to pass to the callback.

func

-

Destroy function for user_data

+

Destroy function for user_data.

  @@ -616,9 +616,9 @@

XAppFavo

xapp_favorites_create_actions ()

-
GList *
+
GList *
 xapp_favorites_create_actions (XAppFavorites *favorites,
-                               const gchar **mimetypes);
+ const gchar **mimetypes);

Generates a list of favorite GtkActions.

Parameters

@@ -678,18 +678,18 @@

XAppFavo -

gchar *uri;

+

gchar *uri;

The uri to the favorite file.

  -

gchar *display_name;

+

gchar *display_name;

The name for use when displaying the item. This may not exactly match the filename if there are files with the same name but in different folders.

  -

gchar *cached_mimetype;

+

gchar *cached_mimetype;

The mimetype calculated for the uri when it was added to favorites.

  @@ -709,7 +709,7 @@

XAppFavo

The “changed” signal

void
 user_function (XAppFavorites *xappfavorites,
-               gpointer       user_data)
+ gpointer user_data)

Notifies when the favorites list has changed.

Parameters

@@ -726,11 +726,11 @@

XAppFavo

-

Flags: Action

+

Flags: Action

+
Generated by GTK-Doc V1.34.0

\ No newline at end of file diff --git a/docs/reference/XAppGpuOffloadHelper.html b/docs/reference/XAppGpuOffloadHelper.html index 64b5b811..011f2bf3 100644 --- a/docs/reference/XAppGpuOffloadHelper.html +++ b/docs/reference/XAppGpuOffloadHelper.html @@ -8,7 +8,7 @@ - + @@ -59,7 +59,7 @@

X -gboolean +gboolean xapp_gpu_offload_helper_is_ready () @@ -67,7 +67,7 @@

X -gboolean +gboolean xapp_gpu_offload_helper_is_offload_supported () @@ -75,7 +75,7 @@

X -gint +gint xapp_gpu_offload_helper_get_n_gpus () @@ -83,7 +83,7 @@

X -GList * +GList * xapp_gpu_offload_helper_get_offload_infos () @@ -107,7 +107,7 @@

X -gchar * +gchar * xapp_gpu_info_get_shell_env_prefix () @@ -127,7 +127,7 @@

X void ready -Action +Action

@@ -158,7 +158,7 @@

X

Object Hierarchy

    GBoxed
     ╰── XAppGpuInfo
-    GObject
+    GObject
     ╰── XAppGpuOffloadHelper
 

@@ -201,7 +201,7 @@

X

xapp_gpu_offload_helper_is_ready ()

-
gboolean
+
gboolean
 xapp_gpu_offload_helper_is_ready (XAppGpuOffloadHelper *helper);

Checks if the helper is ready and valid. This does not mean offload support exists.

@@ -222,14 +222,14 @@

X

Returns

-

TRUE if the helper has been successfully initialized.

+

TRUE if the helper has been successfully initialized.

Since: 2.6


xapp_gpu_offload_helper_is_offload_supported ()

-
gboolean
+
gboolean
 xapp_gpu_offload_helper_is_offload_supported
                                (XAppGpuOffloadHelper *helper);

Checks if there is a non-default GPU available for offloading.

@@ -250,14 +250,14 @@

X

Returns

-

TRUE if there is an extra GPU available.

+

TRUE if there is an extra GPU available.

Since: 2.6


xapp_gpu_offload_helper_get_n_gpus ()

-
gint
+
gint
 xapp_gpu_offload_helper_get_n_gpus (XAppGpuOffloadHelper *helper);

Gets the number of GPUs noticed by Switcheroo.

@@ -285,7 +285,7 @@

X

xapp_gpu_offload_helper_get_offload_infos ()

-
GList *
+
GList *
 xapp_gpu_offload_helper_get_offload_infos
                                (XAppGpuOffloadHelper *helper);

Generates a list of XAppGpuInfos that can be offloaded to, if there are any.

@@ -306,7 +306,7 @@

X

Returns

-

a list of XAppGpuInfos or NULL if there is only +

a list of XAppGpuInfos or NULL if there is only a single GPU. The elements are owned by helper but the container itself should be freed.

[element-type XAppGpuInfo][transfer container]

@@ -348,7 +348,7 @@

X
XAppGpuInfo *
 xapp_gpu_offload_helper_get_info_by_id
                                (XAppGpuOffloadHelper *helper,
-                                gint id);
+ gint id);

Returns an XAppGpuInfo with the given ID.

Parameters

@@ -374,7 +374,7 @@

X

Returns

-

the appropriate XAppGpuInfo, or NULL if id +

the appropriate XAppGpuInfo, or NULL if id was invalid.

[transfer none]

@@ -383,7 +383,7 @@

X

xapp_gpu_info_get_shell_env_prefix ()

-
gchar *
+
gchar *
 xapp_gpu_info_get_shell_env_prefix (XAppGpuInfo *info);

Creates a new string in a form intended to prefix a shell command, containing the appropriate name/values for this gpu. For example:

@@ -405,7 +405,7 @@

X

Returns

-

A new string, free with g_free().

+

A new string, free with g_free().

Since 2.6.

[transfer full]

@@ -440,22 +440,22 @@

X -

gint id;

+

gint id;

An identifier that can be used to refer to this GPU.

  -

gboolean is_default;

+

gboolean is_default;

Whether this GPU is used by default.

  -

gchar *display_name;

+

gchar *display_name;

User-visible name of the GPU.

  -

gchar **env_strv;

+

gchar **env_strv;

A string array containing alternating environment variables names and values to use to enable the gpu.

[array zero-terminated=1] @@ -475,8 +475,8 @@

X

The “ready” signal

void
 user_function (XAppGpuOffloadHelper *helper,
-               gboolean              success,
-               gpointer              user_data)
+ gboolean success, + gpointer user_data)

This signal is emitted by the helper when it has completed gathering GPU information. It will only be sent once.

@@ -506,11 +506,11 @@

X

-

Flags: Action

+

Flags: Action

+
Generated by GTK-Doc V1.34.0 \ No newline at end of file diff --git a/docs/reference/XAppGtkWindow.html b/docs/reference/XAppGtkWindow.html index 98a19b50..3f89f4de 100644 --- a/docs/reference/XAppGtkWindow.html +++ b/docs/reference/XAppGtkWindow.html @@ -8,7 +8,7 @@ - + @@ -174,8 +174,8 @@

XAppGtkW

Object Hierarchy

-
    GObject
-    ╰── GInitiallyUnowned
+
    GObject
+    ╰── GInitiallyUnowned
         ╰── GtkWidget
             ╰── GtkContainer
                 ╰── GtkBin
@@ -251,12 +251,12 @@ 

XAppGtkW

xapp_gtk_window_set_icon_name ()

void
 xapp_gtk_window_set_icon_name (XAppGtkWindow *window,
-                               const gchar *icon_name);
+ const gchar *icon_name);

Sets the icon name hint for a window manager (like muffin) to make available when applications want to change their icons during runtime without having to resort to the internal low-res pixbufs that GdkWindow sets on the client side. This also chains up and calls GtkWindow.set_icon_name -for convenience and compatibility. Set to NULL to unset.

+for convenience and compatibility. Set to NULL to unset.

Parameters

@@ -273,7 +273,7 @@

XAppGtkW

- + @@ -285,13 +285,13 @@

XAppGtkW

xapp_gtk_window_set_icon_from_file ()

void
 xapp_gtk_window_set_icon_from_file (XAppGtkWindow *window,
-                                    const gchar *file_name,
-                                    GError **error);
+ const gchar *file_name, + GError **error);

Sets the icon name hint for a window manager (like muffin) to make available when applications want to change their icons during runtime without having to resort to the internal low-res pixbufs that GdkWindow sets on the client side. This also chains up and calls GtkWindow.set_icon_from_file -for convenience and compatibility. Set to NULL to unset.

+for convenience and compatibility. Set to NULL to unset.

Parameters

icon_name

The icon name or path to set, or NULL to unset.

The icon name or path to set, or NULL to unset.

[nullable]
@@ -308,7 +308,7 @@

XAppGtkW

- + @@ -325,7 +325,7 @@

XAppGtkW

xapp_gtk_window_set_progress ()

void
 xapp_gtk_window_set_progress (XAppGtkWindow *window,
-                              gint progress);
+ gint progress);

Sets the progress hint for a window manager (like muffin) to make available when applications want to display the application's progress in some operation. The value sent to the WM will be clamped to @@ -363,7 +363,7 @@

XAppGtkW

xapp_gtk_window_set_progress_pulse ()

void
 xapp_gtk_window_set_progress_pulse (XAppGtkWindow *window,
-                                    gboolean pulse);
+ gboolean pulse);

Sets the progress pulse hint hint for a window manager (like muffin) to make available when applications want to display indeterminate or ongoing progress in a task manager.

@@ -399,14 +399,14 @@

XAppGtkW

xapp_set_window_icon_name ()

void
 xapp_set_window_icon_name (GtkWindow *window,
-                           const gchar *icon_name);
+ const gchar *icon_name);

Sets the icon name hint for a window manager (like muffin) to make available when applications want to change their icons during runtime without having to resort to the internal low-res pixbufs that GdkWindow sets on the client side. This is a function, not a method, for taking advantage of this feature with descendants of GtkWindows, such as GtkDialogs. Sets gtk_window_set_icon_name as well, to avoid needing -to have two calls each time. Set to NULL to unset.

+to have two calls each time. Set to NULL to unset.

Parameters

file_name

The icon path to set, or NULL to unset.

The icon path to set, or NULL to unset.

[nullable]
@@ -423,7 +423,7 @@

XAppGtkW

- + @@ -435,13 +435,13 @@

XAppGtkW

xapp_set_window_icon_from_file ()

void
 xapp_set_window_icon_from_file (GtkWindow *window,
-                                const gchar *file_name,
-                                GError **error);
+ const gchar *file_name, + GError **error);

Sets the icon name hint for a window manager (like muffin) to make available when applications want to change their icons during runtime without having to resort to the internal low-res pixbufs that GdkWindow sets on the client side. This also chains up and calls GtkWindow.set_icon_from_file -for convenience and compatibility. Set to NULL to unset.

+for convenience and compatibility. Set to NULL to unset.

Parameters

icon_name

The icon name to set, or NULL to unset.

The icon name to set, or NULL to unset.

[nullable]
@@ -458,7 +458,7 @@

XAppGtkW

- + @@ -475,7 +475,7 @@

XAppGtkW

xapp_set_window_progress ()

void
 xapp_set_window_progress (GtkWindow *window,
-                          gint progress);
+ gint progress);

Sets the progress hint for a window manager (like muffin) to make available when applications want to display the application's progress in some operation. The value sent to the WM will be clamped to @@ -513,7 +513,7 @@

XAppGtkW

xapp_set_window_progress_pulse ()

void
 xapp_set_window_progress_pulse (GtkWindow *window,
-                                gboolean pulse);
+ gboolean pulse);

Sets the progress pulse hint hint for a window manager (like muffin) to make available when applications want to display indeterminate or ongoing progress in a task manager.

@@ -548,14 +548,14 @@

XAppGtkW

xapp_set_xid_icon_name ()

void
-xapp_set_xid_icon_name (gulong xid,
-                        const gchar *icon_name);
+xapp_set_xid_icon_name (gulong xid, + const gchar *icon_name);

Sets the icon name hint for a window manager (like muffin) to make available when applications want to change their icons during runtime without having to resort to the internal low-res pixbufs that GdkWindow sets on the client side. This is a function, not a method, for applying the icon name property for a given (possibly foreign) window, by passing -the window's XID. Set to NULL to unset.

+the window's XID. Set to NULL to unset.

Parameters

file_name

The icon path to set, or NULL to unset.

The icon path to set, or NULL to unset.

[nullable]
@@ -572,7 +572,7 @@

XAppGtkW

- + @@ -583,14 +583,14 @@

XAppGtkW

xapp_set_xid_icon_from_file ()

void
-xapp_set_xid_icon_from_file (gulong xid,
-                             const gchar *file_name);
+xapp_set_xid_icon_from_file (gulong xid, + const gchar *file_name);

Sets the icon name hint for a window manager (like muffin) to make available when applications want to change their icons during runtime without having to resort to the internal low-res pixbufs that GdkWindow sets on the client side. This is a function, not a method, for applying the icon name property for a given (possibly foreign) window, by passing -the window's XID. Set to NULL to unset.

+the window's XID. Set to NULL to unset.

Parameters

icon_name

The icon name to set, or NULL to unset.

The icon name to set, or NULL to unset.

[nullable]
@@ -607,7 +607,7 @@

XAppGtkW

- + @@ -618,8 +618,8 @@

XAppGtkW

xapp_set_xid_progress ()

void
-xapp_set_xid_progress (gulong xid,
-                       gint progress);
+xapp_set_xid_progress (gulong xid, + gint progress);

Sets the progress hint for a window manager (like muffin) to make available when applications want to display the application's progress in some operation. The value sent to the WM will be clamped to @@ -658,8 +658,8 @@

XAppGtkW

xapp_set_xid_progress_pulse ()

void
-xapp_set_xid_progress_pulse (gulong xid,
-                             gboolean pulse);
+xapp_set_xid_progress_pulse (gulong xid, + gboolean pulse);

Sets the progress pulse hint hint for a window manager (like muffin) to make available when applications want to display indeterminate or ongoing progress in a task manager.

@@ -716,6 +716,6 @@

XAppGtkW

+
Generated by GTK-Doc V1.34.0 \ No newline at end of file diff --git a/docs/reference/XAppIconChooserButton.html b/docs/reference/XAppIconChooserButton.html index e2ca37da..c5b5ecff 100644 --- a/docs/reference/XAppIconChooserButton.html +++ b/docs/reference/XAppIconChooserButton.html @@ -8,7 +8,7 @@ - + @@ -83,7 +83,7 @@

- - +

file_name

The icon path to set, or NULL to unset.

The icon path to set, or NULL to unset.

[nullable]
const gchar * +const gchar * xapp_icon_chooser_button_get_icon () @@ -150,8 +150,8 @@

Object Hierarchy

-
    GObject
-    ╰── GInitiallyUnowned
+
    GObject
+    ╰── GInitiallyUnowned
         ╰── GtkWidget
             ╰── GtkContainer
                 ╰── GtkBin
@@ -250,7 +250,7 @@ 

xapp_icon_chooser_button_set_icon ()

void
 xapp_icon_chooser_button_set_icon (XAppIconChooserButton *button,
-                                   const gchar *icon);
+ const gchar *icon);

Sets the icon on the XAppIconChooserButton.

Parameters

@@ -281,7 +281,7 @@

void
 xapp_icon_chooser_button_set_default_category
                                (XAppIconChooserButton *button,
-                                const gchar *category);
+ const gchar *category);

Sets the icon on the XAppIconChooserButton.

Parameters

@@ -309,7 +309,7 @@


xapp_icon_chooser_button_get_icon ()

-
const gchar *
+
const gchar *
 xapp_icon_chooser_button_get_icon (XAppIconChooserButton *button);

Gets the icon from the XAppIconChooserButton.

@@ -407,6 +407,6 @@

+
Generated by GTK-Doc V1.34.0

\ No newline at end of file diff --git a/docs/reference/XAppIconChooserDialog.html b/docs/reference/XAppIconChooserDialog.html index 4d6eac25..295cef4d 100644 --- a/docs/reference/XAppIconChooserDialog.html +++ b/docs/reference/XAppIconChooserDialog.html @@ -7,8 +7,8 @@ - - + + @@ -24,7 +24,7 @@

Home Up PrevNextNext
@@ -53,7 +53,7 @@

-gint +gint xapp_icon_chooser_dialog_run () @@ -61,7 +61,7 @@

-gint +gint xapp_icon_chooser_dialog_run_with_icon () @@ -69,7 +69,7 @@

-gint +gint xapp_icon_chooser_dialog_run_with_category () @@ -77,7 +77,7 @@

-gchar * +gchar * xapp_icon_chooser_dialog_get_icon_string () @@ -93,7 +93,7 @@

-gchar * +gchar * xapp_icon_chooser_dialog_get_default_icon () @@ -128,7 +128,7 @@

-gboolean +gboolean allow-paths Read / Write @@ -158,12 +158,12 @@

void close -Action +Action void select -Action +Action

@@ -195,8 +195,8 @@

Object Hierarchy

    GEnum
     ╰── XAppIconSize
-    GObject
-    ╰── GInitiallyUnowned
+    GObject
+    ╰── GInitiallyUnowned
         ╰── GtkWidget
             ╰── GtkContainer
                 ╰── GtkBin
@@ -233,7 +233,7 @@ 


xapp_icon_chooser_dialog_run ()

-
gint
+
gint
 xapp_icon_chooser_dialog_run (XAppIconChooserDialog *dialog);

Shows the dialog and enters a separate main loop until an icon is chosen or the action is canceled.

xapp_icon_chooser_dialog_run (), xapp_icon_chooser_dialog_run_with_icon(), and @@ -263,10 +263,10 @@


xapp_icon_chooser_dialog_run_with_icon ()

-
gint
+
gint
 xapp_icon_chooser_dialog_run_with_icon
                                (XAppIconChooserDialog *dialog,
-                                gchar *icon);
+ gchar *icon);

Like xapp_icon_chooser_dialog_run but selects the icon specified by icon . This can be either an icon name or a path. Passing an icon string or path that doesn't exist is accepted, but it may show @@ -307,10 +307,10 @@


xapp_icon_chooser_dialog_run_with_category ()

-
gint
+
gint
 xapp_icon_chooser_dialog_run_with_category
                                (XAppIconChooserDialog *dialog,
-                                gchar *category);
+ gchar *category);

Like xapp_icon_chooser_dialog_run but selects a particular category specified by category . This is used when there is a particular category of icon that is more appropriate than the @@ -343,7 +343,7 @@


xapp_icon_chooser_dialog_get_icon_string ()

-
gchar *
+
gchar *
 xapp_icon_chooser_dialog_get_icon_string
                                (XAppIconChooserDialog *dialog);

Gets the currently selected icon from the dialog. If allow-paths is TRUE, this function may return @@ -417,7 +417,7 @@


xapp_icon_chooser_dialog_get_default_icon ()

-
gchar *
+
gchar *
 xapp_icon_chooser_dialog_get_default_icon
                                (XAppIconChooserDialog *dialog);

Returns the default icon (if set).

@@ -433,7 +433,7 @@

void
 xapp_icon_chooser_dialog_set_default_icon
                                (XAppIconChooserDialog *dialog,
-                                const gchar *icon);
+ const gchar *icon);

Sets the default icon. If icon is not NULL, a button will be shown that will reset the dialog to it's default value.

@@ -459,8 +459,8 @@

void
 xapp_icon_chooser_dialog_add_custom_category
                                (XAppIconChooserDialog *dialog,
-                                const gchar *name,
-                                GList *icons);
+ const gchar *name, + GList *icons);

Adds a custom category to the dialog.

Parameters

@@ -554,7 +554,7 @@

Property Details

The “allow-paths” property

-
  “allow-paths”              gboolean
+
  “allow-paths”              gboolean

Whether to allow paths to be searched and selected or only icon names.

Owner: XAppIconChooserDialog

Flags: Read / Write

@@ -587,20 +587,20 @@

The “close” signal

void
 user_function (XAppIconChooserDialog *xappiconchooserdialog,
-               gpointer               user_data)
-

Flags: Action

+ gpointer user_data)

+

Flags: Action


The “select” signal

void
 user_function (XAppIconChooserDialog *xappiconchooserdialog,
-               gpointer               user_data)
-

Flags: Action

+ gpointer user_data)

+

Flags: Action

+
Generated by GTK-Doc V1.34.0 \ No newline at end of file diff --git a/docs/reference/XAppMonitorBlanker.html b/docs/reference/XAppMonitorBlanker.html index 54083ced..1d694d8a 100644 --- a/docs/reference/XAppMonitorBlanker.html +++ b/docs/reference/XAppMonitorBlanker.html @@ -6,9 +6,9 @@ - + - + @@ -20,7 +20,7 @@ Home Up -Prev +Prev Next
@@ -66,7 +66,7 @@

XAp -gboolean +gboolean xapp_monitor_blanker_are_monitors_blanked () @@ -96,7 +96,7 @@

XAp

Object Hierarchy

-
    GObject
+
    GObject
     ╰── XAppMonitorBlanker
 
@@ -176,7 +176,7 @@

XAp

xapp_monitor_blanker_are_monitors_blanked ()

-
gboolean
+
gboolean
 xapp_monitor_blanker_are_monitors_blanked
                                (XAppMonitorBlanker *self);

Returns whether monitors are currently blanked. @@ -198,7 +198,7 @@

XAp

Returns

-

TRUE if monitors are blanked.

+

TRUE if monitors are blanked.

@@ -217,6 +217,6 @@

XAp +
Generated by GTK-Doc V1.34.0 \ No newline at end of file diff --git a/docs/reference/XAppObjectManagerClient.html b/docs/reference/XAppObjectManagerClient.html index d913861b..7574dc67 100644 --- a/docs/reference/XAppObjectManagerClient.html +++ b/docs/reference/XAppObjectManagerClient.html @@ -8,7 +8,7 @@ - + @@ -44,7 +44,7 @@

-GDBusInterfaceInfo * +GDBusInterfaceInfo * xapp_status_icon_interface_interface_info () @@ -52,7 +52,7 @@

-guint +guint xapp_status_icon_interface_override_properties () @@ -92,7 +92,7 @@

-gboolean +gboolean xapp_status_icon_interface_call_button_press_finish () @@ -100,7 +100,7 @@

-gboolean +gboolean xapp_status_icon_interface_call_button_press_sync () @@ -116,7 +116,7 @@

-gboolean +gboolean xapp_status_icon_interface_call_button_release_finish () @@ -124,7 +124,7 @@

-gboolean +gboolean xapp_status_icon_interface_call_button_release_sync () @@ -140,7 +140,7 @@

-gboolean +gboolean xapp_status_icon_interface_call_scroll_finish () @@ -148,14 +148,14 @@

-gboolean +gboolean xapp_status_icon_interface_call_scroll_sync () -const gchar * +const gchar * xapp_status_icon_interface_get_name () @@ -163,7 +163,7 @@

-gchar * +gchar * xapp_status_icon_interface_dup_name () @@ -178,7 +178,7 @@

-const gchar * +const gchar * xapp_status_icon_interface_get_icon_name () @@ -186,7 +186,7 @@

-gchar * +gchar * xapp_status_icon_interface_dup_icon_name () @@ -201,7 +201,7 @@

-const gchar * +const gchar * xapp_status_icon_interface_get_tooltip_text () @@ -209,7 +209,7 @@

-gchar * +gchar * xapp_status_icon_interface_dup_tooltip_text () @@ -224,7 +224,7 @@

-const gchar * +const gchar * xapp_status_icon_interface_get_label () @@ -232,7 +232,7 @@

-gchar * +gchar * xapp_status_icon_interface_dup_label () @@ -248,7 +248,7 @@

-gboolean +gboolean xapp_status_icon_interface_get_visible () @@ -264,7 +264,7 @@

-gint +gint xapp_status_icon_interface_get_icon_size () @@ -280,7 +280,7 @@

-gboolean +gboolean xapp_status_icon_interface_get_primary_menu_is_open () @@ -296,7 +296,7 @@

-gboolean +gboolean xapp_status_icon_interface_get_secondary_menu_is_open () @@ -311,7 +311,7 @@

-const gchar * +const gchar * xapp_status_icon_interface_get_metadata () @@ -319,7 +319,7 @@

-gchar * +gchar * xapp_status_icon_interface_dup_metadata () @@ -431,7 +431,7 @@

-GType +GType xapp_object_manager_client_get_proxy_type () @@ -447,7 +447,7 @@

-GDBusObjectManager * +GDBusObjectManager * xapp_object_manager_client_new_finish () @@ -455,7 +455,7 @@

-GDBusObjectManager * +GDBusObjectManager * xapp_object_manager_client_new_sync () @@ -471,7 +471,7 @@

-GDBusObjectManager * +GDBusObjectManager * xapp_object_manager_client_new_for_bus_finish () @@ -479,7 +479,7 @@

-GDBusObjectManager * +GDBusObjectManager * xapp_object_manager_client_new_for_bus_sync () @@ -533,12 +533,12 @@

Read / Write -gboolean +gboolean primary-menu-is-open Read / Write -gboolean +gboolean secondary-menu-is-open Read / Write @@ -549,7 +549,7 @@

Read / Write -gboolean +gboolean visible Read / Write @@ -566,19 +566,19 @@

-gboolean +gboolean handle-button-press -Run Last +Run Last -gboolean +gboolean handle-button-release -Run Last +Run Last -gboolean +gboolean handle-scroll -Run Last +Run Last @@ -588,16 +588,16 @@

GInterface ├── XAppObject ╰── XAppStatusIconInterface - GObject - ├── GDBusInterfaceSkeleton + GObject + ├── GDBusInterfaceSkeleton ╰── XAppStatusIconInterfaceSkeleton - ├── GDBusObjectManagerClient + ├── GDBusObjectManagerClient ╰── XAppObjectManagerClient - ├── GDBusObjectProxy + ├── GDBusObjectProxy ╰── XAppObjectProxy - ├── GDBusObjectSkeleton + ├── GDBusObjectSkeleton ╰── XAppObjectSkeleton - ╰── GDBusProxy + ╰── GDBusProxy ╰── XAppStatusIconInterfaceProxy @@ -608,24 +608,24 @@

Functions

xapp_status_icon_interface_interface_info ()

-
GDBusInterfaceInfo *
+
GDBusInterfaceInfo *
 xapp_status_icon_interface_interface_info
                                (void);

Gets a machine-readable description of the org.x.StatusIcon D-Bus interface.

Returns

-

A GDBusInterfaceInfo. Do not free.

+

A GDBusInterfaceInfo. Do not free.

[transfer none]


xapp_status_icon_interface_override_properties ()

-
guint
+
guint
 xapp_status_icon_interface_override_properties
-                               (GObjectClass *klass,
-                                guint property_id_begin);
-

Overrides all GObject properties in the XAppStatusIconInterface interface for a concrete class. + (GObjectClass *klass, + guint property_id_begin);

+

Overrides all GObject properties in the XAppStatusIconInterface interface for a concrete class. The properties are overridden in the order they are defined.

Parameters

@@ -638,7 +638,7 @@

klass

-

The class structure for a GObject derived class.

+

The class structure for a GObject derived class.

  @@ -660,8 +660,8 @@

void xapp_status_icon_interface_complete_button_press (XAppStatusIconInterface *object, - GDBusMethodInvocation *invocation); -

Helper function used in service implementations to finish handling invocations of the ButtonPress() D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.

+ GDBusMethodInvocation *invocation); +

Helper function used in service implementations to finish handling invocations of the ButtonPress() D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.

This method will free invocation , you cannot use it afterwards.

@@ -680,7 +680,7 @@

invocation

-

A GDBusMethodInvocation.

+

A GDBusMethodInvocation.

[transfer full] @@ -693,8 +693,8 @@

void xapp_status_icon_interface_complete_button_release (XAppStatusIconInterface *object, - GDBusMethodInvocation *invocation); -

Helper function used in service implementations to finish handling invocations of the ButtonRelease() D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.

+ GDBusMethodInvocation *invocation); +

Helper function used in service implementations to finish handling invocations of the ButtonRelease() D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.

This method will free invocation , you cannot use it afterwards.

@@ -713,7 +713,7 @@

invocation

-

A GDBusMethodInvocation.

+

A GDBusMethodInvocation.

[transfer full] @@ -726,8 +726,8 @@

void xapp_status_icon_interface_complete_scroll (XAppStatusIconInterface *object, - GDBusMethodInvocation *invocation); -

Helper function used in service implementations to finish handling invocations of the Scroll() D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.

+ GDBusMethodInvocation *invocation); +

Helper function used in service implementations to finish handling invocations of the Scroll() D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.

This method will free invocation , you cannot use it afterwards.

@@ -746,7 +746,7 @@

invocation

-

A GDBusMethodInvocation.

+

A GDBusMethodInvocation.

[transfer full] @@ -759,18 +759,18 @@

void xapp_status_icon_interface_call_button_press (XAppStatusIconInterface *proxy, - gint arg_x, - gint arg_y, - guint arg_button, - guint arg_time, - gint arg_panel_position, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); + gint arg_x, + gint arg_y, + guint arg_button, + guint arg_time, + gint arg_panel_position, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

Asynchronously invokes the ButtonPress() D-Bus method on proxy . When the operation is finished, callback - will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). + will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). You can then call xapp_status_icon_interface_call_button_press_finish() to get the result of the operation.

See xapp_status_icon_interface_call_button_press_sync() for the synchronous, blocking version of this method.

@@ -814,12 +814,12 @@

cancellable

-

A GCancellable or NULL.

+

A GCancellable or NULL.

[nullable]

callback

-

A GAsyncReadyCallback to call when the request is satisfied or NULL.

+

A GAsyncReadyCallback to call when the request is satisfied or NULL.

  @@ -835,11 +835,11 @@

xapp_status_icon_interface_call_button_press_finish ()

-
gboolean
+
gboolean
 xapp_status_icon_interface_call_button_press_finish
                                (XAppStatusIconInterface *proxy,
-                                GAsyncResult *res,
-                                GError **error);
+ GAsyncResult *res, + GError **error);

Finishes an operation started with xapp_status_icon_interface_call_button_press().

Parameters

@@ -857,12 +857,12 @@

res

-

The GAsyncResult obtained from the GAsyncReadyCallback passed to xapp_status_icon_interface_call_button_press().

+

The GAsyncResult obtained from the GAsyncReadyCallback passed to xapp_status_icon_interface_call_button_press().

 

error

-

Return location for error or NULL.

+

Return location for error or NULL.

  @@ -870,7 +870,7 @@

Returns

-

TRUE if the call succeeded, FALSE if error +

TRUE if the call succeeded, FALSE if error is set.

[skip]

@@ -878,16 +878,16 @@

xapp_status_icon_interface_call_button_press_sync ()

-
gboolean
+
gboolean
 xapp_status_icon_interface_call_button_press_sync
                                (XAppStatusIconInterface *proxy,
-                                gint arg_x,
-                                gint arg_y,
-                                guint arg_button,
-                                guint arg_time,
-                                gint arg_panel_position,
-                                GCancellable *cancellable,
-                                GError **error);
+ gint arg_x, + gint arg_y, + guint arg_button, + guint arg_time, + gint arg_panel_position, + GCancellable *cancellable, + GError **error);

Synchronously invokes the ButtonPress() D-Bus method on proxy . The calling thread is blocked until a reply is received.

See xapp_status_icon_interface_call_button_press() for the asynchronous version of this method.

@@ -932,12 +932,12 @@

cancellable

-

A GCancellable or NULL.

+

A GCancellable or NULL.

[nullable]

error

-

Return location for error or NULL.

+

Return location for error or NULL.

  @@ -945,7 +945,7 @@

Returns

-

TRUE if the call succeeded, FALSE if error +

TRUE if the call succeeded, FALSE if error is set.

[skip]

@@ -956,18 +956,18 @@

void xapp_status_icon_interface_call_button_release (XAppStatusIconInterface *proxy, - gint arg_x, - gint arg_y, - guint arg_button, - guint arg_time, - gint arg_panel_position, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); + gint arg_x, + gint arg_y, + guint arg_button, + guint arg_time, + gint arg_panel_position, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

Asynchronously invokes the ButtonRelease() D-Bus method on proxy . When the operation is finished, callback - will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). + will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). You can then call xapp_status_icon_interface_call_button_release_finish() to get the result of the operation.

See xapp_status_icon_interface_call_button_release_sync() for the synchronous, blocking version of this method.

@@ -1011,12 +1011,12 @@

cancellable

-

A GCancellable or NULL.

+

A GCancellable or NULL.

[nullable]

callback

-

A GAsyncReadyCallback to call when the request is satisfied or NULL.

+

A GAsyncReadyCallback to call when the request is satisfied or NULL.

  @@ -1032,11 +1032,11 @@

xapp_status_icon_interface_call_button_release_finish ()

-
gboolean
+
gboolean
 xapp_status_icon_interface_call_button_release_finish
                                (XAppStatusIconInterface *proxy,
-                                GAsyncResult *res,
-                                GError **error);
+ GAsyncResult *res, + GError **error);

Finishes an operation started with xapp_status_icon_interface_call_button_release().

Parameters

@@ -1054,12 +1054,12 @@

res

-

The GAsyncResult obtained from the GAsyncReadyCallback passed to xapp_status_icon_interface_call_button_release().

+

The GAsyncResult obtained from the GAsyncReadyCallback passed to xapp_status_icon_interface_call_button_release().

 

error

-

Return location for error or NULL.

+

Return location for error or NULL.

  @@ -1067,7 +1067,7 @@

Returns

-

TRUE if the call succeeded, FALSE if error +

TRUE if the call succeeded, FALSE if error is set.

[skip]

@@ -1075,16 +1075,16 @@

xapp_status_icon_interface_call_button_release_sync ()

-
gboolean
+
gboolean
 xapp_status_icon_interface_call_button_release_sync
                                (XAppStatusIconInterface *proxy,
-                                gint arg_x,
-                                gint arg_y,
-                                guint arg_button,
-                                guint arg_time,
-                                gint arg_panel_position,
-                                GCancellable *cancellable,
-                                GError **error);
+ gint arg_x, + gint arg_y, + guint arg_button, + guint arg_time, + gint arg_panel_position, + GCancellable *cancellable, + GError **error);

Synchronously invokes the ButtonRelease() D-Bus method on proxy . The calling thread is blocked until a reply is received.

See xapp_status_icon_interface_call_button_release() for the asynchronous version of this method.

@@ -1129,12 +1129,12 @@

cancellable

-

A GCancellable or NULL.

+

A GCancellable or NULL.

[nullable]

error

-

Return location for error or NULL.

+

Return location for error or NULL.

  @@ -1142,7 +1142,7 @@

Returns

-

TRUE if the call succeeded, FALSE if error +

TRUE if the call succeeded, FALSE if error is set.

[skip]

@@ -1153,16 +1153,16 @@

void xapp_status_icon_interface_call_scroll (XAppStatusIconInterface *proxy, - gint arg_delta, - gint arg_orientation, - guint arg_time, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); + gint arg_delta, + gint arg_orientation, + guint arg_time, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

Asynchronously invokes the Scroll() D-Bus method on proxy . When the operation is finished, callback - will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). + will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). You can then call xapp_status_icon_interface_call_scroll_finish() to get the result of the operation.

See xapp_status_icon_interface_call_scroll_sync() for the synchronous, blocking version of this method.

@@ -1196,12 +1196,12 @@

cancellable

-

A GCancellable or NULL.

+

A GCancellable or NULL.

[nullable]

callback

-

A GAsyncReadyCallback to call when the request is satisfied or NULL.

+

A GAsyncReadyCallback to call when the request is satisfied or NULL.

  @@ -1217,11 +1217,11 @@

xapp_status_icon_interface_call_scroll_finish ()

-
gboolean
+
gboolean
 xapp_status_icon_interface_call_scroll_finish
                                (XAppStatusIconInterface *proxy,
-                                GAsyncResult *res,
-                                GError **error);
+ GAsyncResult *res, + GError **error);

Finishes an operation started with xapp_status_icon_interface_call_scroll().

Parameters

@@ -1239,12 +1239,12 @@

res

-

The GAsyncResult obtained from the GAsyncReadyCallback passed to xapp_status_icon_interface_call_scroll().

+

The GAsyncResult obtained from the GAsyncReadyCallback passed to xapp_status_icon_interface_call_scroll().

 

error

-

Return location for error or NULL.

+

Return location for error or NULL.

  @@ -1252,7 +1252,7 @@

Returns

-

TRUE if the call succeeded, FALSE if error +

TRUE if the call succeeded, FALSE if error is set.

[skip]

@@ -1260,14 +1260,14 @@

xapp_status_icon_interface_call_scroll_sync ()

-
gboolean
+
gboolean
 xapp_status_icon_interface_call_scroll_sync
                                (XAppStatusIconInterface *proxy,
-                                gint arg_delta,
-                                gint arg_orientation,
-                                guint arg_time,
-                                GCancellable *cancellable,
-                                GError **error);
+ gint arg_delta, + gint arg_orientation, + guint arg_time, + GCancellable *cancellable, + GError **error);

Synchronously invokes the Scroll() D-Bus method on proxy . The calling thread is blocked until a reply is received.

See xapp_status_icon_interface_call_scroll() for the asynchronous version of this method.

@@ -1302,12 +1302,12 @@

cancellable

-

A GCancellable or NULL.

+

A GCancellable or NULL.

[nullable]

error

-

Return location for error or NULL.

+

Return location for error or NULL.

  @@ -1315,7 +1315,7 @@

Returns

-

TRUE if the call succeeded, FALSE if error +

TRUE if the call succeeded, FALSE if error is set.

[skip]

@@ -1323,7 +1323,7 @@

xapp_status_icon_interface_get_name ()

-
const gchar *
+
const gchar *
 xapp_status_icon_interface_get_name (XAppStatusIconInterface *object);

Gets the value of the "Name" D-Bus property.

Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.

@@ -1347,7 +1347,7 @@

Returns

-

The property value or NULL if the property is not set. Do not free the returned value, it belongs to object +

The property value or NULL if the property is not set. Do not free the returned value, it belongs to object .

[transfer none][nullable]

@@ -1355,7 +1355,7 @@

xapp_status_icon_interface_dup_name ()

-
gchar *
+
gchar *
 xapp_status_icon_interface_dup_name (XAppStatusIconInterface *object);

Gets a copy of the "Name" D-Bus property.

Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.

@@ -1377,7 +1377,7 @@

Returns

-

The property value or NULL if the property is not set. The returned value should be freed with g_free().

+

The property value or NULL if the property is not set. The returned value should be freed with g_free().

[transfer full][nullable]

@@ -1386,7 +1386,7 @@

xapp_status_icon_interface_set_name ()

void
 xapp_status_icon_interface_set_name (XAppStatusIconInterface *object,
-                                     const gchar *value);
+ const gchar *value);

Sets the "Name" D-Bus property to value .

Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.

@@ -1417,7 +1417,7 @@

xapp_status_icon_interface_get_icon_name ()

-
const gchar *
+
const gchar *
 xapp_status_icon_interface_get_icon_name
                                (XAppStatusIconInterface *object);

Gets the value of the "IconName" D-Bus property.

@@ -1442,7 +1442,7 @@

Returns

-

The property value or NULL if the property is not set. Do not free the returned value, it belongs to object +

The property value or NULL if the property is not set. Do not free the returned value, it belongs to object .

[transfer none][nullable]

@@ -1450,7 +1450,7 @@

xapp_status_icon_interface_dup_icon_name ()

-
gchar *
+
gchar *
 xapp_status_icon_interface_dup_icon_name
                                (XAppStatusIconInterface *object);

Gets a copy of the "IconName" D-Bus property.

@@ -1473,7 +1473,7 @@

Returns

-

The property value or NULL if the property is not set. The returned value should be freed with g_free().

+

The property value or NULL if the property is not set. The returned value should be freed with g_free().

[transfer full][nullable]

@@ -1483,7 +1483,7 @@

void xapp_status_icon_interface_set_icon_name (XAppStatusIconInterface *object, - const gchar *value);

+ const gchar *value);

Sets the "IconName" D-Bus property to value .

Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.

@@ -1514,7 +1514,7 @@

xapp_status_icon_interface_get_tooltip_text ()

-
const gchar *
+
const gchar *
 xapp_status_icon_interface_get_tooltip_text
                                (XAppStatusIconInterface *object);

Gets the value of the "TooltipText" D-Bus property.

@@ -1539,7 +1539,7 @@

Returns

-

The property value or NULL if the property is not set. Do not free the returned value, it belongs to object +

The property value or NULL if the property is not set. Do not free the returned value, it belongs to object .

[transfer none][nullable]

@@ -1547,7 +1547,7 @@

xapp_status_icon_interface_dup_tooltip_text ()

-
gchar *
+
gchar *
 xapp_status_icon_interface_dup_tooltip_text
                                (XAppStatusIconInterface *object);

Gets a copy of the "TooltipText" D-Bus property.

@@ -1570,7 +1570,7 @@

Returns

-

The property value or NULL if the property is not set. The returned value should be freed with g_free().

+

The property value or NULL if the property is not set. The returned value should be freed with g_free().

[transfer full][nullable]

@@ -1580,7 +1580,7 @@

void xapp_status_icon_interface_set_tooltip_text (XAppStatusIconInterface *object, - const gchar *value);

+ const gchar *value);

Sets the "TooltipText" D-Bus property to value .

Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.

@@ -1611,7 +1611,7 @@

xapp_status_icon_interface_get_label ()

-
const gchar *
+
const gchar *
 xapp_status_icon_interface_get_label (XAppStatusIconInterface *object);

Gets the value of the "Label" D-Bus property.

Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.

@@ -1635,7 +1635,7 @@

Returns

-

The property value or NULL if the property is not set. Do not free the returned value, it belongs to object +

The property value or NULL if the property is not set. Do not free the returned value, it belongs to object .

[transfer none][nullable]

@@ -1643,7 +1643,7 @@

xapp_status_icon_interface_dup_label ()

-
gchar *
+
gchar *
 xapp_status_icon_interface_dup_label (XAppStatusIconInterface *object);

Gets a copy of the "Label" D-Bus property.

Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.

@@ -1665,7 +1665,7 @@

Returns

-

The property value or NULL if the property is not set. The returned value should be freed with g_free().

+

The property value or NULL if the property is not set. The returned value should be freed with g_free().

[transfer full][nullable]

@@ -1674,7 +1674,7 @@

xapp_status_icon_interface_set_label ()

void
 xapp_status_icon_interface_set_label (XAppStatusIconInterface *object,
-                                      const gchar *value);
+ const gchar *value);

Sets the "Label" D-Bus property to value .

Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.

@@ -1705,7 +1705,7 @@

xapp_status_icon_interface_get_visible ()

-
gboolean
+
gboolean
 xapp_status_icon_interface_get_visible
                                (XAppStatusIconInterface *object);

Gets the value of the "Visible" D-Bus property.

@@ -1737,7 +1737,7 @@

void xapp_status_icon_interface_set_visible (XAppStatusIconInterface *object, - gboolean value);

+ gboolean value);

Sets the "Visible" D-Bus property to value .

Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.

@@ -1768,7 +1768,7 @@

xapp_status_icon_interface_get_icon_size ()

-
gint
+
gint
 xapp_status_icon_interface_get_icon_size
                                (XAppStatusIconInterface *object);

Gets the value of the "IconSize" D-Bus property.

@@ -1800,7 +1800,7 @@

void xapp_status_icon_interface_set_icon_size (XAppStatusIconInterface *object, - gint value);

+ gint value);

Sets the "IconSize" D-Bus property to value .

Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.

@@ -1831,7 +1831,7 @@

xapp_status_icon_interface_get_primary_menu_is_open ()

-
gboolean
+
gboolean
 xapp_status_icon_interface_get_primary_menu_is_open
                                (XAppStatusIconInterface *object);

Gets the value of the "PrimaryMenuIsOpen" D-Bus property.

@@ -1863,7 +1863,7 @@

void xapp_status_icon_interface_set_primary_menu_is_open (XAppStatusIconInterface *object, - gboolean value);

+ gboolean value);

Sets the "PrimaryMenuIsOpen" D-Bus property to value .

Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.

@@ -1894,7 +1894,7 @@

xapp_status_icon_interface_get_secondary_menu_is_open ()

-
gboolean
+
gboolean
 xapp_status_icon_interface_get_secondary_menu_is_open
                                (XAppStatusIconInterface *object);

Gets the value of the "SecondaryMenuIsOpen" D-Bus property.

@@ -1926,7 +1926,7 @@

void xapp_status_icon_interface_set_secondary_menu_is_open (XAppStatusIconInterface *object, - gboolean value);

+ gboolean value);

Sets the "SecondaryMenuIsOpen" D-Bus property to value .

Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.

@@ -1957,7 +1957,7 @@

xapp_status_icon_interface_get_metadata ()

-
const gchar *
+
const gchar *
 xapp_status_icon_interface_get_metadata
                                (XAppStatusIconInterface *object);

Gets the value of the "Metadata" D-Bus property.

@@ -1982,7 +1982,7 @@

Returns

-

The property value or NULL if the property is not set. Do not free the returned value, it belongs to object +

The property value or NULL if the property is not set. Do not free the returned value, it belongs to object .

[transfer none][nullable]

@@ -1990,7 +1990,7 @@

xapp_status_icon_interface_dup_metadata ()

-
gchar *
+
gchar *
 xapp_status_icon_interface_dup_metadata
                                (XAppStatusIconInterface *object);

Gets a copy of the "Metadata" D-Bus property.

@@ -2013,7 +2013,7 @@

Returns

-

The property value or NULL if the property is not set. The returned value should be freed with g_free().

+

The property value or NULL if the property is not set. The returned value should be freed with g_free().

[transfer full][nullable]

@@ -2023,7 +2023,7 @@

void xapp_status_icon_interface_set_metadata (XAppStatusIconInterface *object, - const gchar *value);

+ const gchar *value);

Sets the "Metadata" D-Bus property to value .

Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.

@@ -2055,16 +2055,16 @@

xapp_status_icon_interface_proxy_new ()

void
-xapp_status_icon_interface_proxy_new (GDBusConnection *connection,
-                                      GDBusProxyFlags flags,
-                                      const gchar *name,
-                                      const gchar *object_path,
-                                      GCancellable *cancellable,
-                                      GAsyncReadyCallback callback,
-                                      gpointer user_data);
-

Asynchronously creates a proxy for the D-Bus interface org.x.StatusIcon. See g_dbus_proxy_new() for more details.

+xapp_status_icon_interface_proxy_new (GDBusConnection *connection, + GDBusProxyFlags flags, + const gchar *name, + const gchar *object_path, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +

Asynchronously creates a proxy for the D-Bus interface org.x.StatusIcon. See g_dbus_proxy_new() for more details.

When the operation is finished, callback - will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). + will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). You can then call xapp_status_icon_interface_proxy_new_finish() to get the result of the operation.

See xapp_status_icon_interface_proxy_new_sync() for the synchronous, blocking version of this constructor.

@@ -2078,17 +2078,17 @@

connection

-

A GDBusConnection.

+

A GDBusConnection.

 

flags

-

Flags from the GDBusProxyFlags enumeration.

+

Flags from the GDBusProxyFlags enumeration.

 

name

-

A bus name (well-known or unique) or NULL if connection +

A bus name (well-known or unique) or NULL if connection is not a message bus connection.

[nullable] @@ -2099,12 +2099,12 @@

cancellable

-

A GCancellable or NULL.

+

A GCancellable or NULL.

[nullable]

callback

-

A GAsyncReadyCallback to call when the request is satisfied.

+

A GAsyncReadyCallback to call when the request is satisfied.

  @@ -2122,8 +2122,8 @@

xapp_status_icon_interface_proxy_new_finish ()

XAppStatusIconInterface *
 xapp_status_icon_interface_proxy_new_finish
-                               (GAsyncResult *res,
-                                GError **error);
+ (GAsyncResult *res, + GError **error);

Finishes an operation started with xapp_status_icon_interface_proxy_new().

Parameters

@@ -2136,12 +2136,12 @@

res

-

The GAsyncResult obtained from the GAsyncReadyCallback passed to xapp_status_icon_interface_proxy_new().

+

The GAsyncResult obtained from the GAsyncReadyCallback passed to xapp_status_icon_interface_proxy_new().

 

error

-

Return location for error or NULL

+

Return location for error or NULL

  @@ -2149,7 +2149,7 @@

Returns

-

The constructed proxy object or NULL if error +

The constructed proxy object or NULL if error is set.

[transfer full][type XAppStatusIconInterfaceProxy]

@@ -2159,13 +2159,13 @@

xapp_status_icon_interface_proxy_new_sync ()

XAppStatusIconInterface *
 xapp_status_icon_interface_proxy_new_sync
-                               (GDBusConnection *connection,
-                                GDBusProxyFlags flags,
-                                const gchar *name,
-                                const gchar *object_path,
-                                GCancellable *cancellable,
-                                GError **error);
-

Synchronously creates a proxy for the D-Bus interface org.x.StatusIcon. See g_dbus_proxy_new_sync() for more details.

+ (GDBusConnection *connection, + GDBusProxyFlags flags, + const gchar *name, + const gchar *object_path, + GCancellable *cancellable, + GError **error); +

Synchronously creates a proxy for the D-Bus interface org.x.StatusIcon. See g_dbus_proxy_new_sync() for more details.

The calling thread is blocked until a reply is received.

See xapp_status_icon_interface_proxy_new() for the asynchronous version of this constructor.

@@ -2179,17 +2179,17 @@

connection

-

A GDBusConnection.

+

A GDBusConnection.

 

flags

-

Flags from the GDBusProxyFlags enumeration.

+

Flags from the GDBusProxyFlags enumeration.

 

name

-

A bus name (well-known or unique) or NULL if connection +

A bus name (well-known or unique) or NULL if connection is not a message bus connection.

[nullable] @@ -2200,12 +2200,12 @@

cancellable

-

A GCancellable or NULL.

+

A GCancellable or NULL.

[nullable]

error

-

Return location for error or NULL

+

Return location for error or NULL

  @@ -2213,7 +2213,7 @@

Returns

-

The constructed proxy object or NULL if error +

The constructed proxy object or NULL if error is set.

[transfer full][type XAppStatusIconInterfaceProxy]

@@ -2223,16 +2223,16 @@

xapp_status_icon_interface_proxy_new_for_bus ()

void
 xapp_status_icon_interface_proxy_new_for_bus
-                               (GBusType bus_type,
-                                GDBusProxyFlags flags,
-                                const gchar *name,
-                                const gchar *object_path,
-                                GCancellable *cancellable,
-                                GAsyncReadyCallback callback,
-                                gpointer user_data);
-

Like xapp_status_icon_interface_proxy_new() but takes a GBusType instead of a GDBusConnection.

+ (GBusType bus_type, + GDBusProxyFlags flags, + const gchar *name, + const gchar *object_path, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +

Like xapp_status_icon_interface_proxy_new() but takes a GBusType instead of a GDBusConnection.

When the operation is finished, callback - will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). + will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). You can then call xapp_status_icon_interface_proxy_new_for_bus_finish() to get the result of the operation.

See xapp_status_icon_interface_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.

@@ -2246,12 +2246,12 @@

bus_type

-

A GBusType.

+

A GBusType.

 

flags

-

Flags from the GDBusProxyFlags enumeration.

+

Flags from the GDBusProxyFlags enumeration.

  @@ -2266,12 +2266,12 @@

cancellable

-

A GCancellable or NULL.

+

A GCancellable or NULL.

[nullable]

callback

-

A GAsyncReadyCallback to call when the request is satisfied.

+

A GAsyncReadyCallback to call when the request is satisfied.

  @@ -2289,8 +2289,8 @@

xapp_status_icon_interface_proxy_new_for_bus_finish ()

XAppStatusIconInterface *
 xapp_status_icon_interface_proxy_new_for_bus_finish
-                               (GAsyncResult *res,
-                                GError **error);
+ (GAsyncResult *res, + GError **error);

Finishes an operation started with xapp_status_icon_interface_proxy_new_for_bus().

Parameters

@@ -2303,12 +2303,12 @@

res

-

The GAsyncResult obtained from the GAsyncReadyCallback passed to xapp_status_icon_interface_proxy_new_for_bus().

+

The GAsyncResult obtained from the GAsyncReadyCallback passed to xapp_status_icon_interface_proxy_new_for_bus().

 

error

-

Return location for error or NULL

+

Return location for error or NULL

  @@ -2316,7 +2316,7 @@

Returns

-

The constructed proxy object or NULL if error +

The constructed proxy object or NULL if error is set.

[transfer full][type XAppStatusIconInterfaceProxy]

@@ -2326,13 +2326,13 @@

xapp_status_icon_interface_proxy_new_for_bus_sync ()

XAppStatusIconInterface *
 xapp_status_icon_interface_proxy_new_for_bus_sync
-                               (GBusType bus_type,
-                                GDBusProxyFlags flags,
-                                const gchar *name,
-                                const gchar *object_path,
-                                GCancellable *cancellable,
-                                GError **error);
-

Like xapp_status_icon_interface_proxy_new_sync() but takes a GBusType instead of a GDBusConnection.

+ (GBusType bus_type, + GDBusProxyFlags flags, + const gchar *name, + const gchar *object_path, + GCancellable *cancellable, + GError **error); +

Like xapp_status_icon_interface_proxy_new_sync() but takes a GBusType instead of a GDBusConnection.

The calling thread is blocked until a reply is received.

See xapp_status_icon_interface_proxy_new_for_bus() for the asynchronous version of this constructor.

@@ -2346,12 +2346,12 @@

bus_type

-

A GBusType.

+

A GBusType.

 

flags

-

Flags from the GDBusProxyFlags enumeration.

+

Flags from the GDBusProxyFlags enumeration.

  @@ -2366,12 +2366,12 @@

cancellable

-

A GCancellable or NULL.

+

A GCancellable or NULL.

[nullable]

error

-

Return location for error or NULL

+

Return location for error or NULL

  @@ -2379,7 +2379,7 @@

Returns

-

The constructed proxy object or NULL if error +

The constructed proxy object or NULL if error is set.

[transfer full][type XAppStatusIconInterfaceProxy]

@@ -2421,7 +2421,7 @@

Returns

-

A XAppStatusIconInterface that must be freed with g_object_unref() or NULL if object +

A XAppStatusIconInterface that must be freed with g_object_unref() or NULL if object does not implement the interface.

[transfer full][nullable]

@@ -2433,7 +2433,7 @@

XAppObject *object);

Like xapp_object_get_status_icon_interface() but doesn't increase the reference count on the returned object.

-

It is not safe to use the returned object if you are on another thread than the one where the GDBusObjectManagerClient or GDBusObjectManagerServer for object +

It is not safe to use the returned object if you are on another thread than the one where the GDBusObjectManagerClient or GDBusObjectManagerServer for object is running.

[skip]

@@ -2453,7 +2453,7 @@

Returns

-

A XAppStatusIconInterface or NULL if object +

A XAppStatusIconInterface or NULL if object does not implement the interface. Do not free the returned object, it is owned by object .

[transfer none][nullable]

@@ -2463,8 +2463,8 @@

xapp_object_proxy_new ()

XAppObjectProxy *
-xapp_object_proxy_new (GDBusConnection *connection,
-                       const gchar *object_path);
+xapp_object_proxy_new (GDBusConnection *connection, + const gchar *object_path);

Creates a new proxy object.

Parameters

@@ -2477,7 +2477,7 @@

connection

-

A GDBusConnection.

+

A GDBusConnection.

  @@ -2498,7 +2498,7 @@

xapp_object_skeleton_new ()

XAppObjectSkeleton *
-xapp_object_skeleton_new (const gchar *object_path);
+xapp_object_skeleton_new (const gchar *object_path);

Creates a new skeleton object.

Parameters

@@ -2546,7 +2546,7 @@

interface_

-

A XAppStatusIconInterface or NULL to clear the interface.

+

A XAppStatusIconInterface or NULL to clear the interface.

[nullable] @@ -2556,14 +2556,14 @@

xapp_object_manager_client_get_proxy_type ()

-
GType
+
GType
 xapp_object_manager_client_get_proxy_type
-                               (GDBusObjectManagerClient *manager,
-                                const gchar *object_path,
-                                const gchar *interface_name,
-                                gpointer user_data);
-

A GDBusProxyTypeFunc that maps interface_name - to the generated GDBusObjectProxy derived and GDBusProxy derived types.

+ (GDBusObjectManagerClient *manager, + const gchar *object_path, + const gchar *interface_name, + gpointer user_data);
+

A GDBusProxyTypeFunc that maps interface_name + to the generated GDBusObjectProxy derived and GDBusProxy derived types.

Parameters

@@ -2575,7 +2575,7 @@

- + @@ -2585,7 +2585,7 @@

- + @@ -2598,24 +2598,24 @@

Returns

-

A GDBusProxy derived GType if interface_name -is not NULL, otherwise the GType for XAppObjectProxy.

+

A GDBusProxy derived GType if interface_name +is not NULL, otherwise the GType for XAppObjectProxy.


xapp_object_manager_client_new ()

void
-xapp_object_manager_client_new (GDBusConnection *connection,
-                                GDBusObjectManagerClientFlags flags,
-                                const gchar *name,
-                                const gchar *object_path,
-                                GCancellable *cancellable,
-                                GAsyncReadyCallback callback,
-                                gpointer user_data);
-

Asynchronously creates GDBusObjectManagerClient using xapp_object_manager_client_get_proxy_type() as the GDBusProxyTypeFunc. See g_dbus_object_manager_client_new() for more details.

+xapp_object_manager_client_new (GDBusConnection *connection, + GDBusObjectManagerClientFlags flags, + const gchar *name, + const gchar *object_path, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +

Asynchronously creates GDBusObjectManagerClient using xapp_object_manager_client_get_proxy_type() as the GDBusProxyTypeFunc. See g_dbus_object_manager_client_new() for more details.

When the operation is finished, callback - will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). + will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). You can then call xapp_object_manager_client_new_finish() to get the result of the operation.

See xapp_object_manager_client_new_sync() for the synchronous, blocking version of this constructor.

@@ -2629,17 +2629,17 @@

- + - + - @@ -2650,12 +2650,12 @@

- + - + @@ -2671,9 +2671,9 @@

xapp_object_manager_client_new_finish ()

-
GDBusObjectManager *
-xapp_object_manager_client_new_finish (GAsyncResult *res,
-                                       GError **error);
+
GDBusObjectManager *
+xapp_object_manager_client_new_finish (GAsyncResult *res,
+                                       GError **error);

Finishes an operation started with xapp_object_manager_client_new().

Parameters

@@ -2686,12 +2686,12 @@

- + - + @@ -2699,7 +2699,7 @@

Returns

-

The constructed object manager client or NULL if error +

The constructed object manager client or NULL if error is set.

[transfer full][type XAppObjectManagerClient]

@@ -2707,14 +2707,14 @@

xapp_object_manager_client_new_sync ()

-
GDBusObjectManager *
-xapp_object_manager_client_new_sync (GDBusConnection *connection,
-                                     GDBusObjectManagerClientFlags flags,
-                                     const gchar *name,
-                                     const gchar *object_path,
-                                     GCancellable *cancellable,
-                                     GError **error);
-

Synchronously creates GDBusObjectManagerClient using xapp_object_manager_client_get_proxy_type() as the GDBusProxyTypeFunc. See g_dbus_object_manager_client_new_sync() for more details.

+
GDBusObjectManager *
+xapp_object_manager_client_new_sync (GDBusConnection *connection,
+                                     GDBusObjectManagerClientFlags flags,
+                                     const gchar *name,
+                                     const gchar *object_path,
+                                     GCancellable *cancellable,
+                                     GError **error);
+

Synchronously creates GDBusObjectManagerClient using xapp_object_manager_client_get_proxy_type() as the GDBusProxyTypeFunc. See g_dbus_object_manager_client_new_sync() for more details.

The calling thread is blocked until a reply is received.

See xapp_object_manager_client_new() for the asynchronous version of this constructor.

@@ -2728,17 +2728,17 @@

- + - + - @@ -2749,12 +2749,12 @@

- + - + @@ -2762,7 +2762,7 @@

Returns

-

The constructed object manager client or NULL if error +

The constructed object manager client or NULL if error is set.

[transfer full][type XAppObjectManagerClient]

@@ -2772,16 +2772,16 @@

xapp_object_manager_client_new_for_bus ()

void
 xapp_object_manager_client_new_for_bus
-                               (GBusType bus_type,
-                                GDBusObjectManagerClientFlags flags,
-                                const gchar *name,
-                                const gchar *object_path,
-                                GCancellable *cancellable,
-                                GAsyncReadyCallback callback,
-                                gpointer user_data);
-

Like xapp_object_manager_client_new() but takes a GBusType instead of a GDBusConnection.

+ (GBusType bus_type, + GDBusObjectManagerClientFlags flags, + const gchar *name, + const gchar *object_path, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +

Like xapp_object_manager_client_new() but takes a GBusType instead of a GDBusConnection.

When the operation is finished, callback - will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). + will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). You can then call xapp_object_manager_client_new_for_bus_finish() to get the result of the operation.

See xapp_object_manager_client_new_for_bus_sync() for the synchronous, blocking version of this constructor.

@@ -2795,12 +2795,12 @@

- + - + @@ -2815,12 +2815,12 @@

- + - + @@ -2836,10 +2836,10 @@

xapp_object_manager_client_new_for_bus_finish ()

-
GDBusObjectManager *
+
GDBusObjectManager *
 xapp_object_manager_client_new_for_bus_finish
-                               (GAsyncResult *res,
-                                GError **error);
+ (GAsyncResult *res, + GError **error);

Finishes an operation started with xapp_object_manager_client_new_for_bus().

Parameters

@@ -2852,12 +2852,12 @@

- + - + @@ -2865,7 +2865,7 @@

Returns

-

The constructed object manager client or NULL if error +

The constructed object manager client or NULL if error is set.

[transfer full][type XAppObjectManagerClient]

@@ -2873,15 +2873,15 @@

xapp_object_manager_client_new_for_bus_sync ()

-
GDBusObjectManager *
+
GDBusObjectManager *
 xapp_object_manager_client_new_for_bus_sync
-                               (GBusType bus_type,
-                                GDBusObjectManagerClientFlags flags,
-                                const gchar *name,
-                                const gchar *object_path,
-                                GCancellable *cancellable,
-                                GError **error);
-

Like xapp_object_manager_client_new_sync() but takes a GBusType instead of a GDBusConnection.

+ (GBusType bus_type, + GDBusObjectManagerClientFlags flags, + const gchar *name, + const gchar *object_path, + GCancellable *cancellable, + GError **error);
+

Like xapp_object_manager_client_new_sync() but takes a GBusType instead of a GDBusConnection.

The calling thread is blocked until a reply is received.

See xapp_object_manager_client_new_for_bus() for the asynchronous version of this constructor.

@@ -2895,12 +2895,12 @@

- + - + @@ -2915,12 +2915,12 @@

- + - + @@ -2928,7 +2928,7 @@

Returns

-

The constructed object manager client or NULL if error +

The constructed object manager client or NULL if error is set.

[transfer full][type XAppObjectManagerClient]

@@ -2940,7 +2940,7 @@

The “status-icon-interface” property

  “status-icon-interface”    XAppStatusIconInterface *

The XAppStatusIconInterface instance corresponding to the D-Bus interface org.x.StatusIcon, if any.

-

Connect to the “notify” signal to get informed of property changes.

+

Connect to the “notify” signal to get informed of property changes.

Owner: XAppObject

Flags: Read / Write

@@ -2949,7 +2949,7 @@

The “icon-name” property

  “icon-name”                char *

Represents the D-Bus property "IconName".

-

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

+

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

Owner: XAppStatusIconInterface

Flags: Read / Write

Default value: NULL

@@ -2959,7 +2959,7 @@

The “icon-size” property

  “icon-size”                int

Represents the D-Bus property "IconSize".

-

Since the D-Bus property for this GObject property is both readable and writable, it is meaningful to both read from it and write to it on both the service- and client-side.

+

Since the D-Bus property for this GObject property is both readable and writable, it is meaningful to both read from it and write to it on both the service- and client-side.

Owner: XAppStatusIconInterface

Flags: Read / Write

Default value: 0

@@ -2969,7 +2969,7 @@

The “label” property

  “label”                    char *

Represents the D-Bus property "Label".

-

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

+

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

Owner: XAppStatusIconInterface

Flags: Read / Write

Default value: NULL

@@ -2979,7 +2979,7 @@

The “metadata” property

  “metadata”                 char *

Represents the D-Bus property "Metadata".

-

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

+

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

Owner: XAppStatusIconInterface

Flags: Read / Write

Default value: NULL

@@ -2989,7 +2989,7 @@

The “name” property

  “name”                     char *

Represents the D-Bus property "Name".

-

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

+

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

Owner: XAppStatusIconInterface

Flags: Read / Write

Default value: NULL

@@ -2997,9 +2997,9 @@

The “primary-menu-is-open” property

-
  “primary-menu-is-open”     gboolean
+
  “primary-menu-is-open”     gboolean

Represents the D-Bus property "PrimaryMenuIsOpen".

-

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

+

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

Owner: XAppStatusIconInterface

Flags: Read / Write

Default value: FALSE

@@ -3007,9 +3007,9 @@

The “secondary-menu-is-open” property

-
  “secondary-menu-is-open”   gboolean
+
  “secondary-menu-is-open”   gboolean

Represents the D-Bus property "SecondaryMenuIsOpen".

-

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

+

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

Owner: XAppStatusIconInterface

Flags: Read / Write

Default value: FALSE

@@ -3019,7 +3019,7 @@

The “tooltip-text” property

  “tooltip-text”             char *

Represents the D-Bus property "TooltipText".

-

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

+

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

Owner: XAppStatusIconInterface

Flags: Read / Write

Default value: NULL

@@ -3027,9 +3027,9 @@

The “visible” property

-
  “visible”                  gboolean
+
  “visible”                  gboolean

Represents the D-Bus property "Visible".

-

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

+

Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

Owner: XAppStatusIconInterface

Flags: Read / Write

Default value: FALSE

@@ -3039,18 +3039,18 @@

Signal Details

The “handle-button-press” signal

-
gboolean
+
gboolean
 user_function (XAppStatusIconInterface *object,
-               GDBusMethodInvocation   *invocation,
+               GDBusMethodInvocation   *invocation,
                int                      arg_x,
                int                      arg_y,
-               guint                    arg_button,
-               guint                    arg_time,
+               guint                    arg_button,
+               guint                    arg_time,
                int                      arg_panel_position,
-               gpointer                 user_data)
+ gpointer user_data)

Signal emitted when a remote caller is invoking the ButtonPress() D-Bus method.

-

If a signal handler returns TRUE, it means the signal handler will handle the invocation (e.g. take a reference to invocation - and eventually call xapp_status_icon_interface_complete_button_press() or e.g. g_dbus_method_invocation_return_error() on it) and no other signal handlers will run. If no signal handler handles the invocation, the G_DBUS_ERROR_UNKNOWN_METHOD error is returned.

+

If a signal handler returns TRUE, it means the signal handler will handle the invocation (e.g. take a reference to invocation + and eventually call xapp_status_icon_interface_complete_button_press() or e.g. g_dbus_method_invocation_return_error() on it) and no other signal handlers will run. If no signal handler handles the invocation, the G_DBUS_ERROR_UNKNOWN_METHOD error is returned.

Parameters

manager

A GDBusObjectManagerClient.

A GDBusObjectManagerClient.

 

interface_name

Interface name of the remote object or NULL to get the object proxy GType.

Interface name of the remote object or NULL to get the object proxy GType.

[nullable]

connection

A GDBusConnection.

A GDBusConnection.

 

flags

Flags from the GDBusObjectManagerClientFlags enumeration.

Flags from the GDBusObjectManagerClientFlags enumeration.

 

name

A bus name (well-known or unique) or NULL if connection +

A bus name (well-known or unique) or NULL if connection is not a message bus connection.

[nullable]

cancellable

A GCancellable or NULL.

A GCancellable or NULL.

[nullable]

callback

A GAsyncReadyCallback to call when the request is satisfied.

A GAsyncReadyCallback to call when the request is satisfied.

 

res

The GAsyncResult obtained from the GAsyncReadyCallback passed to xapp_object_manager_client_new().

The GAsyncResult obtained from the GAsyncReadyCallback passed to xapp_object_manager_client_new().

 

error

Return location for error or NULL

Return location for error or NULL

 

connection

A GDBusConnection.

A GDBusConnection.

 

flags

Flags from the GDBusObjectManagerClientFlags enumeration.

Flags from the GDBusObjectManagerClientFlags enumeration.

 

name

A bus name (well-known or unique) or NULL if connection +

A bus name (well-known or unique) or NULL if connection is not a message bus connection.

[nullable]

cancellable

A GCancellable or NULL.

A GCancellable or NULL.

[nullable]

error

Return location for error or NULL

Return location for error or NULL

 

bus_type

A GBusType.

A GBusType.

 

flags

Flags from the GDBusObjectManagerClientFlags enumeration.

Flags from the GDBusObjectManagerClientFlags enumeration.

 

cancellable

A GCancellable or NULL.

A GCancellable or NULL.

[nullable]

callback

A GAsyncReadyCallback to call when the request is satisfied.

A GAsyncReadyCallback to call when the request is satisfied.

 

res

The GAsyncResult obtained from the GAsyncReadyCallback passed to xapp_object_manager_client_new_for_bus().

The GAsyncResult obtained from the GAsyncReadyCallback passed to xapp_object_manager_client_new_for_bus().

 

error

Return location for error or NULL

Return location for error or NULL

 

bus_type

A GBusType.

A GBusType.

 

flags

Flags from the GDBusObjectManagerClientFlags enumeration.

Flags from the GDBusObjectManagerClientFlags enumeration.

 

cancellable

A GCancellable or NULL.

A GCancellable or NULL.

[nullable]

error

Return location for error or NULL

Return location for error or NULL

 
@@ -3067,7 +3067,7 @@

- + @@ -3105,25 +3105,25 @@

Returns

-

G_DBUS_METHOD_INVOCATION_HANDLED or TRUE if the invocation was handled, G_DBUS_METHOD_INVOCATION_UNHANDLED or FALSE to let other signal handlers run.

+

G_DBUS_METHOD_INVOCATION_HANDLED or TRUE if the invocation was handled, G_DBUS_METHOD_INVOCATION_UNHANDLED or FALSE to let other signal handlers run.

-

Flags: Run Last

+

Flags: Run Last


The “handle-button-release” signal

-
gboolean
+
gboolean
 user_function (XAppStatusIconInterface *object,
-               GDBusMethodInvocation   *invocation,
+               GDBusMethodInvocation   *invocation,
                int                      arg_x,
                int                      arg_y,
-               guint                    arg_button,
-               guint                    arg_time,
+               guint                    arg_button,
+               guint                    arg_time,
                int                      arg_panel_position,
-               gpointer                 user_data)
+ gpointer user_data)

Signal emitted when a remote caller is invoking the ButtonRelease() D-Bus method.

-

If a signal handler returns TRUE, it means the signal handler will handle the invocation (e.g. take a reference to invocation - and eventually call xapp_status_icon_interface_complete_button_release() or e.g. g_dbus_method_invocation_return_error() on it) and no other signal handlers will run. If no signal handler handles the invocation, the G_DBUS_ERROR_UNKNOWN_METHOD error is returned.

+

If a signal handler returns TRUE, it means the signal handler will handle the invocation (e.g. take a reference to invocation + and eventually call xapp_status_icon_interface_complete_button_release() or e.g. g_dbus_method_invocation_return_error() on it) and no other signal handlers will run. If no signal handler handles the invocation, the G_DBUS_ERROR_UNKNOWN_METHOD error is returned.

Parameters

invocation

A GDBusMethodInvocation.

A GDBusMethodInvocation.

 
@@ -3140,7 +3140,7 @@

- + @@ -3178,23 +3178,23 @@

Returns

-

G_DBUS_METHOD_INVOCATION_HANDLED or TRUE if the invocation was handled, G_DBUS_METHOD_INVOCATION_UNHANDLED or FALSE to let other signal handlers run.

+

G_DBUS_METHOD_INVOCATION_HANDLED or TRUE if the invocation was handled, G_DBUS_METHOD_INVOCATION_UNHANDLED or FALSE to let other signal handlers run.

-

Flags: Run Last

+

Flags: Run Last


The “handle-scroll” signal

-
gboolean
+
gboolean
 user_function (XAppStatusIconInterface *object,
-               GDBusMethodInvocation   *invocation,
+               GDBusMethodInvocation   *invocation,
                int                      arg_delta,
                int                      arg_orientation,
-               guint                    arg_time,
-               gpointer                 user_data)
+ guint arg_time, + gpointer user_data)

Signal emitted when a remote caller is invoking the Scroll() D-Bus method.

-

If a signal handler returns TRUE, it means the signal handler will handle the invocation (e.g. take a reference to invocation - and eventually call xapp_status_icon_interface_complete_scroll() or e.g. g_dbus_method_invocation_return_error() on it) and no other signal handlers will run. If no signal handler handles the invocation, the G_DBUS_ERROR_UNKNOWN_METHOD error is returned.

+

If a signal handler returns TRUE, it means the signal handler will handle the invocation (e.g. take a reference to invocation + and eventually call xapp_status_icon_interface_complete_scroll() or e.g. g_dbus_method_invocation_return_error() on it) and no other signal handlers will run. If no signal handler handles the invocation, the G_DBUS_ERROR_UNKNOWN_METHOD error is returned.

Parameters

invocation

A GDBusMethodInvocation.

A GDBusMethodInvocation.

 
@@ -3211,7 +3211,7 @@

- + @@ -3239,13 +3239,13 @@

Returns

-

G_DBUS_METHOD_INVOCATION_HANDLED or TRUE if the invocation was handled, G_DBUS_METHOD_INVOCATION_UNHANDLED or FALSE to let other signal handlers run.

+

G_DBUS_METHOD_INVOCATION_HANDLED or TRUE if the invocation was handled, G_DBUS_METHOD_INVOCATION_UNHANDLED or FALSE to let other signal handlers run.

-

Flags: Run Last

+

Flags: Run Last

+
Generated by GTK-Doc V1.34.0 \ No newline at end of file diff --git a/docs/reference/XAppPreferencesWindow.html b/docs/reference/XAppPreferencesWindow.html index 34f33f45..ba13ae3d 100644 --- a/docs/reference/XAppPreferencesWindow.html +++ b/docs/reference/XAppPreferencesWindow.html @@ -8,7 +8,7 @@ - + @@ -80,7 +80,7 @@

- +

invocation

A GDBusMethodInvocation.

A GDBusMethodInvocation.

 
void closeActionAction
@@ -109,8 +109,8 @@

Object Hierarchy

-
    GObject
-    ╰── GInitiallyUnowned
+
    GObject
+    ╰── GInitiallyUnowned
         ╰── GtkWidget
             ╰── GtkContainer
                 ╰── GtkBin
@@ -149,8 +149,8 @@ 

void
 xapp_preferences_window_add_page (XAppPreferencesWindow *window,
                                   GtkWidget *widget,
-                                  const gchar *name,
-                                  const gchar *title);
+ const gchar *name, + const gchar *title);

Adds a page to the window. The page is identified by name. The title will be used in the sidebar so should be short. The sidebar will show automatically once at least two pages are added.

@@ -257,12 +257,12 @@

The “close” signal

void
 user_function (XAppPreferencesWindow *xapppreferenceswindow,
-               gpointer               user_data)
-

Flags: Action

+ gpointer user_data)

+

Flags: Action

+
Generated by GTK-Doc V1.34.0

\ No newline at end of file diff --git a/docs/reference/XAppStackSidebar.html b/docs/reference/XAppStackSidebar.html index 1c682384..e907c2fd 100644 --- a/docs/reference/XAppStackSidebar.html +++ b/docs/reference/XAppStackSidebar.html @@ -8,7 +8,7 @@ - + @@ -106,8 +106,8 @@

XAppS

Object Hierarchy

-
    GObject
-    ╰── GInitiallyUnowned
+
    GObject
+    ╰── GInitiallyUnowned
         ╰── GtkWidget
             ╰── GtkContainer
                 ╰── GtkBin
@@ -130,7 +130,7 @@ 

XAppS to the GtkStack. The XAppStackSidebar is an extended version of the the GtkStackSidebar that allows showing an icon in addition to the text.

-

CSS nodes

+

CSS nodes

XAppStackSidebar has a single CSS node with the name stacksidebar and style class .sidebar

When circumstances require it, XAppStackSidebar adds the @@ -207,7 +207,7 @@

XAppS

Returns

the associated GtkStack or -NULL if none has been set explicitly.

+NULL if none has been set explicitly.

[nullable][transfer none]

@@ -237,6 +237,6 @@

XAppS

+
Generated by GTK-Doc V1.34.0

\ No newline at end of file diff --git a/docs/reference/XAppStatusIcon.html b/docs/reference/XAppStatusIcon.html index 5f0592e3..223cc825 100644 --- a/docs/reference/XAppStatusIcon.html +++ b/docs/reference/XAppStatusIcon.html @@ -8,7 +8,7 @@ - + @@ -76,7 +76,7 @@

XAppSta -gint +gint xapp_status_icon_get_icon_size () @@ -108,7 +108,7 @@

XAppSta -gboolean +gboolean xapp_status_icon_get_visible () @@ -172,7 +172,7 @@

XAppSta -gboolean +gboolean xapp_status_icon_any_monitors () @@ -228,27 +228,27 @@

XAppSta void activate -Action +Action void button-press-event -Action +Action void button-release-event -Action +Action void scroll-event -Action +Action void state-changed -Action +Action

@@ -285,7 +285,7 @@

XAppSta
    GEnum
     ├── XAppScrollDirection
     ╰── XAppStatusIconState
-    GObject
+    GObject
     ╰── XAppStatusIcon
 

@@ -315,7 +315,7 @@

XAppSta

xapp_status_icon_new_with_name ()

XAppStatusIcon *
-xapp_status_icon_new_with_name (const gchar *name);
+xapp_status_icon_new_with_name (const gchar *name);

Creates a new XAppStatusIcon instance and sets its name to name.

Returns

@@ -329,7 +329,7 @@

XAppSta

xapp_status_icon_set_name ()

void
 xapp_status_icon_set_name (XAppStatusIcon *icon,
-                           const gchar *name);
+ const gchar *name);

Sets the status icon name. This is not shown to users.

Parameters

@@ -360,7 +360,7 @@

XAppSta

xapp_status_icon_set_icon_name ()

void
 xapp_status_icon_set_icon_name (XAppStatusIcon *icon,
-                                const gchar *icon_name);
+ const gchar *icon_name);

Sets the icon name or local path to use.

Parameters

@@ -389,7 +389,7 @@

XAppSta

xapp_status_icon_get_icon_size ()

-
gint
+
gint
 xapp_status_icon_get_icon_size (XAppStatusIcon *icon);

Parameters

@@ -419,7 +419,7 @@

XAppSta

xapp_status_icon_set_tooltip_text ()

void
 xapp_status_icon_set_tooltip_text (XAppStatusIcon *icon,
-                                   const gchar *tooltip_text);
+ const gchar *tooltip_text);

Sets the tooltip text

Parameters

@@ -450,7 +450,7 @@

XAppSta

xapp_status_icon_set_label ()

void
 xapp_status_icon_set_label (XAppStatusIcon *icon,
-                            const gchar *label);
+ const gchar *label);

Sets a label, shown beside the icon

Parameters

@@ -481,7 +481,7 @@

XAppSta

xapp_status_icon_set_visible ()

void
 xapp_status_icon_set_visible (XAppStatusIcon *icon,
-                              const gboolean visible);
+ const gboolean visible);

Sets the visibility of the status icon

Parameters

@@ -510,7 +510,7 @@

XAppSta

xapp_status_icon_get_visible ()

-
gboolean
+
gboolean
 xapp_status_icon_get_visible (XAppStatusIcon *icon);

Returns whether or not the icon should currently be visible.

@@ -540,11 +540,11 @@

XAppSta
void
 xapp_status_icon_popup_menu (XAppStatusIcon *icon,
                              GtkMenu *menu,
-                             gint x,
-                             gint y,
-                             guint button,
-                             guint _time,
-                             gint panel_position);
+ gint x, + gint y, + guint button, + guint _time, + gint panel_position);

Pop up menu using the positioning arguments. These arguments should be those provided by a “button-release-event”.

@@ -634,7 +634,7 @@

XAppSta
GtkWidget *
 xapp_status_icon_get_primary_menu (XAppStatusIcon *icon);

Returns a pointer to a GtkMenu that was set previously for the -primary mouse button. If no menu was set, this returns NULL.

+primary mouse button. If no menu was set, this returns NULL.

Parameters

@@ -652,7 +652,7 @@

XAppSta

Returns

-

the GtkMenu or NULL if none was set.

+

the GtkMenu or NULL if none was set.

[transfer none]

Since: 1.6

@@ -694,7 +694,7 @@

XAppSta
GtkWidget *
 xapp_status_icon_get_secondary_menu (XAppStatusIcon *icon);

Returns a pointer to a GtkMenu that was set previously for the -secondary mouse button. If no menu was set, this returns NULL.

+secondary mouse button. If no menu was set, this returns NULL.

Parameters

@@ -712,7 +712,7 @@

XAppSta

Returns

-

the GtkMenu or NULL if none was set.

+

the GtkMenu or NULL if none was set.

[transfer none]

Since: 1.6

@@ -752,7 +752,7 @@

XAppSta

xapp_status_icon_set_metadata ()

void
 xapp_status_icon_set_metadata (XAppStatusIcon *icon,
-                               const gchar *metadata);
+ const gchar *metadata);

Sets metadata to pass to the icon proxy for an applet's use. Right now this is only so xapp-sn-watcher can tell the applets when the icon is originating from appindicator so panel button 'highlighting' can behave correctly.

@@ -783,12 +783,12 @@

XAppSta

xapp_status_icon_any_monitors ()

-
gboolean
+
gboolean
 xapp_status_icon_any_monitors (void);

Looks for the existence of any active XAppStatusIconMonitors on the bus.

Returns

-

TRUE if at least one monitor was found.

+

TRUE if at least one monitor was found.

Since: 1.6

@@ -916,7 +916,7 @@

XAppSta additional icons are created, only the name given to the initial one will be used for dbus, though different names can still affect the sort order. This is set to the value of -g_get_prgname() if no other name is provided.

+g_get_prgname() if no other name is provided.

Owner: XAppStatusIcon

Flags: Read / Write / Construct

Default value: NULL

@@ -926,9 +926,9 @@

XAppSta

The “primary-menu” property

  “primary-menu”             GtkWidget *

A GtkMenu to use when requested by the remote monitor via a left (or primary) click.

-

When this property is not NULL, the menu will be automatically positioned and +

When this property is not NULL, the menu will be automatically positioned and displayed during a primary button release.

-

When this property IS NULL, the “activate” will be sent for primary +

When this property IS NULL, the “activate” will be sent for primary button presses.

In both cases, the “button-press-event” and “button-release-events” will be fired like normal.

@@ -945,9 +945,9 @@

XAppSta

The “secondary-menu” property

  “secondary-menu”           GtkWidget *

A GtkMenu to use when requested by the remote monitor via a right (or secondary) click.

-

When this property is not NULL, the menu will be automatically positioned and +

When this property is not NULL, the menu will be automatically positioned and displayed during a secondary button release.

-

When this property IS NULL, the “activate” will be sent for secondary +

When this property IS NULL, the “activate” will be sent for secondary button presses.

In both cases, the “button-press-event” and “button-release-events” will be fired like normal.

@@ -966,11 +966,11 @@

XAppSta

The “activate” signal

void
 user_function (XAppStatusIcon *icon,
-               guint           button,
-               guint           time,
-               gpointer        user_data)
+ guint button, + guint time, + gpointer user_data)

Gets emitted when the user activates the status icon. If the XAppStatusIcon:primary-menu or -XAppStatusIcon:secondary-menu is not NULL, this signal is skipped for the respective button +XAppStatusIcon:secondary-menu is not NULL, this signal is skipped for the respective button presses. A middle button click will always send this signal when pressed.

Parameters

@@ -1004,7 +1004,7 @@

XAppSta

-

Flags: Action

+

Flags: Action


@@ -1013,10 +1013,10 @@

XAppSta user_function (XAppStatusIcon *icon, int x, int y, - guint button, - guint time, + guint button, + guint time, int panel_position, - gpointer user_data) + gpointer user_data)

Gets emitted when there is a button press received from an applet

Parameters

@@ -1065,7 +1065,7 @@

XAppSta

-

Flags: Action

+

Flags: Action


@@ -1074,10 +1074,10 @@

XAppSta user_function (XAppStatusIcon *icon, int x, int y, - guint button, - guint time, + guint button, + guint time, int panel_position, - gpointer user_data) + gpointer user_data)

Gets emitted when there is a button release received from an applet

Parameters

@@ -1126,7 +1126,7 @@

XAppSta

-

Flags: Action

+

Flags: Action


@@ -1135,8 +1135,8 @@

XAppSta user_function (XAppStatusIcon *icon, int amount, XAppScrollDirection direction, - guint time, - gpointer user_data) + guint time, + gpointer user_data)

Gets emitted when the user uses the mouse scroll wheel over the status icon. For the most part, amounts will always be 1, unless an applet supports smooth scrolling. Generally the direction value is most important.

@@ -1177,7 +1177,7 @@

XAppSta

-

Flags: Action

+

Flags: Action


@@ -1185,7 +1185,7 @@

XAppSta
void
 user_function (XAppStatusIcon     *icon,
                XAppStatusIconState new_state,
-               gpointer            user_data)
+ gpointer user_data)

Gets emitted when the state of the icon changes. If you wish to react to changes in how the status icon is being handled (perhaps to alter the menu or other click behavior), you should @@ -1217,11 +1217,11 @@

XAppSta

-

Flags: Action

+

Flags: Action

+
Generated by GTK-Doc V1.34.0

\ No newline at end of file diff --git a/docs/reference/XAppStatusIconMonitor.html b/docs/reference/XAppStatusIconMonitor.html index 7961209a..7209c952 100644 --- a/docs/reference/XAppStatusIconMonitor.html +++ b/docs/reference/XAppStatusIconMonitor.html @@ -8,7 +8,7 @@ - + @@ -52,7 +52,7 @@

-GList * +GList * xapp_status_icon_monitor_list_icons () @@ -73,12 +73,12 @@

void icon-added -Action +Action void icon-removed -Action +Action

@@ -104,7 +104,7 @@

Object Hierarchy

-
    GObject
+
    GObject
     ╰── XAppStatusIconMonitor
 
@@ -137,7 +137,7 @@


xapp_status_icon_monitor_list_icons ()

-
GList *
+
GList *
 xapp_status_icon_monitor_list_icons (XAppStatusIconMonitor *monitor);

List known icon proxies.

@@ -157,7 +157,7 @@

Returns

-

a GList of icons.

+

a GList of icons.

[element-type XAppStatusIconMonitor][transfer container]

Since: 1.6

@@ -183,7 +183,7 @@

void
 user_function (XAppStatusIconMonitor        *monitor,
                XAppStatusIconInterfaceProxy *proxy,
-               gpointer                      user_data)
+ gpointer user_data)

This signal is emitted by the monitor when it has discovered a new XAppStatusIcon on the bus.

@@ -213,7 +213,7 @@

-

Flags: Action

+

Flags: Action


@@ -221,7 +221,7 @@

void
 user_function (XAppStatusIconMonitor        *monitor,
                XAppStatusIconInterfaceProxy *proxy,
-               gpointer                      user_data)
+ gpointer user_data)

This signal is emitted by the monitor when an XAppStatusIcon has disappeared from the bus.

@@ -251,11 +251,11 @@

-

Flags: Action

+

Flags: Action

+
Generated by GTK-Doc V1.34.0

\ No newline at end of file diff --git a/docs/reference/XAppVisibilityGroup.html b/docs/reference/XAppVisibilityGroup.html index 18bd49b1..7a136ec3 100644 --- a/docs/reference/XAppVisibilityGroup.html +++ b/docs/reference/XAppVisibilityGroup.html @@ -8,7 +8,7 @@ - + @@ -54,12 +54,20 @@

XA void +xapp_visibility_group_free () + + + + +void + + xapp_visibility_group_add_widget () -gboolean +gboolean xapp_visibility_group_remove_widget () @@ -91,7 +99,7 @@

XA -gboolean +gboolean xapp_visibility_group_get_visible () @@ -107,7 +115,7 @@

XA -gboolean +gboolean xapp_visibility_group_get_sensitive () @@ -115,7 +123,7 @@

XA -GSList * +GSList * xapp_visibility_group_get_widgets () @@ -167,9 +175,9 @@

XA

xapp_visibility_group_new ()

XAppVisibilityGroup *
-xapp_visibility_group_new (gboolean visible,
-                           gboolean sensitive,
-                           GSList *widgets);
+xapp_visibility_group_new (gboolean visible, + gboolean sensitive, + GSList *widgets);

Creates a new XAppVisibilityGroup.

If widgets is not NULL, adds these widgets to the group with the starting visibility and @@ -210,6 +218,29 @@

XA


+

xapp_visibility_group_free ()

+
void
+xapp_visibility_group_free (XAppVisibilityGroup *group);
+

Destroys the XAppVisibilityGroup.

+

Since 2.2.15

+
+

Parameters

+
+++++ + + + + + +

group

The XAppVisibilityGroup to free.

 
+
+
+
+

xapp_visibility_group_add_widget ()

void
 xapp_visibility_group_add_widget (XAppVisibilityGroup *group,
@@ -242,7 +273,7 @@ 

XA

xapp_visibility_group_remove_widget ()

-
gboolean
+
gboolean
 xapp_visibility_group_remove_widget (XAppVisibilityGroup *group,
                                      GtkWidget *widget);
@@ -324,7 +355,7 @@

XA

xapp_visibility_group_set_visible ()

void
 xapp_visibility_group_set_visible (XAppVisibilityGroup *group,
-                                   gboolean visible);
+ gboolean visible);

Set the visibility of all widgets in the group.

Parameters

@@ -353,7 +384,7 @@

XA

xapp_visibility_group_get_visible ()

-
gboolean
+
gboolean
 xapp_visibility_group_get_visible (XAppVisibilityGroup *group);

Get the visibility of the group.

There is no guarantee that all widgets in the group actually are @@ -385,7 +416,7 @@

XA

xapp_visibility_group_set_sensitive ()

void
 xapp_visibility_group_set_sensitive (XAppVisibilityGroup *group,
-                                     gboolean sensitive);
+ gboolean sensitive);

Set the sensitivity of all widgets in group.

Parameters

@@ -414,7 +445,7 @@

XA

xapp_visibility_group_get_sensitive ()

-
gboolean
+
gboolean
 xapp_visibility_group_get_sensitive (XAppVisibilityGroup *group);

Get the sensitivity of the group.

There is no guarantee that all widgets in the group actually are @@ -444,7 +475,7 @@

XA

xapp_visibility_group_get_widgets ()

-
GSList *
+
GSList *
 xapp_visibility_group_get_widgets (XAppVisibilityGroup *group);

Returns the members of the group or NULL if the group is empty.

@@ -475,7 +506,7 @@

XA

xapp_visibility_group_set_widgets ()

void
 xapp_visibility_group_set_widgets (XAppVisibilityGroup *group,
-                                   GSList *widgets);
+ GSList *widgets);

Parameters

@@ -522,17 +553,17 @@

XA

- + - + - + @@ -543,6 +574,6 @@

XA +
Generated by GTK-Doc V1.34.0 \ No newline at end of file diff --git a/docs/reference/annotation-glossary.html b/docs/reference/annotation-glossary.html index 5e0c2b67..29f712de 100644 --- a/docs/reference/annotation-glossary.html +++ b/docs/reference/annotation-glossary.html @@ -7,15 +7,13 @@ - +

GSList *widgets;

GSList *widgets;

The GtkWidget members of this group.

[element-type Gtk.Widget][transfer none][nullable]

gboolean visible;

gboolean visible;

The current visible state of the group. There is no guarantee that all members are actually in this state.

 

gboolean sensitive;

gboolean sensitive;

The current sensitive state of the group. There is no guarantee that all members are actually in this state.

 
-