Unit 'intuition' Package
[Overview][Constants][Types][Procedures and functions][Variables][Index] [#os4units]

RefreshGList

Refresh (redraw) a chosen number of gadgets.

Declaration

Source position: intuition.pas line 3874

procedure RefreshGList(

  Gadgets: PGadget;

  Window: PWindow;

  Requester: PRequester;

  NumGad: LongWord

);

Arguments

Gadgets

  

A pointer to the first in the list of gadgets wanting refreshment

Window

  

A pointer to the window containing the gadget or its requester

Requester

  

A 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.)

Description

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 nil 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 nil.

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

Snippet

// Refresh one gadget
RefreshGList(@Gadget, Win, nil, 1);

// Refresh all gadgets in the window
RefreshGList(Win^.FirstGadget, Win, nil, -1);

See also

RefreshGadgets

  

Refresh (redraw) the gadget display.


Documentation generated on: 2021-07-30