Home List boxes LIST BOX - FREE ITEM LIST (AES 175, 3) LIST BOX - SET SLIDER B (AES 175, 5)

2.4.23 LIST BOX - SCROLL TO, SLIDER A (AES 175, 4)

This function positions Slider A and updates the contents of the list box. <box_rect> is the redraw rectangle for the list box and <slider_rect> ist the redraw rectangle for the slider.

SCROLL TO works in principle like a call of lbox_set_slider() followed by a lbox_update(); scrolling takes place if possible, however, to reduce the amount of drawing required. One may therefore not use lbox_scroll_to() if the item list of the list box has changed.

Declaration:
void lbox_scroll_to( LIST_BOX *box, WORD first, GRECT *box_rect,
                                              GRECT *slider_rect );

Call:
lbox_scroll_to( box, first, &box_rect, &slider_rect );
      or
lbox_ascroll_to( box, first, &box_rect, &slider_rect );

Variable         Argument         Meaning
Inputs:

contrl[0]        175              lbox_set
contrl[1]        2                Entries in intin
contrl[3]        3                Entries in addrin

intin[0]         4                lbox_scroll_to
intin[1]         first            Index of the first visible entry

addrin[0]        box              Pointer to the list box structure
addrin[1]        box_rect         Pointer to redraw rectangle or 0L
addrin[2]        slider_rect      Pointer to redraw rectangle or 0L

Outputs:

contrl[2]        0                Entries in intout
contrl[4]        0                Entries in addrout


Home List boxes LIST BOX - FREE ITEM LIST (AES 175, 3) LIST BOX - SET SLIDER B (AES 175, 5)