XMTEXTXYTOPOS(3)

💖 XmTextXYToPos — a lil library call from the Text girlies 💖

okay so bestie, we're in the library call section of the manual, and today's main character is XmTextXYToPos from the XmText fam. pull up a chair, grab a boba, and let's get into it 🧋✨

---

✨ NAME ✨

XmTextXYToPos — a Text function that accesses the character position nearest an x and y position 💅

like. it's the "which letter am I hovering over" girlie. she does one job and she does it flawlessly. periodt.

---

🎀 SYNOPSIS 🎀

#include <Xm/Text.h>
XmTextPosition XmTextXYToPos(
Widget widget,
Position x,
Position y);

yes, that's the whole thing. three args. no drama. no cap. 🦋

---

🌸 DESCRIPTION 🌸

so XmTextXYToPos accesses the character position nearest to the specified x and y position, relative to the upper left corner of the Text widget. like, upper left is home base, that's where we start counting from, always 🌈

and here's the tea about orientation, because she's bilingual in writing directions:

• in the case of horizontal writing, the position is the origin of the character.
• in the case of vertical writing, the position is the vertical origin of the character.

so whichever way your text is vibing, she knows where the "start" of that character lives. she's not confused. she's never confused. 👑

the arguments, one by one 💫

• widget — specifies the Text widget ID. this is your girl, the widget you're asking about 🫶
• x — specifies the x position, relative to the upper left corner of the widget.
• y — specifies the y position, relative to the upper left corner of the widget.

heads up bestie: for a complete definition of Text and its associated resources, see XmText(3). that's the deep lore page, this one's just the little spotlight moment ✨

---

🔥 RETURN 🔥

she returns the character position in the text nearest the x and y position specified. and ngl that's an integer number of characters from the beginning of the buffer.

and listen — the first character position is 0 (zero). zero-indexed, like a true programmer. not me being shocked, we been knew 😭💀

---

🌈 RELATED 🌈

• XmText(3).

---

lowkey remember: this is a function, not a macro, so she's got a real return value, and that return value is a XmTextPosition. treat her right and she'll tell you exactly which character you're pointing at 💖

---

okay that's the whole page, you ate that, I ate that, we all ate 🍓 and for the lil sign-off: this was XmTextXYToPos from the library call manual, sourced straight from the XmText corner of the docs — mwah, sending you and your widget nothing but good vibes 🎀💜✨