1
0
mirror of https://github.com/SquidDev-CC/CC-Tweaked synced 2024-06-25 06:33:23 +00:00
CC-Tweaked/doc/events/term_resize.md
Jonathan Coates a9519f68a1
Clarify term_resize event
Closes #1000, fixes #999.

Co-authored-by: Wojbie <Wojbie@gmail.com>
2021-12-31 18:16:36 +00:00

691 B

module: [kind=event] term_resize

The @{term_resize} event is fired when the main terminal is resized. For instance:

  • When a the tab bar is shown or hidden in @{multishell}.
  • When the terminal is redirected to a monitor via the "monitor" program and the monitor is resized.

When this event fires, some parts of the terminal may have been moved or deleted. Simple terminal programs (those not using @{term.setCursorPos}) can ignore this event, but more complex GUI programs should redraw the entire screen.

Example

Prints :

while true do
  os.pullEvent("term_resize")
  local w, h = term.getSize()
  print("The term was resized to (" .. w .. ", " .. h .. ")")
end