13 Writing in a View

13 Q3View_EndWriting

You can use the Q3View_EndWriting function to end writing to a file.

TQ3ViewStatus Q3View_EndWriting (TQ3ViewObject view);
view A view.

DESCRIPTION


The Q3View_EndWriting function returns, as its function result, a view status value that indicates the current state of the writing in the view specified by the view parameter. Q3View_EndWriting returns one of these four values:

typedef enum TQ3ViewStatus {
 kQ3ViewStatusDone,
 kQ3ViewStatusRetraverse,
 kQ3ViewStatusError,
 kQ3ViewStatusCancelled
} TQ3ViewStatus;
If Q3View_EndWriting returns kQ3ViewStatusDone, the writing has been completed and the specified view is no longer in writing mode. At that point, it is safe to exit your writing loop.

If Q3View_EndWriting returns kQ3ViewStatusRetraverse, the writing has not yet been completed. You should respecify the model by reentering your writing loop.

If Q3View_EndWriting returns kQ3ViewStatusError, the writing has failed because the renderer associated with the view encountered an error in processing the model. You should exit the writing loop.

If Q3View_EndWriting returns kQ3ViewStatusCancelled, the writing has been canceled. You should exit the writing loop.

SPECIAL CONSIDERATIONS


You should call Q3View_EndWriting only if writing is already occurring.

DESCRIPTION
SPECIAL CONSIDERATIONS

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