XMTEXTCUT(3)

✨ XmTextCut ✨

okay bestie, so this one is a library call and honestly? it's giving "copy + delete in one glow-up." 💅

---

🌸 NAME 🌸

XmTextCut — a Text function that copies the primary selection to the clipboard and deletes the selected text 🎀

---

🦋 SYNOPSIS 🦋

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

---

💖 DESCRIPTION 💖

So XmTextCut takes the primary selected text, copies it to the clipboard, and then deletes the primary selected text. yes, both. it's an overachiever, we love that for it. 👑

This routine calls the widget's XmNvalueChangedCallback and verification callbacks, either XmNmodifyVerifyCallback or XmNmodifyVerifyCallbackWcs, or both. and here's the little order-of-operations tea: if both verification callback lists are registered, the procedures of the XmNmodifyVerifyCallback list are executed first, and the resulting data is passed to the XmNmodifyVerifyCallbackWcs callbacks. so Wcs gets the hand-me-down data, no cap.

This routine also calls the XmNconvertCallback procedures — possibly multiple times — with the selection member of the XmConvertCallbackStruct set to CLIPBOARD and with the parm member set to XmMOVE. then, if the transfer is successful, this routine calls the XmNconvertCallback procedures for the CLIPBOARD selection and the DELETE target. iconic chain reaction, fr fr. 🔥

• widget — Specifies the Text widget ID. like, which Text widget are we doing this to, bestie? that one. 💫
• time — Specifies the server time at which the selection value is to be modified. this should be the time of the event that triggered this request. 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).

---

and that's the whole page, bestie — it's from the XmTextCut(library call) manual, mwah 💋