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

SetGadgetAttrsA

Specify attribute values for a boopsi gadget.

Declaration

Source position: intuition.pas line 3919

function SetGadgetAttrsA(

  Gadget: PGadget;

  Window: PWindow;

  Requester: PRequester;

  const TagList: PTagItem

):LongWord;

Arguments

Gadget

  

An abstract pointer to a boopsi gadget

Window

  

A window gadget has been added to using AddGList() or AddGadget()

Requester

  

For GTYP_REQGADGETs, requester containing the gadget

TagList

  

An array of TagItem structures with attribute/value pairs.

Function result

The object does whatever it wants with the attributes you provide, which might include updating its gadget visuals. The return value tends to be non-zero if the changes would require refreshing gadget imagery, if the object is a gadget.

Description

Same as SetAttrsA(), but provides context information and arbitration for classes which implement custom Intuition gadgets.

You should use this function for boopsi gadget objects which have already been added to a requester or a window, or for "models" which propagate information to gadget already added.

Typically, the gadgets will refresh their visuals to reflect changes to visible attributes, such as the value of a slider, the text in a string-type gadget, the selected state of a button.

You can use this as a replacement for SetAttrsA(), too, if you specify nil for the Window and Requester parameters.

Notes:

This function invokes the OM_SET method with a GadgetInfo derived from the Window and Requester pointers.

See also

SetGadgetAttrs

  

Varargs Version of SetGadgetAttrsA()

NewObject

  

Varargs version of NewObjectA()

DisposeObject

  

Deletes a 'boopsi' object.

GetAttr

  

Inquire the value of some attribute of an object.

MakeClass

  

Create and initialize a boopsi class.


Documentation generated on: 2021-07-30