tcl::c...twindow(3tcl)

📦
version 2.0 · 2 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

tcl::chan::textwindow 💖 the textwindow channel bestie

okay so before we even get into it — this page lives in the Reflected/virtual channel support corner of the tcllib manual, section 3tcl. and the manual name is literally tcl::c...twindow(3tcl) because terminals are dramatic and truncate things. 🙈 anyway. sit down, grab a strawberry 🍓, let's talk.

✨ NAME ✨

tcl::chan::textwindow — Textwindow channel 🎀

✨ SYNOPSIS ✨

package require Tcl 8.5 9

package require TclOO

package require tcl::chan::events ?1.1?

package require tcl::chan::textwindow ?1.1?

::tcl::chan::textwindow widget

like. look at that. five whole lines of yes you need all of this. 💅

✨ DESCRIPTION ✨

so the tcl::chan::textwindow package hands you a command that makes write-only channels that are glued to text widgets. anything you write into that channel? it gets printed straight into the widget it's attached to. that's it. that's the whole vibe. channel goes in, text widget goes brrr. ✨

the internal TclOO class doing the actual channel-handler work is a sub-class of the tcl::chan::events framework. so it's not out here freelancing, it's got a whole family tree. 🫶

✨ API ✨

  • ::tcl::chan::textwindow widget — this command makes you a brand new textwindow channel and gives you back its handle. anything you write to that channel is gonna show up in the associated widget. no cap. 💖

✨ BUGS, IDEAS, FEEDBACK ✨

okay bestie, real talk: this doc, and the package it's describing? they will undoubtedly have bugs and other problems. not me being shady, that's literally what it says. 😭 so if you find one, please report it in the virtchannel category of the Tcllib Trackers:

http://core.tcl.tk/tcllib/reportlist

and while you're there — got ideas for enhancements? for the package, for the docs, for either one? report those too. we love a thoughtful queen. 👑

if you're proposing code changes, please send unified diffs, aka literally the output of diff -u. no hand-wavy "just change this line" energy. ✨
also: attachments are strongly preferred over inlined patches. to attach something, go to the Edit form of the ticket right after you create it, then hit the left-most button in the secondary navigation bar. that's the door. 🚪💅

✨ KEYWORDS ✨

Tk, reflected channel, text widget, tip 219, virtual channel 🌈

✨ CATEGORY ✨

Channels 🎀

Copyright (c) 2009 Andreas Kupries <andreas_kupries@users.sourceforge.net>

and that's the whole page, bestie — brought to you by tcllib, version 1.1, filed under tcl::c...twindow(3tcl). go make some text widgets say things. mwah. 💜✨

📦 where this page comes from