XMLISTADDITEMUNSELECTED(3)

💖 XmListAddItemUnselected 💖

okay bestie, gather round, because we're doing a library call today — yes, from section 3 of the manual, XmListAddItemUnselected, and it's lowkey one of the most useful little List functions you'll ever meet 🫶

✨ NAME ✨

XmListAddItemUnselected — a List function that adds an item to the list 🌸

🎀 SYNOPSIS 🎀

#include <Xm/List.h>
void XmListAddItemUnselected(
Widget widget,
XmString item,
int position);

💅 DESCRIPTION 💅

so here's the tea: XmListAddItemUnselected adds an item to the list, at the position you tell it. and the whole point, the main character energy of it all, is that the item does not appear selected — even if it matches an item that's already chilling in the current XmNselectedItems list. it's giving "I'm here but I'm not on the guest list." iconic. 🙈

the parameters, bestie, one by one:

• widget — specifies the ID of the List from whose list an item is added 💖
• item — specifies the item to be added to the list ✨
• position — specifies the position of the new item in the list. and listen, the numbering is a whole thing:
  • a value of 1 makes the new item the first item in the list
  • a value of 2 makes it the second item
  • and so on, you get the pattern, you're smart, I believe in you 🦋
  • a value of 0 (zero) makes the new item the last item in the list 👑

not me pointing out that 0 means "end of the line" while 1 means "front of the line" — yes it's a little unhinged, no I did not make the rules, I just report them 💀

and if you want the complete definition of List and all its associated resources (the full lore, the extended universe), go read XmList(3) 🌈

🔥 RELATED 🔥

• XmList(3)

and that's the whole page, babe — literally everything, no cap. this little gem lives in the library call corner of the manual, and the page signs itself off as XmListAddItemUnselected(library call), which, yes, is the exact same thing it said at the top, it's very "I am who I am" of it 💜 🎀⭐💖