home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Workbench / Libs / GADUTIL.LHA / GadUtil / Docs / AutoDocs / 04.GU_SetGadgetAttrsA < prev    next >
Encoding:
Text File  |  1995-06-18  |  1.5 KB  |  46 lines
  1. gadutil.library/GU_SetGadgetAttrsA         gadutil.library/GU_SetGadgetAttrsA
  2.  
  3.    NAME
  4.     GU_SetGadgetAttrsA -- Change the attributes of a GadTools gadget.
  5.  
  6.    SYNOPSIS
  7.     GU_SetGadgetAttrsA(gad, win, req, taglist)
  8.                        A0    A1  A2   A3
  9.  
  10.     VOID GU_SetGadgetAttrsA(struct Gadget *, struct Window *,
  11.                 struct Requester *, struct TagItem *);
  12.  
  13.    FUNCTION
  14.     Change the attributes of the specified gadget, according to the
  15.     attributes chosen in the tag list. If an attribute is not provided
  16.     in the tag list, its value remains the unchanged. This function
  17.     also stores some information for the hotkey part of the library.
  18.  
  19.     Use this in place of the gadtools function GT_SetGadgetAttrsA().
  20.  
  21.    INPUTS
  22.     gad - pointer to the gadget in question. This address may be NULL,
  23.           in which case this function does nothing.
  24.  
  25.     win - pointer to the window containing the gadget. Starting with
  26.           V39 (of the OS), this value may be NULL, in which case the
  27.           internal attributes of the gadgets are altered but no
  28.           rendering occurs.
  29.  
  30.     req - reserved for future use, should always be NULL.
  31.  
  32.     taglist - pointer to an array of tags providing optional extra
  33.           parameters, or NULL.
  34.  
  35.    TAGS
  36.     See the GadTools function GT_SetGadgetAttrsA() for all tags, since
  37.     this is an extended version of that routine.
  38.  
  39.    NOTES
  40.     This function may not be called inside of a GU_BeginRefesh() /
  41.     GU_EndRefresh() session. (as always, restrict yourself to simple
  42.     rendering functions).
  43.  
  44.    SEE ALSO
  45.     gadtools/GT_SetGadgetAttrsA(), GU_GetGadgetAttrsA()
  46.