iwidgets::canvasprintdialog(1)

💖 iwidgets::canvasprintdialog — the manual page, but make it make sense 💖

okay bestie, so this is iwidgets::canvasprintdialog(1) from the [incr Widgets] collection — it's a Tk manual page, section 1. Yes, the section number is real, no I'm not joking, section 1 is for user commands. Anyway. Sit down, grab a boba, we're printing canvases. 🎀

---

✨ NAME ✨

iwidgets::canvasprintdialog — creates and manipulates a canvas print dialog widget. That's it, that's the whole vibe: it makes a dialog, and you can poke at it. 💅

---

🌸 SYNOPSIS 🌸

iwidgets::canvasprintdialog pathName ?options?

---

🦋 INHERITANCE 🦋

the family tree, and yes it's giving royal lineage:

itk::Toplevel ← iwidgets::Dialogshell ← iwidgets::Dialog ← iwidgets::Canvasprintdialog

so like, everything at the top of that chain? it's literally inside this widget too. it's giving nepo baby but make it legitimate. 👑

---

⭐ STANDARD OPTIONS ⭐

these are the standard ones, all lowercase, all iconic:

• activeBackground
• background
• borderWidth
• cursor
• foreground
• highlightBackground
• highlightColor
• highlightThickness
• insertBackground
• insertBorderWidth
• insertOffTime
• insertOnTime
• insertWidth
• relief
• repeatDelay
• repeatInterval
• selectBackground
• selectBorderWidth
• selectForeground

the "options" manual entry has the deets on all of these, iykyk. go read it, bestie. 📖

---

💜 ASSOCIATED OPTIONS 💜

these ones come from its canvasprintbox bestie:

• filename
• hpagecnt
• orient
• output
• pagesize
• posterize
• printcmd
• printregion
• vpagecnt

the "canvasprintbox" widget manual entry explains all of the above. not me outsourcing the lore, but also yes. 🫶

---

🧚 INHERITED OPTIONS 🧚

from dialogshell:

• buttonBoxPadX
• buttonBoxPadY
• buttonBoxPos
• padX
• padY
• separator
• thickness

see the "dialogshell" widget manual entry for these, fr fr.

from shell:

• master
• modality

see the "shell" widget manual entry for those two. 💫

from Toplevel:

• title

see the "Toplevel" widget manual entry for that one. 🌈

---

🎀 WIDGET-SPECIFIC OPTIONS 🎀

...nothing here. it's empty. this section is the quiet friend in the group chat. 💀 like it exists but it has nothing to say. iconic behaviour honestly.

---

🔥 DESCRIPTION 🔥

The iwidgets::canvasprintdialog command creates a print dialog — for printing the contents of a canvas widget to a printer or to a file. 🖨️✨

and you get to control the whole situation: you can specify page orientation, you can specify how many pages to print the image on, and you can decide whether the output should be stretched to fit the page. so many choices, and every one of them is yours. main character energy. 👑

---

🩷 METHODS 🩷

The iwidgets::canvasprintdialog command creates a new Tcl command whose name is pathName. you can use that command to invoke various operations on the widget. general form goes like this:

pathName option ?arg arg ...?

option and the args decide the exact behavior of the command. and these are the commands that are possible for canvasprintdialog widgets: 👇

---

🌼 ASSOCIATED METHODS 🌼

• getoutput
• setcanvas
• refresh
• print

see the "canvasprintbox" class manual entry for the details on all of these. 💖

---

🌟 INHERITED METHODS 🌟

from buttonbox:

• add
• buttonconfigure
• defaulthide
• insert
• invoke
• show

see the "buttonbox" widget manual entry for the details, bestie.

from dialogshell:

• activate
• deactivate

see the "dialogshell" widget manual entry for those two. ⭐

---

💫 WIDGET-SPECIFIC METHODS 💫

• pathName cget option — returns the current value of the configuration option given by option. and option may have any of the values accepted by the iwidgets::canvasprintdialog command. literally any of them, no gatekeeping. 🔍
• pathName configure ?option? ?value option value ...? — query or modify the configuration options of the widget. here's the tea, in order:
  • if no option is specified, it returns a list describing all of the available options for pathName (peep Tk_ConfigureInfo for info on the format of this list).
  • if option is specified with no value, then the command returns a list describing that one named option (and this list will be identical to the corresponding sublist of the value you'd get if no option was specified — yes, same info, smaller portion).
  • if one or more option-value pairs are specified, then the command modifies the given widget option(s) to have the given value(s); in this case the command returns an empty string. nothing. silence. 🫥
  • and option may have any of the values accepted by the iwidgets::canvasprintdialog command.

---

🍓 COMPONENTS 🍓

• Name: cpb
• Class: Canvasprintbox

The cpb component is the canvas print box for the canvas print dialog. see the "canvasprintbox" widget manual entry for the details on the cpb component item. 🧺

---

💀 EXAMPLE 💀

steal this, it works:

package require Iwidgets 4.0
iwidgets::canvasprintdialog .cpb
.cpb activate

---

👑 AUTHOR 👑

Tako Schotanus

Tako.Schotanus@bouw.tno.nl

we stan. thank you for your service. 🫡💖

---

🔑 KEYWORDS 🔑

canvasprintdialog, canvasprintbox, dialog, widget

---

so yeah, that's the whole page. the footer says it's a Tk manual page, from iwidgets::canvasprintdialog(1) — the [incr Widgets] corner of the Tk universe. that's your source and your version, bestie, and there's genuinely no date on this one so I'm not gonna invent one. 🎀✨

go print something, you absolute legend. periodt. 💅