tk_chooseColor(3tk)

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

💖 tk_chooseColor — the Tk Built-In Commands era 💖

okay bestie, gather round, because this one is a Tk built-in command and it is so fun actually. it's a procedure called tk_chooseColor and its whole job is popping up a dialog box so the user can pick a color. that's it. that's the gig. 🎨✨

✨ SYNOPSIS ✨

tk_chooseColor ?option value ...?

🌸 DESCRIPTION 🌸

The procedure tk_chooseColor pops up a dialog box for the user to select a color. no cap, that's literally the entire vibe — you call it, a lil color picker appears, the user does their thing. 💅

The following option-value pairs are possible as command line arguments:

  • -initialcolor color — this one specifies the color to display in the color dialog when it pops up. so like, the pre-selected swatch, the opening mood, the starting lewk. color must be in a form acceptable to the Tk_GetColor function. 🎀
  • -parent window — makes window the logical parent of the color dialog. the color dialog is displayed on top of its parent window, so it's giving "standing directly on top of its parent," very main character energy, very unmissable. 👑
  • -title titleString — specifies a string to display as the title of the dialog box. if this option is not specified, then a default title will be displayed. (yes bestie, it has a fallback title, she's self-sufficient.) 💜

Now, the return tea ☕: if the user selects a color, tk_chooseColor will return the name of the color in a form acceptable to Tk_GetColor. and if the user cancels the operation? both commands will return the empty string. (that's what the page says — both commands — we report, we don't question. 😭) so always check your return value before you go styling anything with it, fr fr.

🔥 EXAMPLE 🔥

button .b -bg [tk_chooseColor -initialcolor gray -title "Choose color"]

look at her. a button, a bg, a lil nested call, and a title. ate. 🫶

🦋 KEYWORDS 🦋

color, color selection, dialog

💫 the sign-off 💫

this page lives in the Tk manual, and it's tagged as version 4.2 — so when you're flipping through the Tk Built-In Commands docs, look for tk_chooseColor(3tk) and you'll find her right there. go pick a color, bestie, you deserve it. 🌈💖

📦 where this page comes from