PtGenListSelectedItems()

Get pointers to the selected items

Synopsis:

PtGenListItem_t **PtGenListSelectedItems( 
                      PtWidget_t *widget, 
                      PtGenListItem_t **buffer );

Description:

This function fills the given buffer with pointers to the currently selected items.

If buffer is NULL, the function will allocate a buffer using malloc(), and the buffer will be NULL-terminated (or zero-terminated). It's the caller's responsibility to free the buffer when it's no longer needed.

If buffer isn't NULL, the function adds a NULL to the end only if there are no selected items.

Returns:

A pointer to the buffer.

Classification:

Photon