17 Managing Unknown Objects

17 Q3UnknownText_GetData

You can use the Q3UnknownText_GetData function to get the data of an unknown text object.

TQ3Status Q3UnknownText_GetData (
TQ3UnknownObject unknownObject, 
TQ3UnknownTextData *unknownTextData);
unknownObject
An unknown text object.
unknownTextData
A pointer to an unknown text data structure.

DESCRIPTION


The Q3UnknownText_GetData function returns, in the objectName and contents fields of the unknown text data structure pointed to by the unknownTextData parameter, pointers to the name and contents of an unknown text object (that is, an unknown object of type kQ3UnknownTypeText) specified by the unknownObject parameter. The contents field of the unknown text data structure points to the data stored in the text metafile, excluding any excess white space and any delimiter characters (that is, outermost parentheses).

Your application is responsible for allocating the memory occupied by the unknownTextData parameter. Q3UnknownText_GetData allocates memory to hold the name and contents pointed to by the fields of that structure. You must make certain to call Q3UnknownText_EmptyData to release the memory allocated by Q3UnknownText_GetData when you are finished using the data.

DESCRIPTION

3D Graphics Programming with QuickDraw 3D - 17 OCT 1995

© Apple Computer, Inc.

Let us know what you think of these prototype pages.

Generated with Harlequin WebMaker