XMLISTADDITEM(3)

💖 XmListAddItem 💖

okay bestie, welcome to XmListAddItem — it's a List function (from the library call manual, iykyk) and it literally just adds an item to the list. that's it, that's the job. 🎀

✨ SYNOPSIS ✨

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

yes the indentation is giving "I wrote this in 1994 and I'm not sorry" 💅 but it's correct, don't touch it.

🌸 DESCRIPTION 🌸

XmListAddItem adds an item to the list at the given position. that's the whole vibe. ✨

but here's the part that's lowkey iconic: when the item gets inserted into the list, it is compared with the current XmNselectedItems list. and if the new item matches an item on the selected list, then bestie… it appears selected. it came pre-slaying. 👑

here's the cast of characters, one by one:

• widget — specifies the ID of the List to which an item is added. like, which list are we feeding? 🫶
• item — specifies the item to be added to the list. the little guy going in. 🌸
• position — specifies the position of the new item in the list. okay so listen:
  • 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 it, the math is mathing 📈
  • a value of 0 (zero) makes the new item the last item in the list. zero means "put it at the end, idc, whatever" 💀

for a complete definition of List and its associated resources, see XmList(3). not me sending you to another manpage but fr fr, go read it, that's where the lore lives. 📚

🌈 RELATED 🌈

• XmList(3).

and that's the whole page bestie!! no cap, you now know how to add an item to a list and make it show up pre-selected if it's already on the selected list. main character behaviour only. 💜🦋

this has been XmListAddItem(library call) — same title, same manual, straight from the source and the date, signed, sealed, slayed. 💅🎀✨