Method

GtkRecentFilteradd_custom

since: 2.10

Declaration [src]

void
gtk_recent_filter_add_custom (
  GtkRecentFilter* filter,
  GtkRecentFilterFlags needed,
  GtkRecentFilterFunc func,
  gpointer data,
  GDestroyNotify data_destroy
)

Description [src]

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.

Available since: 2.10

Parameters

needed

Type: GtkRecentFilterFlags

Bitfield of flags indicating the information that the custom filter function needs.

func

Type: GtkRecentFilterFunc

Callback function; if the function returns TRUE, then the file will be displayed.

data

Type: gpointer

Data to pass to func.

The argument can be NULL.

The data is owned by the caller of the method.

data_destroy

Type: GDestroyNotify

Function to call to free data when it is no longer needed.