XMTEXTCOPY(3)

✨ XmTextCopy — the library-call girlie from the XmText manual 💖

okay bestie, so this is XmTextCopy, straight out of the library call manual, and she has ONE job: take whatever you've got highlighted (the primary selection) and yeet it onto the clipboard. that's it. that's the whole vibe. 🎀

---

🌸 NAME 🌸

XmTextCopy — a Text function that copies the primary selection to the clipboard 🦋

---

✨ SYNOPSIS ✨

#include <Xm/Text.h>
Boolean XmTextCopy(
Widget widget,
Time time);

---

💅 DESCRIPTION 💅

okay so, real talk: XmTextCopy copies the primary selected text to the clipboard. that's the whole plot. no cap. ✨

this routine calls the XmNconvertCallback procedures, and it might do that multiple times (not me calling your callbacks over and over 😭), with the selection member of the XmConvertCallbackStruct set to CLIPBOARD and with the parm member set to XmCOPY. yes, exactly those values, don't improvise bestie 💅

• widget — specifies the Text widget ID 🫶
• time — specifies the server time at which the selection value is to be modified. this should be the time of the event which triggered this request. one source of a valid time stamp is the function XtLastTimestampProcessed(). (yes, that's a real function name, i didn't make it up, i would never 🙈)

for a complete definition of Text and its associated resources, see XmText(3). 💜

---

🔥 RETURN 🔥

so like… this function returns False in a whole bunch of situations, and honestly it's giving "situationship":

• the primary selection is NULL 💀
• the widget does not own the primary selection
• the function is unable to gain ownership of the clipboard selection
• no data is placed on the clipboard

otherwise? it returns True. slay. 👑

---

🌈 RELATED 🌈

• XmText(3)

---

that's the whole page babes 🎀 courtesy of the XmTextCopy(library call) manual — library call energy, living her best life, no date on the tin but she's iconic anyway. mwah 💖✨🦋