Prima::...tIndents(3)

💅 Prima::Widget::IntIndents — indenting support (yep, that's the Prima::...tIndents(3) page, bestie)

Okay so this is one of those pages where the title gets truncated by the man renderer and honestly? It's giving mystery. The real name is Prima::Widget::IntIndents, and it's pure Perl widget glue, no cap.

---

✨ NAME ✨

Prima::Widget::IntIndents — indenting support. That's it, that's the whole vibe check. 🎀

---

🌸 DESCRIPTION 🌸

So like, this module gives you common functionality for widgets that delegate part of their surface to border elements. Think of it as the friend that holds your bag while you do your thing. 🫶

For example — and these are the actual examples, not me making stuff up — scroll bars and borders in a list box are such elements. Iconic behavior, honestly.

---

🦋 Properties 🦋

• indents ARRAY — holds four integers that say how wide the decoration elements are on each side. The order is very specific, so listen up:
  1. the first integer is the width of the left element
  2. the second is the height of the lower element
  3. the third is the width of the right element
  4. the fourth is the height of the upper element

And the tea on the property itself: it can accept and return the array either as four scalars, or as an anonymous array of four scalars. Both. It's flexible like that. 💅

---

🧚 Methods 🧚

• get_active_area [ TYPE = 0, WIDTH, HEIGHT ] — calculates and returns the extension of the area without the border elements. That's the active area ✨. The extension is related to the current size of a widget — but plot twist, you can override it by specifying WIDTH and HEIGHT.

TYPE is an integer that says which type of calculation you want:

• TYPE = 0 — returns four integers, defining the area in the inclusive-exclusive coordinates.
• TYPE = 1 — returns four integers, defining the area in the inclusive-inclusive coordinates.
• TYPE = 2 — returns two integers, the size of the area.

Default is TYPE = 0, so if you just call it bare, you get the inclusive-exclusive four-integer situation. No notes. 🍓

Heads up bestie: those coordinate modes are different and the numbers you get back differ accordingly — don't mix them up mid-calculation or it's gonna be a whole thing. 😭

---

👑 AUTHOR 👑

Dmitry Karasik, <dmitry@karasik.eu.org>. Give them their flowers. 💐

---

💜 SEE ALSO 💜

• Prima
• Prima::Widget

Go read those next, iykyk. 🔥

---

Fr fr that's the whole page — brought to you by perl v5.42.0 and dated 2024-08-20, straight from the Prima::...tIndents(3) manual. Mwah 💋