notcurses_multiselector - high level widget for selecting from a set

       nick black <nickblack@linux.com>.

                                                     v3.0.7                           notcurses_multiselector(3)

       A multiselector widget presents a list of items (possibly more than can be displayed at once).  It facil‐
       itates  a choice of zero, one, or multiple items from the list.  Items can be selected and deselected be‐
       fore a final choice is made.

       notcurses_multiselector - high level widget for selecting from a set

       The ncplanen provided to ncmultiselector_create must not be NULL.  It will be freely resized by the  new
       ncmultiselector.

       ncmultiselector_selected  returns  the index of the option currently highlighted.  It stores to the n-ary
       bitmap pointed to by selected based on the currently-selected options.

       ncmultiselector_plane will return the ncplane on which the widget is drawn.

       Input should be run through ncmultiselector_offer_input to take advantage of common  controls.   It  will
       handle  the  up  and  down  arrows,  along  with PageUp and PageDown.  If the mouse is enabled, the mouse
       scrollwheel and mouse clicks on the scroll arrows will be handled.

       ncmultiselector_destroy destroys the backing ncplane, as does ncmultiselector_create in the event of  any
       error.

ncmultiselector_create returns NULL on an error, in which case the passed ncplane is destroyed.

       ncmultiselector_selected  returns  -1 if there are no items, or if n is not equal to the number of items.
       It otherwise returns the index of the currently highlighted option, and writes a bitmap to selected based
       off the selected items.

notcurses(3), notcurses_input(3), notcurses_plane(3)notcurses_selector(3)

#include<notcurses/notcurses.h>

              struct ncplane;
              struct notcurses;
              struct ncmultiselector;

              struct ncmselector_item {
                const char* option;
                const char* desc;
              };

              typedef struct ncmultiselector_options {
                const char* title; // title may be NULL, inhibiting riser
                const char* secondary; // secondary may be NULL
                const char* footer; // footer may be NULL
                struct ncmselector_item* items; // initial items, statuses
                // default item (selected at start)
                unsigned defidx;
                // maximum number of options to display at once
                unsigned maxdisplay;
                // exhaustive styling options
                uint64_t opchannels;   // option channels
                uint64_t descchannels; // description channels
                uint64_t titlechannels;// title channels
                uint64_t footchannels; // secondary and footer channels
                uint64_t boxchannels;  // border channels
                uint64_t flags;        // bitfield over NCMULTISELECTOR_OPTION_*
              } ncmultiselector_options;

       structncmultiselector*ncmultiselector_create(structncplane*n,constncmultiselector_options*opts);intncmultiselector_selected(bool*selected,unsignedn);structncplane*ncmultiselector_plane(structncmultiselector*n);boolncmultiselector_offer_input(structncmultiselector*n,constncinput*nc);voidncmultiselector_destroy(structncmultiselector*n);