Inputs

Input controls collect values from the user: booleans, numbers, text, selections, dates, and colors.

Controls And Helpers

Event Fields

App-level events require .Id(...) ≥ 0 and a connected MuiEventSink. See Event Bus.

MuiCheckbox

Purpose

Labelled boolean checkbox with optional indeterminate visual state. Use for explicit on/off options with readable text beside the box.

Source: Controls/Inputs/Checkbox.mqh.

Create It

MuiCheckbox *confirm=Mui::Checkbox(parent,"Confirm before trade",NULL);
confirm.Id(APP_INPUT_CONFIRM);
confirm.Checked(true);

MuiCreate::Checkbox(parent, x, y, w, h, label, checked) for explicit bounds.

Form row: Mui::LabeledCheckbox(parent, label, initial, hint).

Events

Pointer/keyboard toggle switches only between on and off. Use CheckState(MUI_CHECK_INDETERMINATE) for a third visual state without changing click behaviour.

Common Setters

Common Reads

Notes

• Programmatic .Checked() / .CheckState() do not emit MUI_EVENT_CHECK_CHANGED; only user interaction does.
• Inherits common MuiElement spacing and visibility APIs.

Example

if(event.EventId()==MUI_EVENT_CHECK_CHANGED && event.ControlId()==APP_INPUT_CONFIRM)
  {
   const bool on=event.Checked();
   // event.Text() is the checkbox label
  }

Related

• Checkbox, toggle, and slider guide

MuiToggle

Purpose

Compact switch-style boolean control without a separate text label (optional tooltip). Use when a switch metaphor fits better than a checkbox.

Source: Controls/Inputs/Toggle.mqh.

Create It

MuiToggle *enabled=Mui::Toggle(parent,false,NULL);
enabled.Id(APP_INPUT_ENABLED);

MuiCreate::Toggle(parent, x, y, w, h, checked, text) — non-empty text sets a tooltip on the toggle.

Events

Text() is not set on toggle events.

Common Setters

Common Reads

Notes

• Programmatic .Checked() does not emit the event bus event.
• Default size follows theme toggle metrics via PreferredWidth() / PreferredHeight().

Example

if(event.EventId()==MUI_EVENT_CHECK_CHANGED && event.ControlId()==APP_INPUT_ENABLED)
  {
   g_tradingEnabled=event.Checked();
  }

Related

• Checkbox, toggle, and slider guide

MuiSlider

Purpose

Numeric range control for continuous or stepped values. Supports horizontal and vertical orientation, optional value legend, and theme or custom track colours.

Source: Controls/Inputs/Slider.mqh.

Create It

MuiSlider *risk=Mui::HorizontalSlider(parent,0.1,10.0,1.0,NULL,220.0,0.0,0.1,true);
risk.Id(APP_INPUT_RISK);

Also: Mui::Slider, Mui::VerticalSlider, Mui::LabeledSlider, MuiCreate::Slider(parent, x, y, w, h, min, max, value).

Events

Programmatic .Value(...) updates display only; it does not emit MUI_EVENT_VALUE_CHANGED.

Common Setters

Common Reads

Notes

• While dragging, value changes can emit multiple MUI_EVENT_VALUE_CHANGED events.
• UsePreferredSizeAlongLegendAxes() relaxes fixed axes when a legend needs extra space.

Example

if(event.EventId()==MUI_EVENT_VALUE_CHANGED && event.ControlId()==APP_INPUT_RISK)
  {
   const double pct=event.Value();
   // event.Text() is the formatted legend string when legend is enabled
  }

Related

• Checkbox, toggle, and slider guide

MuiSpinEditHost

Purpose

Numeric input combining a native OBJ_EDIT field with canvas-painted stepper buttons. Best for bounded numbers with min, max, step, and decimal places.

Source: Controls/Inputs/SpinEditHost.mqh (extends MuiTextBoxHost).

Create It

MuiSpinEditHost *lots=Mui::SpinEdit(parent,0.01,100.0,0.10,0.01,2,NULL,220.0,0.0,true);
lots.Id(APP_INPUT_LOTS);

Argument order on Mui::SpinEdit: parent, min, max, initial, step, decimals, handler, width, height, stepperFilled.

MuiCreate::SpinEdit(...) and MuiCreate::SpinEdit(parent, MuiSpinEditConfig) for explicit bounds. Form row: Mui::LabeledSpinEdit.

Events

Programmatic .Value(...) clamps and refreshes text but does not fire the handler or event bus (per class documentation).

Common Setters

Common Reads

Notes

• Native edit behaviour, modal suppression, and scroll clipping follow Native input hosts.
• Right side reserves logical space for steppers via NativeRightInsetLogical().

Example

if(event.EventId()==MUI_EVENT_VALUE_CHANGED && event.ControlId()==APP_INPUT_LOTS)
  {
   const double lots=event.Value();
  }

Related

• Spin edit guide
• Native input hosts

MuiTextBoxHost

Purpose

Single-line text entry using a chart OBJ_EDIT behind themed canvas chrome. Use for names, symbols, notes, and other one-line strings where native editing behaviour matters.

Source: Controls/Inputs/TextBoxHost.mqh.

Create It

MuiTextBoxHost *name=Mui::TextBox(parent,"Default",260.0,0.0);

MuiCreate::TextBox(parent, x, y, w, h, text, placeholder) — placeholder is applied as tooltip when non-empty.

Mui::LabeledTextBox for label + field rows.

Events

None by default. Read and write .Text() in your save/load or button handlers. The host does not emit app-level UI events on commit.

Common Setters

Common Reads

Notes

• Call MuiRoot::Shutdown() on deinit so native objects are removed.
• Inside scroll views or modals, hosts hide or resize the native object to avoid overflow; see Native input hosts.

Example

void CMyPanel::OnMuiEvent(MuiRoot &root,const MuiEventData &event)
  {
   if(event.EventId()==MUI_EVENT_CLICK && event.ControlId()==APP_ACTION_SAVE)
     {
      const string name=m_name.Text();
      // persist name
     }
  }

Related

• Text inputs guide
• Native input hosts

MuiTextAreaHost

Purpose

Multi-line native text host with optional auto-scroll and line-oriented helpers (AppendLine, Line, SetLine, etc.). Use for logs, comments, and longer editable text.

Source: Controls/Inputs/TextAreaHost.mqh (extends MuiTextBoxHost).

Create It

MuiTextAreaHost *notes=Mui::TextArea(parent,"",420.0,120.0,false);

MuiCreate::TextArea(parent, x, y, w, h, text) for explicit bounds. Mui::LabeledTextArea for form rows.

Events

None by default. Poll or read .Text() / line helpers when the user triggers an action (for example a Save button click).

Common Setters

Common Reads

Notes

• Same native host limitations as MuiTextBoxHost.
• TextHostChromeGrowPx is 0 so borders stay inside logical bounds (reduces parent clip issues).

Example

if(event.EventId()==MUI_EVENT_CLICK && event.ControlId()==APP_ACTION_READ_NOTES)
  {
   const string body=m_notes.Text();
  }

Related

• Text inputs guide
• Native input hosts

MuiComboBoxHost

Purpose

Combo field backed by a native text edit plus a dropdown menu overlay for item selection. Supports filtering typed text against the item list when the menu opens.

Source: Controls/Inputs/ComboBoxHost.mqh.

Create It

string modes[];
ArrayResize(modes,3);
modes[0]="Manual";
modes[1]="Semi-auto";
modes[2]="Disabled";

MuiComboBoxHost *mode=Mui::ComboBox(parent,modes,0,260.0,0.0);
mode.Id(APP_INPUT_MODE);

Mui::ComboBox(parent, items[], handler, initialText, width, height) and MuiCreate::ComboBox overloads. Mui::LabeledCombo for labelled forms.

Events

Programmatic .Selected(index) sets text without firing selection handlers or the event bus.

Common Setters

Common Reads

Notes

• Native edit + overlay menu: see Native input hosts.
• NativeRightInsetLogical() reserves space for the dropdown affordance.
• MuiDropdown (navigation menu button) is documented on Navigation (Phase 4).

Example

if(event.EventId()==MUI_EVENT_SELECTION_CHANGED && event.ControlId()==APP_INPUT_MODE)
  {
   const int ix=event.Index();
   const string label=event.Text();
  }

Related

• Combo and dropdown guide
• Native input hosts

MuiRadioGroup

Purpose

Mutually exclusive options rendered as radio items. Each option is a child MuiRadioItem created via AddOption.

Source: Controls/Inputs/RadioGroup.mqh.

Create It

MuiRadioGroup *side=Mui::RadioGroup(parent,NULL);
side.AddOption("Buy");
side.AddOption("Sell");
side.Id(APP_INPUT_SIDE);
side.Selected(0);  // programmatic; does not emit events

MuiCreate::RadioGroup(parent, x, y, w, h) or overload with items[], selectedIndex, and optional handler.

Events

Programmatic .Selected(idx) updates highlight only; use user Select path for events (user clicks call Select internally).

Common Setters

Common Reads

Notes

• Child items are owned by the group container.
• Prefer assigning .Id(...) on the group, not on individual radio items.

Example

if(event.EventId()==MUI_EVENT_SELECTION_CHANGED && event.ControlId()==APP_INPUT_SIDE)
  {
   const bool isBuy=(event.Index()==0);
   const string label=event.Text();
  }

Related

• Checkbox, toggle, and slider guide
• Combo and dropdown guide

MuiDatePicker

Purpose

Date field with calendar popup (MuiCalendarPopup) opened from a button-styled field. Enforces optional min/max dates on calendar picks.

Source: Controls/Inputs/DatePicker.mqh.

Create It

MuiDatePicker *start=Mui::DatePicker(parent,TimeCurrent(),NULL,220.0,0.0,0.0);
start.Id(APP_INPUT_START_DATE);

MuiCreate::DatePicker(parent, x, y, w, h, value). Mui::LabeledDatePicker for form rows.

Events

Programmatic .Value(datetime) updates the field without emitting the event bus event.

Common Setters

Common Reads

Notes

• Calendar opens in the root overlay layer; backdrop dismiss closes the popup.
• Field inherits button-like chrome setters (SizePt, Pad, Radius) from the date field implementation.

Example

if(event.EventId()==MUI_EVENT_DATE_CHANGED && event.ControlId()==APP_INPUT_START_DATE)
  {
   const datetime d=event.Date();
  }

Related

• Event Bus — MUI_EVENT_DATE_CHANGED

MuiColorPicker

Purpose

Full color editor with swatch preview, HSV square, hue strip, and RGB/HSL/Lab spin groups. Emits preview events while the value changes and a commit event when the user confirms.

Source: Controls/Inputs/ColorPicker.mqh.

Create It

MuiColorPicker *accent=Mui::ColorPicker(parent,0xFF3B82F6,NULL);
accent.Id(APP_INPUT_ACCENT);

MuiCreate::ColorPicker(parent, x, y, w, h, color) uses color type for initial value. Mui::LabeledColorPicker for form rows.

Events

Revert restores baseline without emitting MUI_EVENT_COLOR_CHANGED.

Common Setters

Common Reads

Notes

• Preview events can be frequent while dragging; throttle heavy work in OnMuiEvent if needed.
• Internal spin edits and swatches are sub-controls; route using the picker’s .Id(...).

Example

if(event.EventId()==MUI_EVENT_COLOR_PREVIEW_CHANGED && event.ControlId()==APP_INPUT_ACCENT)
  {
   const uint preview=(uint)event.Argb();
  }
else if(event.EventId()==MUI_EVENT_COLOR_CHANGED && event.ControlId()==APP_INPUT_ACCENT)
  {
   const uint committed=(uint)event.Argb();
  }

Related

• Event Bus — color events
• Themes and tokens

Related Pages

• Spin edit guide
• Text inputs guide
• Combo and dropdown guide
• Checkbox, toggle, and slider guide
• Event Bus