4
4
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5
5
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
6
<meta name="generator" content="Doxygen 1.8.3.1"/>
6
7
<title>glibmm: Gio::DBus::SubtreeVTable Class Reference</title>
7
8
<link href="tabs.css" rel="stylesheet" type="text/css"/>
8
9
<script type="text/javascript" src="jquery.js"></script>
54
55
<a href="#pub-types">Public Types</a> |
55
56
<a href="#pub-methods">Public Member Functions</a> |
56
57
<a href="#pro-attribs">Protected Attributes</a> |
57
<a href="classGio_1_1DBus_1_1SubtreeVTable-members.html">List of all members</a> </div>
58
<a href="classGio_1_1DBus_1_1SubtreeVTable-members.html">List of all members</a> </div>
58
59
<div class="headertitle">
59
<div class="title">Gio::DBus::SubtreeVTable Class Reference<div class="ingroups"><a class="el" href="group__DBus.html">D-Bus API</a></div></div> </div>
60
<div class="title">Gio::DBus::SubtreeVTable Class Reference<div class="ingroups"><a class="el" href="group__DBus.html">D-Bus API</a></div></div> </div>
60
61
</div><!--header-->
61
62
<div class="contents">
63
<p>This represents a virtual table for subtrees registered with <a class="el" href="classGio_1_1DBus_1_1Connection.html#ade98c63ff3e2ce7906ca4a2f63849e07" title="Registers a whole subtree of “dynamic” objects.">Gio::DBus::Connection::register_subtree()</a>. <a href="classGio_1_1DBus_1_1SubtreeVTable.html#details">More...</a></p>
64
<p>This represents a virtual table for subtrees registered with <a class="el" href="classGio_1_1DBus_1_1Connection.html#ade98c63ff3e2ce7906ca4a2f63849e07" title="Registers a whole subtree of “dynamic” objects.">Gio::DBus::Connection::register_subtree()</a>.
65
<a href="classGio_1_1DBus_1_1SubtreeVTable.html#details">More...</a></p>
65
67
<p><code>#include <giomm/dbussubtreevtable.h></code></p>
66
68
<table class="memberdecls">
72
74
< <a class="el" href="classGio_1_1DBus_1_1Connection.html">Connection</a> >&, const <br class="typebreak"/>
73
75
<a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&, const <br class="typebreak"/>
74
76
<a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1SubtreeVTable.html#af740e180d81b2a9277c10493de9f5181">SlotSubtreeEnumerate</a></td></tr>
75
<tr class="memdesc:af740e180d81b2a9277c10493de9f5181"><td class="mdescLeft"> </td><td class="mdescRight">The type for a slot which handles enumerating child nodes. <a href="#af740e180d81b2a9277c10493de9f5181"></a><br/></td></tr>
77
<tr class="memdesc:af740e180d81b2a9277c10493de9f5181"><td class="mdescLeft"> </td><td class="mdescRight">The type for a slot which handles enumerating child nodes. <a href="#af740e180d81b2a9277c10493de9f5181">More...</a><br/></td></tr>
76
78
<tr class="separator:af740e180d81b2a9277c10493de9f5181"><td class="memSeparator" colspan="2"> </td></tr>
77
79
<tr class="memitem:a096df119a5f4991b4cdbdd5858638742"><td class="memItemLeft" align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a><br class="typebreak"/>
78
80
< std::vector< <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/>
82
84
<a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&, const <br class="typebreak"/>
83
85
<a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&, const <br class="typebreak"/>
84
86
<a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1SubtreeVTable.html#a096df119a5f4991b4cdbdd5858638742">SlotSubtreeIntrospect</a></td></tr>
85
<tr class="memdesc:a096df119a5f4991b4cdbdd5858638742"><td class="mdescLeft"> </td><td class="mdescRight">The type for a slot which handles introspecting a child node. <a href="#a096df119a5f4991b4cdbdd5858638742"></a><br/></td></tr>
87
<tr class="memdesc:a096df119a5f4991b4cdbdd5858638742"><td class="mdescLeft"> </td><td class="mdescRight">The type for a slot which handles introspecting a child node. <a href="#a096df119a5f4991b4cdbdd5858638742">More...</a><br/></td></tr>
86
88
<tr class="separator:a096df119a5f4991b4cdbdd5858638742"><td class="memSeparator" colspan="2"> </td></tr>
87
89
<tr class="memitem:a4f483dbeb3fd1712c81e4a78b213a32a"><td class="memItemLeft" align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>< const <br class="typebreak"/>
88
90
<a class="el" href="classGio_1_1DBus_1_1InterfaceVTable.html">InterfaceVTable</a>*, const <br class="typebreak"/>
91
93
&, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> <br class="typebreak"/>
92
94
&, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> <br class="typebreak"/>
93
95
&, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1SubtreeVTable.html#a4f483dbeb3fd1712c81e4a78b213a32a">SlotSubtreeDispatch</a></td></tr>
94
<tr class="memdesc:a4f483dbeb3fd1712c81e4a78b213a32a"><td class="mdescLeft"> </td><td class="mdescRight">The type for a slot which handles dispatching a remote call on a child node. <a href="#a4f483dbeb3fd1712c81e4a78b213a32a"></a><br/></td></tr>
96
<tr class="memdesc:a4f483dbeb3fd1712c81e4a78b213a32a"><td class="mdescLeft"> </td><td class="mdescRight">The type for a slot which handles dispatching a remote call on a child node. <a href="#a4f483dbeb3fd1712c81e4a78b213a32a">More...</a><br/></td></tr>
95
97
<tr class="separator:a4f483dbeb3fd1712c81e4a78b213a32a"><td class="memSeparator" colspan="2"> </td></tr>
96
98
</table><table class="memberdecls">
97
99
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
98
100
Public Member Functions</h2></td></tr>
99
101
<tr class="memitem:ab142d859127f32a04de93cb4026c085e"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1SubtreeVTable.html#ab142d859127f32a04de93cb4026c085e">SubtreeVTable</a> (const <a class="el" href="classGio_1_1DBus_1_1SubtreeVTable.html#af740e180d81b2a9277c10493de9f5181">SlotSubtreeEnumerate</a>& slot_enumerate, const <a class="el" href="classGio_1_1DBus_1_1SubtreeVTable.html#a096df119a5f4991b4cdbdd5858638742">SlotSubtreeIntrospect</a>& slot_introspect=<a class="el" href="classGio_1_1DBus_1_1SubtreeVTable.html#a096df119a5f4991b4cdbdd5858638742">SlotSubtreeIntrospect</a>(), const <a class="el" href="classGio_1_1DBus_1_1SubtreeVTable.html#a4f483dbeb3fd1712c81e4a78b213a32a">SlotSubtreeDispatch</a>& slot_dispatch=<a class="el" href="classGio_1_1DBus_1_1SubtreeVTable.html#a4f483dbeb3fd1712c81e4a78b213a32a">SlotSubtreeDispatch</a>())</td></tr>
100
<tr class="memdesc:ab142d859127f32a04de93cb4026c085e"><td class="mdescLeft"> </td><td class="mdescRight">Constructs a new <a class="el" href="classGio_1_1DBus_1_1SubtreeVTable.html" title="This represents a virtual table for subtrees registered with Gio::DBus::Connection::register_subtree(...">SubtreeVTable</a> using specified slots. <a href="#ab142d859127f32a04de93cb4026c085e"></a><br/></td></tr>
102
<tr class="memdesc:ab142d859127f32a04de93cb4026c085e"><td class="mdescLeft"> </td><td class="mdescRight">Constructs a new <a class="el" href="classGio_1_1DBus_1_1SubtreeVTable.html" title="This represents a virtual table for subtrees registered with Gio::DBus::Connection::register_subtree(...">SubtreeVTable</a> using specified slots. <a href="#ab142d859127f32a04de93cb4026c085e">More...</a><br/></td></tr>
101
103
<tr class="separator:ab142d859127f32a04de93cb4026c085e"><td class="memSeparator" colspan="2"> </td></tr>
102
104
<tr class="memitem:a4a8853420d435f12b7402e293a2ac1f4"><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1SubtreeVTable.html#a4a8853420d435f12b7402e293a2ac1f4">~SubtreeVTable</a> ()</td></tr>
103
<tr class="memdesc:a4a8853420d435f12b7402e293a2ac1f4"><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <a href="#a4a8853420d435f12b7402e293a2ac1f4"></a><br/></td></tr>
105
<tr class="memdesc:a4a8853420d435f12b7402e293a2ac1f4"><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <a href="#a4a8853420d435f12b7402e293a2ac1f4">More...</a><br/></td></tr>
104
106
<tr class="separator:a4a8853420d435f12b7402e293a2ac1f4"><td class="memSeparator" colspan="2"> </td></tr>
105
107
<tr class="memitem:af887da7b2fca079327636e969fcdb00e"><td class="memItemLeft" align="right" valign="top">GDBusSubtreeVTable* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1SubtreeVTable.html#af887da7b2fca079327636e969fcdb00e">gobj</a> ()</td></tr>
106
<tr class="memdesc:af887da7b2fca079327636e969fcdb00e"><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C object. <a href="#af887da7b2fca079327636e969fcdb00e"></a><br/></td></tr>
108
<tr class="memdesc:af887da7b2fca079327636e969fcdb00e"><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C object. <a href="#af887da7b2fca079327636e969fcdb00e">More...</a><br/></td></tr>
107
109
<tr class="separator:af887da7b2fca079327636e969fcdb00e"><td class="memSeparator" colspan="2"> </td></tr>
108
110
<tr class="memitem:a51e9295b3dd3d79923a57b60dc29d4b0"><td class="memItemLeft" align="right" valign="top">const GDBusSubtreeVTable* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1SubtreeVTable.html#a51e9295b3dd3d79923a57b60dc29d4b0">gobj</a> () const </td></tr>
109
<tr class="memdesc:a51e9295b3dd3d79923a57b60dc29d4b0"><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C object. <a href="#a51e9295b3dd3d79923a57b60dc29d4b0"></a><br/></td></tr>
111
<tr class="memdesc:a51e9295b3dd3d79923a57b60dc29d4b0"><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C object. <a href="#a51e9295b3dd3d79923a57b60dc29d4b0">More...</a><br/></td></tr>
110
112
<tr class="separator:a51e9295b3dd3d79923a57b60dc29d4b0"><td class="memSeparator" colspan="2"> </td></tr>
111
113
</table><table class="memberdecls">
112
114
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pro-attribs"></a>
123
125
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
124
126
<div class="textblock"><p>This represents a virtual table for subtrees registered with <a class="el" href="classGio_1_1DBus_1_1Connection.html#ade98c63ff3e2ce7906ca4a2f63849e07" title="Registers a whole subtree of “dynamic” objects.">Gio::DBus::Connection::register_subtree()</a>. </p>
125
127
<p>The only correct use of this class is to declare a global instance of it (or an instance local to the main function) and pass pointers to the instance to the methods that require such a parameter. The instance can be used for multiple registrations and the memory it uses will be freed at the end of execution. Any other use (like creating an instance local to a function and using that) may cause memory leaks or errors (if the instance is destroyed too early).</p>
126
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000152">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
128
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000154">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
127
129
</div><h2 class="groupheader">Member Typedef Documentation</h2>
128
130
<a class="anchor" id="a4f483dbeb3fd1712c81e4a78b213a32a"></a>
129
131
<div class="memitem">
142
144
<div class="line"><a class="code" href="classGlib_1_1RefPtr.html" title="RefPtr<> is a reference-counting shared smartpointer.">Glib::RefPtr<Gio::DBus::Connection></a>& connection, <span class="keyword">const</span> <a class="code" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>&</div>
143
145
<div class="line">sender, <span class="keyword">const</span> <a class="code" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& object_path, <span class="keyword">const</span> <a class="code" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>&</div>
144
146
<div class="line">interface_name, <span class="keyword">const</span> <a class="code" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& node);</div>
145
</div><!-- fragment --> </div>
147
</div><!-- fragment -->
147
150
<a class="anchor" id="af740e180d81b2a9277c10493de9f5181"></a>
148
151
<div class="memitem">
155
158
</div><div class="memdoc">
157
160
<p>The type for a slot which handles enumerating child nodes. </p>
158
<p>This slot is called when generating introspection data and also when preparing to dispatch incoming messages in the event that the <a class="el" href="group__giommEnums.html#gga57ca559dd8d3b93c96c4828cb457b975a0765ee03c950bcaf808a9c178261ec53">Gio::DBus::SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES</a> flag is not specified (ie: to verify that the object path is valid).</p>
161
<p>This slot is called when generating introspection data and also when preparing to dispatch incoming messages in the event that the <a class="el" href="group__giommEnums.html#gga57ca559dd8d3b93c96c4828cb457b975a0765ee03c950bcaf808a9c178261ec53" title="Method calls to objects not in the enumerated range will still be dispatched.">Gio::DBus::SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES</a> flag is not specified (ie: to verify that the object path is valid).</p>
159
162
<p>Hierarchies are not supported; the items that you return should not contain the '/' character.</p>
160
163
<p>For example, </p>
161
164
<div class="fragment"><div class="line">std::vector<Glib::ustring> on_subtree_enumerate(<span class="keyword">const</span></div>
162
165
<div class="line"><a class="code" href="classGlib_1_1RefPtr.html" title="RefPtr<> is a reference-counting shared smartpointer.">Glib::RefPtr<Gio::DBus::Connection></a>& connection, <span class="keyword">const</span> <a class="code" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>&</div>
163
166
<div class="line">sender, <span class="keyword">const</span> <a class="code" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& object_path);</div>
164
</div><!-- fragment --> </div>
167
</div><!-- fragment -->
166
170
<a class="anchor" id="a096df119a5f4991b4cdbdd5858638742"></a>
167
171
<div class="memitem">
182
186
<div class="line">on_subtree_introspect(<span class="keyword">const</span> <a class="code" href="classGlib_1_1RefPtr.html" title="RefPtr<> is a reference-counting shared smartpointer.">Glib::RefPtr<Gio::DBus::Connection></a>&</div>
183
187
<div class="line">connection, <span class="keyword">const</span> <a class="code" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& sender, <span class="keyword">const</span> <a class="code" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>&</div>
184
188
<div class="line">object_path, <span class="keyword">const</span> <a class="code" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& node);</div>
185
</div><!-- fragment --> </div>
189
</div><!-- fragment -->
187
192
<h2 class="groupheader">Constructor & Destructor Documentation</h2>
188
193
<a class="anchor" id="ab142d859127f32a04de93cb4026c085e"></a>