Package org.gnome.gtk

Class FileFilter

java.lang.Object

io.github.jwharm.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gtk.Filter

org.gnome.gtk.FileFilter

All Implemented Interfaces:

Proxy, Buildable

@Generated("io.github.jwharm.JavaGI")
public class FileFilter
extends Filter
implements Buildable

GtkFileFilter filters files by name or mime type.

GtkFileFilter can be used to restrict the files being shown in a GtkFileChooser. Files can be filtered based on their name (with addPattern(java.lang.String) or addSuffix(java.lang.String)) or on their mime type (with addMimeType(java.lang.String)).

Filtering by mime types 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 GtkFileFilter allows wildcards for the subtype of a mime type, so you can e.g. filter for image/\\*.

Normally, file filters are used by adding them to a GtkFileChooser (see FileChooser.addFilter(org.gnome.gtk.FileFilter)), but it is also possible to manually use a file filter on any FilterListModel containing GFileInfo objects.

GtkFileFilter as GtkBuildable
The GtkFileFilter implementation of the GtkBuildable interface supports adding rules using the <mime-types> and <patterns> and <suffixes> elements and listing the rules within. Specifying a <mime-type> or <pattern> or <suffix> has the same effect as as calling addMimeType(java.lang.String) or addPattern(java.lang.String) or addSuffix(java.lang.String).

An example of a UI definition fragment specifying GtkFileFilter rules:

<object class="GtkFileFilter">
   <property name="name" translatable="yes">Text and Images</property>
   <mime-types>
     <mime-type>text/plain</mime-type>
     <mime-type>image/ *</mime-type>
   </mime-types>
   <patterns>
     <pattern>*.txt</pattern>
   </patterns>
   <suffixes>
     <suffix>png</suffix>
   </suffixes>
 </object>
 

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	FileFilter.Builder<B extends FileFilter.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.

Nested classes/interfaces inherited from class org.gnome.gtk.Filter

Filter.ChangedCallback, Filter.FilterClass

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

GObject.NotifyCallback, GObject.ObjectClass

Nested classes/interfaces inherited from interface org.gnome.gtk.Buildable

Buildable.BuildableIface, Buildable.BuildableImpl

Constructor Summary

Constructors

Constructor	Description
FileFilter()	Creates a new GtkFileFilter with no rules added to it.
FileFilter(MemorySegment address)	Create a FileFilter proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
void	addMimeType(String mimeType)	Adds a rule allowing a given mime type to this FileFilter.
void	addPattern(String pattern)	Adds a rule allowing a shell style glob to a filter.
void	addPixbufFormats()	Adds a rule allowing image files in the formats supported by GdkPixbuf.
void	addSuffix(String suffix)	Adds a suffix match rule to a filter.
protected FileFilter	asParent()	Returns this instance as if it were its parent type.
static FileFilter.Builder<? extends FileFilter.Builder>	builder()	A FileFilter.Builder object constructs a FileFilter with the specified properties.
static FileFilter	fromGvariant(Variant variant)	Deserialize a file filter from a GVariant.
String[]	getAttributes()	Gets the attributes that need to be filled in for the GFileInfo passed to this filter.
String	getName()	Gets the human-readable name for the filter.
static Type	getType()	Get the GType of the FileFilter class
void	setName(@Nullable String name)	Sets a human-readable name of the filter.
Variant	toGvariant()	Serialize a file filter to an a{sv} variant.

Methods inherited from class org.gnome.gtk.Filter

changed, emitChanged, getMemoryLayout, getStrictness, match, onChanged

Methods inherited from class org.gnome.gobject.GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newv, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class org.gnome.gobject.TypeInstance

callParent, callParent, getPrivate, readGClass, writeGClass

Methods inherited from class io.github.jwharm.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.gnome.gtk.Buildable

getBuildableId

Methods inherited from interface io.github.jwharm.javagi.base.Proxy

handle

Constructor Details

FileFilter

public FileFilter(MemorySegment address)

Create a FileFilter proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

FileFilter

public FileFilter()

Creates a new GtkFileFilter with no rules added to it.

Such a filter doesn’t accept any files, so is not particularly useful until you add rules with addMimeType(java.lang.String), addPattern(java.lang.String), addSuffix(java.lang.String) or addPixbufFormats().

To create a filter that accepts any file, use:

GtkFileFilter *filter = gtk_file_filter_new ();
 gtk_file_filter_add_pattern (filter, "*");
 

Method Details

getType

public static Type getType()

Get the GType of the FileFilter class

Returns:

the GType

asParent

protected FileFilter asParent()

Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.

Overrides:

asParent in class Filter

fromGvariant

public static FileFilter fromGvariant(Variant variant)

Deserialize a file filter from a GVariant.

The variant must be in the format produced by toGvariant().

Parameters:

variant - an a{sv} GVariant

Returns:

a new GtkFileFilter object

addMimeType

public void addMimeType(String mimeType)

Adds a rule allowing a given mime type to this FileFilter.

Parameters:

mimeType - name of a MIME type

addPattern

public void addPattern(String pattern)

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

Note that it depends on the platform whether pattern matching ignores case or not. On Windows, it does, on other platforms, it doesn't.

Parameters:

pattern - a shell style glob

addPixbufFormats

public void addPixbufFormats()

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

This is equivalent to calling addMimeType(java.lang.String) for all the supported mime types.

addSuffix

public void addSuffix(String suffix)

Adds a suffix match rule to a filter.

This is similar to adding a match for the pattern "*.suffix".

In contrast to pattern matches, suffix matches are always case-insensitive.

Parameters:

suffix - filename suffix to match

getAttributes

public String[] getAttributes()

Gets the attributes that need to be filled in for the GFileInfo passed to this filter.

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

Returns:

the attributes

getName

public String getName()

Gets the human-readable name for the filter.

See setName(java.lang.String).

Returns:

The human-readable name of the filter

setName

public void setName(@Nullable
 @Nullable String name)

Sets a human-readable name of the filter.

This is the string that will be displayed in the file chooser if there is a selectable list of filters.

Parameters:

name - the human-readable-name for the filter, or null to remove any existing name.

toGvariant

public Variant toGvariant()

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

Returns:

a new, floating, GVariant

builder

public static FileFilter.Builder<? extends FileFilter.Builder> builder()

A FileFilter.Builder object constructs a FileFilter with the specified properties. Use the various set...() methods to set properties, and finish construction with FileFilter.Builder.build().