NAME

ObtainDTDrawInfoA: Obtain a DataTypes object for drawing. (V44)

SYNOPSIS

handle = ObtainDTDrawInfoA (o, attrs);
d0 a0 a1

APTR ObtainDTDrawInfoA (Object *, struct TagItem *);

handle = ObtainDTDrawInfo (o, tag1, ...);

APTR ObtainDTDrawInfo (Object *, Tag, ...);

FUNCTION

This function prepares a DataTypes object to render itself into a RastPort.

This function will send the DTM_OBTAINDRAWINFO method to the object using the opSet message structure.

INPUTS

o: Pointer to an object as returned by NewDTObjectA().
attrs: Additional attributes.

RESULT

Returns a opaque handle that must be passed to ReleaseDTDrawInfo() when the application is done drawing the object.

NOTES

This function implies a layout operation. Thus, you must not add the object in question to a window or requester and use ObtainDTDrawInfo() on it.