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 peas.ConfigurableT;
26 
27 public  import gobject.ObjectG;
28 public  import gtk.Widget;
29 public  import peas.c.functions;
30 public  import peas.c.types;
31 
32 
33 /**
34  * Interface for configurable plugins.
35  */
36 public template ConfigurableT(TStruct)
37 {
38 	/** Get the main Gtk struct */
39 	public PeasGtkConfigurable* getConfigurableStruct(bool transferOwnership = false)
40 	{
41 		if (transferOwnership)
42 			ownedRef = false;
43 		return cast(PeasGtkConfigurable*)getStruct();
44 	}
45 
46 
47 	/**
48 	 * Creates the configure widget for the plugin. The returned widget
49 	 * should allow configuring all the relevant aspects of the plugin, and should
50 	 * allow instant-apply, as promoted by the Gnome Human Interface Guidelines.
51 	 *
52 	 * #PeasGtkPluginManager will embed the returned widget into a dialog box,
53 	 * but you shouldn't take this behaviour for granted as other implementations
54 	 * of a plugin manager UI might do otherwise.
55 	 *
56 	 * This method should always return a valid #GtkWidget instance, never %NULL.
57 	 *
58 	 * Returns: A #GtkWidget used for configuration.
59 	 */
60 	public Widget createConfigureWidget()
61 	{
62 		auto p = peas_gtk_configurable_create_configure_widget(getConfigurableStruct());
63 
64 		if(p is null)
65 		{
66 			return null;
67 		}
68 
69 		return ObjectG.getDObject!(Widget)(cast(GtkWidget*) p, true);
70 	}
71 }