Skip to main content

FilePicker

Trait FilePicker 

Source
pub trait FilePicker {
    // Required methods
    fn pick_file(
        &self,
        options: FilePickerOptions,
    ) -> PickerFuture<Result<Option<ContentHandle>, FilePickerError>>;
    fn pick_folder(
        &self,
        options: FilePickerOptions,
    ) -> PickerFuture<Result<Option<ContentFolderRef>, FilePickerError>>;

    // Provided methods
    fn pick_files(
        &self,
        options: FilePickerOptions,
    ) -> PickerFuture<Result<Vec<ContentHandle>, FilePickerError>> { ... }
    fn save_document(
        &self,
        request: SaveDocumentRequest,
    ) -> PickerFuture<Result<Option<ContentSinkRef>, FilePickerError>> { ... }
    fn pick_writable_folder(
        &self,
        options: FilePickerOptions,
    ) -> PickerFuture<Result<Option<String>, FilePickerError>> { ... }
}
Expand description

Presents the system’s file, folder and document choosers.

Implemented by the platform backends and consumed by crate::launcher.

Required Methods§

Source

fn pick_file( &self, options: FilePickerOptions, ) -> PickerFuture<Result<Option<ContentHandle>, FilePickerError>>

Presents a single-file chooser. Resolves to None if cancelled.

Source

fn pick_folder( &self, options: FilePickerOptions, ) -> PickerFuture<Result<Option<ContentFolderRef>, FilePickerError>>

Presents a folder chooser. Resolves to None if cancelled.

Provided Methods§

Source

fn pick_files( &self, options: FilePickerOptions, ) -> PickerFuture<Result<Vec<ContentHandle>, FilePickerError>>

Presents a multi-file chooser. Resolves to an empty vector if cancelled.

The default presents the single-file chooser, for backends whose system chooser has no multi-selection mode.

Source

fn save_document( &self, request: SaveDocumentRequest, ) -> PickerFuture<Result<Option<ContentSinkRef>, FilePickerError>>

Presents a save-destination chooser and opens a sink on the chosen document. Resolves to None if cancelled.

Source

fn pick_writable_folder( &self, options: FilePickerOptions, ) -> PickerFuture<Result<Option<String>, FilePickerError>>

Presents a chooser for a folder the app may keep writing to across runs, resolving to the durable handle accepted by crate::writable_folder::open_writable_folder.

Dyn Compatibility§

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors§