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

RefreshGList

Refresh (redraw) a chosen number of gadgets.

Declaration

Source position: intuition.pas line 4149

procedure RefreshGList(

  gadgets: pGadget;

  window: pWindow;

  requester: pRequester;

  numGad: LongInt

);

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