XMMULTILISTGETSELECTEDROWS(3)

💖 XmMultiListGetSelectedRows — bestie edition 💖

okay so picture this: it's a library call from the XmMultiList...electedRows corner of the manual, and it's here to answer the one question every MultiList girlie asks — who is selected rn? ✨

---

🌸 NAME 🌸

XmMultiListGetSelectedRows — it's a MultiList function, and its whole job is returning the rows that are currently selected. that's it. that's the gig. 💅

---

🎀 SYNOPSIS 🎀

#include <Xm/MultiList.h>
XmMultiListRowInfo ** XmMultiListGetSelectedRows(
Widget widget);

---

✨ DESCRIPTION ✨

use this routine to find the rows that currently are selected in a MultiList widget. like, you point it at the widget, it tells you who's chosen. main character detection, but for rows. 👑

• widget — specifies the ID of the MultiList widget. yes bestie, you have to tell it which one. it's not psychic. 🙈

for a complete definition of MultiList and its associated resources, see XmMultiList(3). go read it, i'll wait. 🫶

---

💀 RETURN 💀

the XmMultiListRowInfo ** that this function hands back contains a NULL terminated array of XmMultiListRowInfo pointers. read that again. NULL terminated. it just keeps going until it hits that NULL, so don't go wandering past it. 😭

⚠️ the calling routine is responsible for freeing the returned pointer with XtFree(). that's on YOU. not on the function. not on the widget. YOU. memory leaks are not the vibe. 💅

and if nothing is selected? the function will return NULL. no elements, no array, no problem. 🌈

---

🦋 RELATED 🦋

• XmMultiList(3).

---

and that's the whole page, bestie — it lives in the library call section as XmMultiList...electedRows(library call), so if you ever need to cite it, that's the glow-up it's filed under. slay, stay selected, and free your pointers. periodt. 👑💖✨