1 /*
2  * This file is part of gtkD.
3  *
4  * gtkD is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU Lesser General Public License
6  * as published by the Free Software Foundation; either version 3
7  * of the License, or (at your option) any later version, with
8  * some exceptions, please read the COPYING file.
9  *
10  * gtkD is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General Public License
16  * along with gtkD; if not, write to the Free Software
17  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
18  */
19 
20 // generated automatically - do not change
21 // find conversion definition on APILookup.txt
22 // implement new conversion functionalities on the wrap.utils pakage
23 
24 
25 module gio.DBusObjectT;
26 
27 public  import gio.DBusInterfaceIF;
28 public  import gio.c.functions;
29 public  import gio.c.types;
30 public  import glib.ListG;
31 public  import glib.Str;
32 public  import gobject.ObjectG;
33 public  import gobject.Signals;
34 public  import gtkc.giotypes;
35 public  import std.algorithm;
36 
37 
38 /**
39  * The #GDBusObject type is the base type for D-Bus objects on both
40  * the service side (see #GDBusObjectSkeleton) and the client side
41  * (see #GDBusObjectProxy). It is essentially just a container of
42  * interfaces.
43  */
44 public template DBusObjectT(TStruct)
45 {
46 	/** Get the main Gtk struct */
47 	public GDBusObject* getDBusObjectStruct(bool transferOwnership = false)
48 	{
49 		if (transferOwnership)
50 			ownedRef = false;
51 		return cast(GDBusObject*)getStruct();
52 	}
53 
54 
55 	/**
56 	 * Gets the D-Bus interface with name @interface_name associated with
57 	 * @object, if any.
58 	 *
59 	 * Params:
60 	 *     interfaceName = A D-Bus interface name.
61 	 *
62 	 * Returns: %NULL if not found, otherwise a
63 	 *     #GDBusInterface that must be freed with g_object_unref().
64 	 *
65 	 * Since: 2.30
66 	 */
67 	public DBusInterfaceIF getInterface(string interfaceName)
68 	{
69 		auto p = g_dbus_object_get_interface(getDBusObjectStruct(), Str.toStringz(interfaceName));
70 
71 		if(p is null)
72 		{
73 			return null;
74 		}
75 
76 		return ObjectG.getDObject!(DBusInterfaceIF)(cast(GDBusInterface*) p, true);
77 	}
78 
79 	/**
80 	 * Gets the D-Bus interfaces associated with @object.
81 	 *
82 	 * Returns: A list of #GDBusInterface instances.
83 	 *     The returned list must be freed by g_list_free() after each element has been freed
84 	 *     with g_object_unref().
85 	 *
86 	 * Since: 2.30
87 	 */
88 	public ListG getInterfaces()
89 	{
90 		auto p = g_dbus_object_get_interfaces(getDBusObjectStruct());
91 
92 		if(p is null)
93 		{
94 			return null;
95 		}
96 
97 		return new ListG(cast(GList*) p, true);
98 	}
99 
100 	/**
101 	 * Gets the object path for @object.
102 	 *
103 	 * Returns: A string owned by @object. Do not free.
104 	 *
105 	 * Since: 2.30
106 	 */
107 	public string getObjectPath()
108 	{
109 		return Str.toString(g_dbus_object_get_object_path(getDBusObjectStruct()));
110 	}
111 
112 	/**
113 	 * Emitted when @interface is added to @object.
114 	 *
115 	 * Params:
116 	 *     iface = The #GDBusInterface that was added.
117 	 *
118 	 * Since: 2.30
119 	 */
120 	gulong addOnInterfaceAdded(void delegate(DBusInterfaceIF, DBusObjectIF) dlg, ConnectFlags connectFlags=cast(ConnectFlags)0)
121 	{
122 		return Signals.connect(this, "interface-added", dlg, connectFlags ^ ConnectFlags.SWAPPED);
123 	}
124 
125 	/**
126 	 * Emitted when @interface is removed from @object.
127 	 *
128 	 * Params:
129 	 *     iface = The #GDBusInterface that was removed.
130 	 *
131 	 * Since: 2.30
132 	 */
133 	gulong addOnInterfaceRemoved(void delegate(DBusInterfaceIF, DBusObjectIF) dlg, ConnectFlags connectFlags=cast(ConnectFlags)0)
134 	{
135 		return Signals.connect(this, "interface-removed", dlg, connectFlags ^ ConnectFlags.SWAPPED);
136 	}
137 }