Display
Display controls show information, status, visual grouping, and feedback. Most do not emit app-level events unless they include explicit actions.
Controls And Helpers
| Control/helper | Use it for | Emits events |
|---|---|---|
MuiLabel |
Text display. | None by default |
MuiBadge |
Small status pill/chip. | None by default |
MuiIcon |
Icon display using atlas or canvas fallback. | None by default |
MuiProgressBar |
Linear progress. | None by default |
MuiLoadingSpinner |
Loading/working indicator. | None by default |
MuiStatusBar |
Footer/status item strip. | None by default |
MuiSwatch |
Color swatch display. | None by default |
MuiHoverRow |
Row container with hover background. | None by default |
MuiCard |
Card with header/body/actions. | MUI_EVENT_CARD_ACTION when header actions are used |
MuiStatCard |
KPI/stat summary card. | None by default |
MuiHeader |
Header/title strip. | None by default |
MuiAlertBanner |
Inline alert with action/dismiss support. | MUI_EVENT_ALERT_ACTION, MUI_EVENT_ALERT_DISMISSED |
Event Fields
| Event | Useful fields |
|---|---|
MUI_EVENT_CARD_ACTION |
Index(), Value(), Text(), Argb() |
MUI_EVENT_ALERT_ACTION |
Text() |
MUI_EVENT_ALERT_DISMISSED |
Text() |
For MuiAlertBanner, see the full entry on Overlays.
App-level events require .Id(...) ≥ 0 on interactive controls. See Event Bus.
MuiLabel
Purpose
Canvas text display: single-line with ellipsis, optional multiline wrap, alignment, and colour overrides.
Source: Controls/Display/Label.mqh.
Create It
MuiLabel *title=Mui::Label(parent,"Account summary",0.0,0.0);
Mui::CaptionLabel(parent,"Section",0.0,0.0);
MuiCreate::Label(parent, x, y, w, h, text).
Events
None by default.
Common Setters
| Setter | Purpose |
|---|---|
.Text(...) / .text |
Label string. |
.Align(h, v) |
Horizontal/vertical alignment in bounds. |
.Multiline(true) |
Word wrap inside width. |
.CaptionTypography(true) |
Caption font when FontSize not set. |
.TextColor(argb) |
Foreground override (0 = theme). |
.LineSpacing(...), .SizePt(...), .SetFixedSize(...), .FullWidth(...) |
Layout and typography. |
Related
MuiBadge
Purpose
Small status pill/chip for compact state text (neutral, success, warning, danger variants).
Source: Controls/Display/Badge.mqh.
Create It
MuiBadge *st=Mui::Badge(parent,"Live",MUI_BADGE_SUCCESS);
MuiCreate::Badge(parent, x, y, w, h, text, variant).
Events
None by default.
Common Setters
| Setter | Purpose |
|---|---|
.Text(...) |
Badge label (auto-sizes). |
.Variant(...) |
MUI_BADGE_NEUTRAL, SUCCESS, WARNING, DANGER, etc. |
.BgColor, .TextColor, .SizePt(...) |
Overrides. |
Related
MuiIcon
Purpose
Semantic icon (MuiIconKind) or cached bitmap image for logos and custom artwork.
Source: Controls/Display/Icon.mqh.
Create It
MuiIcon *gear=Mui::Icon(parent,MUI_ICON_SETTINGS,20,0);
MuiCreate::Icon(parent, x, y, size, iconKind, argb).
Events
None by default.
Common Setters
| Setter | Purpose |
|---|---|
.Icon(kind, size, argb) |
Built-in semantic icon. |
.Bitmap(key) |
Use g_MuiImageStore bitmap by key. |
.IconAtlasEnabled(false) |
Force vector canvas path instead of PNG atlas. |
.Color(argb) |
Tint (0 = theme text colour). |
Related
MuiProgressBar
Purpose
Horizontal progress indicator with optional percent label.
Source: Controls/Display/ProgressBar.mqh.
Create It
MuiProgressBar *pb=Mui::Progress(parent,0.65,220.0,10.0);
MuiCreate::ProgressBar(parent, x, y, w, h, value).
Events
None by default. Read .Value() after updates or bind to your own refresh logic.
Common Setters
| Setter | Purpose |
|---|---|
.Value(0..1) |
Normalized progress. |
.FillColor / .AccentColor(argb) |
Bar fill colour. |
.PercentLabelMode(...) |
Show/hide/format percent text. |
.Radius(...), .SetFixedSize(...) |
Chrome. |
Related
MuiLoadingSpinner
Purpose
Animated loading indicator with optional status text.
Source: Controls/Display/LoadingSpinner.mqh.
Create It
MuiLoadingSpinner *sp=MuiCreate::LoadingSpinner(parent,0,0,120,32,"Loading...",true);
Events
None by default.
Common Setters
| Setter | Purpose |
|---|---|
.Text(...) |
Status caption. |
.Running(true/false) |
Start/stop animation. |
.SetFixedSize(...) |
Bounds. |
Related
MuiStatusBar
Purpose
Footer-style strip of label/value status items with optional separators and tone colours.
Source: Controls/Display/StatusBar.mqh.
Create It
MuiStatusBar *sb=MuiCreate::StatusBar(parent,0,0,600,28);
sb.AddItem("conn","Connection","Connected",MUI_STATUS_SUCCESS);
Pin to window bottom: Mui::PinStatusBarToWindowBottom(win, sb).
Events
None by default.
Common Setters
| Setter | Purpose |
|---|---|
.AddItem(id, label, value, tone) |
Append status cell. |
.ClearItems() |
Remove all items. |
| Item update helpers on returned indices (see source). | |
.SetFixedSize(...), alignment helpers via Mui::StatusBarItemsAlign |
Layout. |
Notes
- Owned by parent/window when attached; use window footer APIs for docking.
Related
MuiSwatch
Purpose
Small filled colour square/circle for previews and legends.
Source: Controls/Display/Swatch.mqh.
Create It
MuiSwatch *sw=Mui::Swatch(parent,0xFF3B82F6,16.0);
MuiCreate::Swatch(parent, x, y, size, argb).
Events
None by default.
Common Setters
| Setter | Purpose |
|---|---|
.Color(argb) |
Fill colour. |
.SetFixedSize(size, size) |
Square dimensions. |
Related
MuiHoverRow
Purpose
Container that paints a subtle hover background behind its children — useful for list-like rows built manually.
Source: Controls/Display/HoverRow.mqh.
Create It
MuiHoverRow *row=Mui::HoverRow(parent,36.0,10.0);
row.Add(Mui::Label(parent,"Row label"));
Events
None by default (hover is visual only).
Common Setters
| Setter | Purpose |
|---|---|
.SetFixedSize(w, h) / height via factory |
Row bounds. |
.Radius(...) |
Hover plate corner radius. |
.Add(child) |
Child content (owned by row). |
Related
MuiCard
Purpose
Dashboard card with title/subtitle, optional left icon, optional header action icons, optional left accent strip, and owned body container for child controls.
Source: Controls/Display/Card.mqh.
Create It
MuiCard *card=Mui::Card(parent,"Performance","Last 24h",MUI_ICON_CHART,320.0,180.0);
card.Id(APP_CARD_PERF);
Mui::Label(card.Body(),"Equity curve");
MuiCreate::Card, Mui::CardEx. Body is card.Body() — children added with Body()->Add(...) or card.Add(...).
Events
| Event | When it fires | Useful fields |
|---|---|---|
MUI_EVENT_CARD_ACTION |
Header action icon clicked | ControlId(), Index() (action index), Value() (index), Text() (icon type as string), Argb() (action icon colour) |
Requires .Id(...) on the card. Action handlers passed to AddActionIcon are owned by the card.
Common Setters
| Setter | Purpose |
|---|---|
.Title(...), .Subtitle(...) |
Header text. |
.Body() |
Owned MuiContainer for content. |
.AddActionIcon(type, handler, argb) |
Header icon button (handler owned). |
.LeftAccentWidth, .LeftAccentTone, variant/ colour overrides |
Visual chrome. |
.SetFixedSize(w, h) |
Explicit tile size (0,0 uses intrinsic height). |
Example
if(event.EventId()==MUI_EVENT_CARD_ACTION && event.ControlId()==APP_CARD_PERF)
{
const int actionIx=event.Index();
}
Related
MuiStatCard
Purpose
Compact KPI card: label, large value, optional delta line, optional left accent stripe.
Source: Controls/Display/StatCard.mqh.
Create It
MuiStatCard *kpi=Mui::StatCard(parent,"Equity","12,450","+2.3%",0xFF22C55E,260.0,120.0);
MuiCreate::StatCard, Mui::StatCardEx for extra typography control.
Events
None by default.
Common Setters
| Setter | Purpose |
|---|---|
.Label(...), .Value(...), .Delta(...) |
KPI text. |
.Accent(argb), .AccentWidth(...) |
Left stripe. |
.DeltaColor, .LabelColor, .ValueColor |
Text colours. |
.SetFixedSize(...) |
Tile size. |
Related
MuiHeader
Purpose
Header strip container for title rows, tabs, or toolbar content. Often pinned to MuiWindow top via Mui::PinHeaderToWindowTop.
Source: Controls/Display/Header.mqh.
Create It
MuiHeader *hdr=new MuiHeader();
hdr.Title("Trade panel");
Mui::PinHeaderToWindowTop(win,hdr,48.0);
Events
None by default.
Common Setters
| Setter | Purpose |
|---|---|
.Title(...), .Subtitle(...) |
Header text. |
.Height(logical) |
Fixed strip height (<=0 for auto). |
.Add(child) |
Additional header content (owned). |
Notes
- Ownership transfers to window when pinned via
PinHeaderToWindowTop.