Struct TaskForm 

pub struct TaskForm {

    pub title: TextInput,
    pub due: TextInput,
    pub importance: u8,
    pub body: BodyEditor,
    pub field: Field,
    pub error: Option<String>,
    pub editing: Option<String>,
    pub areas: FieldAreas,
    pub preview: bool,
    pub gif: Option<(PathBuf, GifPlayback)>,
    pub gif_pending: Option<GifLoad>,
    pub picker: Option<DuePicker>,
    pub last_body_click: Option<(Instant, usize)>,
    pub menu_was_open: bool,
    pub body_scroll: usize,
    pub body_menu_area: Option<Rect>,
    pub image_hits: Vec<(usize, Rect)>,
    /* private fields */
}

Fields

title: TextInput

due: TextInput

importance: u8

body: BodyEditor

field: Field

error: Option<String>

editing: Option<String>

The task being edited; None when creating a new one.

areas: FieldAreas

Filled in while drawing; used to hit-test clicks.

preview: bool

Whether the description’s image is shown full size.

gif: Option<(PathBuf, GifPlayback)>

Decoded GIF for preview, keyed by path (kept after close for fast reopen).

gif_pending: Option<GifLoad>

GIF decode in progress; polled by the normal animation tick.

picker: Option<DuePicker>

The calendar, while a due date is being picked.

last_body_click: Option<(Instant, usize)>

Last body click (line index), for double-click to open a picture.

menu_was_open: bool

Whether the / menu was open last frame — used to re-emit images after the menu is dismissed (see ui::draw_body).

body_scroll: usize

Body scroll after last paint — scroll changes need the same protocol drop as menu close so pictures that shrink/move do not ghost.

body_menu_area: Option<Rect>

Screen rect of the open body / dropdown (for mouse hit-testing).

image_hits: Vec<(usize, Rect)>

Where each body picture was drawn last frame: (line index, screen rect). Clicks only select a picture when they land inside this rect — not the full-width letterbox gutter.

Implementations

impl TaskForm

pub fn new() -> Self

pub fn edit(task: &Task) -> Self

pub fn image_hit_at(&self, line: usize, x: u16, y: u16) -> bool

Whether (x, y) sits on the drawn picture for body line line.

pub fn set_image_root(&mut self, image_root: PathBuf)

pub fn set_attachments(&mut self, attachments: &[Attachment])

pub fn set_categories( &mut self, categories: &[Category], selected_id: Option<&str>, )

Install the real categories available to this form and select the task’s starting category. All tasks is a view, not a destination; Uncategorized is always the first choice.

Call this once when opening the form, before the user edits it. The selected value becomes part of the dirty-state baseline.

pub fn category_id(&self) -> Option<&str>

pub fn category_label(&self) -> &str

pub fn cycle_category(&mut self, delta: i32)

Select the previous/next category, wrapping at either end.

pub fn clear_category(&mut self)

pub fn open_image_preview(&mut self) -> Option<String>

Open the full-size image viewer. GIF frames decode asynchronously; the still-image cache can paint a placeholder in the meantime.

pub fn close_image_preview(&mut self)

pub fn gif_playing(&self) -> bool

pub fn tick_gif(&mut self) -> bool

Advance GIF animation; returns true when the frame changed.

pub fn preview_click(&mut self)

Click while preview is open: pause/resume an animated GIF. Static images ignore the click (Esc still closes).

pub fn is_edit(&self) -> bool

pub fn is_dirty(&self) -> bool

pub fn title_text(&self) -> &'static str

pub fn before_edit(&mut self, kind: EditKind)

Snapshot before a content edit (call before mutating).

pub fn break_coalesce(&mut self)

pub fn undo(&mut self) -> bool

pub fn redo(&mut self) -> bool

pub fn open_due_picker(&mut self)

Opens the calendar on whatever the field already reads.

pub fn take_due_picker(&mut self)

Writes the picked day back into the field.

pub fn cycle_importance(&mut self)

Steps importance up, wrapping back to none after three.

pub fn set_importance(&mut self, importance: u8)

pub fn clear_due(&mut self)

pub fn focus_next(&mut self)

pub fn focus_prev(&mut self)

pub fn set_field(&mut self, field: Field)

Move focus; dismiss the calendar and slash menu when leaving the fields that own them.

pub fn submit(&mut self) -> Option<TaskDraft>

Validates the form. On success returns the draft; on failure sets error and focuses the offending field.

Trait Implementations

impl Default for TaskForm

fn default() -> Self

Returns the “default value” for a type.