XMLISTDESELECTITEM(3)

💖 XmListDeselectItem — the "actually, un-pick that" button 💖

okay bestie, so this is XmListDeselectItem, and it lives in the library call section of the manual. it's a List function whose whole entire job is deselecting the specified item from the selected list. that's it. that's the gig. and honestly? iconic of it to be so focused. 🎀

✨ SYNOPSIS ✨

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

🌸 DESCRIPTION 🌸

so here's the vibe: XmListDeselectItem unhighlights and removes from the selected list the first item in the list that matches item. it's like when you accidentally add something to your cart and then quietly take it back out. no drama, no ceremony. just gone from the selection. 💅

here's the breakdown of the two things you gotta hand it:

• widget — this is the ID of the List from whose list an item is getting deselected. yes, the double "list" is real, it's in the original, we respect the canon. 🫶
• item — the item you want deselected from the list. ⚠️ important caveat alert ⚠️ if item shows up more than once in the List, only the first occurrence is matched. so if your list is like "strawberry, strawberry, strawberry" and you deselect "strawberry", bestie, you deselected one strawberry. the other two are still chilling there. 🍓🍓

and for the complete definition of List and all its associated resources, you're gonna wanna go read XmList(3). it's the extended lore. iykyk. 📖

🌈 RELATED 🌈

• XmList(3) — go read it, it's the main character. 👑

okay that's the whole page, periodt. 💜 this was XmListDeselectItem from the library call manual, and the footer stamp on it is just XmListDeselectItem(library call) — same name, same section, keeping it cute and consistent. no date drama, no version tea, just the classic library-call signature. bye bestie, go deselect something responsibly! 🦋✨