XMTEXTFIELDPASTE(3)

💖 XmTextFieldPaste 💖

okay bestie, welcome to XmTextFieldPaste — a TextField function that inserts the clipboard selection ✨ like, it's THE clipboard-paste girlie for your TextField widget and she's lowkey iconic for it 🎀

🌸 SYNOPSIS 🌸

#include <Xm/TextF.h>
Boolean XmTextFieldPaste(
Widget widget);

✨ DESCRIPTION ✨

So here's the vibe: XmTextFieldPaste inserts the clipboard selection at the insertion cursor of the destination widget. That's it, that's the whole job, and she does it flawlessly 💅

But wait, there's a plot twist 👀 — if XmNpendingDelete is True and the insertion cursor is inside the current selection, then the clipboard selection replaces the selected text. bye bye old text, hello new text, no cap 🫶

This routine also calls the widget's XmNvalueChangedCallback and the verification callbacks — either XmNmodifyVerifyCallback or XmNmodifyVerifyCallbackWcs, or literally both of them, she's thorough like that. And if both verification callback lists are registered, the procedures of the XmNmodifyVerifyCallback list get executed first, and then the resulting data is passed along to the XmNmodifyVerifyCallbackWcs callbacks. Order matters, bestie, that's the way that works 📋

She also calls the widget's XmNdestinationCallback procedures, with the selection member of the XmDestinationCallbackStruct set to CLIPBOARD and the operation member set to XmCOPY. And if the XmNcursorPosition resource is greater than or is the same value as the position where the selection is to be inserted, then XmNmotionVerifyCallback gets called. yeah. she keeps receipts 📝

• widget — Specifies the TextField widget ID. just hand her the widget, that's all she needs 🫶

For a complete definition of TextField and its associated resources, go check out XmTextField(3) — she's the main character of that page 🌟

💫 RETURN 💫

This function returns False if no transfers take place 😭 — like, nothing happened, awkward. Otherwise? She returns True and she ate 🔥

🔗 RELATED 🔗

• XmTextField(3). — go read her, she's the blueprint 👑

okay that's the whole page, bestie!! this was XmTextFieldPaste(library call) from the library call manual, and if you see that same XmTextFieldPaste(library call) footer floating around at the bottom, that's just her signature, she signs her work 💖 mwah, go paste something iconic 🦋✨💅