XMLISTADDITEMSUNSELECTED(3)

💖 XmListAddItemsUnselected 💖

okay bestie, so this one lives in the XmListAddItemsUnselected(library call) section of the manual, and it's literally just a List function that adds items to a list. that's the whole vibe. let's get into it 🦋

✨ NAME ✨

XmListAddItemsUnselected — a List function that adds items to a list 💅

🌸 SYNOPSIS 🌸

#include <Xm/List.h>
void XmListAddItemsUnselected(
Widget widget,
XmString *items,
int item_count,
int position);

like, that's it. that's the whole signature. she's simple, she's direct, she knows what she wants 🎀

👑 DESCRIPTION 👑

so XmListAddItemsUnselected adds the items you hand her to the list, at the position you give her. and here's the icon behavior: the inserted items stay unselected — even if they're currently chillin' in the XmNselectedItems list. no cap. she does not care. they go in unselected and that's final 💀✨

now the arguments, one by one, because we do NOT skip details in this house:

• widget — specifies the ID of the List widget you're adding items to. that's your girl. your target. 🫶
• items — a pointer to the items you wanna add to the list. the actual goods. 📦
• item_count — the number of elements in items. this number must be nonnegative. like. do not pass her a negative number. that's not a vibe check she's willing to pass 😭
• position — the position of the first new item in the list. let's break it down because the numbering is lowkey iconic:
  • a value of 1 makes the first 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 💅
  • a value of 0 (zero) makes the first new item follow the last item of the list — so she goes to the end, like the final boss of the list 🌈

fr fr, if you want a complete definition of List and all its associated resources, go read XmList(3). that's where the lore lives 📚

🎀 RELATED 🎀

• XmList(3).

and that's the whole page bestie!! 🦋✨ this one came straight outta the XmListAddItemsUnselected(library call) manual, so if you ever need to cite her, that's the glow-up label she goes by 💖 go add some unselected items to a list, you absolute main character 👑🫶