DTACTIONICON(3)

💖 NAME 💖

okay so, bestie, welcome to the DtActionIcon page from the library call manual — this is the function that gets you the icon information for an action. icon queen behavior, no cap 💅

DtActionIcon — get the icon information for an action.

---

🦋 SYNOPSIS 🦋

#include &<Dt/Action.h>
char *DtActionIcon(
char *actionName);

Yes, the & before <Dt/Action.h> is literally there in the page — copy it exactly, bestie, don't "fix" it 🙈.

💖 DESCRIPTION 💖

The DtActionIcon function gets the icon information for an action. The actionName argument is the name of the action. DtActionIcon returns the name of the icon associated with an actionName action.

If the action definition does not explicitly identify an icon name, this function returns the default action icon name, as described in dtactionfile(4) ("Action Selection"). The default action icon name can be customized using the actionIcon X resource.

If there are multiple actionName actions, the string returned is the icon associated with the most general action. The most general action is the one with the lowest precedence, as described in dtactionfile(4) ("Action Selection"). lowkey the hierarchy matters here, so don't skip that part 👑

✨ RETURN VALUE ✨

Upon successful completion, the DtActionIcon function returns a newly allocated copy of the icon name string (the ICON field) associated with the action; otherwise, it returns NULL.

bestie, it's a newly allocated copy — that means you own it and you gotta free it. no leaking on my watch 😭

🎀 APPLICATION USAGE 🎀

The DtActionIcon function is useful for applications that provide a graphical interface to actions. it's giving "I need an icon for this action" energy 🎨✨

The application should use XtFree(3) to free the icon name string returned by the DtActionIcon function.

🌈 SEE ALSO 🌈

• Dt/Action.h — the header, bestie 💖
• DtAction(5)
• XtFree(3)
• dtactionfile(4)
• dtdtfile(4)

---

mwah 💋 that's the DtActionIcon library-call page, bestie — no date or version line on this one, so catch u later 🫶