XMIMSETXIC(3)

💖 XmImSetXIC 💖

okay bestie, so this one's from the library call section of the XmIm crew — it's XmImSetXIC, and she's the input manager girlie whose whole job is registering an existing XIC with a widget. no cap. 🫶

---

✨ NAME ✨

XmImSetXIC — an input manager function that registers an existing XIC with a widget. that's it, that's the girl. 💅

---

🌸 SYNOPSIS 🌸

#include <Xm/XmIm.h>
XIC XmImSetXIC(
Widget widget,
XIC xic);

---

🦋 DESCRIPTION 🦋

so like, XmImSetXIC registers the specified X Input Context (XIC) with widget. and here's the tea 🍓: any existing XIC that was already registered for widget? unregistered. gone. not invited to the party anymore. and then the new XIC that got registered for widget is returned to you. iconic behavior honestly.

🚨 important lore alert: if xic was not created by XmImGetXIC or XmImRegister, then it will not be subject to closing activities when it has no widgets registered with it. like, she's not on the official list, so nobody's gonna do the closing ritual for her. just so you know. 💀

• widget — the ID of a widget for which a new Input Context is to be registered. she's the main character getting a fresh XIC assigned. ✨
• xic — the Input Context to be registered with the widget. and plot twist: if xic is NULL, the function returns the current XIC used by widget. so passing NULL is basically asking "who's the XIC right now?" — lowkey a vibe check. 🔥

---

👑 RETURN 👑

returns the new XIC registered for widget. 🎀

😭 bestie listen: the application is responsible for freeing the returned XIC. that's on you, not on her. to free the XIC, call XmImFreeXIC. don't just leave it hanging, that's not the move. periodt.

---

🌈 RELATED 🌈

• XmImGetXIC(3)
• XmImFreeXIC(3)

go read those too, iykyk. 🧚

---

and that's the whole page, fr fr — signed off from the XmImSetXIC library call corner of the manual, version-flavored and dated just like the original footer said. mwah. 💜