### ----------------------------------------------------
### -- Gnome::Gtk3
### -- Licenses: Artistic-2.0
### -- Authors: Marcel Timmerman
### -- File: docs/content-docs/reference/Gtk3/FileChooser.md
### ----------------------------------------------------
### -- Chunk 2 of 2
-GObject :$_native-object,
      *%user-options

      --> Unknown type: GTK_TYPE_FILE_CHOOSER_CONFIRMATION
    )

  * $_handler-id; The handler id which is returned from the registration

  * $_native-object; The native object provided by the caller wrapped in the Raku object which registered the signal.

  * %user-options; A list of named arguments provided at the `register-signal()` method

current-folder-changed
----------------------

This signal is emitted when the current folder in a **Gnome::Gtk3::FileChooser** changes. This can happen due to the user performing some action that changes folders, such as selecting a bookmark or visiting a folder on the file list. It can also happen as a result of calling a function to explicitly change the current folder in a file chooser.

Normally you do not need to connect to this signal, unless you need to keep track of which folder a file chooser is showing.

See also: `set_current_folder()`, `get_current_folder()`, `set_current_folder_uri()`, `get_current_folder_uri()`.

    method handler (
      Int :$_handler-id,
      N-GObject :$_native-object,
      *%user-options
    )

  * $_handler-id; The handler id which is returned from the registration

  * $_native-object; The native object provided by the caller wrapped in the Raku object which registered the signal.

  * %user-options; A list of named arguments provided at the `register-signal()` method

file-activated
--------------

This signal is emitted when the user "activates" a file in the file chooser. This can happen by double-clicking on a file in the file list, or by pressing `Enter`.

Normally you do not need to connect to this signal. It is used internally by **Gnome::Gtk3::FileChooserDialog** to know when to activate the default button in the dialog.

See also: `get_filename()`, `get_filenames()`, `get_uri()`, `get_uris()`.

    method handler (
      Int :$_handler-id,
      N-GObject :$_native-object,
      *%user-options
    )

  * $_handler-id; The handler id which is returned from the registration

  * $_native-object; The native object provided by the caller wrapped in the Raku object which registered the signal.

  * %user-options; A list of named arguments provided at the `register-signal()` method

selection-changed
-----------------

This signal is emitted when there is a change in the set of selected files in a **Gnome::Gtk3::FileChooser**. This can happen when the user modifies the selection with the mouse or the keyboard, or when explicitly calling functions to change the selection.

Normally you do not need to connect to this signal, as it is easier to wait for the file chooser to finish running, and then to get the list of selected files using the functions mentioned below.

See also: `select_filename()`, `unselect_filename()`, `get_filename()`, `get_filenames()`, `select_uri()`, `unselect_uri()`, `get_uri()`, `get_uris()`.

    method handler (
      Int :$_handler-id,
      N-GObject :$_native-object,
      *%user-options
    )

  * $_handler-id; The handler id which is returned from the registration

  * $_native-object; The native object provided by the caller wrapped in the Raku object which registered the signal.

  * %user-options; A list of named arguments provided at the `register-signal()` method

update-preview
--------------

This signal is emitted when the preview in a file chooser should be regenerated. For example, this can happen when the currently selected file changes. You should use this signal if you want your file chooser to have a preview widget.

Once you have installed a preview widget with `set_preview_widget()`, you should update it when this signal is emitted. You can use the functions `get_preview_filename()` or `get_preview_uri()` to get the name of the file to preview. Your widget may not be able to preview all kinds of files; your callback must call `set_preview_widget_active()` to inform the file chooser about whether the preview was generated successfully or not.

Please see the example code in [Using a Preview Widget][gtkfilechooser-preview].

See also: `set_preview_widget()`, `set_preview_widget_active()`, `set_use_preview_label()`, `get_preview_filename()`, `get_preview_uri()`.

    method handler (
      Int :$_handler-id,
      N-GObject :$_native-object,
      *%user-options
    )

  * $_handler-id; The handler id which is returned from the registration

  * $_native-object; The native object provided by the caller wrapped in the Raku object which registered the signal.

  * %user-options; A list of named arguments provided at the `register-signal()` method

Properties
==========

action
------

The type of operation that the file selector is performing

  * **Gnome::GObject::Value** type of this property is G_TYPE_ENUM

  * The type of this G_TYPE_ENUM object is GTK_TYPE_FILE_CHOOSER_ACTION

  * Parameter is readable and writable.

  * Default value is GTK_FILE_CHOOSER_ACTION_OPEN.

create-folders
--------------

Whether a file chooser not in open mode will offer the user to create new folders.

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is TRUE.

do-overwrite-confirmation
-------------------------

Whether a file chooser in save mode will present an overwrite confirmation dialog if necessary.

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is FALSE.

extra-widget
------------

Application supplied widget for extra options.

  * **Gnome::GObject::Value** type of this property is G_TYPE_OBJECT

  * The type of this G_TYPE_OBJECT object is GTK_TYPE_WIDGET

  * Parameter is readable and writable.

filter
------

The current filter for selecting which files are displayed

  * **Gnome::GObject::Value** type of this property is G_TYPE_OBJECT

  * The type of this G_TYPE_OBJECT object is GTK_TYPE_FILE_FILTER

  * Parameter is readable and writable.

local-only
----------

Whether the selected file(s should be limited to local file: URLs)

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is TRUE.

preview-widget
--------------

Application supplied widget for custom previews.

  * **Gnome::GObject::Value** type of this property is G_TYPE_OBJECT

  * The type of this G_TYPE_OBJECT object is GTK_TYPE_WIDGET

  * Parameter is readable and writable.

preview-widget-active
---------------------

Whether the application supplied widget for custom previews should be shown.

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is TRUE.

select-multiple
---------------

Whether to allow multiple files to be selected

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is FALSE.

show-hidden
-----------

Whether the hidden files and folders should be displayed

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is FALSE.

use-preview-label
-----------------

Whether to display a stock label with the name of the previewed file.

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is TRUE.



