X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gtk%2Fgtkappchooser.c;h=e4037d2c1e0fde5e9772b19c2218012dfa36c2e1;hb=a960230a20f86ebb31594a40132e341c1b7a7c21;hp=74b552bb38d36ee9a96ccf4edbcdb1ac5b2d1ce8;hpb=05bb715c51d8963e47a8b34f94b14f0748f6b8d8;p=~andy%2Fgtk
diff --git a/gtk/gtkappchooser.c b/gtk/gtkappchooser.c
index 74b552bb3..e4037d2c1 100644
--- a/gtk/gtkappchooser.c
+++ b/gtk/gtkappchooser.c
@@ -14,14 +14,37 @@
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
- * License along with the Gnome Library; see the file COPYING.LIB. If not,
- * write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * License along with this library. If not, see .
*
* Authors: Cosimo Cecchi
*/
-#include
+/**
+ * SECTION:gtkappchooser
+ * @Title: GtkAppChooser
+ * @Short_description: Interface implemented by widgets for choosing an application
+ * @See_also: #GAppInfo
+ *
+ * #GtkAppChooser is an interface that can be implemented by widgets which
+ * allow the user to choose an application (typically for the purpose of
+ * opening a file). The main objects that implement this interface are
+ * #GtkAppChooserWidget, #GtkAppChooserDialog and #GtkAppChooserButton.
+ *
+ * Applications are represented by GIO #GAppInfo objects here.
+ * GIO has a concept of recommended and fallback applications for a
+ * given content type. Recommended applications are those that claim
+ * to handle the content type itself, while fallback also includes
+ * applications that handle a more generic content type. GIO also
+ * knows the default and last-used application for a given content
+ * type. The #GtkAppChooserWidget provides detailed control over
+ * whether the shown list of applications should include default,
+ * recommended or fallback applications.
+ *
+ * To obtain the application that has been selected in a #GtkAppChooser,
+ * use gtk_app_chooser_get_app_info().
+ */
+
+#include "config.h"
#include "gtkappchooser.h"
@@ -38,15 +61,34 @@ gtk_app_chooser_default_init (GtkAppChooserIface *iface)
{
GParamSpec *pspec;
+ /**
+ * GtkAppChooser:content-type:
+ *
+ * The content type of the #GtkAppChooser object.
+ *
+ * See GContentType
+ * for more information about content types.
+ */
pspec = g_param_spec_string ("content-type",
- P_("Content type"),
- P_("The content type used by the open with object"),
- NULL,
- G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE |
- G_PARAM_STATIC_STRINGS);
+ P_("Content type"),
+ P_("The content type used by the open with object"),
+ NULL,
+ G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE |
+ G_PARAM_STATIC_STRINGS);
g_object_interface_install_property (iface, pspec);
}
+
+/**
+ * gtk_app_chooser_get_content_type:
+ * @self: a #GtkAppChooser
+ *
+ * Returns the current value of the #GtkAppChooser:content-type property.
+ *
+ * Returns: the content type of @self. Free with g_free()
+ *
+ * Since: 3.0
+ */
gchar *
gtk_app_chooser_get_content_type (GtkAppChooser *self)
{
@@ -55,18 +97,37 @@ gtk_app_chooser_get_content_type (GtkAppChooser *self)
g_return_val_if_fail (GTK_IS_APP_CHOOSER (self), NULL);
g_object_get (self,
- "content-type", &retval,
- NULL);
+ "content-type", &retval,
+ NULL);
return retval;
}
+/**
+ * gtk_app_chooser_get_app_info:
+ * @self: a #GtkAppChooser
+ *
+ * Returns the currently selected application.
+ *
+ * Returns: (transfer full): a #GAppInfo for the currently selected
+ * application, or %NULL if none is selected. Free with g_object_unref()
+ *
+ * Since: 3.0
+ */
GAppInfo *
gtk_app_chooser_get_app_info (GtkAppChooser *self)
{
return GTK_APP_CHOOSER_GET_IFACE (self)->get_app_info (self);
}
+/**
+ * gtk_app_chooser_refresh:
+ * @self: a #GtkAppChooser
+ *
+ * Reloads the list of applications.
+ *
+ * Since: 3.0
+ */
void
gtk_app_chooser_refresh (GtkAppChooser *self)
{