Struct ChartExportModal 

pub struct ChartExportModal {

    pub focus: ChartExportFocus,
    pub format: ChartExportFormat,
    pub style: ExportStyle,
    pub size: SizePreset,
    pub dpi: f32,
    pub legend: LegendPlace,
    pub mark: Mark,
    pub point_opacity: PointOpacity,
    pub point_size: PointSize,
    pub line_width: LineWidth,
    pub y_from_zero: bool,
    pub path_input: TextInput,
    pub width_input: TextInput,
    pub height_input: TextInput,
    pub title_input: TextInput,
    pub description_input: TextInput,
    pub notes_input: TextInput,
    pub source_input: TextInput,
    pub byline_input: TextInput,
    pub recipe: bool,
    pub restore: Option<SavedChartExport>,
    pub error: Option<String>,
}

Fields

focus: ChartExportFocus

format: ChartExportFormat

style: ExportStyle

size: SizePreset

dpi: f32

Pixels per inch: the last preset’s, which a custom size keeps, so typing a width does not change the text’s size on the page.

legend: LegendPlace

mark: Mark

The chart being exported, for which mark rows apply.

point_opacity: PointOpacity

point_size: PointSize

line_width: LineWidth

y_from_zero: bool

path_input: TextInput

width_input: TextInput

height_input: TextInput

title_input: TextInput

description_input: TextInput

notes_input: TextInput

source_input: TextInput

byline_input: TextInput

recipe: bool

Whether the file carries how the chart was made: the source path, query, chart and sample. Starts from chart.export_recipe, then stays as last set.

restore: Option<SavedChartExport>

A view’s export settings, put in place the next time the dialog opens.

error: Option<String>

Why Enter did not write: a blank path, or the failed write’s reason. Said on the dialog’s status line; cleared by typing in the path.

Implementations

impl ChartExportModal

pub fn new() -> Self

pub fn open( &mut self, theme: &Theme, history_limit: usize, defaults: ExportDefaults, )

Open the dialog for a chart. The format, style, size and byline stay as they were last used; the words about the chart start from defaults.

pub fn saved(&self) -> SavedChartExport

The dialog as a view keeps it: everything but the path.

pub fn shows(&self, field: ChartExportFocus) -> bool

Whether field applies to the chart being exported: the points’ rows to a scatter, the line’s width and Y from zero to a line. Bars always start at zero: a bar’s length is its value.

pub fn shown(&self) -> Vec<ChartExportFocus>

The fields on screen, top to bottom.

pub fn choice(&self, field: ChartExportFocus) -> Option<&'static str>

What a choice row shows.

pub fn y_from_zero_option(&self) -> Option<bool>

Y from zero for the file: what the dialog says, on a line chart.

pub fn reopen_with_path(&mut self, path: &Path, format: ChartExportFormat)

Reopen after an overwrite declined or a failed write: the form as it was, focus on the path.

pub fn close(&mut self)

pub fn step(&mut self, field: ChartExportFocus, delta: i8)

←/→ on a choice.

pub fn size_typed(&mut self)

A width or height typed: the size is custom from then on.

pub fn input(&self, field: ChartExportFocus) -> Option<&TextInput>

A text field’s input; None for a choice.

pub fn input_mut(&mut self, field: ChartExportFocus) -> Option<&mut TextInput>

Self::input, to edit.

pub fn export_dimensions(&self) -> (u32, u32)

The width and height typed, each 16 to 8,192 px; the preset’s where a field does not read as a number.

Trait Implementations

impl Default for ChartExportModal

fn default() -> Self

Returns the “default value” for a type.

impl Form for ChartExportModal

type Field = ChartExportFocus

The modal’s name for a field.

fn fields(&self) -> Vec<(ChartExportFocus, FieldKind)>

The fields on screen, top to bottom, each with its kind. A field the current state hides or disables is left out, so focus never lands on it.

fn focused(&self) -> ChartExportFocus

fn set_focused(&mut self, field: ChartExportFocus)

Put focus on field. Called only with a field of Form::fields; a modal that shows a text cursor in the focused field syncs it here.

fn text_edge(&self, _field: Self::Field) -> (bool, bool)

For a multiline field: whether its cursor is on the first line, and on the last, where ↑ and ↓ leave it.

fn list_row(&self, _field: Self::Field) -> bool

Whether field is a row of a list (a sort, a filter, a column) rather than a setting. A click on a list row only focuses it, so it can be picked to move or remove without changing it; a click on it once focused acts. A setting (a checkbox, a choice, a button) acts on the first click.

fn focused_kind(&self) -> Option<FieldKind>

The focused field’s kind; None when focus is on a field not shown.

fn shown_picker(&mut self) -> Option<(&mut PickerState, bool)>

The picker open over a field, and whether it takes several values; None for a form with no picker open.

fn dismiss_picker(&mut self)

Close the open picker, choosing nothing.

fn pick(&mut self, _toggle: bool)

Take the picker’s item and close it, or with toggle, flip it and stay open.

fn focus(&mut self, field: Self::Field) -> bool

Focus field if the form shows it: a click on a row, or a modal moving focus itself. Returns whether it did.

fn move_focus(&mut self, delta: isize)

Move focus delta fields along, wrapping. A focus the form no longer shows counts from the top.

fn focus_next(&mut self)

fn focus_prev(&mut self)

fn settle_focus(&mut self)

After a change that hides fields: when the focused one went, focus the first field instead, so it never points at nothing.