morph 0.1.0
Asynchronous bridge between GUI thread and business models
Loading...
Searching...
No Matches
morph::forms::FormViewOptions Struct Reference

How formView lays a form out and labels its chrome. More...

#include <form_view.hpp>

Public Attributes

Overrides overrides {}
 Replacement controls.
int gridColumns = 2
 Columns of every section's, accordion's and tab's grid; x-colspan is clamped to it.
std::optional< int > flatGridColumns
 Columns of the implicit group's grid; unset is 1 while gridColumns is 2, else gridColumns.
ui::Prop< std::string > submitLabel = "Submit"
 The explicit-mode button's label, which the status line names (ready: press <label>).
std::string addLabel = "Add"
 The caption of a collection's Add button.
std::string removeLabel = "Remove"
 The caption of a collection row's Remove button.
bool showTitle = true
 Whether the form's title heads the view.
bool showStatus = true
 Whether the status line ("fill the required (*) fields", …) is shown.
ui::Prop< std::string > title
 A heading over the fields (test id form_title) in place of the schema's title; empty shows none. A title given is shown whatever showTitle says.
FieldLayout fieldLayout = FieldLayout::Stacked
 Where each cell puts its field's caption: over the control, or beside it.
int inlineLabelWidth = 16
 The width of an inline caption, in backend units; at least 1, else formView throws std::invalid_argument. Read only for FieldLayout::Inline.

Detailed Description

How formView lays a form out and labels its chrome.

Definition at line 38 of file form_view.hpp.

Member Data Documentation

◆ overrides

Overrides morph::forms::FormViewOptions::overrides {}

Replacement controls.

Definition at line 40 of file form_view.hpp.

◆ gridColumns

int morph::forms::FormViewOptions::gridColumns = 2

Columns of every section's, accordion's and tab's grid; x-colspan is clamped to it.

Definition at line 42 of file form_view.hpp.

◆ flatGridColumns

std::optional<int> morph::forms::FormViewOptions::flatGridColumns

Columns of the implicit group's grid; unset is 1 while gridColumns is 2, else gridColumns.

Definition at line 44 of file form_view.hpp.

◆ submitLabel

ui::Prop<std::string> morph::forms::FormViewOptions::submitLabel = "Submit"

The explicit-mode button's label, which the status line names (ready: press <label>).

Definition at line 46 of file form_view.hpp.

◆ addLabel

std::string morph::forms::FormViewOptions::addLabel = "Add"

The caption of a collection's Add button.

Definition at line 48 of file form_view.hpp.

◆ removeLabel

std::string morph::forms::FormViewOptions::removeLabel = "Remove"

The caption of a collection row's Remove button.

Definition at line 50 of file form_view.hpp.

◆ showTitle

bool morph::forms::FormViewOptions::showTitle = true

Whether the form's title heads the view.

Definition at line 52 of file form_view.hpp.

◆ showStatus

bool morph::forms::FormViewOptions::showStatus = true

Whether the status line ("fill the required (*) fields", …) is shown.

Definition at line 54 of file form_view.hpp.

◆ title

ui::Prop<std::string> morph::forms::FormViewOptions::title

A heading over the fields (test id form_title) in place of the schema's title; empty shows none. A title given is shown whatever showTitle says.

Definition at line 57 of file form_view.hpp.

◆ fieldLayout

FieldLayout morph::forms::FormViewOptions::fieldLayout = FieldLayout::Stacked

Where each cell puts its field's caption: over the control, or beside it.

Definition at line 59 of file form_view.hpp.

◆ inlineLabelWidth

int morph::forms::FormViewOptions::inlineLabelWidth = 16

The width of an inline caption, in backend units; at least 1, else formView throws std::invalid_argument. Read only for FieldLayout::Inline.

Definition at line 62 of file form_view.hpp.


The documentation for this struct was generated from the following file: