Table of Contents

Method Reserve

Namespace
Terminal.Gui.Drawing
Assembly
Terminal.Gui.dll

Reserve(Rectangle)

Reserves a rectangular region of cells. Reserved cells do not produce visible output and do not affect this canvas's intersection resolution or GetCellMap() output. They are metadata consumed during multi-canvas compositing (see RenderLineCanvas(DrawContext?)): reserved cells claim their positions so that cells from canvases composited later do not show through.

public void Reserve(Rectangle rect)

Parameters

rect Rectangle

The rectangle of cells to reserve, in canvas coordinates.

Remarks

Use this for intentional gaps in borders — positions where a line is deliberately absent and lines from other canvases should not show through. For example, the open gap in a focused tab's border where the tab header connects to the content area.

Compare with Exclude(Region): Exclude filters this canvas's own resolved output (lines still auto-join through excluded positions). Reserve has no effect on this canvas — it only affects how multiple canvases are layered during compositing.

Reserved cells are cleared when Clear() is called.