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

DoGadgetMethodA

Invoke method on a boopsi gadget.

Declaration

Source position: intuition.pas line 4093

function DoGadgetMethodA(

  gad: pGadget;

  win: pWindow;

  req: pRequester;

  message: tMsg

):LongWord;

Arguments

gad

  

An abstract pointer to a boopsi gadget

win

  

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

req

  

For REQGADGETs, requester containing the gadget

Function result

The object does whatever it wants with the message you sent, which might include updating its gadget visuals. The return value is defined per-method.

Description

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

You should use this function for boopsi gadget objects, or for "models" which propagate information to gadgets.

Unlike DoMethodA(), this function provides a TGadgetInfo pointer (if possible) when invoking the method. Some classes may require or benefit from this.

Note: This function invokes the specified method with a TGadgetInfo derived from the Window and Requester pointers. The TGadgetInfo is passed as the second parameter of the message, except for OM_NEW, OM_SET, OM_NOTIFY, and OM_UPDATE, where the TGadgetInfo is passed as the third parameter.

Implementers of new gadget methods should ensure that the TGadgetInfo is the second long-word of their message!

See also

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