XMDRAGSTART(3)

✨ XmDragStart — library call ✨

Okay bestie, gather round. This is the manual page for XmDragStart, a Drag and Drop function that initiates a drag and drop transaction. It's giving "let's start the drag, no cap." 💅

---

🌸 NAME 🌸

XmDragStart — A Drag and Drop function that initiates a drag and drop transaction. 🎀

---

🦋 SYNOPSIS 🦋

#include <Xm/DragDrop.h>
Widget XmDragStart(
Widget widget,
XEvent *event,
ArgList arglist,
Cardinal argcount);

---

💖 DESCRIPTION 💖

XmDragStart initiates a drag operation. This routine returns the DragContext widget that it initializes for the associated drag transaction. The toolkit is responsible for freeing the DragContext when the drag and drop transaction is complete. So like, you don't free it, bestie — the toolkit handles that. 👑

Here's what the arguments are doing:

• widget — Specifies the ID of the smallest widget and/or gadget that encloses the source elements selected for a drag operation. Basically the tightest container around the stuff you're dragging.
• event — Specifies the XEvent that triggered the drag operation. This event must be a ButtonPress event.

⚠️ No substitutes, no other event type, periodt. 💀

• arglist — Specifies the argument list. Any XmDragContext resources not specified in the argument list are obtained from the resource database or are set to their default values. So if you leave stuff out, it gets looked up or defaulted. Slay. ✨
• argcount — Specifies the number of attribute/value pairs in the argument list (arglist). That's the count, bestie. 🔢

For a complete definition of DragContext and its associated resources, see XmDragContext(3). 🫶

---

⭐ RETURN ⭐

Returns the ID of the DragContext widget that controls this drag and drop transaction. Returns NULL if the drag cannot be initiated. So if it fails, you get NULL, not a vibe. 😭

---

🌈 RELATED 🌈

XmDragCancel(3) and XmDragContext(3). Go read those too, iykyk. 💜

---

Sign-off from the library call manual: XmDragStart. No version or date was printed on this page, just the manual section. Stay iconic, bestie. 💖✨