XMMULTILISTSELECTITEMS(3)

💖 XmMultiListSelectItems 💖

okay bestie, welcome to the XmMultiListSelectItems page of the library call manual — yes, the whole library call situation, we're in the (3) section and we're thriving. 🎀

✨ NAME ✨

XmMultiListSelectItems — it's a MultiList function, and what it does is select items in the list by matching column entries. that's the whole job. iconic behavior honestly. 👑

🦋 SYNOPSIS 🦋

#include <Xm/MultiList.h>
void XmMultiListSelectItems(
Widget widget,
XmString item,
int column,
Boolean notify);

like. look at that signature. it's giving four arguments and zero regrets. 💅

🌸 DESCRIPTION 🌸

so here's the tea: XmMultiListSelectItems highlights rows in the list wherever the column number column matches item. that's it. that's the vibe. you give it a column, you give it a key, and it lights up every row that agrees. ✨

• widget — bestie, this is the ID of the MultiList widget from whose list an item is selected. it's the main character here, the one doing the selecting. 🫶
• item — the XmString you're using as your selection key. this is the thing we're matching against, fr fr. 🔑
• column — a column number to match. and listen, it starts from 0, okay, we're not doing the 1-based thing here, zero-indexed and unbothered. OR you can pass XmANY_COLUMN and it'll go looking through any column like the little detective it is. 🔍
• notify — a Boolean, and this one has ✨consequences✨. when it's TRUE, it invokes the selection callback for the current mode. and from an application interface view, calling this function with notify True is indistinguishable from a user-initiated selection action — like, the app literally cannot tell the difference. the function ate and left no crumbs. 😭 when notify is FALSE, no callbacks are called. nothing. silence. the callbacks are not coming to the function. 💀

for a complete definition of MultiList and its associated resources, please go see XmMultiList(3). we don't gatekeep lore here. 📚

🧚 RELATED 🧚

• XmMultiList(3)
• XmMultiListGetSelectRows(3)

and that's the whole page, bestie!! 🌈 this was XmMultiListSelectItems(library call) — the library call manual, living its truth. now go select some rows and slay. 💖✨🎀🦋🌸💅🫶👑⭐