XMIMSETFOCUSVALUES(3)

💖 XmImSetFocusValues 💖

okay bestie, so this one is a library call from the X/Motif crew — XmImSetFocusValues, an input manager function that notifies an input manager that a widget has received input focus and updates the input context attributes. two jobs, one function, she's multitasking 💅

---

✨ SYNOPSIS ✨

#include <Xm/XmIm.h>
void XmImSetFocusValues(
Widget widget,
ArgList arglist,
Cardinal argcount,
);

---

🌸 DESCRIPTION 🌸

so XmImSetFocusValues slides into the input manager's DMs to say "hey, this widget just got input focus 👑". and while she's there, she also updates the attributes of the input context associated with that widget. the focus window for the XIC gets set to the window of the widget. that's the whole vibe.

the arglist argument is a list of attribute/value pairs for the input context. this function passes those attributes and values straight to XICSetValues.

🫶 bestie please listen: the caller of this routine should pass in only those values that have changed since the last call to any of these functions: XmImSetValues, XmImSetFocusValues, XmImVaSetValues, or XmImVaSetFocusValues. don't be out here re-sending the whole thing, that's not the assignment. 💀

for a list of associated resources, go read the description in the XmImSetValues(3) reference page. she has the receipts.

also — if the previous parameters for the widget's XIC do not allow the previously registered XIC to be reused, that XIC will be unregistered, and a new one will be created and registered with the widget. glow-up era ✨. and note that sharing of data is preserved. no cap.

the arguments, one by one 🎀

• widget — Specifies the ID of the widget registered with the input manager.
• arglist — Specifies the list of attribute/value pairs to be passed to XICSetValues. See the description in the XmImSetValues(3) man page for a description of resources.
• argcount — Specifies the number of attribute/values pairs in the argument list (arglist).

---

🦋 one lil heads-up

Note that the Text and TextField widgets call the XmImSetFocusValues function when they receive focus. Therefore, further calls to the XmImSetFocusValues function for these widgets are unnecessary. like, they already handled it, don't double-text. 🙈

---

🌈 RELATED 🌈

• XmImSetValues(3)
• XmImVaSetFocusValues(3)
• XmImVaSetValues(3)

---

and that's the tea, bestie 🍓 this whole page lives under the XmImSetFocusValues(library call) banner in the X/Motif manual set — a library call, through and through, iconic as always 💜 mwah, go set some focus ✨🎀