XMTEXTPOSTOXY(3)

💖 XmTextPosToXY 💖

okay bestie, welcome to the XmTextPosToXY page from the library call manual — yes it's a Text function, and yes it is exactly as iconic as it sounds ✨

---

🌸 NAME 🌸

XmTextPosToXY — a Text function that accesses the x and y position of a character position. like, you give it a spot in the text buffer and it tells you where that spot actually lives on screen. obsessed 🫶

---

✨ SYNOPSIS ✨

#include <Xm/Text.h>
Boolean XmTextPosToXY(
Widget widget,
XmTextPosition position,
Position *x,
Position *y);

---

🎀 DESCRIPTION 🎀

okay so here's the vibe: XmTextPosToXY accesses the x and y position — relative to the upper left corner of the Text widget — of a given character position in the text buffer. that's it. that's the whole job. and it ate 💅

lowkey important detail: 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. not me making sure you actually read that part 😭

• widget — specifies the Text widget ID. the main character of this whole situation 👑
• position — specifies the character position in the text for which the x and y position is accessed. this is an integer number of characters from the beginning of the buffer. and bestie, the first character position is 0 (zero). zero. not one. i said what i said 🍓
• x — specifies the pointer in which the x position is returned. the returned position is the distance from the left side of the widget to the left border of the character. ⚠️ this value is meaningful only if the function returns True. no cap.
• y — specifies the pointer in which the y position is returned. the returned position is the distance from the top of the widget to the character's baseline. ⚠️ and this one is also meaningful only if the function returns True. fr fr.

for a complete definition of Text and its associated resources, see XmText(3). it's giving required reading 📚

---

🌈 RETURN 🌈

this function returns True if the character position is displayed in the Text widget; otherwise, it returns False, and no x or y value is returned. like, none. zero. the pointers stay unbothered 💀

---

🦋 RELATED 🦋

• XmText(3).

---

and that's the whole page, babe 🎀 this was XmTextPosToXY(library call) — yes the footer says the exact same thing as the header, they're matching, it's a set, it's a look 💜 slay, go place some characters and get those coordinates. bye bestie 🫶✨