DTDNDCREATESOURCEICON(3)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

💅 NAME 💅

DtDndCreateSourceIcon — create a drag source icon. Also hi bestie, this is the <pink>DtDndCreateSourceIcon</pink> page from the <purple>library call</purple> manual, and it’s giving “make a cute little drag icon” main character energy. ✨

✨ SYNOPSIS ✨

Okay so the synopsis is literally this, no cap:

#include &<Dt/Dnd.h>
Widget DtDndCreateSourceIcon(
       Widget parent,
       Pixmap pixmap,
       Pixmap mask);

🎀 DESCRIPTION 🎀

The DtDndCreateSourceIcon function creates a Motif drag icon, named sourceIcon, based on the characteristics of the pixmap argument. The resulting drag icon is suitable for use with DtDndDragStart(3) — obsessed, honestly. 💖

The parent argument is the parent of the drag icon. Typically this widget is the drag source. Slay.

The pixmap argument is the pixmap representation of the data to be dragged. The mask argument is the mask for the pixmap. Periodt.

When it calls XmCreateDragIcon(3), the DtDndCreateSourceIcon function sets Motif resources in the drag icon. The application must not modify the values of any of these resources — seriously, hands off, bestie:

  • XmNwidth
  • XmNheight
  • XmNpixmap
  • XmNmask
  • XmNdepth
⚠️ Hard no: the application must not modify the values of those resources. Not even a little. 💀

🌈 RETURN VALUE 🌈

Upon successful completion, the DtDndCreateSourceIcon function returns a drag icon created by calling XmCreateDragIcon(3) with the characteristics of the pixmap; otherwise, it returns NULL — sad girl hours. 😭

🦋 SEE ALSO 🦋

The SEE ALSO squad is: Dt/Dnd.h - DtDnd(5), DtDndDragStart(3), XmCreateDragIcon(3), XmDragIcon(3), XmDragStart(3), XtDestroyWidget(3).

That’s the whole page, bestie 🫶 — signed off from the <pink>library call</pink> manual for <purple>DtDndCreateSourceIcon</purple>. The footer has no extra source/version or date line printed, so this is the entire tea. 💖

📦 where this page comes from