Struct FilePicker 

pub struct FilePicker { /* private fields */ }

A dialog to choose files on a FilePickerState: an Up button and the path field, a row with the filter and the “Show hidden” switch, a bordered list of the entries, and Cancel and “Open file” in the footer.

use gpui_cn::{FilePicker, FilePickerState};
use gpui_kit::{Entity, IntoElement};

fn picker(state: &Entity<FilePickerState>, open: bool) -> impl IntoElement {
    FilePicker::new("open-file", state)
        .open(open)
        .title("Open a Rust file")
}

The application owns the open state: open sets it, and it closes the picker when the state reports FilePickerEvent::Confirmed or FilePickerEvent::Cancelled. The id must be stable across frames.

Implementations

impl FilePicker

pub fn new(id: impl Into<ElementId>, state: &Entity<FilePickerState>) -> Self

A closed picker on state, with a stable id.

pub fn open(self, open: bool) -> Self

Shows or hides the picker.

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

The title. The default is “Choose a file”, or “Choose files” for a picker of several.

pub fn confirm_label(self, label: impl Into<SharedString>) -> Self

The label of the button that chooses. The default is “Open file”, or “Open files” for a picker of several.

pub fn cancel_label(self, label: impl Into<SharedString>) -> Self

The label of the button that cancels. The default is “Cancel”.

pub fn on_open_change( self, handler: impl Fn(bool, &mut Window, &mut App) + 'static, ) -> Self

Called when Escape, a press on the backdrop, the close button, or Cancel asks to close the picker, after the state reports FilePickerEvent::Cancelled.

Trait Implementations

impl IntoElement for FilePicker

type Element = ViewElement<FilePicker>

The specific type of element into which the implementing type is converted. Useful for converting other types into elements automatically, like Strings

fn into_element(self) -> Self::Element

Convert self into a type that implements Element.

fn into_any_element(self) -> AnyElement

Convert self into a dynamically-typed AnyElement.

impl RenderOnce for FilePicker

fn render(self, window: &mut Window, cx: &mut App) -> impl IntoElement

Render this component into an element tree. Note that this method takes ownership of self, as compared to Render::render() method which takes a mutable reference.