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

RemoveGList

Remove a sublist of gadgets from a window.

Declaration

Source position: intuition.pas line 4155

function RemoveGList(

  remPtr: pWindow;

  gadget: pGadget;

  numGad: LongInt

):Word;

Arguments

remPtr

  

A pointer to the window containing the gadget or the requester containing the gadget to be removed.

gadget

  

A pointer to the gadget to be removed. The gadget itself describes whether this is a gadget that should be removed from the window or some requester.

numGad

  

Number of gadgets to be removed. If $FFFF, remove all gadgets to end of window gadget list

Function result

Returns the ordinal position of the removed gadget. If the gadget wasn't found in the appropriate list, or if there are no gadgets in the list, returns $FFFF.

Description

Removes Numgad gadgets from the gadget list of the specified window. Will remove gadgets from a requester if the first gadget's GadgetType flag GTYP_REQGADGET is set.

Otherwise identical to RemoveGadget().

Note: Last gadget's NextGadget field is set to nil.

If one of the gadgets you wish to remove is the active gadget, this routine will wait for the user to release the mouse button before deactivating and removing the gadget.

See also

RemoveGadget

  

Remove a gadget from a window.

AddGadget

  

Add a gadget to the gadget list of a window.

AddGList

  

Add a linked list of gadgets to a window or requester.


Documentation generated on: 2021-07-30