Skip to content

Modern Tui TuiPopup

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

Home › Terminal TUI Library › Overlays and Chrome › TuiPopup

TuiPopup

Draws a floating panel over the screen, optionally modal and dimming what is behind.

Syntax

type TuiPopup extends TuiWidget
    as TuiBlock frame_
    as TuiRect area
    as boolean dimBackground, modal
    as TuiStyle dimStyle
end type

Description

A floating panel. It ignores the area passed to Render and uses its own area field, because an overlay is positioned in screen space. modal makes it swallow every event, and dimBackground blends the style of everything behind it.

Example

#import "std/tui"
using tui

dim as TuiScreen scr
scr.Resize( 40, 12 )
dim as TuiFrame ptr f = scr.BeginFrame( )
dim as TuiTheme th = TuiThemeDefault( )

f->DrawText( 0, 0, "the application, behind", TuiStyleDefault( ) )

dim as TuiPopup p
p.area = TuiCenter( f->Area( ), 20, 5 )
p.modal = TRUE
p.dimBackground = TRUE
p.dimStyle = th.dim_
p.frame_.borderKind = TUIBORDER_DOUBLE
p.frame_.sides = TUISIDE_ALL
p.Render( *f, f->Area( ) )

See also

TuiMessageBox TuiMenu TuiStatusItem TuiStatusBar.Add
TuiMessageBox.Accepted TuiMenuBar TuiStatusItemOf TuiTreeNode
TuiMessageBox.Cancelled TuiMenuBar.IsOpen TuiStatusBar TuiTreeState

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


Home · Keyword Index

Clone this wiki locally