pieBoxLabeler(n)

💖 pieBoxLabeler(n) — the tkpiechart pie box style labeler class 💖

🌸 NAME 🌸

Okay so pieBoxLabeler is the tkpiechart pie box style labeler class — the little bestie that places slice labels for a pie chart and honestly? It’s giving quiet luxury. 🥧✨

🎀 SYNOPSIS 🎀

stooop::new pieBoxLabeler canvas ?options?

switched::configure pieBoxLabelerObject ?options?

switched::cget pieBoxLabelerObject option

🦋 DESCRIPTION 🦋

The pie box style labeler object is used as a slice label placer for a pie object, and you pass it to the pie constructor through its -labeler option — see the pie class manual for the full tea. ☕

The labels are arranged in 2 columns below the pie graphics. Each label text is placed to the right of a rectangle, and that rectangle’s background color matches its corresponding slice. The slice share value is placed to the right of the label text, separated by a semicolon. Each label is actually a canvasLabel object — see the canvasLabel class manual for further information. 💅

There is no need to delete a pieBoxLabeler object, because the pie class automatically handles it. Periodt. 👑

• stooop::new pieBoxLabeler canvas ?options? — Creates a pieBoxLabeler object in the specified Tk canvas. The pieBoxLabeler object identifier is returned (referred to as pieBoxLabelerObject in this document). Slay, you got an object ID. 🫶
• switched::configure pieBoxLabelerObject ?options? — Configures a pieBoxLabeler object, or returns all the options with their current values if no options are passed as parameters. Vibe check, but for options. ✨
• switched::cget pieBoxLabelerObject option — Returns an option value for the specified pieBoxLabeler object. One little value, no cap. 🔍

✨ OPTIONS ✨

• -font value — Specifies a font for the slice labels. If not specified, the default font is system dependent — so your font may vary by system, bestie. 🖍️
• -justify value — Specifies how to justify labels within their own column. Must be one of left, center or right. Defaults to left. For example, if justification is right, all column labels right edges are aligned. Obsessed with a clean edge. 📐
• -offset value — Specifies the distance between the pie graphics and the closest slice label. This value may be specified in any of the forms described in the canvas COORDINATES manual section. It’s giving precise spacing. 📏

🏷️ TAGS 🏷️

The labeler has the following specific tag — see the canvas manual page ITEM IDS AND TAGS section for more information:

• pieBoxLabeler(pieBoxLabelerObject)

😭 BUGS, IDEAS, FEEDBACK 😭

This document, and the package it describes, will undoubtedly contain bugs and other problems. It’s giving “we are human, bestie” — please report such in the category tkpiechart of the Tklib Trackers at http://core.tcl.tk/tklib/reportlist. Please also report any ideas for enhancements you may have for either package and/or documentation. We love feedback fr fr. 🫶

📚 SEE ALSO 📚

canvasLabel, pie, piePeripheralLabeler — go read those next, iykyk. 🌈

🔑 KEYWORDS 🔑

canvas, labeler, pie, slice — literally the whole vibe. 💜

👑 COPYRIGHT 👑

Copyright (c) 1995-2004 Jean-Luc Fontaine <jfontain@free.fr> — protect the copyright, periodt. 👑

---

xoxo bestie 💖 this was pieBoxLabeler(n) from tklib 6.6; the original footer doesn’t show a date, so I’m not inventing one — no cap 🫶