XMGETDRAGCONTEXT(3)

💖 XmGetDragContext 💖

okay bestie, welcome to the XmGetDragContext page from the library call manual — yes, the whole thing lives under XmGetDragContext(library call), and no, that is not a typo, that's just how the docs roll. 🫶

---

✨ NAME ✨

XmGetDragContext — a Drag and Drop function that retrieves the DragContext widget ID associated with a timestamp. literally its whole job. 💅

---

🌸 SYNOPSIS 🌸

#include <Xm/DragC.h>
Widget XmGetDragContext(
Widget refwidget,
Time timestamp);

---

🦋 DESCRIPTION 🦋

so XmGetDragContext hands you back the widget ID of the active DragContext that's associated with a given display and timestamp. periodt. 🎀

and here's the tea: a timestamp is what uniquely identifies which DragContext is active when more than one drag and drop transaction has been initiated on a display. like, multiple drags fighting for attention? the timestamp is the vibe check that sorts them out. ✨

if the timestamp you specified matches a timestamp processed between the start and finish of a single drag and drop transaction, the function returns the corresponding DragContext ID. chef's kiss. 👑

• refwidget — this is the ID of the widget that the routine uses to figure out which display you mean. the function returns the ID of the DragContext associated with the display value passed by this widget. it's giving "you tell me the widget, i'll tell you the display." 🪄
• timestamp — a timestamp. that's it. that's the whole description. ⏰

for a complete definition of DragContext and all its associated resources, go peek at XmDragContext(3). iykyk. 📖

---

⭐ RETURN ⭐

it returns the ID of the DragContext widget that is active for the specified timestamp. 🌈

otherwise? it returns NULL if no active DragContext is found. not me getting ghosted by a null pointer 😭💀

---

🔥 RELATED 🔥

• XmDragContext(3).

---

and that's the whole page, bestie — no cap, every flag, arg and return value accounted for. 💜 this was XmGetDragContext(library call), straight from the library call manual, mwah 💋 stay slay, go read your docs. 🎀✨