[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()