Back to Seed Clases

Gtk

Classes

Interfaces

Structs

Unions

Enums

GObject.Object
parent-child marker GObject.InitiallyUnowned
Gtk.RecentFilter

Class Gtk.RecentFilter

Import line:	Gtk = imports.gi.Gtk;
GIR File:	Gtk-3.0.gir
C documentation:	GtkRecentFilter
Class :	RecentFilter
Implements:	Gtk.Buildable
Extends:	GObject.InitiallyUnowned

A GtkRecentFilter can be used to restrict the files being shown
in a GtkRecentChooser. Files can be filtered based on their name
(with gtk_recent_filter_add_pattern()), on their mime type (with
gtk_file_filter_add_mime_type()), on the application that has
registered them (with gtk_recent_filter_add_application()), or by
a custom filter function (with gtk_recent_filter_add_custom()).
Filtering by mime type handles aliasing and subclassing of mime
types; e.g. a filter for text/plain also matches a file with mime
type application/rtf, since application/rtf is a subclass of text/plain.
Note that GtkRecentFilter allows wildcards for the subtype of a
mime type, so you can e.g. filter for image/*.
Normally, filters are used by adding them to a GtkRecentChooser,
see gtk_recent_chooser_add_filter(), but it is also possible to
manually use a filter on a file with gtk_recent_filter_filter().
Recently used files are supported since GTK+ 2.10.

GtkRecentFilter as GtkBuildable

The GtkRecentFilter implementation of the GtkBuildable interface
supports adding rules using the <mime-types>, <patterns> and
<applications> elements and listing the rules within. Specifying
a <mime-type>, <pattern> or <application> is the same
as calling gtk_recent_filter_add_mime_type(), gtk_recent_filter_add_pattern()
or gtk_recent_filter_add_application().

A UI definition fragment specifying GtkRecentFilter rules

]]>

Properties
Properties		Defined By
	g_type_instance : GObject.TypeInstance	GObject.InitiallyUnowned
	qdata : GLib.Data read only	GObject.InitiallyUnowned
	ref_count : guint32 read only	GObject.InitiallyUnowned

Methods / Constructors
Method / Constructor		Defined By
	new Gtk.RecentFilter (Object *properties) Create a new Gtk.RecentFilter Create a new Gtk.RecentFilter Parameters: Object properties*
	add_age (gint32 *days) : none Adds a rule that allows resources based on their age - that is, the number of days elapsed since they were last modified. Adds a rule that allows resources based on their age - that is, the number of days elapsed since they were last modified. Parameters: gint32 days* Required (not null) number of days Returns: none	Gtk.RecentFilter
	add_application (String *application) : none Adds a rule that allows resources based on the name of the application that has registered them. Adds a rule that allows resources based on the name of the application that has registered them. Parameters: String application* Required (not null) an application name Returns: none	Gtk.RecentFilter
	add_child (Builder *builder, Object child, String type) : none Adds a child to buildable. Adds a child to buildable. type* is an optional string describing how the child should be added. Parameters: Gtk.Builder builder Required (not null) a GtkBuilder GObject.Object child Required (not null) child to add String type kind of child or NULL Returns: none	Gtk.Buildable
	add_custom (RecentFilterFlags *needed, Function func, void *data, Function data_destroy) : none Adds a rule to a filter that allows resources based on a custom callback function. Adds a rule to a filter that allows resources based on a custom callback function. The bitfield needed* which is passed in provides information about what sorts of information that the filter function needs; this allows GTK+ to avoid retrieving expensive information when it isn't needed by the filter. Parameters: Gtk.RecentFilterFlags needed Required (not null) bitfield of flags indicating the information that the custom filter function needs. Function (RecentFilterInfo *filter_info, void *user_data) : none Required (not null) callback function; if the function returns TRUE, then the file will be displayed. void data Required (not null) data to pass to func Function (void* *data) : none Required (not null) function to call to free data* when it is no longer needed. Returns: none	Gtk.RecentFilter
	add_group (String *group) : none Adds a rule that allows resources based on the name of the group to which they belong Adds a rule that allows resources based on the name of the group to which they belong Parameters: String group* Required (not null) a group name Returns: none	Gtk.RecentFilter
	add_mime_type (String *mime_type) : none Adds a rule that allows resources based on their registered MIME type. Adds a rule that allows resources based on their registered MIME type. Parameters: String mime_type* Required (not null) a MIME type Returns: none	Gtk.RecentFilter
	add_pattern (String *pattern) : none Adds a rule that allows resources based on a pattern matching their display name. Adds a rule that allows resources based on a pattern matching their display name. Parameters: String pattern* Required (not null) a file pattern Returns: none	Gtk.RecentFilter
	add_pixbuf_formats () : none Adds a rule allowing image files in the formats supported by GdkPixbuf. Adds a rule allowing image files in the formats supported by GdkPixbuf. Returns: none	Gtk.RecentFilter
	construct_child (Builder *builder, String name) : GObject.Object Constructs a child of buildable* with the name name. Constructs a child of buildable with the name name. GtkBuilder calls this function if a "constructor" has been specified in the UI definition. Parameters: Gtk.Builder builder Required (not null) GtkBuilder used to construct this object String name Required (not null) name of child to construct Returns: GObject.Object the constructed child	Gtk.Buildable
	custom_finished (Builder *builder, Object child, String tagname, void *data) : none This is similar to gtk_buildable_parser_finished() but is called once for each custom tag handled by the buildable. This is similar to gtk_buildable_parser_finished() but is called once for each custom tag handled by the buildable. Parameters: Gtk.Builder builder* Required (not null) a GtkBuilder GObject.Object child child object or NULL for non-child tags String tagname Required (not null) the name of the tag void* data Required (not null) user data created in custom_tag_start Returns: none	Gtk.Buildable
	custom_tag_end (Builder *builder, Object child, String tagname, void *data) : none This is called at the end of each custom element handled by the buildable. This is called at the end of each custom element handled by the buildable. Parameters: Gtk.Builder builder* Required (not null) GtkBuilder used to construct this object GObject.Object child child object or NULL for non-child tags String tagname Required (not null) name of tag void* data Required (not null) user data that will be passed in to parser functions Returns: none	Gtk.Buildable
	custom_tag_start (Builder *builder, Object child, String tagname, Object out_values) : gboolean This is called for each unknown element under <child>. This is called for each unknown element under <child>. if it doesn't. Parameters: Gtk.Builder builder* Required (not null) a GtkBuilder used to construct this object GObject.Object child child object or NULL for non-child tags String tagname Required (not null) name of tag Object out_values GLib.MarkupParser parser void* data Returns: gboolean TRUE if a object has a custom implementation, FALSE	Gtk.Buildable
	filter (RecentFilterInfo *filter_info) : gboolean Tests whether a file should be displayed according to filter. Tests whether a file should be displayed according to filter. The GtkRecentFilterInfo* structure filter_info should include the fields returned from gtk_recent_filter_get_needed(). This function will not typically be used by applications; it is intended principally for use in the implementation of GtkRecentChooser. Parameters: Gtk.RecentFilterInfo filter_info Required (not null) a GtkRecentFilterInfo structure containing information about a recently used resource Returns: gboolean TRUE if the file should be displayed	Gtk.RecentFilter
	get_internal_child (Builder *builder, String childname) : GObject.Object Get the internal child called childname* of the buildable object. Get the internal child called childname of the buildable object. Parameters: Gtk.Builder builder Required (not null) a GtkBuilder String childname Required (not null) name of child Returns: GObject.Object the internal child of the buildable object	Gtk.Buildable
	get_name () : String Gets the human-readable name for the filter. Gets the human-readable name for the filter. See gtk_recent_filter_set_name(). is owned by the filter object and should not be freed. Returns: String the name of the filter, or NULL. The returned string	Gtk.RecentFilter
	get_needed () : Gtk.RecentFilterFlags Gets the fields that need to be filled in for the structure passed to gtk_recent_filter_filter() This function will not typically be used by applications; it is intended principally for use in the implementation of GtkRecentChooser. Gets the fields that need to be filled in for the structure passed to gtk_recent_filter_filter() This function will not typically be used by applications; it is intended principally for use in the implementation of GtkRecentChooser. calling gtk_recent_filter_filter() Returns: Gtk.RecentFilterFlags bitfield of flags indicating needed fields when	Gtk.RecentFilter
	parser_finished (Builder *builder) : none Called when the builder finishes the parsing of a GtkBuilder UI definition. Called when the builder finishes the parsing of a GtkBuilder UI definition. Note that this will be called once for each time gtk_builder_add_from_file() or gtk_builder_add_from_string() is called on a builder. Parameters: Gtk.Builder builder* Required (not null) a GtkBuilder Returns: none	Gtk.Buildable
	set_buildable_property (Builder *builder, String name, Value value) : none Sets the property name name* to value on the buildable object. Sets the property name name to value on the buildable object. Parameters: Gtk.Builder builder Required (not null) a GtkBuilder String name Required (not null) name of property GObject.Value value Required (not null) value of property Returns: none	Gtk.Buildable
	set_name (String *name) : none Sets the human-readable name of the filter; this is the string that will be displayed in the recently used resources selector user interface if there is a selectable list of filters. Sets the human-readable name of the filter; this is the string that will be displayed in the recently used resources selector user interface if there is a selectable list of filters. Parameters: String name* Required (not null) then human readable name of filter Returns: none	Gtk.RecentFilter

Events
None

Used by These Methods / Signals / Properties
Class / Namespace	Method / Signal / Properties
Gtk.RecentChooser Property	filter : Gtk.RecentFilter The GtkRecentFilter object to be used when displaying the recently used resources.
Gtk.RecentChooser Method	add_filter (RecentFilter *filter) : none Adds filter* to the list of GtkRecentFilter objects held by chooser.
Gtk.RecentChooser Method	get_filter () : Gtk.RecentFilter Gets the GtkRecentFilter object currently used by chooser to affect the display of the recently used resources.
Gtk.RecentChooser Method	remove_filter (RecentFilter *filter) : none Removes filter* from the list of GtkRecentFilter objects held by chooser.
Gtk.RecentChooser Method	set_filter (RecentFilter *filter) : none Sets filter* as the current GtkRecentFilter object used by chooser to affect the displayed recently used resources.