Top |
gboolean | (*GtkRecentFilterFunc) () |
GtkRecentFilter * | gtk_recent_filter_new () |
const gchar * | gtk_recent_filter_get_name () |
void | gtk_recent_filter_set_name () |
void | gtk_recent_filter_add_mime_type () |
void | gtk_recent_filter_add_pattern () |
void | gtk_recent_filter_add_pixbuf_formats () |
void | gtk_recent_filter_add_application () |
void | gtk_recent_filter_add_group () |
void | gtk_recent_filter_add_age () |
void | gtk_recent_filter_add_custom () |
GtkRecentFilterFlags | gtk_recent_filter_get_needed () |
gboolean | gtk_recent_filter_filter () |
gboolean (*GtkRecentFilterFunc) (const GtkRecentFilterInfo *filter_info
,gpointer user_data
);
GtkRecentFilter *
gtk_recent_filter_new (void
);
Creates a new GtkRecentFilter with no rules added to it.
Such filter does not accept any recently used resources, so is not
particularly useful until you add rules with
gtk_recent_filter_add_pattern()
, gtk_recent_filter_add_mime_type()
,
gtk_recent_filter_add_application()
, gtk_recent_filter_add_age()
.
To create a filter that accepts any recently used resource, use:
1 2 |
GtkRecentFilter *filter = gtk_recent_filter_new (); gtk_recent_filter_add_pattern (filter, "*"); |
Since: 2.10
const gchar *
gtk_recent_filter_get_name (GtkRecentFilter *filter
);
Gets the human-readable name for the filter.
See gtk_recent_filter_set_name()
.
the name of the filter, or NULL
. The returned string
is owned by the filter object and should not be freed.
Since: 2.10
void gtk_recent_filter_set_name (GtkRecentFilter *filter
,const gchar *name
);
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.
Since: 2.10
void gtk_recent_filter_add_mime_type (GtkRecentFilter *filter
,const gchar *mime_type
);
Adds a rule that allows resources based on their registered MIME type.
Since: 2.10
void gtk_recent_filter_add_pattern (GtkRecentFilter *filter
,const gchar *pattern
);
Adds a rule that allows resources based on a pattern matching their display name.
Since: 2.10
void
gtk_recent_filter_add_pixbuf_formats (GtkRecentFilter *filter
);
Adds a rule allowing image files in the formats supported by GdkPixbuf.
Since: 2.10
void gtk_recent_filter_add_application (GtkRecentFilter *filter
,const gchar *application
);
Adds a rule that allows resources based on the name of the application that has registered them.
Since: 2.10
void gtk_recent_filter_add_group (GtkRecentFilter *filter
,const gchar *group
);
Adds a rule that allows resources based on the name of the group to which they belong
Since: 2.10
void gtk_recent_filter_add_age (GtkRecentFilter *filter
,gint days
);
Adds a rule that allows resources based on their age - that is, the number of days elapsed since they were last modified.
Since: 2.10
void gtk_recent_filter_add_custom (GtkRecentFilter *filter
,GtkRecentFilterFlags needed
,GtkRecentFilterFunc func
,gpointer data
,GDestroyNotify data_destroy
);
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.
filter |
||
needed |
bitfield of flags indicating the information that the custom filter function needs. |
|
func |
callback function; if the function returns |
|
data |
data to pass to |
|
data_destroy |
function to call to free |
Since: 2.10
GtkRecentFilterFlags
gtk_recent_filter_get_needed (GtkRecentFilter *filter
);
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.
Since: 2.10
gboolean gtk_recent_filter_filter (GtkRecentFilter *filter
,const GtkRecentFilterInfo *filter_info
);
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.
filter |
||
filter_info |
a GtkRecentFilterInfo structure containing information about a recently used resource |
Since: 2.10