Skip to content

Modern Tui TuiFrame PushLayer

Paul Squires edited this page Oct 19, 2026 · 6 revisions

Home › Terminal TUI Library › Buffer and Frame › TuiFrame.PushLayer

TuiFrame.PushLayer

Starts an overlay layer, as a popup or an open dropdown uses.

Syntax

TuiFrame.PushLayer( byval r as TuiRect )

Description

Starts an overlay. A popup or an open dropdown draws inside a layer, which is what makes the cells beneath it restorable when it closes -- and the reason an overlay may legitimately draw OUTSIDE the area it was given.

Example

#import "std/tui"
using tui

dim as TuiScreen scr
scr.Resize( 30, 8 )
dim as TuiFrame ptr f = scr.BeginFrame( )

f->DrawText( 0, 0, "behind", TuiStyleDefault( ) )
f->PushLayer( TuiRectOf( 2, 0, 10, 3 ) )
f->FillRect( TuiRectOf( 2, 0, 10, 3 ), " ", TuiStyleOf( TuiWhite( ), TuiBlue( ) ) )
f->PopLayer( )
print scr.Back( )->At( 2, 0 )->st.bg.Index( )      '' 4

See also

TuiCell TuiCell.Equals TuiBuffer TuiBuffer.Clear TuiBuffer.At TuiFrame
TuiCell.SetChar TuiCellBlank TuiBuffer.Resize TuiBuffer.InBounds TuiBuffer.Count TuiFrame.Area

Library: Terminal TUI Library
Category: Terminal TUI Library
Documented under: Buffer and Frame
Working examples: hello.tiko · form.tiko · dashboard.tiko


Home · Keyword Index

Clone this wiki locally