XMTEXTSETSOURCE(3)

💖 XmTextSetSource 💖

okay bestie, so this one is XmTextSetSource(library call) — it lives in the library call manual, and it is literally the glow-up button for your Text widget's source. let's get into it 🫶

---

✨ NAME ✨

XmTextSetSource — a Text function that sets the source of the widget. that's it, that's the whole job description, and she does it flawlessly 💅

---

✨ SYNOPSIS ✨

#include <Xm/Text.h>
void XmTextSetSource(
Widget widget,
XmTextSource source,
XmTextPosition top_character,
XmTextPosition cursor_position);

no cap, that's the whole thing. void return, four args, no drama ✨

---

✨ DESCRIPTION ✨

so XmTextSetSource sets the source of the Text widget. and the reason this is iconic? Text widgets can share sources of text, which means editing in one widget is reflected in another. yes bestie, one edit, multiple widgets, synchronized behavior, main character energy 👑

this function sets the source of one widget so that it can share the source of another widget. that's the whole vibe.

🚨 okay important thing, don't skip this: setting a new text source destroys the old text source if no other Text widgets are using that source. gone. poof. 💀

and if you want to replace a text source but keep it for later use? the move is: create an unmanaged Text widget and set its source to the text source you want to keep. that's the trick, iykyk 🧚

now the arguments, one by one:

• widget — specifies the Text widget ID. your lil guy. the one you're doing this to 🎀
• source — specifies the source with which the widget displays text. this can be a value returned by the XmTextGetSource(3) function. and if no source is specified, the widget creates a default string source. so like, she'll handle it herself, but you can hand her one 💖
• top_character — specifies the position in the text to display at the top of the widget. this is an integer number of characters from the beginning of the text buffer. and listen, the first character position is 0 (zero). not 1. zero. counting from zero is the way 🌸
• cursor_position — specifies the position in the text at which the insert cursor is located. this is an integer number of characters from the beginning of the text buffer. and again, the first character position is 0 (zero). same deal, same zero, no exceptions ✨

and for a complete definition of Text and its associated resources, see XmText(3). that's your homework, bestie 📚

---

✨ RELATED ✨

• XmText(3).

---

that's the whole page fr fr 🦋

XmTextSetSource(library call) — that's the manual name and the footer right there, so consider it shouted from the rooftops. mwah, go share some sources responsibly 💜💅