XMDATAFIELDCOPY(3)

💅 XmDataFieldCopy 💅

okay bestie, welcome to the XmDataFieldCopy page from the (library call) manual — yes it's a Motif library call, yes it's giving vintage-but-iconic, and yes I'm gonna walk you through every single crumb of it. 🎀

---

✨ NAME ✨

XmDataFieldCopy — a DataField function that copies the primary selection to the clipboard 🫶

---

✨ SYNOPSIS ✨

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

---

✨ DESCRIPTION ✨

XmDataFieldCopy copies the primary selected text to the clipboard. that's the whole vibe, bestie — select, copy, done, slay. 💅

the way this works internally: this routine calls the XmNconvertCallback procedures, and it might do that possibly multiple times, with the selection member of the XmConvertCallbackStruct set to CLIPBOARD and with the parm member set to XmCOPY. like, it's not shy about it. it's gonna call those callbacks however many times it needs to. no cap. 🔥

here's the tea on the arguments:

• widget — specifies the DataField widget ID. that's your main character right there. 👑
• time — specifies the time at which the selection value is to be modified. this should be the time of the event that triggered this request. (so like, the moment the user actually did the thing. give it that timestamp, not some random one. 😭)

for a complete definition of DataField and its associated resources, see XmDataField(3). go read that one too, fr fr, it's the lore. 🦋

---

✨ RETURN ✨

this function returns False if any of these happen:

• 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 no data is placed on the clipboard

otherwise, it returns True. ✨💖

so basically: False = it didn't eat, True = it ate. 🙈

---

✨ RELATED ✨

• XmDataField(3). 💜

---

and that's the whole page, bestie!! 🌸 go forth and copy your primary selection to the clipboard with confidence, you're doing amazing sweetie. mwah. 🧚✨

signing off from the XmDataFieldCopy(library call) manual — library call, as in, the whole page and its footer said the exact same thing, so consider this my little curtsy to it. 💅🎀 bye!!