ElementTile class Core

A cell composition as a control - a sparkline, a bullet, a donut or any other SlotEl - drawn from one data item: new ElementTile(Cell.Sparkline<Kpi>(k => k.History), kpi) { Height = 48 }. The same drawing a grid cell shows, so a dashboard tile and a table column look alike. Never focusable.

Under the pointer it reacts as the grid cell does: an element with data points marks the one under the pointer (the guide and dot of a sparkline, the column of a column sparkline, the segment of a donut), and ElementTile.Tooltip names it through the grid's tooltip. Built from a chart column (Controls.ElementTile), the tile takes that column's tooltip and spoken text as well.

public sealed class ElementTile : Control
Namespace
ArionUI.Presentation.Controls
Package
ArionUI.Presentation · dotnet add package ArionUI.Presentation --prerelease
Inherits
Control

Constructors

ElementTile

public ElementTile(SlotEl element, object item);

Parameters

element

What to draw (built with the Cell factories).

item

The data item the element's accessors read.

ElementTile

public ElementTile(IColumnDefinition column, object item);

The cell of a column built by Column as a tile, for one item: the drawing, the tooltip naming the data point under the pointer and the spoken text are the ones the grid shows for that column - new ElementTile(Column.Sparkline<Kpi>("Revenue", k => k.History), kpi) { Height = 48 }.

Parameters

column

A column whose cell is a composition (the chart columns).

item

The row the cell shows, of the column's row type.

Properties

Height

public double Height { get; init; }

Desired height; 0 takes the element's own (its fixed height or one line).

Role

public override ControlRole Role { get; }

Text to read when it has a name, decoration otherwise.

Tooltip

public Func<double, string?>? Tooltip { get; init; }

The hover text for the data point under the pointer (-1 when the pointer names none, or the element has no points), shown through the grid's tooltip; null or empty shows none.

Width

public double? Width { get; init; }

Desired width; null takes the width it is given, or the element's own when there is no limit.

Methods

HitTest

public override Control? HitTest(LogPoint p);

Hit only where it reacts to the pointer (data points or a tooltip); otherwise the pointer falls through to the tile's container.

Measure

public override LogSize Measure(LogSize available);

The given width (or ElementTile.Width, or the element's own without a limit) by ElementTile.Height (or the element's own).

OnDetached

protected internal override void OnDetached();

A tile no longer shown stamps nothing.

OnPointerLeft

public override void OnPointerLeft();

The pointer left: a mark it leaves behind goes.

OnPointerMoved

public override void OnPointerMoved(LogPoint p, bool buttonDown);

Follows the pointer and shows the mark of the data point it names when that changes - not on every move. A stamped mark asks for a present only: a sparkline that follows the pointer names another point on nearly every move.

Render

public override void Render(IRenderSurface s, ControlFrame frame);

Draws the element into the bounds, as a grid cell would - with the point under the pointer marked, resolved from the data as it is now, so the mark follows values that change while the pointer rests. A stamped mark (ElementTile.Stamps) is left to ElementTile.RenderPresentStamps.

SpokenLabel

public override string? SpokenLabel();

The Control.AccessibleName, asked each time.