Data views

Data views display rows, columns, lists, and tree structures. They usually depend on a source object that supplies row content.

Controls And Sources

Event Fields

App-level events require .Id(...) ≥ 0. See Event Bus.

List vs table: MuiListView emits MUI_EVENT_SELECTION_CHANGED only (no MUI_EVENT_ITEM_CLICK on the bus). MuiTableView emits row/cell/header events as listed below.

Source Ownership And Refresh

Data views read from sources the application owns. The view registers a non-owned observer; it does not delete your source.

Deeper patterns: Table and list sources.

MuiItemSource

Purpose

Abstract data contract for MuiListView. Supplies item count and binds each visible row slot to a source index.

Source: Controls/Data/ItemSource.mqh (extends MuiBindableSource).

Implement It

class CMyListSource : public MuiItemSource
  {
public:
   virtual int Count(void)
     {
      return ArraySize(m_rows);
     }

   virtual void BindRow(MuiRowTemplate *row,const int index)
     {
      if(row==NULL) return;
      row.ResetSlotsBeforeBind();
      row.primary.Text(m_rows[index].title);
      if(m_rows[index].status!="")
        {
         row.badge.Text(m_rows[index].status);
         row.badge.SetVisible(true);
        }
     }
  };

Events

None. Views emit events; sources only notify observers via NotifyChanged().

Key API

Notes

• Virtualized lists call BindRow only for visible row slots, not once per data row.
• Always reset optional slots (ResetSlotsBeforeBind() on MuiRowTemplate) to avoid stale pooled state.

Related

• MuiRowTemplate
• MuiListView

MuiRowTemplate

Purpose

Default reusable row layout for list sources: primary, optional secondary, badge, and meta slots in a horizontal row.

Source: Controls/Data/RowTemplate.mqh.

Create It

You do not construct MuiRowTemplate in EA code for normal usage. MuiListView creates and pools instances; your source fills them in BindRow().

Events

None by default.

Common Setters (in BindRow)

Notes

• Same template instance is rebound to many indices while scrolling — set every field you rely on each time.
• Owned by the list view row pool; configure in BindRow, do not delete the template.

Related

• MuiItemSource

MuiTableSource

Purpose

Abstract data contract for MuiTableView: row/column dimensions, column names, and cell text. Optional SortBy for header-click sorting.

Source: Controls/Data/TableView.mqh (MuiTableSource class; extends MuiBindableSource).

Implement It

class CMyTableSource : public MuiTableSource
  {
public:
   virtual int RowCount(void) { return m_rowCount; }
   virtual int ColCount(void) { return 3; }
   virtual string ColName(const int col) { return m_colNames[col]; }
   virtual string CellText(const int row,const int col)
     {
      return m_cells[row][col];
     }
   virtual void SortBy(const int col,const bool ascending)
     {
      // optional: reorder m_cells, then NotifyChanged()
     }
  };

Events

None. The table view emits UI events.

Key API

Related

• MuiTableView
• MuiSimpleTableSource

MuiSimpleTableSource

Purpose

In-memory string grid implementing MuiTableSource. Used by Mui::SimpleTable and MuiCreate::SimpleTableSource.

Source: Controls/Data/TableView.mqh.

Create It

string headers[];
ArrayResize(headers,3);
headers[0]="Symbol";
headers[1]="Side";
headers[2]="PnL";

MuiSimpleTableSource *src=MuiCreate::SimpleTableSource(headers);
string row[];
ArrayResize(row,3);
row[0]="EURUSD"; row[1]="Buy"; row[2]="12.5";
MuiCreate::AddTableRow(src,row);

MuiTableView *tv=Mui::TableView(parent,src,520.0,260.0);
tv.Id(APP_TABLE_POSITIONS);

Or use MuiSimpleTable table=Mui::SimpleTable(parent, headers, rows, ...).

Events

None (table view emits events).

Common API

Notes

• Application owns the source; MuiTableView does not delete it.
• After bulk edits, NotifyChanged() runs automatically from setters that mutate data.

Related

• Table and list sources
• MuiSimpleTable wrapper

MuiTreeSource

Purpose

Abstract contract for MuiTreeView: flattened visible rows with depth, expand state, and toggle.

Source: Controls/Data/TreeView.mqh.

Key API

Events

None (tree view emits events). Indices in tree events are visible-row indices, not stable node IDs unless you map them in your source.

Related

• MuiTreeView

MuiListView

Purpose

Virtualized list: a small pool of row templates bound to visible indices. Use with custom MuiItemSource or Mui::ListBox for simple strings.

Source: Controls/Data/ListView.mqh.

Create It

CMyListSource *src=new CMyListSource();
MuiListView *list=Mui::ListView(parent,src,260.0,200.0);
list.Id(APP_LIST_SYMBOLS);

MuiCreate::ListView(parent, x, y, w, h, source) for explicit bounds.

Simple strings: MuiListBox lb=Mui::ListBox(parent, items, selectedIndex, w, h).

Events

MuiListView does not emit MUI_EVENT_ITEM_CLICK on the event bus. Item/double-click intent handlers exist for advanced/legacy use only.

Common Setters

Common Reads

Performance notes

• Only visible rows are bound each frame/layout — suitable for large Count() when BindRow is cheap.
• Call NotifyChanged() on the source after bulk updates instead of recreating the list.
• Fixed RowHeight keeps scroll and hit-testing predictable.

Example

if(event.EventId()==MUI_EVENT_SELECTION_CHANGED && event.ControlId()==APP_LIST_SYMBOLS)
  {
   const int ix=event.Index();
   if(ix>=0)
      LoadSymbol(ix);
  }

Related

• Table, list, and tree guide

MuiTableView

Purpose

Virtualized data table: sortable header, column widths/flex, row selection (optional multi-select), horizontal/vertical scroll, cell and header interaction.

Source: Controls/Data/TableView.mqh.

Create It

MuiTableView *tv=Mui::TableView(parent,src,520.0,260.0);
tv.Id(APP_TABLE_TRADES);
tv.ColWidth(0,120.0);
tv.ColFlex(1,1.0);
tv.ShowGrid(true);
tv.SelectionEnabled(true);

MuiCreate::Table(parent, x, y, w, h, source, scrollable) or MuiCreate::Table + MuiTableConfig.

Events

Important: MUI_EVENT_TABLE_CELL_DOUBLE_CLICK is emitted only when SetCellDoubleClickedHandler(...) is set to a non-NULL handler (the view early-outs otherwise). For event-bus-only code, assign a minimal handler or use single-click/cell-click events.

Header click calls MuiTableSource::SortBy when implemented.

Common Setters

Common Reads

Performance notes

• Body uses a virtualized cell pool (visible rows × columns), not one widget per data row.
• Prefer NotifyChanged() over destroying/recreating the table for updates.
• Very wide tables: enable ScrollableX; assign explicit ColWidth for key columns and ColFlex for stretch columns.
• CellText should return display strings only — avoid heavy work per cell during paint.

Example

void CPanel::OnMuiEvent(MuiRoot &root,const MuiEventData &event)
  {
   if(event.ControlId()!=APP_TABLE_TRADES)
      return;

   if(event.EventId()==MUI_EVENT_TABLE_CELL_CLICK)
     {
      const int r=event.Row();
      const int c=event.Col();
      const string cell=event.Text();
     }
   else if(event.EventId()==MUI_EVENT_TABLE_HEADER_CLICK)
     {
      const string colName=event.Text();
     }
   else if(event.EventId()==MUI_EVENT_SELECTION_CHANGED)
     {
      const int row=event.Row();
     }
  }

Related

• Table, list, and tree guide

MuiTreeView

Purpose

Virtualized hierarchical list using a flattened visible-row model from MuiTreeSource. Supports expand/collapse gutter, selection, and double-click.

Source: Controls/Data/TreeView.mqh.

Create It

CMyTreeSource *src=new CMyTreeSource();
MuiTreeView *tree=Mui::TreeView(parent,src,360.0,220.0);
tree.Id(APP_TREE_NAV);

MuiCreate::TreeView(parent, x, y, w, h, source) for explicit bounds.

Events

Text() on tree events is VisibleText(index).

Common Setters

Common Reads

Performance notes

• Virtualized visible-row pool (similar to list).
• Rebuild visible list in the source efficiently; call NotifyChanged() once per logical tree mutation batch.

Example

if(event.EventId()==MUI_EVENT_EXPANDED_CHANGED && event.ControlId()==APP_TREE_NAV)
  {
   const bool expanded=event.Expanded();
   const string nodeLabel=event.Text();
  }

Related

• Table, list, and tree guide

MuiSimpleTable and MuiListBox

Purpose

Fast wrapper structs from Factory/Factory.mqh that pair a view with a heap-allocated simple source.

Create It

MuiListBox lb=Mui::ListBox(parent,items,0,260.0,200.0);
lb.list.Id(APP_LIST_BOX);

MuiSimpleTable st=Mui::SimpleTable(parent,headers,10,520.0,180.0,true,true);
st.table.Id(APP_TABLE_SIMPLE);
st.SetCell(0,0,"EURUSD");

Events

Emitted by the contained list or table (assign .Id(...) on lb.list / st.table).

Ownership

• MuiListView / MuiTableView do not own the source.
• Keep MuiListBox / MuiSimpleTable (or at least .source) alive while editing.
• Delete source on shutdown if you need explicit cleanup after removing the view.

See Table and list sources for SetItem, Refresh, SetCell, and row helpers.

Related

• Fast wrapper types

Related Pages

• Table, list, and tree guide
• Table and list sources
• Event Bus