RUI Studio Help

Table data

Column arrays, enum mapping, cell scalars, paging, clickable keypad.

Property group Data. Fonts and look: Table look and fonts. Overview: Table.

Pick one data source — do not mix them:

SourceRolePaging
Bind column arraysEach column binds a 1-D array; each page shows a sliceYes
Enum mappingstring_table items; each cell picks an item mapped to a scalarNo (preview page ignored)

Bind column arrays

  1. Set the source to Bind column arrays.
  2. Optionally Show sequence column (column 0): automatic 1,2,3…, no array.
  3. Header titles: bind a string table (row i is column i, including the sequence column) or custom multi-line text.
  4. For column 1, column 2… pick a numeric 1-D array variable.
  5. Preview page current/total: which page the canvas shows. Total pages = ceil(longest array length ÷ body rows), at least 1.

Rows per page = table body rows. Page p, row r maps to index p × rows + r.

Display format is currently raw values only.

Cell scalar variable

Bind a scalar on a body cell to override that cell’s column array / sequence. Paging does not change it. Headers cannot bind.

When click-preview is on, a scalar cell shows an amber S. Choose “None” to go back to the array or sequence.

If multi-selected cells disagree, the UI shows “(selection differs)”.

Enum mapping

  1. Switch the source to Enum mapping. Column arrays, sequence column, preview page, and cell-scalar rows hide.
  2. Pick the enum source (a project string_table; one line per item).
  3. Fill the table-level mapping: which scalar each item uses.
  4. Select a body cell and pick the enum item. Headers cannot pick an item.

The canvas shows a teal E badge. Runtime shows the mapped scalar and does not move with a paging window.

Clickable cells and keypad

Enable cell property Clickable:

  • Effect demo / firmware: the cell darkens on press and restores lines and text on release.
  • This does not run a callback on the cell. Use a nearby button or touch area.
  • If the cell has a cell scalar and the table keypad kind is numeric: press opens the numeric keypad; OK writes the scalar. Place a keypad on the same page. Clicking a cell on the design canvas only selects it — it does not open the pad.

You can also Allow switching keypad kind. Changing page closes the keypad.

Merged slave cells do not export a hit area.