XMIMVASETFOCUSVALUES(3)

πŸ“¦
version 2.5.2 Β· 2 versions
, in alpine 3.24, arch rolling, centos-stream 9, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

πŸ’– XmImVaSetFocusValues πŸ’–

ok so bestie, welcome to the XmImVaSetFocusValues page β€” it's a library call from the X/Motif corner of the universe, and it's literally the girl who tells the input manager "hey, this widget just got focus πŸ‘€" and also freshens up the input context attributes while she's there. multitasking queen. πŸ’…


✨ NAME ✨

XmImVaSetFocusValues β€” an input manager function that notifies an input manager that a widget has received input focus and updates the input context attributes. no cap, that's the whole job description. πŸŽ€


🌸 SYNOPSIS 🌸

#include <Xm/XmIm.h>
void XmImVaSetFocusValues(
Widget widget);

πŸ¦‹ DESCRIPTION πŸ¦‹

ok so here's the tea. XmImVaSetFocusValues notifies the input manager that the widget you specified has received input focus. that's the main character moment. but she doesn't stop there β€” she also updates the attributes of the input context associated with the widget. two things, one function, she ate. πŸ”₯

the way she does it: this function passes the attributes and values to XICSetValues.

now listen, important: whoever calls this routine should pass in only those values that have changed since the last call to any of these functions β€” XmImVaSetValues, XmImVaSetFocusValues, XmImSetValues, or XmImSetFocusValues. don't be out here re-sending everything, bestie, that's not the vibe. πŸ™ˆ

head over to the description in the XmImSetValues(3) reference page if you want the list of associated resources. iykyk. πŸ“‹

this routine uses the ANSI C variable-length argument list (varargs) calling conventions. the variable-length argument list consists of groups of arguments, and each of those groups contains an attribute followed by the value of the attribute. and the very last argument in the list must be NULL. like, mandatory. periodt. ⭐

not me dropping a lil note here: the List and TextField widgets call the XmImVaSetFocusValues function when they receive focus. so for these widgets, further calls to XmImVaSetFocusValues are unnecessary. they already handled it themselves, they're independent like that. πŸ’…

🌈 Arguments 🌈

  • widget β€” specifies the ID of the widget registered with the input manager. that's the one getting the focus glow-up ✨

and for more info on variable-length argument lists, see the X Toolkit Intrinsics documentation. go read it, it's giving educational. πŸ“š



and that's the whole page, bestie!! 🫢 this lil icon comes to you as XmImVaSetFocusValues(library call) β€” same name up top, same name down at the bottom, she's consistent, she's iconic, she's slaying in both directions. πŸ’–βœ¨πŸŽ€πŸ¦‹πŸŒΈπŸ’…πŸ‘‘πŸŒˆβ­πŸ“πŸ§šπŸ’œ