TreeDataGrid Glossary

This glossary defines core terms used across TreeDataGrid documentation.

A

`AutoDragDropRows`

A TreeDataGrid control property that enables built-in row drag/drop behavior when supported by the source and current sort state.

B

`BeginEditGestures`

A flags enum that controls how a cell enters edit mode, for example F2, Tap, DoubleTap, and WhenSelected.

C

Cell Model

An object implementing ICell (or specialized interfaces such as ITextCell and IExpanderCell) representing a cell's data/edit state.

`CellIndex`

A struct that addresses a cell by (ColumnIndex, RowIndex) where RowIndex is an IndexPath.

Column Model

An object implementing IColumn, typically one of the built-in column types (TextColumn, TemplateColumn, CheckBoxColumn, HierarchicalExpanderColumn).

E

Element Factory

TreeDataGridElementFactory, responsible for creating and recycling row/cell/header controls.

Expander Column

A hierarchical column implementing IExpanderColumn<TModel>, usually HierarchicalExpanderColumn<TModel>, used to display expand/collapse affordances and navigate child models.

I

`IndexPath`

A hierarchical model index path (for example 0, 0,1, 0,1,2) used as the canonical model address in selection, expansion, drag/drop, and model lookup operations.

`ItemsSourceView`

TreeDataGridItemsSourceView and TreeDataGridItemsSourceView<T>, wrappers that normalize item collection access and notifications.

M

Model Index

A position in the source hierarchy represented by IndexPath. This remains the canonical identity even when visible row positions change.

P

Presenter

A virtualized visual host (rows, cells, headers) responsible for realizing and recycling controls for the current viewport.

R

Realization

The process of materializing a visual control for a model row/cell/header in the current viewport.

Row Model

An object implementing IRow, accessed through IRows.

Row Index (Visible Index)

An int index into currently visible rows. It can differ from model index when sorting or hierarchy expansion changes layout.

S

Selection Interaction

The input-behavior adapter interface ITreeDataGridSelectionInteraction, used by TreeDataGrid to delegate keyboard/pointer/text selection handling.

Source

A data source implementing ITreeDataGridSource, typically FlatTreeDataGridSource<TModel> or HierarchicalTreeDataGridSource<TModel>.

T

Typed Binding

Strongly typed binding APIs in Avalonia.Experimental.Data*, including TypedBinding<TIn> and TypedBinding<TIn,TOut>.

V

Virtualization

The strategy of realizing only visible rows/cells and recycling visuals outside viewport to reduce memory/CPU costs.

Troubleshooting

Term usage differs between API and article Cause: one concept can appear under different names across layers (model vs visual). Fix: use xref links in this glossary as canonical anchors.
New API term is missing here Cause: glossary lags behind API/reference updates. Fix: add the term and link it to the namespace reference article.