[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


    NAME
        RefreshGList -- Refresh (redraw) a chosen number of gadgets.

    SYNOPSIS
        RefreshGList( Gadgets, window, requester, numgad )
                      A0       A1      A2         D0

        VOID RefreshGList( struct gadget *, struct window *,
                struct requester *, word );

    FUNCTION
        Refreshes (redraws) gadgets in the gadget list starting
        from the specified gadget.  At most NumGad gadgets are redrawn.
        If NumGad is -1, all gadgets until a terminating NULL value
        in the NextGadget field is found will be refreshed, making this
        routine a superset of refreshgadgets().

        The requester parameter can point to a requester structure.  if
        the first gadget in the list has the GTYP_REQGADGET flag set, the
        gadget list refers to gadgets in a requester and the pointer
        must necessarily point to a window.  If these are not the gadgets
        of a requester, the requester argument may be NULL.

        Be sure to see the refreshgadgets() function description, as this
        function is simply an extension of that.

    INPUTS
        Gadgets = pointer to the first in the list of gadgets wanting
            refreshment
        window = pointer to the window containing the gadget or its requester
        requester = pointer to a requester (ignored if gadget is not attached
            to a Requester).
        NumGad  = maximum number of gadgets to be refreshed.  A value of -1
          will cause all gadgets to be refreshed from gadget to the
          end of the list.  A value of -2 will also do this, but if 'Gadgets'
          points to a requester gadget (gtyp_reqgadget) all gadgets in the
          requester will be refreshed (this is a mode compatible with v1.1
          RefreshGadgets().)

    RESULT
        None

    BUGS

    SEE ALSO
        refreshgadgets()