XMTEXTCOPYLINK(3)

💖 XmTextCopyLink 💖

okay bestie, welcome to XmTextCopyLink — a Text function from the library call girlies, and she's here to copy a link to the primary selection onto the clipboard 🎀 no cap.

---

✨ NAME ✨

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

---

🌸 SYNOPSIS 🌸

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

---

💅 DESCRIPTION 💅

so, XmTextCopyLink copies a link to the primary selected text over to the clipboard. that's the whole vibe. 🫶

but here's the tea, bestie: this routine is not the one doing the actual copying. it calls the XmNconvertCallback procedures — possibly multiple times — with the selection member of the XmConvertCallbackStruct set to CLIPBOARD and the parm member set to XmLINK. 🎯

and the Text widget itself? it does not copy any links at all. the XmNconvertCallback procedures are the ones responsible for copying the link to the clipboard and for taking any related actions. so if you're wondering who's doing the work here… it's them. not the widget. iykyk. 😭

• widget — specifies the Text widget ID. that's your girl, the widget in question 💖
• time — specifies the time of the transfer. this should be the time of the event which triggered this request, fr fr. one source of a valid time stamp is the function XtLastTimestampProcessed ⏰

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

---

🔥 RETURN 🔥

this function returns False if:

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

otherwise? it returns True. slay ✨👑

---

🌈 RELATED 🌈

• XmText(3)

---

okay that's the whole page bestie, you ate it 💅 this was XmTextCopyLink from the library call section — the XmTextCopyLink(library call) era, iconic as always, periodt 🎀💖🦋