Gtk.FileChooserNative¶

Subclasses:: None

Methods¶

Inherited:: Gtk.NativeDialog (10), GObject.Object (37), Gtk.FileChooser (25)
Structs:: GObject.ObjectClass (5)

class	`new` (title, parent, action, accept_label, cancel_label)
	`get_accept_label` ()
	`get_cancel_label` ()
	`set_accept_label` (accept_label)
	`set_cancel_label` (cancel_label)

Virtual Methods¶

Inherited:: Gtk.NativeDialog (3), GObject.Object (7)

Properties¶

Inherited:: Gtk.NativeDialog (4), Gtk.FileChooser (6)

Name	Type	Flags	Short Description
`accept-label`	`str`	r/w
`cancel-label`	`str`	r/w

Signals¶

Inherited:: Gtk.NativeDialog (1), GObject.Object (1)

Fields¶

Inherited:: Gtk.NativeDialog (1), GObject.Object (1)

Class Details¶

class Gtk.FileChooserNative(**kwargs)¶

Bases:: Gtk.NativeDialog, Gtk.FileChooser
Abstract:: No
Structure:: Gtk.FileChooserNativeClass

GtkFileChooserNative is an abstraction of a dialog suitable for use with “File Open” or “File Save as” commands.

By default, this just uses a GtkFileChooserDialog to implement the actual dialog. However, on some platforms, such as Windows and macOS, the native platform file chooser is used instead. When the application is running in a sandboxed environment without direct filesystem access (such as Flatpak), GtkFileChooserNative may call the proper APIs (portals) to let the user choose a file and make it available to the application.

While the API of GtkFileChooserNative closely mirrors GtkFileChooserDialog, the main difference is that there is no access to any GtkWindow or GtkWidget for the dialog. This is required, as there may not be one in the case of a platform native dialog.

Showing, hiding and running the dialog is handled by the [class`Gtk`.NativeDialog] functions.

Note that unlike GtkFileChooserDialog, GtkFileChooserNative objects are not toplevel widgets, and GTK does not keep them alive. It is your responsibility to keep a reference until you are done with the object.

Typical usage

In the simplest of cases, you can the following code to use GtkFileChooserNative to select a file for opening:

```c static void on_response (Gtk.NativeDialog *native, int response) { if (response == Gtk.ResponseType.ACCEPT) { Gtk.FileChooser *chooser = GTK_FILE_CHOOSER (native); Gio.File *file = Gtk.FileChooser.get_file (chooser);

open_file (file);

GObject.Object.unref (file); }

GObject.Object.unref (native); }

// … Gtk.FileChooserNative *native; Gtk.FileChooserAction action = Gtk.FileChooserAction.OPEN;

native = Gtk.FileChooserNative.new (“Open File”, parent_window, action, “_Open”, “_Cancel”);

g_signal_connect (native, “response”, G_CALLBACK (on_response), None); Gtk.NativeDialog.show (GTK_NATIVE_DIALOG (native)); ```

To use a GtkFileChooserNative for saving, you can use this:

```c static void on_response (Gtk.NativeDialog *native, int response) { if (response == Gtk.ResponseType.ACCEPT) { Gtk.FileChooser *chooser = GTK_FILE_CHOOSER (native); Gio.File *file = Gtk.FileChooser.get_file (chooser);

save_to_file (file);

GObject.Object.unref (file); }

GObject.Object.unref (native); }

// … Gtk.FileChooserNative *native; Gtk.FileChooser *chooser; Gtk.FileChooserAction action = Gtk.FileChooserAction.SAVE;

native = Gtk.FileChooserNative.new (“Save File”, parent_window, action, “_Save”, “_Cancel”); chooser = GTK_FILE_CHOOSER (native);

if (user_edited_a_new_document) Gtk.FileChooser.set_current_name (chooser, _(“Untitled document”)); else Gtk.FileChooser.set_file (chooser, existing_file, None);

g_signal_connect (native, “response”, G_CALLBACK (on_response), None); Gtk.NativeDialog.show (GTK_NATIVE_DIALOG (native)); ```

For more information on how to best set up a file dialog, see the [class`Gtk`.FileChooserDialog] documentation.

Response Codes

GtkFileChooserNative inherits from [class`Gtk`.NativeDialog], which means it will return Gtk.ResponseType.ACCEPT if the user accepted, and Gtk.ResponseType.CANCEL if he pressed cancel. It can also return Gtk.ResponseType.DELETE_EVENT if the window was unexpectedly closed.

Differences from Gtk.FileChooserDialog

There are a few things in the [iface`Gtk`.FileChooser] interface that are not possible to use with GtkFileChooserNative, as such use would prohibit the use of a native dialog.

No operations that change the dialog work while the dialog is visible. Set all the properties that are required before showing the dialog.

Win32 details

On windows the IFileDialog implementation (added in Windows Vista) is used. It supports many of the features that GtkFileChooser has, but there are some things it does not handle:

Any [class`Gtk`.FileFilter] added using a mimetype

If any of these features are used the regular GtkFileChooserDialog will be used in place of the native one.

Portal details

When the org.freedesktop.portal.FileChooser portal is available on the session bus, it is used to bring up an out-of-process file chooser. Depending on the kind of session the application is running in, this may or may not be a GTK file chooser.

macOS details

On macOS the NSSavePanel and NSOpenPanel classes are used to provide native file chooser dialogs. Some features provided by GtkFileChooser are not supported:

Shortcut folders.

Deprecated since version 4.10: Use [class`Gtk`.FileDialog] instead

classmethod new(title, parent, action, accept_label, cancel_label)[source]¶

Parameters:

title (str or None) – Title of the native
parent (Gtk.Window or None) – Transient parent of the native
action (Gtk.FileChooserAction) – Open or save mode for the dialog
accept_label (str or None) – text to go in the accept button, or None for the default
cancel_label (str or None) – text to go in the cancel button, or None for the default

Returns:

a new GtkFileChooserNative

Return type:

Gtk.FileChooserNative

Creates a new GtkFileChooserNative.

Deprecated since version 4.10: Use [class`Gtk`.FileDialog] instead

get_accept_label()[source]¶

Returns:: The custom label
Return type:: str or None

Retrieves the custom label text for the accept button.

Deprecated since version 4.10: Use [class`Gtk`.FileDialog] instead

get_cancel_label()[source]¶

Returns:: The custom label
Return type:: str or None

Retrieves the custom label text for the cancel button.

Deprecated since version 4.10: Use [class`Gtk`.FileDialog] instead

set_accept_label(accept_label)[source]¶

Parameters:: accept_label (str or None) – custom label

Sets the custom label text for the accept button.

If characters in label are preceded by an underscore, they are underlined. If you need a literal underscore character in a label, use “__” (two underscores). The first underlined character represents a keyboard accelerator called a mnemonic.

Pressing Alt and that key should activate the button.

Deprecated since version 4.10: Use [class`Gtk`.FileDialog] instead

set_cancel_label(cancel_label)[source]¶

Parameters:: cancel_label (str or None) – custom label

Sets the custom label text for the cancel button.

If characters in label are preceded by an underscore, they are underlined. If you need a literal underscore character in a label, use “__” (two underscores). The first underlined character represents a keyboard accelerator called a mnemonic.

Pressing Alt and that key should activate the button.

Deprecated since version 4.10: Use [class`Gtk`.FileDialog] instead

Property Details¶

Gtk.FileChooserNative.props.accept_label¶

Name:: accept-label
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE

The text used for the label on the accept button in the dialog, or None to use the default text.

Gtk.FileChooserNative.props.cancel_label¶

Name:: cancel-label
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE

The text used for the label on the cancel button in the dialog, or None to use the default text.