Q3View_SubmitWriteData (IM: QD3D)

Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 13 - View Objects / View Objects Reference

View Objects Routines / Writing Custom Data

Q3View_SubmitWriteData
You can use the Q3View_SubmitWriteData function to submit for writing the data associated with a custom object.
TQ3Status Q3View_SubmitWriteData (
TQ3ViewObject view, 
TQ3Size size,
void *data, 
void (*deleteData));
view
A view.
size
The number of bytes of data to write. This value should be aligned on 4-byte boundaries.
data
A pointer to a buffer of data to be submitted for writing.
deleteData
A pointer to a data-deletion method. This method is called after your custom write method exits (whether or not the write method succeeds or fails). The value of the data parameter is passed as a parameter to your method.

DESCRIPTION
The Q3View_SubmitWriteData function submits the data specified by the data and size parameters for writing in the view specified by the view parameter. You can call Q3View_SubmitWriteData in a custom object-traversal method to write the data of a custom object. Q3View_SubmitWriteData calls the write method associated with that custom object type to actually write the data to a file object. When the write method returns, Q3View_SubmitWriteData executes the data-deletion method specified by the deleteData parameter.

SPECIAL CONSIDERATIONS
You should call this function only within a custom object-traversal method. See the chapter "File Objects" for more information about traversal methods.