FileChooserWidget

Deprecated since version 4.10: Direct use of GtkFileChooserWidget is deprecated

class FileChooserWidget(**properties: Any)

Superclasses: Widget, InitiallyUnowned, Object

Implemented Interfaces: Accessible, Buildable, ConstraintTarget, FileChooser

GtkFileChooserWidget is a widget for choosing files.

It exposes the FileChooser interface, and you should use the methods of this interface to interact with the widget.

Shortcuts and Gestures

GtkFileChooserWidget supports the following keyboard shortcuts:

• Shift`+:kbd:`F10 or Menu opens the context menu.

The following signals have default keybindings:

• desktop_folder

• down_folder

• home_folder

• location_popup

• location_popup_on_paste

• location_toggle_popup

• places_shortcut

• quick_bookmark

• recent_shortcut

• search_shortcut

• show_hidden

• up_folder

CSS nodes

GtkFileChooserWidget has a single CSS node with name filechooser.

Constructors

class FileChooserWidget

classmethod new(action: FileChooserAction) → Widget

Creates a new GtkFileChooserWidget.

This is a file chooser widget that can be embedded in custom windows, and it is the same widget that is used by GtkFileChooserDialog.

Deprecated since version 4.10: Direct use of GtkFileChooserWidget is deprecated

Parameters:

action – Open or save mode for the widget

Properties

class FileChooserWidget

props.search_mode: bool

The type of the None singleton.

props.show_time: bool

The type of the None singleton.

Added in version 4.10.

props.subtitle: str

The type of the None singleton.

Signals

class FileChooserWidget.signals

desktop_folder() → None

The type of the None singleton.

down_folder() → None

The type of the None singleton.

home_folder() → None

The type of the None singleton.

location_popup(path: str) → None

The type of the None singleton.

Parameters:

path – a string that gets put in the text entry for the file name

location_popup_on_paste() → None

The type of the None singleton.

location_toggle_popup() → None

The type of the None singleton.

places_shortcut() → None

The type of the None singleton.

quick_bookmark(bookmark_index: int) → None

The type of the None singleton.

Parameters:

bookmark_index – the number of the bookmark to switch to

recent_shortcut() → None

The type of the None singleton.

search_shortcut() → None

The type of the None singleton.

show_hidden() → None

The type of the None singleton.

up_folder() → None

The type of the None singleton.