Struct FilePickerState 

pub struct FilePickerState {
    pub current_dir: PathBuf,
    pub entries: Vec<FileEntry>,
    pub selected: usize,
    pub selected_file: Option<PathBuf>,
    pub show_hidden: bool,
    pub extensions: Vec<String>,
    pub dirty: bool,
}

State for a file picker widget.

Tracks the current directory listing, filtering options, and selected file.

Fields

current_dir: PathBuf

Current directory being browsed.

entries: Vec<FileEntry>

Visible entries in the current directory.

selected: usize

Selected entry index in entries.

selected_file: Option<PathBuf>

Currently selected file path, if any.

show_hidden: bool

Whether dotfiles are included in the listing.

extensions: Vec<String>

Allowed file extensions (lowercase, no leading dot).

dirty: bool

Whether the directory listing needs refresh.

Implementations

impl FilePickerState

pub fn new(dir: impl Into<PathBuf>) -> Self

Create a file picker rooted at dir.

pub fn show_hidden(self, show: bool) -> Self

Configure whether hidden files should be shown.

pub fn extensions(self, exts: &[&str]) -> Self

Restrict visible files to the provided extensions.

pub fn selected_file(&self) -> Option<&PathBuf>

Return the currently selected file path, if any.

Disambiguates from the selected: usize field, which is the entry index into entries. This method returns the resolved file path that the user picked via Enter — None until a file (not a directory) is selected.

Example

let mut state = FilePickerState::new(".");
if ui.file_picker(&mut state).changed {
    if let Some(path) = state.selected_file() {
        println!("picked: {}", path.display());
    }
}

pub fn selected(&self) -> Option<&PathBuf>

👎Deprecated since 0.20.0:

use selected_file() — disambiguates from the selected: usize field index

Return the currently selected file path.

Deprecated alias for selected_file. The shorter name conflicts visually with the selected: usize field — a getter returning a path alongside a public field returning an index made call sites ambiguous. Migrate to selected_file() for new code; this stub stays callable until v1.0.

pub fn refresh(&mut self)

Re-scan the current directory and rebuild entries.

Trait Implementations

impl Clone for FilePickerState

fn clone(&self) -> FilePickerState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FilePickerState

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

Formats the value using the given formatter.

impl Default for FilePickerState

fn default() -> Self

Returns the “default value” for a type.