Struct DirectoryPicker 

pub struct DirectoryPicker { /* private fields */ }

Directory picker widget

Implementations

impl DirectoryPicker

pub fn new(cx: &mut Context<'_, Self>) -> Self

Create a new directory picker

pub fn with_value(self, path: impl Into<String>) -> Self

Set initial value (builder pattern)

pub fn placeholder(self, text: impl Into<SharedString>) -> Self

Set placeholder text (builder pattern)

pub fn theme(self, theme: Theme) -> Self

Set custom theme (builder pattern)

pub fn browse_shortcut(self, enabled: bool) -> Self

Enable or disable Cmd+O / Ctrl+O browse shortcut (builder pattern)

The shortcut is enabled by default. Disable it if your application uses Cmd+O for another purpose (e.g., opening files at the app level).

pub fn validation_display(self, display: ValidationDisplay) -> Self

Set how validation feedback is displayed (builder pattern)

Controls whether path coloring and/or explanation messages are shown. Default is ValidationDisplay::Full (show both).

pub fn with_enabled(self, enabled: bool) -> Self

Set whether the widget is enabled (builder pattern)

When disabled, the widget cannot be edited or used to browse for directories. Default is true.

pub fn value(&self) -> &str

Get the current directory path

pub fn set_value(&mut self, path: &str, cx: &mut Context<'_, Self>)

Set value programmatically

pub fn focus_handle(&self) -> &FocusHandle

Get the focus handle

pub fn focus(&mut self, cx: &mut Context<'_, Self>)

Focus the edit button (the primary interactive element)

Note: This is deferred to the next render to avoid triggering a synthetic click from keyup events.

pub fn validate(&self) -> DirectoryPickerValidation

Validate the current path and return the validation state

Use this to check if the path is valid before taking action.

pub fn is_enabled(&self) -> bool

Returns whether the widget is enabled

pub fn set_enabled(&mut self, enabled: bool, cx: &mut Context<'_, Self>)

Set whether the widget is enabled

pub fn is_valid(&self) -> bool

Returns true if the current path is valid (exists and is a directory)

Trait Implementations

impl Focusable for DirectoryPicker

Available on crate feature file-picker only.

fn focus_handle(&self, _cx: &App) -> FocusHandle

Returns the focus handle associated with this view.

impl Render for DirectoryPicker

Available on crate feature file-picker only.

fn render( &mut self, window: &mut Window, cx: &mut Context<'_, Self>, ) -> impl IntoElement

Render this view into an element tree.

impl EventEmitter<DirectoryPickerEvent> for DirectoryPicker

Available on crate feature file-picker only.