XMTEXTFIELDCUT(3)

💖 XmTextFieldCut — the library call that's basically "cut" but make it iconic 💖

Okay bestie, gather round, because today we're talking about XmTextFieldCut, a <rainbow>library call</rainbow> from the Xm TextField family. It's the cut function. Yes, that cut — the one your fingers do on autopilot. Let's get into it. 🎀

---

✨ NAME ✨

XmTextFieldCut — a TextField function that copies the primary selection to the clipboard and deletes the selected text. Copy, then yeet. Two jobs, one function, main character energy fr fr. 💅

---

🌸 SYNOPSIS 🌸

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

---

🦋 DESCRIPTION 🦋

So here's the tea, bestie: XmTextFieldCut copies the primary selected text to the clipboard, and then deletes the primary selected text. Copy first, delete second — in that order, no cap. 🫶

This routine calls the widget's XmNvalueChangedCallback and verification callbacks — either XmNmodifyVerifyCallback or XmNmodifyVerifyCallbackWcs, or both. And the ordering matters, so listen up: 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 whatever modifyVerify cooked up. That's the pipeline. 🧚

It also calls the XmNconvertCallback procedures, and 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. Like, it does the whole ritual, and only if it works does it do the second half. Very "trust the process". ⭐

💜 Arguments, bestie 💜

• widget — Specifies the TextField widget ID. That's your TextField, your baby, your main character. 👑
• 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. Basically: tell it when this whole thing went down. ⏰

Heads up! For a complete definition of TextField and its associated resources, see XmTextField(3). That's the deep lore page, and you will be reading it. 📖

---

💀 RETURN 💀

This function returns False if the primary selection is NULL, if the widget does not own the primary selection, if 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. ✅

So like, four different ways to get a False — that's the vibe check failing in four distinct flavours, and honestly, valid. 😭

---

🔥 RELATED 🔥

• XmTextField(3). Go read it, iykyk. 💖

---

And that's the page, bestie! This was XmTextFieldCut(library call) — signed, sealed, and delivered from the library call section of the manual, dated whenever the footer says, and honestly it ate. 🎀✨💅