Struct FileDialogUiConfig 

pub struct FileDialogUiConfig {

    pub header_style: HeaderStyle,
    pub layout: LayoutStyle,
    pub validation_buttons: ValidationButtonsConfig,
    pub toolbar: ToolbarConfig,
    pub places_pane_shown: bool,
    pub places_pane_width: f32,
    pub file_list_view: FileListViewMode,
    pub file_list_columns: FileListColumnsConfig,
    pub path_bar_style: PathBarStyle,
    pub breadcrumbs_quick_select: bool,
    pub breadcrumbs_max_segments: usize,
    pub empty_hint_enabled: bool,
    pub empty_hint_color: [f32; 4],
    pub empty_hint_static_message: Option<String>,
    pub new_folder_enabled: bool,
    pub file_style_fonts: HashMap<String, FontId>,
    pub file_styles: FileStyleRegistry,
    pub thumbnails_enabled: bool,
    pub thumbnail_size: [f32; 2],
    pub type_select_enabled: bool,
    pub type_select_timeout: Duration,
    pub custom_pane_enabled: bool,
    pub custom_pane_dock: CustomPaneDock,
    pub custom_pane_height: f32,
    pub custom_pane_width: f32,
}

Caller-facing configuration for the in-UI file dialog.

This Module Interface contains durable UI knobs that callers may configure before or during a frame. Transient buffers, focus requests, modal state, and operation jobs stay in FileDialogUiState.

Fields

header_style: HeaderStyle

Header layout style.

layout: LayoutStyle

Layout style for the dialog UI.

validation_buttons: ValidationButtonsConfig

Validation button row configuration (Ok/Cancel).

toolbar: ToolbarConfig

Top toolbar (“chrome”) configuration.

places_pane_shown: bool

Whether to show the left “Places” pane in LayoutStyle::Standard.

places_pane_width: f32

Width of the left “Places” pane in pixels (Standard layout only).

file_list_view: FileListViewMode

File list view mode (list vs grid).

file_list_columns: FileListColumnsConfig

List-view column visibility configuration.

path_bar_style: PathBarStyle

Path bar style (editable text input vs breadcrumb-style composer).

breadcrumbs_quick_select: bool

Enable quick parallel directory selection popups when clicking breadcrumb separators.

This mimics IGFD’s “quick path selection” feature in the path composer.

breadcrumbs_max_segments: usize

Max breadcrumb segments to display (compress with ellipsis when exceeded).

empty_hint_enabled: bool

Show a hint row when no entries match filters/search.

empty_hint_color: [f32; 4]

RGBA color of the empty hint text.

empty_hint_static_message: Option<String>

Custom static hint message when entries list is empty; if None, a default message is built.

new_folder_enabled: bool

Whether to show and allow the “New Folder” action.

file_style_fonts: HashMap<String, FontId>

Optional font mapping used by file style font_token.

file_styles: FileStyleRegistry

Style registry used to decorate the file list (icons/colors/tooltips).

thumbnails_enabled: bool

Enable thumbnails in the file list (adds a Preview column).

thumbnail_size: [f32; 2]

Thumbnail preview size in pixels.

type_select_enabled: bool

Enable “type-to-select” behavior in the file list (IGFD-style).

type_select_timeout: Duration

Timeout after which the type-to-select buffer resets.

custom_pane_enabled: bool

Whether to render a custom pane region (when a pane is provided by the caller).

custom_pane_dock: CustomPaneDock

Dock position for the custom pane.

custom_pane_height: f32

Height of the custom pane region (in pixels).

custom_pane_width: f32

Width of the custom pane region when right-docked (in pixels).

Implementations

impl FileDialogUiConfig

pub fn apply_igfd_classic_preset(&mut self)

Applies an “IGFD classic” configuration preset (opt-in).

This tunes durable UI knobs to feel closer to ImGuiFileDialog (IGFD) while staying Rust-first.

Trait Implementations

impl Debug for FileDialogUiConfig

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

Formats the value using the given formatter.

impl Default for FileDialogUiConfig

fn default() -> Self

Returns the “default value” for a type.