CtkFileFilter as CtkBuildable

The CtkFileFilter implementation of the CtkBuildable interface supports adding rules using the <mime-types>, <patterns> and <applications> elements and listing the rules within. Specifying a <mime-type> or <pattern> has the same effect as as calling ctk_file_filter_add_mime_type() or ctk_file_filter_add_pattern().

An example of a UI definition fragment specifying CtkFileFilter rules:

1
2
3
4
5
6
7
8
9
10

<object class="CtkFileFilter">
  <mime-types>
    <mime-type>text/plain</mime-type>
    <mime-type>image/ *</mime-type>
  </mime-types>
  <patterns>
    <pattern>*.txt</pattern>
    <pattern>*.png</pattern>
  </patterns>
</object>

CtkFileFilterFunc ()

gboolean
(*CtkFileFilterFunc) (const CtkFileFilterInfo *filter_info,
                      gpointer data);

The type of function that is used with custom filters, see ctk_file_filter_add_custom().

ctk_file_filter_new ()

CtkFileFilter *
ctk_file_filter_new (void);

Creates a new CtkFileFilter with no rules added to it. Such a filter doesn’t accept any files, so is not particularly useful until you add rules with ctk_file_filter_add_mime_type(), ctk_file_filter_add_pattern(), or ctk_file_filter_add_custom(). To create a filter that accepts any file, use:

1
2

CtkFileFilter *filter = ctk_file_filter_new ();
ctk_file_filter_add_pattern (filter, "*");

Since: 2.4

ctk_file_filter_set_name ()

void
ctk_file_filter_set_name (CtkFileFilter *filter,
                          const gchar *name);

Sets the human-readable name of the filter; this is the string that will be displayed in the file selector user interface if there is a selectable list of filters.

Since: 2.4

ctk_file_filter_get_name ()

const gchar *
ctk_file_filter_get_name (CtkFileFilter *filter);

Gets the human-readable name for the filter. See ctk_file_filter_set_name().

Since: 2.4

ctk_file_filter_add_mime_type ()

void
ctk_file_filter_add_mime_type (CtkFileFilter *filter,
                               const gchar *mime_type);

Adds a rule allowing a given mime type to filter .

Since: 2.4

ctk_file_filter_add_pattern ()

void
ctk_file_filter_add_pattern (CtkFileFilter *filter,
                             const gchar *pattern);

Adds a rule allowing a shell style glob to a filter.

Since: 2.4

ctk_file_filter_add_pixbuf_formats ()

void
ctk_file_filter_add_pixbuf_formats (CtkFileFilter *filter);

Adds a rule allowing image files in the formats supported by GdkPixbuf.

Since: 2.6

ctk_file_filter_add_custom ()

void
ctk_file_filter_add_custom (CtkFileFilter *filter,
                            CtkFileFilterFlags needed,
                            CtkFileFilterFunc func,
                            gpointer data,
                            GDestroyNotify notify);

Adds rule to a filter that allows files 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 CTK+ to avoid retrieving expensive information when it isn’t needed by the filter.

Since: 2.4

ctk_file_filter_get_needed ()

CtkFileFilterFlags
ctk_file_filter_get_needed (CtkFileFilter *filter);

Gets the fields that need to be filled in for the CtkFileFilterInfo passed to ctk_file_filter_filter()

This function will not typically be used by applications; it is intended principally for use in the implementation of CtkFileChooser.

Since: 2.4

ctk_file_filter_filter ()

gboolean
ctk_file_filter_filter (CtkFileFilter *filter,
                        const CtkFileFilterInfo *filter_info);

Tests whether a file should be displayed according to filter . The CtkFileFilterInfo filter_info should include the fields returned from ctk_file_filter_get_needed().

This function will not typically be used by applications; it is intended principally for use in the implementation of CtkFileChooser.

Since: 2.4

ctk_file_filter_new_from_gvariant ()

CtkFileFilter *
ctk_file_filter_new_from_gvariant (GVariant *variant);

Deserialize a file filter from an a{sv} variant in the format produced by ctk_file_filter_to_gvariant().

Since: 3.22

ctk_file_filter_to_gvariant ()

GVariant *
ctk_file_filter_to_gvariant (CtkFileFilter *filter);

Serialize a file filter to an a{sv} variant.

Since: 3.22

CtkFileFilter

typedef struct _CtkFileFilter CtkFileFilter;

struct CtkFileFilterInfo

struct CtkFileFilterInfo {
  CtkFileFilterFlags contains;

  const gchar *filename;
  const gchar *uri;
  const gchar *display_name;
  const gchar *mime_type;
};

A CtkFileFilterInfo is used to pass information about the tested file to ctk_file_filter_filter().

enum CtkFileFilterFlags

These flags indicate what parts of a CtkFileFilterInfo struct are filled or need to be filled.