Struct gtk::FileChooserButton

#[repr(transparent)]
pub struct FileChooserButton { /* private fields */ }

The FileChooserButton is a widget that lets the user select a file. It implements the FileChooser interface. Visually, it is a file name with a button to bring up a FileChooserDialog. The user can then use that dialog to change the file associated with that button. This widget does not support setting the property::FileChooser::select-multiple property to true.

Create a button to let the user select a file in /etc

⚠️ The following code is in C ⚠️

{
  GtkWidget *button;

  button = gtk_file_chooser_button_new (_("Select a file"),
                                        GTK_FILE_CHOOSER_ACTION_OPEN);
  gtk_file_chooser_set_current_folder (GTK_FILE_CHOOSER (button),
                                       "/etc");
}

The FileChooserButton supports the GtkFileChooserActions FileChooserAction::Open and FileChooserAction::SelectFolder.

The FileChooserButton will ellipsize the label, and will thus request little horizontal space. To give the button more space, you should call WidgetExt::preferred_size(), FileChooserButtonExt::set_width_chars(), or pack the button in such a way that other interface elements give space to the widget.

CSS nodes

GtkFileChooserButton has a CSS node with name “filechooserbutton”, containing a subnode for the internal button with name “button” and style class “.file”.

Implements

FileChooserButtonExt, BoxExt, ContainerExt, WidgetExt, glib::ObjectExt, BuildableExt, OrientableExt, FileChooserExt, ContainerExtManual, WidgetExtManual, BuildableExtManual, FileChooserExtManual

Implementations

impl FileChooserButton

pub const NONE: Option<&'static FileChooserButton> = None

pub fn new(title: &str, action: FileChooserAction) -> FileChooserButton

Creates a new file-selecting button widget.

title

the title of the browse dialog.

action

the open mode for the widget.

Returns

a new button widget.

pub fn with_dialog(dialog: &impl IsA<Dialog>) -> FileChooserButton

Creates a FileChooserButton widget which uses dialog as its file-picking window.

Note that dialog must be a Dialog (or subclass) which implements the FileChooser interface and must not have DialogFlags::DESTROY_WITH_PARENT set.

Also note that the dialog needs to have its confirmative button added with response ResponseType::Accept or ResponseType::Ok in order for the button to take over the file selected in the dialog.

dialog

the widget to use as dialog

Returns

a new button widget.

pub fn builder() -> FileChooserButtonBuilder

Creates a new builder-pattern struct instance to construct FileChooserButton objects.

This method returns an instance of FileChooserButtonBuilder which can be used to create FileChooserButton objects.

Trait Implementations

impl Clone for FileChooserButton

fn clone(&self) -> Self

Returns a copy of the value.

const fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FileChooserButton

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FileChooserButton

fn default() -> Self

Returns the “default value” for a type.

impl Display for FileChooserButton

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for FileChooserButton

fn hash<H>(&self, state: &mut H)where
    H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,

Feeds a slice of this type into the given Hasher.

impl Ord for FileChooserButton

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

const fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

const fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

const fn clamp(self, min: Self, max: Self) -> Selfwhere
    Self: PartialOrd<Self>,

Restrict a value to a certain interval.

impl ParentClassIs for FileChooserButton

type Parent = Box

impl<OT: ObjectType> PartialEq<OT> for FileChooserButton

fn eq(&self, other: &OT) -> bool

This method tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for FileChooserButton

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

const fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

const fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

const fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

const fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for FileChooserButton

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for FileChooserButton

impl IsA<Box> for FileChooserButton

impl IsA<Buildable> for FileChooserButton

impl IsA<Container> for FileChooserButton

impl IsA<FileChooser> for FileChooserButton

impl IsA<Orientable> for FileChooserButton

impl IsA<Widget> for FileChooserButton