TextUndo(3pm)

💖 TextUndo — the Tk::TextUndo era 💖

okay bestie so Tk::TextUndo is a perl/tk text widget, and it comes with bindings that let you undo your changes. that's the whole vibe. it lives in section 3pm of the perl manual, iykyk. 🦋

---

✨ SYNOPSIS ✨

use Tk::TextUndo;

$testundo = $parent->TextUndo(?-option=>value, ...?);

like, that's it. that's the whole summoning ritual. 💅

---

🌸 DESCRIPTION 🌸

so this widget IS-A text widget — it inherits all that text widget energy — but with one iconic upgrade: an unlimited 'undo' history. 🔥

lowkey important caveat tho: there is no re'undo' capability. no cap. you can go backwards forever, but you cannot go back forwards. it's giving one-way street. 😭

🎀 Bindings 🎀

the TextUndo widget has the exact same bindings as the Text widget, bestie. but in addition, there's this extra one:

• Event <L4> <<Undo>> — undoes the last change. and the way that pressing <L4> several times undoes the changes step by step?? obsessed. every press rewinds you one more step through everything you did to the text widget. 👑

🧚 Methods 🧚

same methods as the Text widget, obviously, it IS-A text widget. but here are the extra ones TextUndo brings to the group chat:

• $text->Load($filename); — loads the contents of $filename into the text widget. heads up bestie: Load() deletes the previous contents of the text widget, and it also wipes the undo history of the previous file. clean slate, periodt. 🫶
• $text->Save(?$otherfilename?) — saves the contents of the text widget to a file. if $otherfilename isn't specified, it writes the contents to the file of $filename that was used in the last Load() call. if no file was previously Load()'ed... an error message pops up. 💀 and btw, the default filename from the last Load() call is not overwritten by $otherfilename. noted. 📝
• $text->FileName(?$otherfilename?) — if you pass it an argument, it sets the file name associated with the loaded document. and either way it returns the current file name associated with the document. dual purpose icon. ✨

---

🔑 KEYS 🔑

• widget
• text
• undo

---

👀 SEE ALSO 👀

• Tk::Text
• Tk::ROText

---

and that's the whole page bestie!! 🌈 this was written by the perl crew and shipped as part of perl v5.40.1, dated 2025-04-13. mwah, go undo something. 💖💅🎀