docs/reference/gio/html/GDBusActionGroup.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>GDBusActionGroup</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GIO Reference Manual">
   8 <link rel="up" href="application.html" title="Application support">
   9 <link rel="prev" href="gio-GActionGroup-exporter.html" title="GActionGroup exporter">
  10 <link rel="next" href="GMenuModel.html" title="GMenuModel">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="gio-GActionGroup-exporter.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="application.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GIO Reference Manual</th>
  21 <td><a accesskey="n" href="GMenuModel.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#GDBusActionGroup.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#GDBusActionGroup.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#GDBusActionGroup.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29                    |
  30                   <a href="#GDBusActionGroup.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
  31 </td></tr>
  32 </table>
  33 <div class="refentry">
  34 <a name="GDBusActionGroup"></a><div class="titlepage"></div>
  35 <div class="refnamediv"><table width="100%"><tr>
  36 <td valign="top">
  37 <h2><span class="refentrytitle"><a name="GDBusActionGroup.top_of_page"></a>GDBusActionGroup</span></h2>
  38 <p>GDBusActionGroup — A D-Bus GActionGroup implementation</p>
  39 </td>
  40 <td valign="top" align="right"></td>
  41 </tr></table></div>
  42 <div class="refsynopsisdiv">
  43 <a name="GDBusActionGroup.synopsis"></a><h2>Synopsis</h2>
  44 <pre class="synopsis">                    <a class="link" href="GDBusActionGroup.html#GDBusActionGroup-struct" title="GDBusActionGroup">GDBusActionGroup</a>;
  45 <a class="link" href="GDBusActionGroup.html" title="GDBusActionGroup"><span class="returnvalue">GDBusActionGroup</span></a> *  <a class="link" href="GDBusActionGroup.html#g-dbus-action-group-get" title="g_dbus_action_group_get ()">g_dbus_action_group_get</a>             (<em class="parameter"><code><a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a> *connection</code></em>,
  46                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *bus_name</code></em>,
  47                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>);
  48 </pre>
  49 </div>
  50 <div class="refsect1">
  51 <a name="GDBusActionGroup.object-hierarchy"></a><h2>Object Hierarchy</h2>
  52 <pre class="synopsis">
  53   <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
  54    +----GDBusActionGroup
  55 </pre>
  56 </div>
  57 <div class="refsect1">
  58 <a name="GDBusActionGroup.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
  59 <p>
  60 GDBusActionGroup implements
  61  <a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> and  <a class="link" href="GRemoteActionGroup.html" title="GRemoteActionGroup">GRemoteActionGroup</a>.</p>
  62 </div>
  63 <div class="refsect1">
  64 <a name="GDBusActionGroup.description"></a><h2>Description</h2>
  65 <p>
  66 <a class="link" href="GDBusActionGroup.html" title="GDBusActionGroup"><span class="type">GDBusActionGroup</span></a> is an implementation of the <a class="link" href="GActionGroup.html" title="GActionGroup"><span class="type">GActionGroup</span></a>
  67 interface that can be used as a proxy for an action group
  68 that is exported over D-Bus with <a class="link" href="gio-GActionGroup-exporter.html#g-dbus-connection-export-action-group" title="g_dbus_connection_export_action_group ()"><code class="function">g_dbus_connection_export_action_group()</code></a>.
  69 </p>
  70 </div>
  71 <div class="refsect1">
  72 <a name="GDBusActionGroup.details"></a><h2>Details</h2>
  73 <div class="refsect2">
  74 <a name="GDBusActionGroup-struct"></a><h3>GDBusActionGroup</h3>
  75 <pre class="programlisting">typedef struct _GDBusActionGroup GDBusActionGroup;</pre>
  76 </div>
  77 <hr>
  78 <div class="refsect2">
  79 <a name="g-dbus-action-group-get"></a><h3>g_dbus_action_group_get ()</h3>
  80 <pre class="programlisting"><a class="link" href="GDBusActionGroup.html" title="GDBusActionGroup"><span class="returnvalue">GDBusActionGroup</span></a> *  g_dbus_action_group_get             (<em class="parameter"><code><a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a> *connection</code></em>,
  81                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *bus_name</code></em>,
  82                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>);</pre>
  83 <p>
  84 Obtains a <a class="link" href="GDBusActionGroup.html" title="GDBusActionGroup"><span class="type">GDBusActionGroup</span></a> for the action group which is exported at
  85 the given <em class="parameter"><code>bus_name</code></em> and <em class="parameter"><code>object_path</code></em>.
  86 </p>
  87 <p>
  88 The thread default main context is taken at the time of this call.
  89 All signals on the menu model (and any linked models) are reported
  90 with respect to this context.  All calls on the returned menu model
  91 (and linked models) must also originate from this same context, with
  92 the thread default main context unchanged.
  93 </p>
  94 <p>
  95 This call is non-blocking.  The returned action group may or may not
  96 already be filled in.  The correct thing to do is connect the signals
  97 for the action group to monitor for changes and then to call
  98 <a class="link" href="GActionGroup.html#g-action-group-list-actions" title="g_action_group_list_actions ()"><code class="function">g_action_group_list_actions()</code></a> to get the initial list.
  99 </p>
 100 <div class="variablelist"><table border="0">
 101 <col align="left" valign="top">
 102 <tbody>
 103 <tr>
 104 <td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
 105 <td>A <a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a>
 106 </td>
 107 </tr>
 108 <tr>
 109 <td><p><span class="term"><em class="parameter"><code>bus_name</code></em> :</span></p></td>
 110 <td>the bus name which exports the action group</td>
 111 </tr>
 112 <tr>
 113 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
 114 <td>the object path at which the action group is exported</td>
 115 </tr>
 116 <tr>
 117 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 118 <td>a <a class="link" href="GDBusActionGroup.html" title="GDBusActionGroup"><span class="type">GDBusActionGroup</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 119 </td>
 120 </tr>
 121 </tbody>
 122 </table></div>
 123 <p class="since">Since 2.32</p>
 124 </div>
 125 </div>
 126 <div class="refsect1">
 127 <a name="GDBusActionGroup.see-also"></a><h2>See Also</h2>
 128 <a class="link" href="gio-GActionGroup-exporter.html" title="GActionGroup exporter">GActionGroup exporter</a>
 129 </div>
 130 </div>
 131 <div class="footer">
 132 <hr>
 133           Generated by GTK-Doc V1.18</div>
 134 </body>
 135 </html>