XMDROPTRANSFERSTART(3)

📦
version 2.5.2 · 2 versions
, in alpine 3.24, arch rolling, centos-stream 9, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

✨ XmDropTransferStart ✨

okay bestie, so this is a page from the library call manual — we're deep in X/Motif land, and today's main character is XmDropTransferStart. 💅

🌸 NAME 🌸

XmDropTransferStart — a Drag and Drop function that initiates a drop transfer, and yes that is literally what it says on the tin 🫶

🎀 SYNOPSIS 🎀

#include <Xm/DragDrop.h>
Widget XmDropTransferStart(
Widget widget,
ArgList arglist,
Cardinal argcount);

like. look at her. so clean. so iconic. 😌

🦋 DESCRIPTION 🦋

so XmDropTransferStart kicks off a drop transfer and uses the argument list you hand it to initialize an XmDropTransfer object. that's the whole vibe. it's giving "start the thing" energy. ✨

and here's the part you actually need to remember, bestie: you can poke at that DropTransfer object with XtSetValues and XtGetValues until the last call to the XmNtransferProc procedure is made. that's your window. that's your moment. 🕐

⚠️ but after that point?? the result of using the widget pointer is undefined. like, genuinely undefined. not "probably fine", not "lowkey fine" — undefined. do not do it. i'm so serious. 😭

also very important, no cap: the DropTransfer object is freed by the toolkit when a transfer is complete. so don't go freeing it yourself, she's handled. 💖

now the arguments, one by one, because we do not skip details in this house 🏠:

  • widget — specifies the ID of the DragContext widget associated with the transaction. this is the one you're doing the thing with. 👑
  • arglist — specifies the argument list. the little list of arguments. you know. 📝
  • argcount — specifies the number of attribute/value pairs in the argument list (arglist). count them. all of them. 🔢

and if you want the complete definition of DropTransfer and all its associated resources — every single one, not just the vibe — go read XmDropTransfer(3). iykyk. 📖

🌈 RETURN 🌈

returns the ID of the DropTransfer widget. that's it. that's the whole return. slay. 💅✨

these are her friends, her little circle, her support system 🫶:

and that's the page, bestie!! 🌸 this was XmDropTransferStart from the library call manual — same name up top, same name down at the bottom in the footer, because symmetry is iconic. go initiate a drop transfer. i believe in you. 🧚💜

📦 where this page comes from