Skip to content

Modern Tui TuiBlock AddTitle

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

Home › Terminal TUI Library › Core Widgets › TuiBlock.AddTitle

TuiBlock.AddTitle

Adds a title to one side of the border, aligned left, centre or right.

Syntax

TuiBlock.AddTitle( byref t as ustring, byval st as TuiStyle, byval side as TuiBorderSide = TUISIDE_TOP, byval align as TuiAlign = TUIALIGN_LEFT )

Description

Adds a title to one side of the border. SEVERAL TITLES CAN SHARE ONE BORDER, each independently aligned -- which is how the btop-style header row puts a hotkey and a menu on the left and a clock hard against the right.

Example

#import "std/tui"
using tui

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

dim as TuiBlock b
b.borderKind = TUIBORDER_ROUNDED
b.sides = TUISIDE_ALL
b.AddTitle( "1cpu",  th.accent, TUISIDE_TOP, TUIALIGN_LEFT )
b.AddTitle( "menu",  th.dim_,   TUISIDE_TOP, TUIALIGN_LEFT )
b.AddTitle( "12f",   th.normal, TUISIDE_TOP, TUIALIGN_RIGHT )
b.AddTitle( "q quit", th.dim_,  TUISIDE_BOTTOM, TUIALIGN_RIGHT )
b.Render( *f, f->Area( ) )
print b.titles.Count( )           '' 4

See also

TuiBlock TuiBorderSet TuiTitle TuiParagraph TuiListState TuiTable
TuiBlock.Inner TuiBorderGlyphs TuiTitleOf TuiList TuiRow TuiTableState

Library: Terminal TUI Library
Category: Terminal TUI Library
Documented under: Core Widgets
Working examples: hello.tiko · form.tiko · dashboard.tiko


Home · Keyword Index

Clone this wiki locally