[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


    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 is used to prepare a DataTypes object for
	drawing 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.

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

    NOTE
	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.

    TAGS
	none defined at this time.

    SEE ALSO
	DrawDTObjectA(), ReleaseDTDrawInfo()