XMLISTPOSTOBOUNDS(3)

✨ XmListPosToBounds ✨

okay bestie, gather round, because today we're talking about XmListPosToBounds — a List function that returns the bounding box of an item at a specified position in a list. it's giving "where exactly is this thing on screen" energy and honestly? obsessed. this is a <library call> from the Xm fam, so grab your #include and let's go 💖

🌸 SYNOPSIS 🌸

#include <Xm/List.h>
Boolean XmListPosToBounds(
Widget widget,
int position,
Position *x,
Position *y,
Dimension *width,
Dimension *height);

🎀 DESCRIPTION 🎀

so what does XmListPosToBounds actually do? it returns the coordinates of an item within a list plus the dimensions of its bounding box. like, it hands you back the x and y-coordinates of the upper left corner of the bounding box — and those coords are relative to the upper left corner of the List widget itself, okay? not the screen, not the window, the widget. it also gives you the width and the height of that box. the full glow-up: position in, rectangle out ✨

and here's the cute part: if you don't care about one of those values, you can just pass a NULL for the x, y, width, or height parameter to say "nah, not requesting that one." the caller gets to choose. main character energy 🫶

• widget — specifies the ID of the List widget. that's the one you're interrogating 💅
• position — specifies the position of the specified item. a value of 1 means the first item in the list; a value of 2 means the second item; and so on, you get the pattern. a value of 0 (zero) specifies the last item in the list. yes, zero is the last one, not the first. iconic, slightly chaotic, but that's the rule 🦋
• x — specifies a pointer to the returned x-coordinate of the item.
• y — specifies the pointer to the returned y-coordinate of the item.
• width — specifies the pointer to the returned width of the item.
• height — specifies the pointer to the returned height of the item.

for a complete definition of List and its associated resources, go check out XmList(3). it's the lore drop, fr fr 📚

⭐ RETURN ⭐

here's the vibe check:

• if the item at the specified position is not visible, this function returns False — and ngl, the returned values (if any) are undefined. like, do not trust them, bestie, they are not your friends 😭
• otherwise, this function returns True. slay 👑

🌈 RELATED 🌈

• XmList(3)
• XmListYToPos(3)

and that's the whole page, no cap. this lil masterpiece comes from the XmListPosToBounds(library call) source, and yes, the page header and footer both say XmListPosToBounds(library call) — consistency is a flex 💜 stay hydrated, read your docs, and go find some bounding boxes. mwah 🎀✨